Difference between revisions of "TexturePack"

From GiderosMobile
Line 6: Line 6:
  
 
=== <translate>Description</translate> ===
 
=== <translate>Description</translate> ===
<translate>The [[Special:MyLanguage/TexturePack|TexturePack]] class specifies a texture pack (or texture atlas). A texture atlas is a large image which contains many smaller sub-images.<br />
+
The [[Special:MyLanguage/TexturePack|TexturePack]] class specifies a texture pack (or texture atlas). A texture atlas is a large image which contains many smaller sub-images.
Gideros supports dynamic creation of texture atlases and pre-packed texture atlasses by using &quot;Gideros Texture Packer&quot; tool.<br />
+
 
 +
Gideros supports dynamic creation of texture atlases and pre-packed texture atlasses by using "Gideros Texture Packer" tool.
  
 
==== Dynamic Creation of Texture Packs ====
 
==== Dynamic Creation of Texture Packs ====
To create a texture pack dynamically (at run-time), create [[Special:MyLanguage/TexturePack|TexturePack]] object with a table of file names of textures.<br />
+
To create a texture pack dynamically (at run-time), create [[Special:MyLanguage/TexturePack|TexturePack]] object with a table of file names of textures.
  
<source lang="lua">local pack = TexturePack.new({"1.png", "2.png", "3.png", "4.png")}</source><br />
+
<source lang="lua">
 +
local pack = TexturePack.new({"1.png", "2.png", "3.png", "4.png")}
 +
</source>
  
 
==== Static Creation of Texture Packs ====
 
==== Static Creation of Texture Packs ====
To create a pre-packed texture atlas, use "Gideros Texture Packer" tool:<br />
+
To create a pre-packed texture atlas, use "Gideros Texture Packer" tool:
<br />
+
 
 
[[File:Texture packer.png]]
 
[[File:Texture packer.png]]
<br />
+
 
<br />
+
This tool exports two files: A ''.txt'' file that specifies the positions of texture regions and a ''.png'' file of packed texture.
This tool exports two files: A ''.txt'' file that specifes the positions of texture regions and a ''.png'' file of packed texture.<br />
+
 
Use these two files to create texture pack:<br />
+
Use these two files to create texture pack:
<source lang="lua">local pack = TexturePack.new("pack.txt", "pack.png")</source><br /></translate>
+
<source lang="lua">
 +
local pack = TexturePack.new("pack.txt", "pack.png")
 +
</source>
 +
 
 
{|-
 
{|-
 
| style="width: 50%; vertical-align:top;"|
 
| style="width: 50%; vertical-align:top;"|
 
 
=== <translate>Methods</translate> ===
 
=== <translate>Methods</translate> ===
 
[[Special:MyLanguage/TexturePack.new|TexturePack.new]] ''<translate>creates a new TexturePack object</translate>''<br/><!-- GIDEROSMTD:TexturePack.new(textures,padding,filtering,options) creates a new TexturePack object -->
 
[[Special:MyLanguage/TexturePack.new|TexturePack.new]] ''<translate>creates a new TexturePack object</translate>''<br/><!-- GIDEROSMTD:TexturePack.new(textures,padding,filtering,options) creates a new TexturePack object -->
 
[[Special:MyLanguage/TexturePack.new|TexturePack.new]] <br/><!-- GIDEROSMTD:TexturePack.new(txtfile,imagefile,filtering,options)  -->
 
[[Special:MyLanguage/TexturePack.new|TexturePack.new]] <br/><!-- GIDEROSMTD:TexturePack.new(txtfile,imagefile,filtering,options)  -->
 
[[Special:MyLanguage/TexturePack:getTextureRegion|TexturePack:getTextureRegion]] ''<translate>returns the texture region of texture pack</translate>''<br/><!-- GIDEROSMTD:TexturePack:getTextureRegion(texturename) returns the texture region of texture pack -->
 
[[Special:MyLanguage/TexturePack:getTextureRegion|TexturePack:getTextureRegion]] ''<translate>returns the texture region of texture pack</translate>''<br/><!-- GIDEROSMTD:TexturePack:getTextureRegion(texturename) returns the texture region of texture pack -->
 +
 
| style="width: 50%; vertical-align:top;"|
 
| style="width: 50%; vertical-align:top;"|
 
=== <translate>Events</translate> ===
 
=== <translate>Events</translate> ===
 
=== <translate>Constants</translate> ===
 
=== <translate>Constants</translate> ===
 
|}
 
|}
 
{{TexturePack}}
 

Revision as of 00:27, 10 December 2019


Supported platforms: Platform android.pngPlatform ios.pngPlatform mac.pngPlatform pc.pngPlatform html5.pngPlatform winrt.pngPlatform win32.png
Available since: Gideros 2011.6
Inherits from: TextureBase

Description

The TexturePack class specifies a texture pack (or texture atlas). A texture atlas is a large image which contains many smaller sub-images.

Gideros supports dynamic creation of texture atlases and pre-packed texture atlasses by using "Gideros Texture Packer" tool.

Dynamic Creation of Texture Packs

To create a texture pack dynamically (at run-time), create TexturePack object with a table of file names of textures.

local pack = TexturePack.new({"1.png", "2.png", "3.png", "4.png")}

Static Creation of Texture Packs

To create a pre-packed texture atlas, use "Gideros Texture Packer" tool:

Texture packer.png

This tool exports two files: A .txt file that specifies the positions of texture regions and a .png file of packed texture.

Use these two files to create texture pack:

local pack = TexturePack.new("pack.txt", "pack.png")

Methods

TexturePack.new creates a new TexturePack object
TexturePack.new
TexturePack:getTextureRegion returns the texture region of texture pack

Events

Constants