Difference between revisions of "Texture.new"
From GiderosMobile
m (formatting) |
|||
| Line 1: | Line 1: | ||
__NOTOC__ | __NOTOC__ | ||
| − | |||
<languages /> | <languages /> | ||
| − | + | '''<translate>Available since</translate>:''' Gideros 2011.6<br/> | |
| − | '''<translate>Available since</translate>:''' Gideros 2011.6 | + | '''<translate>Class</translate>:''' [[Special:MyLanguage/Texture|Texture]]<br/> |
| − | <br/> | ||
| − | |||
| − | '''<translate>Class</translate>:''' [[Special:MyLanguage/Texture|Texture]] | ||
| − | <br/> | ||
=== <translate>Description</translate> === | === <translate>Description</translate> === | ||
| − | |||
Creates a new Texture object. | Creates a new Texture object. | ||
| − | |||
| − | |||
| − | |||
<source lang="lua"> | <source lang="lua"> | ||
Texture.new(filename,filtering,options) | Texture.new(filename,filtering,options) | ||
| Line 20: | Line 11: | ||
=== <translate>Parameters</translate> === | === <translate>Parameters</translate> === | ||
| − | '''filename''': (string) <translate>The name of the texture file to be loaded.</translate> | + | '''filename''': (string) <translate>The name of the texture file to be loaded.</translate><br/> |
| − | <br/> | + | '''filtering''': (boolean, default = false) <translate>Whether or not the texture is filtered.</translate><br/> |
| − | '''filtering''': (boolean, default = false) <translate>Whether or not the texture is filtered.</translate> | + | '''options''': (table, optional) <translate>A table that specifies optional paramaters. The following options are supported:</translate><br/> |
| − | <br/> | + | |
| − | '''options''': (table, optional) <translate>A table that specifies optional paramaters. The following options are supported:</translate> | ||
| − | <br/> | ||
* '''transparentColor''':<translate>Specify which color stands for transparent, for formats that don't supply an alpha channel such as JPEG</translate> | * '''transparentColor''':<translate>Specify which color stands for transparent, for formats that don't supply an alpha channel such as JPEG</translate> | ||
* '''wrap''':<translate>How to treat texels outside the texture. Possible values are Texture.CLAMP and Texture.REPEAT.</translate> | * '''wrap''':<translate>How to treat texels outside the texture. Possible values are Texture.CLAMP and Texture.REPEAT.</translate> | ||
| Line 32: | Line 21: | ||
* '''scale''':<translate>The scale at which this texture was made, if it cannot be determined by a suffix. Defaults to 1.</translate> | * '''scale''':<translate>The scale at which this texture was made, if it cannot be determined by a suffix. Defaults to 1.</translate> | ||
| − | === <translate> | + | === <translate>Example</translate> === |
| − | |||
| − | |||
| − | |||
<source lang="lua"> | <source lang="lua"> | ||
-- do not filter and make the color 0xff00ff transparent | -- do not filter and make the color 0xff00ff transparent | ||
| Line 44: | Line 30: | ||
__NOTOC__ | __NOTOC__ | ||
| − | |||
<languages /> | <languages /> | ||
| − | + | '''<translate>Available since</translate>:''' Gideros 2016.08<br/> | |
| − | '''<translate>Available since</translate>:''' Gideros 2016.08 | + | '''<translate>Class</translate>:''' [[Special:MyLanguage/Texture|Texture]]<br/> |
| − | <br/> | ||
| − | '''<translate>Class</translate>:''' [[Special:MyLanguage/Texture|Texture]] | ||
| − | <br/> | ||
=== <translate>Description</translate> === | === <translate>Description</translate> === | ||
| − | + | Create a texture from pixel data. | |
| − | |||
<source lang="lua"> | <source lang="lua"> | ||
Texture.new(pixels, width, height, filtering, options) | Texture.new(pixels, width, height, filtering, options) | ||
| Line 60: | Line 41: | ||
=== <translate>Parameters</translate> === | === <translate>Parameters</translate> === | ||
| − | '''pixels''': (string) <translate>A string containing actual R,G,B,A compoents of each pixel in the new texture. Each component is stored as a byte. You can pass nil if you don't need to initialize texture content</translate> | + | '''pixels''': (string) <translate>A string containing actual R,G,B,A compoents of each pixel in the new texture. Each component is stored as a byte. You can pass nil if you don't need to initialize texture content</translate><br/> |
| − | <br/> | + | '''width''': (number) <translate>width of the texture to create</translate><br/> |
| − | '''width''': (number) <translate>width of the texture to create</translate> | + | '''height''': (number) <translate>Height of the texture to create</translate><br/> |
| − | <br/> | + | '''filtering''': (boolean, default to false) <translate>indicate that the texture should be filtered</translate> '''optional'''<br/> |
| − | '''height''': (number) <translate>Height of the texture to create</translate> | + | '''options''': (table, optional) <translate>A table that specifies optional paramaters. The following options are supported:</translate><br/> |
| − | <br/> | ||
| − | '''filtering''': (boolean, default to false) <translate>indicate that the texture should be filtered</translate> '''optional''' | ||
| − | <br/> | ||
| − | '''options''': (table, optional) <translate>A table that specifies optional paramaters. The following options are supported:</translate> | ||
| − | <br/> | ||
* '''transparentColor''':<translate>Specify which color stands for transparent, for formats that don't supply an alpha channel such as JPEG</translate> | * '''transparentColor''':<translate>Specify which color stands for transparent, for formats that don't supply an alpha channel such as JPEG</translate> | ||
| Line 77: | Line 53: | ||
* '''scale''':<translate>The scale at which this texture was made, if it cannot be determined by a suffix. Defaults to 1.</translate> | * '''scale''':<translate>The scale at which this texture was made, if it cannot be determined by a suffix. Defaults to 1.</translate> | ||
| − | === <translate> | + | === <translate>Example</translate> === |
| − | |||
| − | |||
| − | |||
<source lang="lua"> | <source lang="lua"> | ||
-- Create a 300x400 empty texture. Prevent gideros from extending the texture to the next power of two size | -- Create a 300x400 empty texture. Prevent gideros from extending the texture to the next power of two size | ||
local texture = Texture.new(nil,300,400, false, {extend=false}) | local texture = Texture.new(nil,300,400, false, {extend=false}) | ||
</source> | </source> | ||
| − | |||
{{Texture}} | {{Texture}} | ||
Revision as of 20:44, 8 December 2019
Available since: Gideros 2011.6
Class: Texture
Description
Creates a new Texture object.
Texture.new(filename,filtering,options)
Parameters
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 paramaters. The following options are supported:
- transparentColor:Specify 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 Texture.CLAMP and Texture.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
-- do not filter and make the color 0xff00ff transparent
local texture = Texture.new("image.png", false, {transparentColor = 0xff00ff})
-- enable filtering and repeat the texture
local texture = Texture.new("image.png", true, {wrap = Texture.REPEAT})
Available since: Gideros 2016.08
Class: Texture
Description
Create a texture from pixel data.
Texture.new(pixels, width, height, filtering, options)
Parameters
pixels: (string) A string containing actual R,G,B,A compoents of each pixel in the new texture. Each component is stored as a byte. You can pass nil if you don't need to initialize texture content
width: (number) width of the texture to create
height: (number) Height of the texture to create
filtering: (boolean, default to false) indicate that the texture should be filtered optional
options: (table, optional) A table that specifies optional paramaters. The following options are supported:
- transparentColor:Specify 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 Texture.CLAMP and Texture.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
-- Create a 300x400 empty texture. Prevent gideros from extending the texture to the next power of two size
local texture = Texture.new(nil,300,400, false, {extend=false})
