Texture:newView
EditCreates a new Texture view. A texture view does not store any pixels on its own, but instead uses the pixel data of a "parent" Texture object. The width, height, format, sample count, and usage flags all match the parent. The view may have a different TextureType from the parent, and it may reference a subset of the parent texture's layers and mipmap levels.
Texture views can be used as render targets in a render pass and they can be bound to Shaders. They can not currently be used for transfer operations. They are used for:
- Reinterpretation of texture contents. For example, a cubemap can be treated as an array texture.
- Rendering to a particular image or mipmap level of a texture.
- Binding a particular image or mipmap level to a shader.
view = Texture:newView(type, layer, layerCount, mipmap, mipmapCount)Arguments
| Name | Type | Default | Description |
| type | TextureType | The texture type of the view. | |
| layer | number | 1 | The index of the first layer in the view. |
| layerCount | number | nil |
The number of layers in the view, or nil to use all remaining layers.
|
| mipmap | number | 1 | The index of the first mipmap in the view. |
| mipmapCount | number | nil |
The number of mipmaps in the view, or nil to use all remaining mipmaps.
|
Returns
| Name | Type | Description |
| view | Texture | The new texture view. |
See also
Texture:isViewTexture:getParentlovr.graphics.newTextureTexture