new Texture(baseTexture, frame, crop, trim)
A texture stores the information that represents an image or part of an image. It cannot be added to the display list directly. Instead use it as the texture for a PIXI.Sprite. If no frame is provided then the whole image is used.
Parameters
| Name | Type | Argument | Description |
|---|---|---|---|
baseTexture |
PIXI.BaseTexture | The base texture source to create the texture from |
|
frame |
PIXI.Rectangle | The rectangle frame of the texture to show |
|
crop |
PIXI.Rectangle |
<optional> |
The area of original texture |
trim |
PIXI.Rectangle |
<optional> |
Trimmed texture rectangle |
- Source code: pixi/textures/Texture.js, line 10
Public Properties
-
baseTexture : PIXI.BaseTexture
-
The base texture that this texture uses.
- Source code: pixi/textures/Texture.js, line 43
-
crop : PIXI.Rectangle
-
This is the area of the BaseTexture image to actually copy to the Canvas / WebGL when rendering, irrespective of the actual frame size or placement (which can be influenced by trimmed texture atlases)
- Source code: pixi/textures/Texture.js, line 108
-
frame : PIXI.Rectangle
-
The frame specifies the region of the base texture that this texture uses
- Source code: pixi/textures/Texture.js, line 51
-
height : number
-
The height of the Texture in pixels.
- Source code: pixi/textures/Texture.js, line 100
-
noFrame : boolean
-
Does this Texture have any frame data assigned to it?
- Source code: pixi/textures/Texture.js, line 24
-
requiresUpdate : boolean
-
This will let a renderer know that a texture has been updated (used mainly for webGL uv updates)
- Source code: pixi/textures/Texture.js, line 75
-
trim : PIXI.Rectangle
-
The texture trim data.
- Source code: pixi/textures/Texture.js, line 59
-
valid : boolean
-
This will let the renderer know if the texture is valid. If it's not then it cannot be rendered.
- Source code: pixi/textures/Texture.js, line 67
-
width : number
-
The width of the Texture in pixels.
- Source code: pixi/textures/Texture.js, line 92
Public Methods
-
<static> addTextureToCache(texture, id)
-
Adds a texture to the global PIXI.TextureCache. This cache is shared across the whole PIXI object.
Parameters
Name Type Description texturePIXI.Texture The Texture to add to the cache.
idString The id that the texture will be stored against.
- Source code: pixi/textures/Texture.js, line 284
-
<static> fromCanvas(canvas, scaleMode)
-
Helper function that creates a new a Texture based on the given canvas element.
Parameters
Name Type Description canvasCanvas The canvas element source of the texture
scaleModeNumber See {{#crossLink "PIXI/scaleModes:property"}}PIXI.scaleModes{{/crossLink}} for possible values
Returns
Texture
- Source code: pixi/textures/Texture.js, line 267
-
<static> fromFrame(frameId)
-
Helper function that returns a Texture objected based on the given frame id. If the frame id is not in the texture cache an error will be thrown.
Parameters
Name Type Description frameIdString The frame id of the texture
Returns
Texture
- Source code: pixi/textures/Texture.js, line 251
-
<static> fromImage(imageUrl, crossorigin, scaleMode)
-
Helper function that creates a Texture object from the given image url. If the image is not in the texture cache it will be created and loaded.
Parameters
Name Type Description imageUrlString The image url of the texture
crossoriginBoolean Whether requests should be treated as crossorigin
scaleModeNumber See {{#crossLink "PIXI/scaleModes:property"}}PIXI.scaleModes{{/crossLink}} for possible values
Returns
Texture
- Source code: pixi/textures/Texture.js, line 227
-
<static> removeTextureFromCache(id) → {PIXI.Texture}
-
Remove a texture from the global PIXI.TextureCache.
Parameters
Name Type Description idString The id of the texture to be removed
Returns
The texture that was removed
- Source code: pixi/textures/Texture.js, line 297
-
destroy(destroyBase)
-
Destroys this texture
Parameters
Name Type Description destroyBaseBoolean Whether to destroy the base texture as well
- Source code: pixi/textures/Texture.js, line 149
-
setFrame(frame)
-
Specifies the region of the baseTexture that this texture will use.
Parameters
Name Type Description framePIXI.Rectangle The frame of the texture to set it to
- Source code: pixi/textures/Texture.js, line 162