Difference between revisions of "Texture.new"

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> ===
<translate>
 
 
Creates a new Texture object.
 
Creates a new Texture object.
<br/>
 
</translate>
 
 
 
<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>Examples</translate> ===
+
=== <translate>Example</translate> ===
'''Example'''
 
<br/>
 
 
 
 
<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> ===
<translate>Create a texture from pixel data.</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>Examples</translate> ===
+
=== <translate>Example</translate> ===
'''Example'''
 
<br/>
 
 
 
 
<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>
<br/>
 
  
 
{{Texture}}
 
{{Texture}}

Latest revision as of 21: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})