Difference between revisions of "Texture.loadAsync"
From GiderosMobile
m (Text replacement - "<source" to "<syntaxhighlight") |
|||
| (One intermediate revision by one other user not shown) | |||
| Line 7: | Line 7: | ||
<syntaxhighlight lang="lua"> | <syntaxhighlight lang="lua"> | ||
Texture.loadAsync(callback,filename,filtering,options) | Texture.loadAsync(callback,filename,filtering,options) | ||
| − | </ | + | </syntaxhighlight> |
=== Parameters === | === Parameters === | ||
| Line 16: | Line 16: | ||
* '''transparentColor''': specifies which color stands for transparent, for formats that don't supply an alpha channel such as JPEG | * '''transparentColor''': specifies which color stands for transparent, for formats that don't supply an alpha channel such as JPEG | ||
| − | * '''wrap''': how to treat texels outside the texture. Possible values are | + | * '''wrap''': how to treat texels outside the texture. Possible values are TextureBase.CLAMP and TextureBase.REPEAT |
* '''format''': the GPU pixel format for the texture | * '''format''': the GPU pixel format for the texture | ||
| − | * '''extend''': wether the texture should be extended to a power of two size. Defaults to true | + | * '''extend''': wether the texture should be extended to a power of two size. Defaults to true |
| − | * '''scale''': the scale at which this texture was made, if it cannot be determined by a suffix. Defaults to 1 | + | * '''scale''': the scale at which this texture was made, if it cannot be determined by a suffix. Defaults to 1 |
=== Example === | === Example === | ||
| Line 26: | Line 26: | ||
stage:addChild(Bitmap.new(texture)) | stage:addChild(Bitmap.new(texture)) | ||
end,"image.png", true, {wrap = Texture.REPEAT}) | end,"image.png", true, {wrap = Texture.REPEAT}) | ||
| − | </ | + | </syntaxhighlight> |
{{Texture}} | {{Texture}} | ||
Latest revision as of 14:33, 20 July 2024
Available since: Gideros 2021.8.1
Class: Texture
Description
Asynchronously loads a texture from a file.
Texture.loadAsync(callback,filename,filtering,options)
Parameters
callback: (function) the function will be called with the Texture object as argument or an error as second argument.
filename: (string) the name of the texture file to be loaded.
filtering: (boolean, default = false) whether or not the texture is filtered.
options: (table, optional) a table that specifies optional parameters. The following options are supported:
- transparentColor: specifies which color stands for transparent, for formats that don't supply an alpha channel such as JPEG
- wrap: how to treat texels outside the texture. Possible values are TextureBase.CLAMP and TextureBase.REPEAT
- format: the GPU pixel format for the texture
- extend: wether the texture should be extended to a power of two size. Defaults to true
- scale: the scale at which this texture was made, if it cannot be determined by a suffix. Defaults to 1
Example
Texture.loadAsync(function (texture, error)
stage:addChild(Bitmap.new(texture))
end,"image.png", true, {wrap = Texture.REPEAT})
