cgGLCreateBuffer
Keywords: cgGLCreateBuffer, NVIDIA, NVIDIA Cg Toolkit, Cg Toolkit, Shader, Shader Programming, GPU Shader Programming, GPU Program

> ## Name

> cgGLCreateBuffer - create an OpenGL buffer object

> ## Synopsis

>     #include <Cg/cgGL.h>

>     CGbuffer cgGLCreateBuffer( CGcontext context,
>                                int size,
>                                const void *data,
>                                GLenum bufferUsage );

> ## Parameters

> context
>   The context to which the new buffer will be added.
> size
>   The length in bytes of the buffer to create.
> data
>   The inital data to be copied into the buffer. NULL will fill the buffer with zero.
> bufferUsage
>   One of the usage flags specified as valid for glBufferData.

> ## Return Values

> Returns a CGbuffer handle on success.

> Returns NULL if any error occurs.

> ## Description

> cgGLCreateBuffer creates an OpenGL buffer object.

> ## Examples

>     CGbuffer myBuffer = cgGLCreateBuffer( myCgContext, sizeof( float ) * 16,
>                                           myData, GL_STATIC_DRAW );

> ## Errors

> CG_INVALID_CONTEXT_HANDLE_ERROR is generated if context is not a valid context.

> CG_MEMORY_ALLOC_ERROR is generated if a buffer couldn't be created.

> ## History

> cgGLCreateBuffer was introduced in Cg 2.0.

> ## See Also

> cgCreateBuffer, cgGLCreateBufferFromObject, cgGLGetBufferObject