SpriteMaterial

Lightweight material for textured 2D sprites and billboards.

Designed for camera-facing quads such as UI elements, particles, and glyphs. Renders without lighting (unlit) and uses an RGBA texture with an optional tint color. Transparency is enabled by default and driven by the texture's alpha channel.

auto material = vglx::SpriteMaterial::Create(texture, 0xFFFFFF);
my_scene->Add(vglx::Sprite::Create(material));

INFO

Derives from Material and inherits all public properties and methods.

Construction

Constructors

SpriteMaterial()

Constructs a sprite material.

Transparency is enabled by default and uses the alpha channel of the provided texture.

SpriteMaterial::SpriteMaterial(std::shared_ptr<Texture> texture_map, const Color& color=0xFFFFFF);

Parameter	Description
texture_map	Sprite texture to sample for color and alpha.
color	Base tint color applied to the texture.

Factories preferred

SpriteMaterial::Create() std::shared_ptr<SpriteMaterial>

Creates a shared instance of SpriteMaterial.

static std::shared_ptr<SpriteMaterial> SpriteMaterial::Create(std::shared_ptr<Texture> texture_map, const Color& color=0xFFFFFF);

Parameter	Description
texture_map	Sprite texture to sample for color and alpha.
color	Base tint color applied to the texture.

Properties

color Color

Base tint color applied multiplicatively to the sprite texture.

Color color {};

size_attenuation bool

Controls whether sprite size is attenuated by distance in perspective.

bool size_attenuation {true};

texture_map std::shared_ptr<Texture>

Sprite texture sampled in RGBA; alpha controls transparency.

std::shared_ptr<Texture> texture_map {};

Functions

GetType() Type virtual

Identifies this material as Material::Type::SpriteMaterial.

Type SpriteMaterial::GetType() const override;