Creates a low-level Texture3D texture with the specified dimensions and pixel format.
The storage for the texture is not allocated before this function returns. You can call allocate to explicitly allocate the underlying storage or preferably let Cogl automatically allocate storage lazily when it may know more about how the texture is going to be used and can optimize how it is allocated.
The texture is still configurable until it has been allocated so for example you can influence the internal format of the texture using set_components and set_premultiplied.
<note>This texture will fail to allocate later if cogl_feature_id_texture_3d is not advertised. Allocation can also fail if the requested dimensions are not supported by the GPU.</note>
context |
a Context |
width |
width of the texture in pixels. |
height |
height of the texture in pixels. |
depth |
depth of the texture in pixels. |
A new Texture3D object with no storage yet allocated. |