kanzi::Texture::CreateInfo2D Struct Reference

Texture creation parameters for two dimensional texture. More...

#include <kanzi/core.ui/graphics2d/texture_create_info.hpp>

Inheritance diagram for kanzi::Texture::CreateInfo2D:

Public Member Functions
	CreateInfo2D (BitmapImageUniquePtr image)
	CreateInfo2D constructor for texture creation parameters, for creating a two dimensional texture that is initialized from an image. More...
	CreateInfo2D (Sampler::MipmapMode mipmaps, BitmapImageUniquePtr image)
	CreateInfo2D constructor that also takes in mipmap mode. More...
	CreateInfo2D (unsigned int width, unsigned int height, GraphicsFormat format)
	CreateInfo2D constructor for texture creation parameters, for creating a two dimensional texture with specified format and size. More...
Public Member Functions inherited from kanzi::Texture::CreateInfo
Status	adjust (const Renderer &renderer, string_view name)
	Validates and applies adjustments to some texture creation parameters in case of avoidable error conditions. More...
	CreateInfo ()
	Default constructor for texture create info. More...
void	updateShapeAndFormatFromImages ()
	Use updateShapeAndFormatFromImages() to fill in format, width, height from images. More...
Status	validate (const Renderer &renderer, string_view name) const
	Perform validation of texture creation parameters. More...
Status	validate (const Renderer &renderer) const
	Perform validation of texture creation parameters. More...

Additional Inherited Members
Public Types inherited from kanzi::Texture::CreateInfo
enum	Status {   StatusInvalidType, StatusTypeNotSupported, StatusInvalidRenderTargetMode, StatusInvalidImageCount,   StatusMissingImages, StatusImageMissingMipmaps, StatusInvalidImageSize, StatusInvalidMinimumSize,   StatusInvalidMaximumSize, StatusInvalidMipmapSize, StatusUnsupportedGraphicsFormat, StatusUnsupportedTextureFilter,   StatusInvalidFeatures, StatusUnsupportedMultisampleFilter, StatusUnsupportedMultisampleMipmaps, StatusUnsupportedMultisampleSamples,   StatusUnsupportedInternalRenderTargetSampleCount, StatusUnsupportedSampleCount, StatusImageFormatMismatch, StatusImageIncompatibleWithDevice,   StatusUnsupportedDepthComparisonMode, StatusValid }
	Status tells if texture creation parameters can be used to create a texture. More...
Static Public Member Functions inherited from kanzi::Texture::CreateInfo
static CreateInfo	createSubstitutePattern (const Renderer &renderer, TextureType type)
	Create a texture create info structure for a black 1x1 texture. More...
Public Attributes inherited from kanzi::Texture::CreateInfo
Sampler::AddressingMode	addressingMode
	Texture addressing mode. More...
float	anisotropy
	Texture anisotropy. More...
unsigned int	depth
	Reserved for future use. More...
GraphicsCompareFunction	depthCompareFunction
	Depth comparison function. More...
GraphicsFormat	depthStencilFormat
	DepthStencil format. More...
unsigned int	features
	Required format features. More...
GraphicsFormat	format
	Format for texture. More...
unsigned int	height
	Height for the base level of texture. More...
unsigned int	heightDivisor
	Automatic size determination divisor for height, 0 when not automatic. More...
vector< BitmapImageSharedPtr >	images
	Images that are used to create the texture. More...
Sampler::Filter	magnificationFilter
	Texture minification filter. More...
float	maxLod
	Reserved for future use. More...
MemoryType	memoryType
	Memory type for the texture. More...
Sampler::Filter	minificationFilter
	Texture magnification filter. More...
float	minLod
	Reserved for future use. More...
float	mipLodBias
	Reserved for future use. More...
unsigned int	mipmapLevelCount
	Number of mipmap levels for the texture. More...
Sampler::MipmapMode	mipmapMode
	Mipmap mode for the texture. More...
NativeDeploymentTarget	nativeDeploymentTarget
	Native deployment target to use for memory storage if supported by the backend. More...
RenderTargetMode	renderTargetMode
	RenderTarget mode for the texture. More...
