Function bgfx_sys::bgfx_update_texture_cube
source · pub unsafe extern "C" fn bgfx_update_texture_cube(
_handle: bgfx_texture_handle_t,
_layer: u16,
_side: u8,
_mip: u8,
_x: u16,
_y: u16,
_width: u16,
_height: u16,
_mem: *const bgfx_memory_t,
_pitch: u16
)
Expand description
Update Cube texture.
@attention It’s valid to update only mutable texture. See bgfx::createTextureCube
for more info.
@param[in] _handle Texture handle.
@param[in] _layer Layer in texture array.
@param[in] _side Cubemap side BGFX_CUBE_MAP_<POSITIVE or NEGATIVE>_<X, Y or Z>
,
where 0 is +X, 1 is -X, 2 is +Y, 3 is -Y, 4 is +Z, and 5 is -Z.
+–––––+
|-z 2|
| ^ +y |
| | | Unfolded cube:
| +––>+x |
+–––––+–––––+–––––+–––––+
|+y 1|+y 4|+y 0|+y 5|
| ^ -x | ^ +z | ^ +x | ^ -z |
| | | | | | | | |
| +––>+z | +––>+x | +––>-z | +––>-x |
+–––––+–––––+–––––+–––––+
|+z 3|
| ^ -y |
| | |
| +––>+x |
+–––––+
@param[in] _mip Mip level.
@param[in] _x X offset in texture.
@param[in] _y Y offset in texture.
@param[in] _width Width of texture block.
@param[in] _height Height of texture block.
@param[in] _mem Texture update data.
@param[in] _pitch Pitch of input image (bytes). When _pitch is set to
UINT16_MAX, it will be calculated internally based on _width.