DataBufferSubDataT Method (IntPtr, T, IntPtr)

Update a subset of a buffer object's data store.

Namespace: Ooogles
Assembly: Ooogles (in Ooogles.dll) Version: 1.0.0.0 (1.0.0.0)

Syntax

public void SubData<T>(
	IntPtr offset,
	T[] data,
	IntPtr size
)
where T : struct, new()

Public Sub SubData(Of T As {Structure, New}) ( 
	offset As IntPtr,
	data As T(),
	size As IntPtr
)

public:
generic<typename T>
where T : value class, gcnew()
void SubData(
	IntPtr offset, 
	array<T>^ data, 
	IntPtr size
)

member SubData : 
        offset : IntPtr * 
        data : 'T[] * 
        size : IntPtr -> unit  when 'T : struct, new()

Parameters

offset: Type: SystemIntPtr
the offset into the buffer object's data store where data replacement will begin, measured in bytes.
data: Type: T
data array to copy to the buffer.
size: Type: SystemIntPtr
the number of bytes in the data array.

Type Parameters

T: the type of data in the data array

Exceptions

Exception	Condition
GLException	InvalidValue if offset or size is negative, or if together they define a region of memory that extends beyond the buffer object's allocated data store.
GLException	InvalidOperation if no buffer is bound.

Remarks

This method redefines some or all of the data store for the buffer object currently bound to target. data starting at byte offset offset and extending for size bytes is copied to the data store from the memory pointed to by data. An error is thrown if offset and size together define a range beyond the bounds of the buffer object's data store.

Note: when replacing the entire data store, consider using SubData rather than completely recreating the data store with DataT(T, IntPtr, DataBufferUsage). This avoids the cost of reallocating the data store.

Note: consider using multiple buffer objects to avoid stalling the rendering pipeline during data store updates. If any rendering in the pipeline makes reference to data in the buffer object being updated by SubData, especially from the specific region being updated, that rendering must drain from the pipeline before the data store can be updated.

Note: clients must align data elements consistent with the requirements of the client platform, with an additional base-level requirement that an offset within a buffer to a datum comprising N be a multiple of N.

Note: in DEBUG mode with assertions enabled, an error will be logged to the debug console if this buffer is not bound.

OpenGL API: glBufferSubData

Reference

DataBufferDataT(T, DataBufferUsage)