Packageru.antkarlov.anthill
Classpublic class AntAtlas
InheritanceAntAtlas Inheritance Object

Since : 29.01.2013

Данный класс позволяет работать с коллекцией маленьких изображений укомплектованных на одной большой картинке. Данный способ работы ориентирован в большей степени для быстрой работы с аппаратными рендерами, но поскольку пока Anthill не поддерживает аппаратное ускорение — работа с атласами позволит вам оптимизировать работу с растровой графикой и анимацией.

Для наибольшей совместимости с уже известными инструментами для создания текстурных атласов, формат данных поизаимствован у Sparrow Framework. Таким образом для создания своих текстурных атласов вы можете использовать любые известные иструменты. Например, скрипт для создания атласов размещенный на официальном сайте Sparrow или встроенный пакер в Adobe Flash CS6, а так-же любые другие сторонние утилиты такие как Texture Packer.

Данный класс ожидает такой формат данных:

     <TextureAtlas imagePath='atlas.png'>
     <SubTexture name='texture_1' x='0'  y='0' width='50' height='50'/>
     <SubTexture name='texture_2' x='50' y='0' width='20' height='30'/>
     </TextureAtlas>
     



Public Properties
 PropertyDefined By
  atlasBitmapData : BitmapData
[read-only] Возвращает указатель на битмап атласа.
AntAtlas
  scale : Number
Определяет масштаб атласа.
AntAtlas
Protected Properties
 PropertyDefined By
  _atlasBitmapData : BitmapData
Текстура атласа.
AntAtlas
  _atlasRegions : AntStorage
Координаты и размеры регионов на атласе (положение и размеры спрайтов).
AntAtlas
Public Methods
 MethodDefined By
  
AntAtlas(aGraphic:Class, aAtlasXML:XML = null)
AntAtlas
  
addRegion(aName:String, aRegion:Rectangle):void
Добавляет новый регион для текущего атласа.
AntAtlas
  
getBitmap(aName:String):BitmapData
Извлекает битмап спрайта из атласа с указанным именем.
AntAtlas
  
getBitmaps(aPrefix:String, aResult:Vector.<BitmapData> = null):Vector.<BitmapData>
Извлекает битмапы в именах которых встречается указанный префикс.
AntAtlas
  
getNames(aPrefix:String, aResult:Vector.<String> = null):Vector.<String>
Извлекает имена спрайтов в которых встречается указанный префикс.
AntAtlas
  
getRegion(aName:String):Rectangle
Извлекает регион с указанным именем.
AntAtlas
  
makeAnimation(aPrefix:String, aName:String = null, aOriginX:int = 0, aOriginY:int = 0):AntAnimation
Создает анимацию из спрайтов.
AntAtlas
  
parseAtlasXML(aAtlasXML:XML):void
Загружает информацию об атласе из XML.
AntAtlas
  
removeRegion(aName:String):void
Удаляет регион с указанным именем.
AntAtlas
Protected Constants
 ConstantDefined By
  DEST_POINT : Point
[static]
AntAtlas
Property Detail
_atlasBitmapDataproperty
protected var _atlasBitmapData:BitmapData

Текстура атласа.

_atlasRegionsproperty 
protected var _atlasRegions:AntStorage

Координаты и размеры регионов на атласе (положение и размеры спрайтов).

atlasBitmapDataproperty 
atlasBitmapData:BitmapData  [read-only]

Возвращает указатель на битмап атласа.


Implementation
    public function get atlasBitmapData():BitmapData
scaleproperty 
public var scale:Number

Определяет масштаб атласа.

The default value is 1.

Constructor Detail
AntAtlas()Constructor
public function AntAtlas(aGraphic:Class, aAtlasXML:XML = null)

Parameters
aGraphic:Class
 
aAtlasXML:XML (default = null)
Method Detail
addRegion()method
public function addRegion(aName:String, aRegion:Rectangle):void

Добавляет новый регион для текущего атласа.

Parameters

aName:String — Имя региона (спрайта).
 
aRegion:Rectangle — Прямоугольник определяющий положение и размеры спрайта в атласе.

getBitmap()method 
public function getBitmap(aName:String):BitmapData

Извлекает битмап спрайта из атласа с указанным именем.

Parameters

aName:String — Имя спрайта битмап которого необходимо получить.

Returns
BitmapData — Возвращает указатель на битмап спрайта.
getBitmaps()method 
public function getBitmaps(aPrefix:String, aResult:Vector.<BitmapData> = null):Vector.<BitmapData>

Извлекает битмапы в именах которых встречается указанный префикс.

Parameters

aPrefix:String — Префикс для имени спрайтов который будет учитыватся в выборке графики.
 
aResult:Vector.<BitmapData> (default = null) — Указатель на массив в который может быть записан результат.

Returns
Vector.<BitmapData> — Возвращает массив указателей на битмапы.
getNames()method 
public function getNames(aPrefix:String, aResult:Vector.<String> = null):Vector.<String>

Извлекает имена спрайтов в которых встречается указанный префикс.

Parameters

aPrefix:String — Префикс который должен встречатся в именах спрайтов.
 
aResult:Vector.<String> (default = null) — Указатель на массив в который может быть записан результат.

Returns
Vector.<String> — Возвращает массив имен.
getRegion()method 
public function getRegion(aName:String):Rectangle

Извлекает регион с указанным именем.

Parameters

aName:String — Имя региона (спрайта) позицию и размеры которого необходимо получить.

Returns
Rectangle — Возвращает прямоугольник определяющий положение и размеры региона (спрайта).
makeAnimation()method 
public function makeAnimation(aPrefix:String, aName:String = null, aOriginX:int = 0, aOriginY:int = 0):AntAnimation

Создает анимацию из спрайтов.

Parameters

aPrefix:String — Префикс для имени спрайтов который будет учитыватся в выборке графики для анимации.
 
aName:String (default = null) — Имя анимации.
 
aOriginX:int (default = 0) — Смещение кадров анимации относительно центра по X.
 
aOriginY:int (default = 0) — Смещение кадров анимации относительно центра по Y.

Returns
AntAnimation — Возвращает указатель на созданную анимацию.
parseAtlasXML()method 
public function parseAtlasXML(aAtlasXML:XML):void

Загружает информацию об атласе из XML.

Parameters

aAtlasXML:XML — Указатель на XML данные для загрузки.

removeRegion()method 
public function removeRegion(aName:String):void

Удаляет регион с указанным именем.

Parameters

aName:String — Имя региона (спрайта) информацию о котором необходимо удалить.

Constant Detail
DEST_POINTConstant
protected static const DEST_POINT:Point