Texture

Artifact: androidx.xr.scenecore:scenecore

Kotlin |Java

public class Texture implements AutoCloseable

Represents a Texture in SceneCore.

A texture is an image that can be applied to a 3D model to give it color, detail, and realism. It can also be used as an alpha mask for a SurfaceEntity.

It's important to close a Texture when it's no longer needed to free up resources. This can be done by calling the close method or letting it get garbage collected.

Summary

Public methods
`void`	`@MainThread close()` Closes the given `Texture`.
`static final @NonNull Texture`	`@MainThread create(@NonNull Session session, @NonNull Path path)` Public factory for a Texture, asynchronously loading a preprocessed texture from a `Path` relative to the application's `assets/` folder.

Public methods

close

Added in 1.0.0-alpha10

@MainThread
public void close()

Closes the given Texture.

The Texture can be explicitly closed at anytime or garbage collected. In both cases, its resources are freed and an exception will be thrown if the Texture is used after being closed.

create

@MainThread
public static final @NonNull Texture create(@NonNull Session session, @NonNull Path path)

Public factory for a Texture, asynchronously loading a preprocessed texture from a Path relative to the application's assets/ folder.

Currently, only URLs and relative paths from the assets/ directory are supported.

Parameters
`@NonNull Session session`	The `Session` to use for loading the `Texture`.
`@NonNull Path path`	The Path of the `.png` texture file to be loaded, relative to the application's `assets/` folder.

Returns
`@NonNull Texture`	a `Texture` upon completion.

Throws
`kotlin.IllegalArgumentException`	if `Path.isAbsolute` is true, as this method requires a relative path.