Constructor

CoglAttributeBuffernew

Declaration [src]

CoglAttributeBuffer*
cogl_attribute_buffer_new (
  CoglContext* context,
  size_t bytes,
  void* data
)

Description [src]

Describes a new CoglAttributeBuffer of size bytes to contain arrays of vertex attribute data and also uploads size bytes read from data to the new buffer.

You should never pass a NULL data pointer.

This function does not report out-of-memory errors back to the caller by returning NULL and so you can assume this function always succeeds.

In the unlikely case that there is an out of memory problem then Cogl will abort the application with a message. If your application needs to gracefully handle out-of-memory errors then you can use cogl_attribute_buffer_new_with_size() and then explicitly catch errors with cogl_buffer_set_data() or cogl_buffer_map().

Parameters

context

Type: CoglContext

A CoglContext.

The data is owned by the caller of the function.
bytes

Type: size_t

The number of bytes to allocate for vertex attribute data.

data

Type: An array of guint8

An optional pointer to vertex data to upload immediately.

The length of the array is specified in the bytes argument.
The data is owned by the caller of the function.

Return value

Type: CoglAttributeBuffer

A newly allocated CoglAttributeBuffer (never NULL).

The caller of the function takes ownership of the data, and is responsible for freeing it.