Difference between revisions of "TexturePack"

From GiderosMobile
Line 1: Line 1:
 
__NOTOC__
 
__NOTOC__
'''Supported platforms:''' android, ios, mac, pc<br/>
+
'''<translate>Supported platforms</translate>:''' [[File:Platform android]][[File:Platform ios]][[File:Platform mac]][[File:Platform pc]]<br/>
'''Available since:''' Gideros 2011.6<br/>
+
'''<translate>Available since</translate>:''' Gideros 2011.6<br/>
 +
'''<translate>Inherits from</translate>:''' [[Special:MyLanguage/TextureBase|TextureBase]]<br/>
 
=== <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 />
+
<translate>The `TexturePack` class specifies a texture pack (or texture atlas). A texture atlas is a large image which contains many smaller sub-images.<br />
 
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 &quot;Gideros Texture Packer&quot; tool.<br />
 
<br />
 
<br />
 
<br />
 
<br />
<h3>Dynamic Creation of Texture Packs</h3><br />
+
&lt;h3&gt;Dynamic Creation of Texture Packs&lt;/h3&gt;<br />
 
<br />
 
<br />
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 `TexturePack` object with a table of file names of textures.<br />
 
<br />
 
<br />
<pre><code>local pack = TexturePack.new({"1.png", "2.png", "3.png", "4.png")}</code></pre><br />
+
&lt;pre&gt;&lt;code&gt;local pack = TexturePack.new({&quot;1.png&quot;, &quot;2.png&quot;, &quot;3.png&quot;, &quot;4.png&quot;)}&lt;/code&gt;&lt;/pre&gt;<br />
 
&lt;h3&gt;Static Creation of Texture Packs&lt;/h3&gt;<br />
 
&lt;h3&gt;Static Creation of Texture Packs&lt;/h3&gt;<br />
 
<br />
 
<br />
Line 19: Line 20:
 
<br />
 
<br />
 
<br />
 
<br />
This tool exports two files: A [[Special:MyLanguage/.txt|.txt]] file that specifes the positions of texture regions and a [[Special:MyLanguage/.png|.png]] file of packed texture.<br />
+
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:<br />
 
&lt;pre&gt;&lt;code&gt;local pack = TexturePack.new(&quot;pack.txt&quot;, &quot;pack.png&quot;)&lt;/code&gt;&lt;/pre&gt;<br /></translate>
 
&lt;pre&gt;&lt;code&gt;local pack = TexturePack.new(&quot;pack.txt&quot;, &quot;pack.png&quot;)&lt;/code&gt;&lt;/pre&gt;<br /></translate>
 
{|-
 
{|-
 
| 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/>
 
[[Special:MyLanguage/TexturePack.new|TexturePack.new]] ''<translate>creates a new TexturePack object</translate>''<br/>

Revision as of 10:29, 24 August 2018

Supported platforms: File:Platform androidFile:Platform iosFile:Platform macFile:Platform pc
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.


<h3>Dynamic Creation of Texture Packs</h3>

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

<pre><code>local pack = TexturePack.new({"1.png", "2.png", "3.png", "4.png")}</code></pre>
<h3>Static Creation of Texture Packs</h3>

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

Texture packer.png

This tool exports two files: A `.txt` file that specifes the positions of texture regions and a `.png` file of packed texture.
Use these two files to create texture pack:
<pre><code>local pack = TexturePack.new("pack.txt", "pack.png")</code></pre>

Methods

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

Events

Constants