![]() |
![]() |
![]() |
Cogl Reference Manual | ![]() |
---|---|---|---|---|
Top | Description |
CoglTexture3D * cogl_texture_3d_new_with_size (,
CoglContext *context,
int width,
int height,
int depthCoglPixelFormat internal_format
);CoglTexture3D * cogl_texture_3d_new_from_data (,
CoglContext *context,
int width,
int height,
int depthCoglPixelFormat format
,CoglPixelFormat internal_format
,,
int rowstride,
int image_strideconst
,uint8_t *data);
CoglError **errorCoglBool cogl_is_texture_3d ();
void *object
These functions allow 3D textures to be used. 3D textures can be thought of as layers of 2D images arranged into a cuboid shape. When choosing a texel from the texture, Cogl will take into account the 'r' texture coordinate to select one of the images.
CoglTexture3D * cogl_texture_3d_new_with_size (,
CoglContext *context,
int width,
int height,
int depthCoglPixelFormat internal_format
);
Creates a new
The storage for the texture is not allocated before this function
returns. You can call cogl_texture_allocate()
COGL_FEATURE_ID_TEXTURE_3D
|
a |
|
width of the texture in pixels. |
|
height of the texture in pixels. |
|
depth of the texture in pixels. |
|
the CoglPixelFormat to use for the GPU storage of the texture. |
Returns : |
A new |
Since 1.10
Stability Level: Unstable
CoglTexture3D * cogl_texture_3d_new_from_data (,
CoglContext *context,
int width,
int height,
int depthCoglPixelFormat format
,CoglPixelFormat internal_format
,,
int rowstride,
int image_strideconst
,uint8_t *data);
CoglError **error
Creates a new 3D texture and initializes it with data
. The data is
assumed to be packed array of depth
images. There can be padding
between the images using image_stride
.
Note that this function will throw a COGL_FEATURE_ID_TEXTURE_3D
|
a |
|
width of the texture in pixels. |
|
height of the texture in pixels. |
|
depth of the texture in pixels. |
|
the CoglPixelFormat the buffer is stored in in RAM |
|
the CoglPixelFormat that will be used for storing
the buffer on the GPU. If COGL_PIXEL_FORMAT_ANY is given then a
premultiplied format similar to the format of the source data will
be used. The default blending equations of Cogl expect premultiplied
color data; the main use of passing a non-premultiplied format here
is if you have non-premultiplied source data and are going to adjust
the blend mode (see cogl_pipeline_set_blend() |
|
the memory offset in bytes between the starts of
scanlines in data or 0 to infer it from the width and format |
|
the number of bytes from one image to the next. This
can be used to add padding between the images in a similar way
that the rowstride can be used to add padding between
rows. Alternatively 0 can be passed to infer the image_stride
from the height . |
|
pointer the memory region where the source buffer resides |
|
A CoglError return location. |
Returns : |
the newly created NULL error . |
Since 1.10
Stability Level: Unstable
CoglBool cogl_is_texture_3d ();
void *object
Checks whether the given object references a
|
a CoglObject |
Returns : |
TRUE FALSE |
Since 1.4
Stability Level: Unstable