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

> ## Name

> cgSetBufferData - resize and completely update a buffer object

> ## Synopsis

>     #include <Cg/cg.h>

>     void cgSetBufferData( CGbuffer buffer,
>                           int size,
>                           const void * data );

> ## Parameters

> buffer
>   The buffer which will be updated.
> size
>   Specifies a new size for the buffer object. Zero for size means use the existing size of the buffer as the effective size.
> data
>   Pointer to the data to copy into the buffer. The number of bytes to copy is determined by the size parameter.

> ## Return Values

> None.

> ## Description

> cgSetBufferData resizes and completely updates an existing buffer object.

> A buffer which has been mapped into an applications address space with cgMapBuffer must be unmapped using cgUnmapBuffer before it can be updated with cgSetBufferData.

> ## Examples

> cgSetBufferData( myBuffer, sizeof( myData ), myData );

> ## Errors

> CG_INVALID_BUFFER_HANDLE_ERROR is generated if buffer is not a valid buffer.

> CG_BUFFER_UPDATE_NOT_ALLOWED_ERROR is generated if buffer is currently mapped.

> ## History

> cgSetBufferData was introduced in Cg 2.0.

> ## See Also

> cgCreateBuffer, cgGLCreateBuffer, cgSetBufferSubData, cgMapBuffer, cgUnmapBuffer