#include <Texture2D.h>

Inherits Object.

Public Types
using	TexParams = rhi::SamplerDesc
	Extension to set the Min / Mag filter.

Public Member Functions
virtual	~Texture2D ()
	@lua NA
bool	initWithImage (Image *image, PixelFormat renderFormat=PixelFormat::NONE, bool autoGenMipmaps=false)
	Initializes a texture from a Image object.
bool	initWithString (std::string_view text, std::string_view fontName, float fontSize, const Vec2 &dimensions=Vec2(0, 0), TextHAlignment hAlignment=TextHAlignment::CENTER, TextVAlignment vAlignment=TextVAlignment::TOP, bool enableWrap=true, int overflow=0)
	Initializes a texture from a string with dimensions, alignment, font name and font size.
bool	initWithString (std::string_view text, const FontDefinition &textDefinition)
	Initializes a texture from a string using a text definition.
bool	initWithData (const void *data, ssize_t dataSize, rhi::PixelFormat pixelFormat, int pixelsWide, int pixelsHigh, bool preMultipliedAlpha=false, bool autoGenMipmaps=false)
	Initializes with a texture2d with data.
bool	initWithData (const void *data, ssize_t dataSize, rhi::PixelFormat pixelFormat, rhi::PixelFormat renderFormat, int pixelsWide, int pixelsHigh, bool preMultipliedAlpha=false, bool autoGenMipmaps=false)
	Initializes with a texture2d with data.
bool	initWithMipmaps (std::span< MipmapInfo > mipmaps, rhi::PixelFormat pixelFormat, rhi::PixelFormat renderFormat, int pixelsWide, int pixelsHigh, bool preMultipliedAlpha=false)
	Initializes with mipmaps.
bool	updateData (Image *image)
	update data by image
bool	updateData (std::span< const TextureSliceData > subDatas)
	update data by subDatas
bool	updateData (const void *data, int width, int height, int level=0, int layerIndex=0)
	Update the texture with a new image data.
bool	updateSubData (const void *data, int offsetX, int offsetY, int width, int height, int level=0, int layerIndex=0)
	Update texture sub data.
void	drawAtPoint (const Vec2 &point, float globalZOrder)
	Drawing extensions to make it easy to draw basic quads using a Texture2D object.
void	drawInRect (const Rect &rect, float globalZOrder)
	Draws a texture inside a rect.
void	setAntiAliasTexParameters ()
	Sets antialias texture parameters:
void	setAliasTexParameters ()
	Sets alias texture parameters:
const char *	getStringForFormat () const
	Returns the pixel format.
unsigned int	getBitsPerPixelForFormat () const
	Returns the bits-per-pixel of the in-memory OpenGL texture.
unsigned int	getBitsPerPixelForFormat (rhi::PixelFormat format) const
	Helper functions that returns bits per pixels for a given format.
const Vec2 &	getContentSizeInPixels ()
	Get content size.
bool	hasPremultipliedAlpha () const
	Whether or not the texture has their Alpha premultiplied.
bool	hasMipmaps () const
	Whether or not the texture has mip maps.
rhi::PixelFormat	getPixelFormat () const
	Gets the pixel format of the texture.
int	getPixelsWide () const
	Gets the width of the texture in pixels.
int	getPixelsHigh () const
	Gets the height of the texture in pixels.
float	getMaxS () const
	Gets max S.
void	setMaxS (float maxS)
	Sets max S.
float	getMaxT () const
	Gets max T.
void	setMaxT (float maxT)
	Sets max T.
Vec2	getContentSize () const
	Get the texture content size.
Public Member Functions inherited from Object
void	retain ()
	Retains the ownership.
void	release ()
	Releases the ownership immediately.
Object *	autorelease ()
	Releases the ownership sometime soon automatically.
unsigned int	getReferenceCount () const
	Returns the Object's current reference count.
virtual	~Object ()
	Destructor.

Additional Inherited Members
Public Attributes inherited from Object
unsigned int	_ID
	object id, ScriptSupport need public _ID
int	_luaID
	Lua reference id.

Detailed Description

Texture2D class.

This class allows to easily create OpenGL 2D textures from images, text or raw data. The created Texture2D object will always have power-of-two dimensions. Depending on how you create the Texture2D object, the actual image area of the texture might be smaller than the texture dimensions i.e. "contentSize" != (pixelsWide, pixelsHigh) and (maxS, maxT) != (1.0, 1.0). Be aware that the content of the generated textures will be upside-down!

Member Function Documentation

◆ initWithImage()

bool initWithImage	(	Image *	image,
		PixelFormat	renderFormat = PixelFormat::NONE,
		bool	autoGenMipmaps = false )

Initializes a texture from a Image object.

We will use the format you passed to the function to convert the image format to the texture format. If you pass PixelFormat::NONE, we will auto detect the image render type and use that type for texture to render.

Parameters

image	An Image object.
format	Texture pixel formats.

◆ initWithString() [1/2]

bool initWithString	(	std::string_view	text,
		std::string_view	fontName,
		float	fontSize,
		const Vec2 &	dimensions = Vec2(0, 0),
		TextHAlignment	hAlignment = TextHAlignment::CENTER,
		TextVAlignment	vAlignment = TextVAlignment::TOP,
		bool	enableWrap = true,
		int	overflow = 0 )

Initializes a texture from a string with dimensions, alignment, font name and font size.

Parameters

text	A null terminated string.
fontName	The font name.
fontSize	The font size.
dimensions	The font dimension.
hAlignment	The font horizontal text alignment type.
vAlignment	The font vertical text alignment type.
enableWrap	Whether enable text wrap or not.
overflow	Whether shrink font size when content larger than the dimensions.

