# Two.Texture

Extends: Two.Element

Fundamental to work with bitmap data, a.k.a. pregenerated imagery, in Two.js. Supported formats include jpg, png, gif, and tiff. See Two.Texture.RegularExpressions for a full list of supported formats.

Source

# Constructor

Argument Description
src The URL path to an image file or an <img /> element.
callback An optional callback function once the image has been loaded.

# Properties

A list of properties that are on every Two.Texture.

texture.js:200

# RegularExpressions

A map of compatible DOM Elements categorized by media format.

texture.js:208

# ImageRegistry

A canonical listing of image data used in a single session of Two.js.

texture.js:214

nota-bene

This object is used to cache image data between different textures.

# getAbsoluteURL

Returns: String

  • The serialized absolute path.

Serializes a URL as an absolute path for canonical attribution in Two.ImageRegistry.

Argument Description
path
texture.js:221

# loadHeadlessBuffer

Loads an image as a buffer in headless environments.

Argument Description
texture The Two.Texture to be loaded.
loaded The callback function to be triggered once the image is loaded.
texture.js:236

nota-bene

  • This function uses node's fs.readFileSync to spoof the <img /> loading process in the browser.

# getTag

Returns: String

  • Returns the tag name of an image, video, or canvas node.

Retrieves the tag name of an image, video, or canvas node.

Argument Description
image The image to infer the tag name from.
texture.js:250

# getImage

Returns: HTMLImageElement

Convenience function to set Two.Texture.image properties with canonical versions set in Two.Texture.ImageRegistry.

Argument Description
src The URL path of the image.
texture.js:262

# Register

A collection of functions to register different types of textures. Used internally by a Two.Texture.

texture.js:305

# load

Argument Description
texture The texture to load.
callback The function to be called once the texture is loaded.
texture.js:410

# FlagOffset

Cached method to let renderers know offset has been updated on a Two.Texture.

texture.js:626

# FlagScale

Cached method to let renderers know scale has been updated on a Two.Texture.

texture.js:635

# loaded

Shorthand value to determine if image has been loaded into the texture.

texture.js:143

# repeat

CSS style declaration to tile Two.Path. Valid values include: 'no-repeat', 'repeat', 'repeat-x', 'repeat-y'.

See: https://www.w3.org/TR/2dcontext/#dom-context-2d-createpattern (opens new window)

texture.js:149

# offset

A two-component vector describing any pixel offset of the texture when applied to a Two.Path.

texture.js:156

# src

The URL path to the image data.

texture.js:172

nota-bene

This property is ultimately serialized in a Two.Registry to cache retrieval.

# image

The corresponding DOM Element of the texture. Can be a <img />, <canvas />, or <video /> element. See Two.Texture.RegularExpressions for a full list of supported elements.

texture.js:187

nota-bene

In headless environments this is a Canvas.Image object. See https://github.com/Automattic/node-canvas (opens new window) for more information on headless image objects.

# clone

Returns: Two.Texture

Create a new instance of Two.Texture with the same properties of the current texture.

texture.js:441

# toObject

Returns: Object

Return a JSON compatible plain object that represents the texture.

texture.js:455

← Two.Sprite →