open class Texture

Known direct subclasses
CubeMapTexture

CubeMapTexture represents a cube map texture that can be used with materials.


Texture represents a texture that can be used with materials.

Summary

Public companion functions

ListenableFuture<Texture>
@MainThread
create(session: Session, name: String, sampler: TextureSampler)

Public factory function for a Texture, where the texture is asynchronously loaded.

Public functions

open Unit

Disposes the given texture resource.

Public companion functions

create

Added in 1.0.0-alpha04
@MainThread
fun create(session: Session, name: String, sampler: TextureSampler): ListenableFuture<Texture>

Public factory function for a Texture, where the texture is asynchronously loaded.

This method must be called from the main thread. https://developer.android.com/guide/components/processes-and-threads

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

Parameters
session: Session

The Session to use for loading the model.

name: String

The URL or asset-relative path of a texture to be loaded

sampler: TextureSampler

The TextureSampler for the texture being created.

Returns
ListenableFuture<Texture>

a ListenableFuture. Listeners will be called on the main thread if Runnable::run is supplied.

Public functions

dispose

Added in 1.0.0-alpha04
@MainThread
open fun dispose(): Unit

Disposes the given texture resource.

This method must be called from the main thread. https://developer.android.com/guide/components/processes-and-threads

Currently, a glTF model (which this texture will be used with) can't be disposed. This means that calling dispose on the texture will lead to a crash if the call is made out of order, that is, if the texture is disposed before the glTF model that uses it.