Difference between revisions of "TexturePack"
Line 6: | Line 6: | ||
=== <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 ==== | ==== 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 | + | <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: | + | 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> | + | <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> === | ||
|} | |} | ||
− | |||
− |
Revision as of 00:27, 10 December 2019
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 |
EventsConstants |