◆ initWithString() [2/2]

bool initWithString	(	std::string_view	text,
		const FontDefinition &	textDefinition )

Initializes a texture from a string using a text definition.

Parameters

text	A null terminated string.
textDefinition	A FontDefinition object contains font attributes.

◆ initWithData() [1/2]

bool initWithData	(	const void *	data,
		ssize_t	dataSize,
		rhi::PixelFormat	pixelFormat,
		int	pixelsWide,
		int	pixelsHigh,
		bool	preMultipliedAlpha = false,
		bool	autoGenMipmaps = false )

inline

Initializes with a texture2d with data.

Parameters

data	Specifies a pointer to the image data in memory.
dataSize	The image data length.
pixelFormat	The image pixelFormat.
pixelsWide	The image width.
pixelsHigh	The image height.
contentSize	The image content size.
preMultipliedAlpha	The texture has premultiplied alpha @lua NA

◆ initWithData() [2/2]

bool initWithData	(	const void *	data,
		ssize_t	dataSize,
		rhi::PixelFormat	pixelFormat,
		rhi::PixelFormat	renderFormat,
		int	pixelsWide,
		int	pixelsHigh,
		bool	preMultipliedAlpha = false,
		bool	autoGenMipmaps = false )

Initializes with a texture2d with data.

Parameters

data	Specifies a pointer to the image data in memory.
dataSize	The image data length.
pixelFormat	The image pixelFormat.
renderFormat	The format converted to.
pixelsWide	The image width.
pixelsHigh	The image height.
contentSize	The image content size.
preMultipliedAlpha	The texture has premultiplied alpha @lua NA

◆ initWithMipmaps()

bool initWithMipmaps	(	std::span< MipmapInfo >	mipmaps,
		rhi::PixelFormat	pixelFormat,
		rhi::PixelFormat	renderFormat,
		int	pixelsWide,
		int	pixelsHigh,
		bool	preMultipliedAlpha = false )

Initializes with mipmaps.

Parameters

mipmaps	Specifies a pointer to the image data in memory.
mipmapsNum	The mipmaps number.
pixelFormat	The image pixelFormat.
pixelsWide	The image width.
pixelsHigh	The image height.
preMultipliedAlpha	The texture has premultiplied alpha

◆ updateData() [1/3]

bool updateData ( Image * image )

update data by image

Parameters

image

◆ updateData() [2/3]

bool updateData ( std::span< const TextureSliceData > subDatas )

update data by subDatas

Parameters

subDatas

◆ updateData() [3/3]

bool updateData	(	const void *	data,
		int	width,
		int	height,
		int	level = 0,
		int	layerIndex = 0 )

Update the texture with a new image data.

Parameters

data	Specifies a pointer to the image data in memory.
width	Specifies the width of the texture.
height	Specifies the height of the texture.
level	Specifies the mipmap level to update. Default is 0.
layerIndex	Specifies the layer index to update. Default is 0.

◆ updateSubData()

bool updateSubData	(	const void *	data,
		int	offsetX,
		int	offsetY,
		int	width,
		int	height,
		int	level = 0,
		int	layerIndex = 0 )

Update texture sub data.

Parameters

data	Specifies a pointer to the image data in memory.
offsetX	Specifies a texel offset in the x direction within the texture array.
offsetY	Specifies a texel offset in the y direction within the texture array.
width	Specifies the width of the texture subimage.
height	Specifies the height of the texture subimage.

◆ drawAtPoint()

void drawAtPoint	(	const Vec2 &	point,
		float	globalZOrder )

Drawing extensions to make it easy to draw basic quads using a Texture2D object.

These functions require GL_TEXTURE_2D and both GL_VERTEX_ARRAY and GL_TEXTURE_COORD_ARRAY client states to be enabled. Draws a texture at a given point.

◆ setAntiAliasTexParameters()

void setAntiAliasTexParameters ( )

Sets antialias texture parameters:

GL_TEXTURE_MIN_FILTER = GL_LINEAR
GL_TEXTURE_MAG_FILTER = GL_LINEAR

Warning: Calling this method could allocate additional texture memory.

Since: v0.8

◆ setAliasTexParameters()

void setAliasTexParameters ( )

Sets alias texture parameters:

GL_TEXTURE_MIN_FILTER = GL_NEAREST
GL_TEXTURE_MAG_FILTER = GL_NEAREST

Warning: Calling this method could allocate additional texture memory.

Since: v0.8

◆ getStringForFormat()

const char * getStringForFormat ( ) const

Returns the pixel format.

Since: v2.0

◆ getBitsPerPixelForFormat() [1/2]

unsigned int getBitsPerPixelForFormat ( ) const

Returns the bits-per-pixel of the in-memory OpenGL texture.

Since: v1.0

◆ getBitsPerPixelForFormat() [2/2]

unsigned int getBitsPerPixelForFormat ( rhi::PixelFormat format ) const

Helper functions that returns bits per pixels for a given format.

Since: v2.0

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

Texture2D.h

Public Types

Public Member Functions

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ initWithImage()

◆ initWithString() [1/2]

◆ initWithString() [2/2]

◆ initWithData() [1/2]

◆ initWithData() [2/2]

◆ initWithMipmaps()

◆ updateData() [1/3]

◆ updateData() [2/3]

◆ updateData() [3/3]

◆ updateSubData()

◆ drawAtPoint()

◆ setAntiAliasTexParameters()

◆ setAliasTexParameters()

◆ getStringForFormat()

◆ getBitsPerPixelForFormat() [1/2]

◆ getBitsPerPixelForFormat() [2/2]