Difference between revisions of "TexturePack"
(14 intermediate revisions by 4 users not shown) | |||
Line 1: | Line 1: | ||
__NOTOC__ | __NOTOC__ | ||
− | < | + | <languages /> |
− | '''<translate>Supported platforms</translate>:''' [[File:Platform android.png]][[File:Platform ios.png]][[File:Platform mac.png]][[File:Platform pc.png]]<br/> | + | '''<translate>Supported platforms</translate>:''' [[File:Platform android.png]][[File:Platform ios.png]][[File:Platform mac.png]][[File:Platform pc.png]][[File:Platform html5.png]][[File:Platform winrt.png]][[File:Platform win32.png]]<br/> |
'''<translate>Available since</translate>:''' Gideros 2011.6<br/> | '''<translate>Available since</translate>:''' Gideros 2011.6<br/> | ||
'''<translate>Inherits from</translate>:''' [[Special:MyLanguage/TextureBase|TextureBase]]<br/> | '''<translate>Inherits from</translate>:''' [[Special:MyLanguage/TextureBase|TextureBase]]<br/> | ||
+ | |||
=== <translate>Description</translate> === | === <translate>Description</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. | |
− | Gideros supports dynamic creation of texture atlases and pre-packed texture atlasses by using | + | |
− | + | 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 [[Special:MyLanguage/TexturePack|TexturePack]] object with a table of file names of textures. | |
− | 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> | |
− | + | ||
− | To create a pre-packed texture atlas, use | + | ==== Static Creation of Texture Packs ==== |
− | + | To create a pre-packed texture atlas, use "Gideros Texture Packer" tool: | |
+ | |||
[[File:Texture packer.png]] | [[File: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. | |
− | This tool exports two files: A ''.txt'' file that | + | |
− | Use these two files to create texture pack:< | + | Use these two files to create texture pack: |
− | + | <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]] '' | + | [[Special:MyLanguage/TexturePack.new|TexturePack.new]] ''creates a new TexturePack object from textures''<br/><!-- GIDEROSMTD:TexturePack.new(textures,padding,filtering,options) creates a new TexturePack object from textures --> |
− | [[Special:MyLanguage/TexturePack.new|TexturePack.new]] <br/><!-- GIDEROSMTD:TexturePack.new --> | + | [[Special:MyLanguage/TexturePack.new|TexturePack.new]] ''creates a new TexturePack object from texture pack files'' <br/><!-- GIDEROSMTD:TexturePack.new(txtfile,imagefile,filtering,options) creates a new TexturePack object from texture pack files --> |
− | [[Special:MyLanguage/TexturePack:getTextureRegion|TexturePack:getTextureRegion]] ''<translate>returns the texture region of texture pack</translate>''<br/><!-- GIDEROSMTD:TexturePack:getTextureRegion --> | + | [[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> === | ||
|} | |} | ||
+ | |||
+ | {{GIDEROS IMPORTANT LINKS}} |
Revision as of 17:34, 7 January 2021
Supported platforms:
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:
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")
MethodsTexturePack.new creates a new TexturePack object from textures |
EventsConstants |