unsigned int	renderTargetSampleCount
	Specifies number of samples for the draw renderbuffer when RenderTargetMode is RenderTargetModeExternal. More...
TextureType	type
	Texture type. More...
unsigned int	width
	Width for the base level of texture. More...
unsigned int	widthDivisor
	Automatic size determination divisor for width, 0 when not automatic. More...
Protected Member Functions inherited from kanzi::Texture::CreateInfo
Status	validateFormat (const Renderer &renderer) const
	Validates texture format and features. More...
Status	validateImages (const Renderer &renderer) const
	Test if given set of images can be used to create Texture. More...
Status	validateSize (const Renderer &renderer) const
	Validates texture size against minimum valid texture size (1x1) and maximum supported by graphics adapter. More...
Status	validateTargetCompatibility (const Renderer &renderer) const
	Checks for known device incompatibilities, for example with texture formats and size. More...

Detailed Description

Texture creation parameters for two dimensional texture.

You can use resulting texture as content in Image2D nodes or texture brushes, or in materials for 3D rendering or material brushes.

Constructor & Destructor Documentation

CreateInfo2D() [1/3]

kanzi::Texture::CreateInfo2D::CreateInfo2D ( BitmapImageUniquePtr  image )

explicit

CreateInfo2D constructor for texture creation parameters, for creating a two dimensional texture that is initialized from an image.

After the CreateInfo2D constructor:

• Image is stored in create info.
• Texture type is set to TypeTwoDimensional.
• Texture size and format is determined from the image.

The following (from CreateInfo constructor) also applies:

• Texture minification and magnification filter settings are set to FilterNearest.
• Texture wrap mode is set to AddressingModeClamp, so texture will not repeat.
• Texture mipmap mode is set to MipmapModeBase, and mipmapLevelCount is set to 1, so texture will have only base image, no mipmaps.

Note

After constructor, due to filter settings and lack of mipmaps, the resulting texture should only be used when texture content is shown without scaling. If you show resulting texture content with scaling, the result has noticeable aliasing. Adjust filter and mipmap settings after constructor to reduce aliasing.

Texture::create() takes ownership of images you pass in the create info,

See also

Texture::create().

Image

Parameters

image

Source image for texture.

CreateInfo2D() [2/3]

kanzi::Texture::CreateInfo2D::CreateInfo2D ( Sampler::MipmapMode  mipmaps, BitmapImageUniquePtr  image  )

explicit

CreateInfo2D constructor that also takes in mipmap mode.

For details, see CreateInfo2D(BitmapImageUniquePtr)

Parameters

mipmaps	Mipmap mode.
image	Source image for texture.

CreateInfo2D() [3/3]

kanzi::Texture::CreateInfo2D::CreateInfo2D ( unsigned int  width, unsigned int  height, GraphicsFormat  format  )

explicit

CreateInfo2D constructor for texture creation parameters, for creating a two dimensional texture with specified format and size.

After the CreateInfo2D constructor:

• Texture type is set to TypeTwoDimensional.
• Texture size and format is set according to constructor parameters.

The following (from CreateInfo constructor) also applies:

• Texture minification and magnification filter settings are set to FilterNearest.
• Texture wrap mode is set to AddressingModeClamp, so texture will not repeat.
• Texture mipmap mode is set to MipmapModeBase, and mipmapLevelCount is set to 1, so texture will have only base image, no mipmaps.
• Texture rendertarget mode is set to RenderTargetModeNone, so resulting texture cannot be set as rendertarget for neither 2d nodes nor renderpasses. If you want to render to the resulting texture, change rendertarget mode.

Note

After constructor, due to filter settings and lack of mipmaps, the resulting texture should only be used when texture content is shown without scaling. If you show resulting texture content with scaling, the result has noticeable aliasing. Adjust filter and mipmap settings after constructor to reduce aliasing.

When you create texture from CreateInfo that has no images, texture contents are initially undefined. Use Texture::setData() to specify texture contents, or render to the texture.

Parameters

width	Width for the texture
height	Height for the texture
format	Format for the texture

---

The documentation for this struct was generated from the following file:

• kanzi/core.ui/graphics2d/texture_create_info.hpp