Texture

R2026b

Texture image with sampler and UV transform settings

Since R2026b

Description

Add-On Required: This feature requires the 3D Asset Processing Library for MATLAB add-on.

The Texture object holds image data along with sampler settings and per-texture UV transform parameters.

Use this object to define texture maps such as base color, normal, emissive, and occlusion for an Material object.

Creation

Syntax

texObj = asset3d.Texture

texObj = asset3d.Texture(Name=Value)

Description

texObj = asset3d.Texture creates an empty texture object texObj with no image data.

texObj = asset3d.Texture(Name=Value) creates a texture object texObj with properties specified by one or more name-value arguments. For example, Image=imread("basecolor.png") specifies the texture image data.

Name-Value Arguments

Specify optional pairs of arguments as Name1=Value1,...,NameN=ValueN, where Name is the argument name and Value is the corresponding value. Name-value arguments must appear after other arguments, but the order of the pairs does not matter.

Example: asset3d.Texture(Image=imread("basecolor.png"),Scale=[4 4],Wrap="repeat") creates a texture with 4x tiling and repeat wrapping.

Image — Texture image data

[] (default) | H-by-W-by-C array

Texture image data, specified as an H-by-W-by-C array. H is the image height in pixels, W is the image width, and C is the number of channels (1, 3, or 4).

This argument sets the Image property.

Data Types: uint8

Offset — UV translation

[0 0] (default) | two-element row vector

UV translation, specified as a two-element row vector of the form [u v].

This argument sets the Offset property.

Data Types: double

Scale — UV tiling

[1 1] (default) | two-element row vector

UV tiling, specified as a two-element row vector of the form [u v].

This argument sets the Scale property.

Data Types: double

Rotation — UV rotation

0 (default) | scalar

UV rotation, specified as a scalar in radians. The rotation is counter-clockwise around the origin.

This argument sets the Rotation property.

Data Types: double

Wrap — Wrap mode

"repeat" (default) | "clamp" | "mirror"

Wrap mode, specified as one of these values:

• "repeat" — Tile the texture by repeating the image.

• "clamp" — Clamp UV coordinates to the range [0, 1].

• "mirror" — Tile the texture with mirrored repetition.

This argument sets the Wrap property.

Data Types: string

Interpolation — Sampling mode

"linear" (default) | "nearest"

Sampling mode, specified as one of these values:

• "linear" — Bilinear interpolation between neighboring pixels.

• "nearest" — Nearest-neighbor sampling.

This argument sets the Interpolation property.

Data Types: string

Output Arguments

texObj — Texture object

Texture object

Texture object, returned as a Texture object.

Properties

Image — Texture image data

[] (default) | H-by-W-by-C array

Texture image data, specified as an H-by-W-by-C array. H is the image height in pixels, W is the image width, and C is the number of channels (1, 3, or 4).

Data Types: uint8

Offset — UV translation

[0 0] (default) | two-element row vector

UV translation, specified as a two-element row vector of the form [u v].

Data Types: double

Scale — UV tiling

[1 1] (default) | two-element row vector

UV tiling, specified as a two-element row vector of the form [u v].

Data Types: double

Rotation — UV rotation

0 (default) | scalar

UV rotation, specified as a scalar in radians. The rotation is counter-clockwise around the origin.

Data Types: double

Wrap — Wrap mode

"repeat" (default) | "clamp" | "mirror"

Wrap mode, specified as "repeat", "clamp", or "mirror".

Data Types: string

Interpolation — Sampling mode

"linear" (default) | "nearest"

Sampling mode, specified as "linear" or "nearest".

Data Types: string

Width — Image width in pixels

Read-only: nonnegative integer

This property is read-only.

Image width in pixels, represented as a nonnegative integer.

Data Types: double

Height — Image height in pixels

Read-only: nonnegative integer

This property is read-only.

Image height in pixels, represented as a nonnegative integer.

Data Types: double

Channels — Number of image channels

Read-only: nonnegative integer

This property is read-only.

Number of image channels (1, 3, or 4), represented as a nonnegative integer.

Data Types: double

Object Functions

sample

Sample texture at UV coordinates

Examples

Create Mesh with Textured Materials

Read a texture image and display.

img = imread("brick.png");
imshow(img)

Create a texture object with repeat wrap mode, then sample it.

tex = asset3d.Texture(Image=img,Wrap="repeat",Scale=[2 2],Offset=[0.1 0.1]);
colors = sample(tex,[0.5 0.5; 1.5 1.5])

colors = 2×4 uint8 matrix

    162    67    52    255
    162    67    52    255

Create a textured material object.

texturedMat = asset3d.Material(Name="textured",BaseColorTexture=tex);

Create a pyramid mesh with textured material on it. Duplicate vertices so that each face gets independent UV coordinates.

faceIdx = [1 2 5; 2 3 5; 3 4 5; 4 1 5; 1 3 2; 1 4 3];
p = [0 0 0; 1 0 0; 1 1 0; 0 1 0; 0.5 0.5 1];
pyramidVerts = p(faceIdx',:);
pyramidFaces = reshape(1:18,3,[])';
uv = repmat([0 0; 1 0; 0.5 1],6,1);
texturedPyramid = asset3d.Mesh(pyramidVerts,pyramidFaces,UV=uv,Material=texturedMat);

Display the textured pyramid mesh.

show(texturedPyramid,Grid=true)

Version History

Introduced in R2026b