Texture, or images, referenced by Material properties.
Textures in glTF Transform are a combination of glTF's
image properties, and
should be unique within a document, such that no other texture contains the same
getImage() data. Where duplicates may already exist, the
transform can remove them. A Document with N texture properties will be exported to a
glTF file with N
image properties, and the minimum number of
texture properties necessary
for the materials that use it.
For properties associated with a particular use of a texture, see TextureInfo.
Makes a copy of this property, with the same resources (by reference) as the original.
Copies all data from another property to this one. Child properties are copied by reference, unless a 'resolve' function is given to override that.
Dispatches an event on the GraphNode, and on the associated
Graph. Event types on the graph are prefixed,
Removes both inbound references to and outbound references from this object. At the end of the process the object holds no references, and nothing holds references to it. A disposed object is not reusable.
Returns true if two properties are deeply equivalent, recursively comparing the attributes of the properties. Optionally, a 'skip' set may be included, specifying attributes whose values should not be considered in the comparison.
Example: Two Primitives are equivalent if they have accessors and materials with equivalent content — but not necessarily the same specific accessors and materials.
Returns an ExtensionProperty attached to this Property, if any.
Attaches the given ExtensionProperty to this Property. For a given extension, only one ExtensionProperty may be attached to any one Property at a time.
Lists all ExtensionProperty instances attached to this Property.
Returns a reference to the Extras object, containing application-specific data for this Property. Extras should be an Object, not a primitive value, for best portability.
Updates the Extras object, containing application-specific data for this Property. Extras should be an Object, not a primitive value, for best portability.
Returns the raw image data for this texture.
Sets the raw image data for this texture.
Returns true if the node has been permanently removed from the graph.
Returns the MIME type for this texture ('image/jpeg' or 'image/png').
Sets the MIME type for this texture ('image/jpeg' or 'image/png'). If the texture does not have a URI, a MIME type is required for correct export.
Returns the name of this property. While names are not required to be unique, this is encouraged, and non-unique names will be overwritten in some tools. For custom data about a property, prefer to use Extras.
Sets the name of this property. While names are not required to be unique, this is encouraged, and non-unique names will be overwritten in some tools. For custom data about a property, prefer to use Extras.
Returns a list of all properties that hold a reference to this property. For example, a material may hold references to various textures, but a texture does not hold references to the materials that use it.
It is often necessary to filter the results for a particular type: some resources, like Accessors, may be referenced by different types of properties. Most properties include the Root as a parent, which is usually not of interest.
const materials = texture .listParents() .filter((p) => p instanceof Material)
Returns the size, in pixels, of this texture.
Returns the URI (e.g. 'path/to/file.png') for this texture.
Sets the URI (e.g. 'path/to/file.png') for this texture. If the texture does not have a MIME type, a URI is required for correct export.