2D texture array object class. More...
#include <texture_2d_array.h>
Inheritance diagram for clan::Texture2DArray:Public Member Functions | |
| Texture2DArray () | |
| Constructs a null instance. | |
| Texture2DArray (const std::shared_ptr< Texture_Impl > &impl) | |
| Texture2DArray (GraphicContext &context, const Size &size, int array_size, TextureFormat texture_format=TextureFormat::rgba8, int levels=1) | |
| Texture2DArray (GraphicContext &context, int width, int height, int array_size, TextureFormat texture_format=TextureFormat::rgba8, int levels=1) | |
| Texture2D | create_2d_view (int array_index, TextureFormat texture_format, int min_level, int num_levels) |
| Creates a 2D texture view. | |
| int | get_array_size () const |
| Returns the number of textures in the array. | |
| float | get_dip_height () const |
| Returns the device independent height of this texture. | |
| Sizef | get_dip_size () const |
| Returns the device independent size of this texture. | |
| float | get_dip_width () const |
| Returns the device independent width of this texture. | |
| int | get_height () const |
| Retrieves the actual height of the texture in the display. | |
| float | get_pixel_ratio () const |
| Size | get_size () const |
| Retrieves the actual size of the texture. | |
| int | get_width () const |
| Retrieves the actual width of the texture in the display. | |
| TextureWrapMode | get_wrap_mode_s () const |
| Get the texture wrap mode for the s coordinate. | |
| TextureWrapMode | get_wrap_mode_t () const |
| Get the texture wrap mode for the t coordinate. | |
| void | set_image (GraphicContext &context, int array_index, const PixelBuffer &image, int level=0) |
| void | set_pixel_ratio (float ratio) |
| Sets the display pixel ratio for this texture. | |
| void | set_subimage (GraphicContext &context, int array_index, const Point &point, const PixelBuffer &image, const Rect &src_rect, int level=0) |
| void | set_subimage (GraphicContext &context, int array_index, int x, int y, const PixelBuffer &image, const Rect &src_rect, int level=0) |
| void | set_wrap_mode (TextureWrapMode wrap_s, TextureWrapMode wrap_t) |
Public Member Functions inherited from clan::Texture | |
| Texture () | |
| Constructs a null instance. | |
| Texture (const std::shared_ptr< Texture_Impl > &impl) | |
| Constructs a texture from an implementation. | |
| Texture (GraphicContext &gc, PixelBufferSet pixelbuffer_set) | |
| Constructs a texture as described in a pixelbuffer set. | |
| Texture (TextureProvider *provider) | |
| Constructs a texture from a texture provider. | |
| virtual | ~Texture () |
| void | generate_mipmap () |
| Generate the mipmap. | |
| int | get_base_level () const |
| Get the texture base level. | |
| CompareFunction | get_compare_function () const |
| Get the texture compare function. | |
| TextureCompareMode | get_compare_mode () const |
| Get the texture compare mode. | |
| std::weak_ptr< Texture_Impl > | get_impl () const |
| Get the implementation weakptr. | |
| float | get_lod_bias () const |
| Get the level of detail bias constant. | |
| TextureFilter | get_mag_filter () const |
| Get the texture magnification filter. | |
| int | get_max_level () const |
| Get the texture max level. | |
| float | get_max_lod () const |
| Get the maximum level of detail. | |
| TextureFilter | get_min_filter () const |
| Get the texture minification filter. | |
| float | get_min_lod () const |
| Get the minimum level of detail. | |
| TextureProvider * | get_provider () const |
| Get Provider. | |
| bool | is_null () const |
| Returns true if this object is invalid. | |
| bool | is_resident () const |
| Returns true if texture is resident in texture memory. | |
| operator bool () const | |
| bool | operator!= (const Texture &other) const |
| Inequality operator. | |
| bool | operator< (const Texture &other) const |
| Less than operator. | |
| bool | operator== (const Texture &other) const |
| Equality operator. | |
| void | set_base_level (int base_level) |
| Sets the texture base level texture parameter. | |
| void | set_lod_bias (float lod_bias) |
| Sets the level of detail bias constant. | |
| void | set_mag_filter (TextureFilter filter) |
| Set the magnification filter. | |
| void | set_max_anisotropy (float max_anisotropy) |
| Set the maximum degree of anisotropy. | |
| void | set_max_level (int max_level) |
| Sets the texture max level texture parameter. | |
| void | set_max_lod (float max_lod) |
| Set the maximum level of detail texture parameter. | |
| void | set_min_filter (TextureFilter filter) |
| Set the minification filter. | |
| void | set_min_lod (float min_lod) |
| Set the minimum level of detail texture parameter. | |
| void | set_texture_compare (TextureCompareMode mode, CompareFunction func) |
| Sets the texture compare mode and compare function texture parameters. | |
| void | throw_if_null () const |
| Throw an exception if this object is invalid. | |
| Texture1D | to_texture_1d () const |
| Dynamic cast to Texture1D. | |
| Texture1DArray | to_texture_1d_array () const |
| Dynamic cast to Texture1DArray. | |
| Texture2D | to_texture_2d () const |
| Dynamic cast to Texture2D. | |
| Texture2DArray | to_texture_2d_array () const |
| Dynamic cast to Texture2DArray. | |
| Texture3D | to_texture_3d () const |
| Dynamic cast to Texture3D. | |
| TextureCube | to_texture_cube () const |
| Dynamic cast to TextureCube. | |
| TextureCubeArray | to_texture_cube_array () const |
| Dynamic cast to TextureCubeArray. | |
Additional Inherited Members | |
Static Public Member Functions inherited from clan::Texture | |
| static Texture | load (GraphicContext &gc, const std::string &id, const XMLResourceDocument &doc, const ImageImportDescription &import_desc=ImageImportDescription()) |
| Loads a Texture from a XML resource definition. | |
| static Resource< Texture > | resource (GraphicContext &gc, const std::string &id, const ResourceManager &resources) |
| Retrieves a Texture resource from the resource manager. | |
Protected Attributes inherited from clan::Texture | |
| std::shared_ptr< Texture_Impl > | impl |
2D texture array object class.
| clan::Texture2DArray::Texture2DArray | ( | ) |
Constructs a null instance.
|
inline |
Constructs a texture from an implementation.
| impl | The Texture object implementation. |
| clan::Texture2DArray::Texture2DArray | ( | GraphicContext & | context, |
| int | width, | ||
| int | height, | ||
| int | array_size, | ||
| TextureFormat | texture_format = TextureFormat::rgba8, | ||
| int | levels = 1 ) |
Constructs a new Texture object.
| context | Graphic context to construct the texture on. |
| width | Width of the new texture. |
| height | Height of the new texture. |
| array_size | Number of textures to allocate in this array. |
| format | Data format of the new texture. |
| levels | Number of mipmap levels for the new texture. Setting this to 0 enables all levels. |
| clan::Texture2DArray::Texture2DArray | ( | GraphicContext & | context, |
| const Size & | size, | ||
| int | array_size, | ||
| TextureFormat | texture_format = TextureFormat::rgba8, | ||
| int | levels = 1 ) |
Constructs a new Texture object.
| context | Graphic context to construct the texture on. |
| size | Size of the new texture. |
| array_size | Number of textures to allocate in this array. |
| format | Data format of the new texture. |
| levels | Number of mipmap levels for the new texture. Setting this to 0 enables all levels. |
| Texture2D clan::Texture2DArray::create_2d_view | ( | int | array_index, |
| TextureFormat | texture_format, | ||
| int | min_level, | ||
| int | num_levels ) |
Creates a 2D texture view.
| int clan::Texture2DArray::get_array_size | ( | ) | const |
Returns the number of textures in the array.
|
inline |
Returns the device independent height of this texture.
References get_height(), and get_pixel_ratio().
Referenced by get_dip_size().
|
inline |
Returns the device independent size of this texture.
References get_dip_height(), and get_dip_width().
|
inline |
Returns the device independent width of this texture.
References get_pixel_ratio(), and get_width().
Referenced by get_dip_size().
| int clan::Texture2DArray::get_height | ( | ) | const |
Retrieves the actual height of the texture in the display.
Referenced by get_dip_height(), and get_size().
| float clan::Texture2DArray::get_pixel_ratio | ( | ) | const |
Retrieves the pixel ratio of this texture.
Referenced by get_dip_height(), and get_dip_width().
|
inline |
Retrieves the actual size of the texture.
References get_height(), and get_width().
| int clan::Texture2DArray::get_width | ( | ) | const |
Retrieves the actual width of the texture in the display.
Referenced by get_dip_width(), and get_size().
| TextureWrapMode clan::Texture2DArray::get_wrap_mode_s | ( | ) | const |
Get the texture wrap mode for the s coordinate.
| TextureWrapMode clan::Texture2DArray::get_wrap_mode_t | ( | ) | const |
Get the texture wrap mode for the t coordinate.
| void clan::Texture2DArray::set_image | ( | GraphicContext & | context, |
| int | array_index, | ||
| const PixelBuffer & | image, | ||
| int | level = 0 ) |
Upload image to this texture array.
| context | Graphic context to use for the request. |
| array_index | Index in the array to upload the image into. |
| image | Image to upload. |
| level | Mipmap level-of-detail number. |
| void clan::Texture2DArray::set_pixel_ratio | ( | float | ratio | ) |
Sets the display pixel ratio for this texture.
| void clan::Texture2DArray::set_subimage | ( | GraphicContext & | context, |
| int | array_index, | ||
| const Point & | point, | ||
| const PixelBuffer & | image, | ||
| const Rect & | src_rect, | ||
| int | level = 0 ) |
| void clan::Texture2DArray::set_subimage | ( | GraphicContext & | context, |
| int | array_index, | ||
| int | x, | ||
| int | y, | ||
| const PixelBuffer & | image, | ||
| const Rect & | src_rect, | ||
| int | level = 0 ) |
Upload image to sub-texture.
| context | Graphic context to use for the request. |
| array_index | Index in the array to upload the image into. |
| x | The horizontal point in the selected texture to write the new sub-texture image onto. |
| y | The vertical point in the selected texture to write the sub-texture image onto. |
| image | Image to upload. |
| level | Mipmap level-of-detail number. |
| void clan::Texture2DArray::set_wrap_mode | ( | TextureWrapMode | wrap_s, |
| TextureWrapMode | wrap_t ) |