class FlxAtlasFrames

package flixel.graphics.frames

extends FlxFramesCollection

@:directlyUsed

Atlas frames collection. It makes possible to use texture atlases in Flixel. Plus it contains few packer parser methods for most commonly used atlas formats.

Static methods

staticfindFrame(graphic:FlxGraphic, ?border:FlxPoint):FlxAtlasFrames

Returns the FlxAtlasFrame of the specified FlxGraphic object.

Parameters:

graphic

FlxGraphic object to find the FlxAtlasFrames collection for.

Returns:

FlxAtlasFrames collection for the specified FlxGraphic object Could be null if FlxGraphic doesn't have it yet.

staticfromLibGdx(source:FlxGraphicAsset, description:String):FlxAtlasFrames

Parsing method for LibGDX atlases.

Parameters:

source

The image source (can be FlxGraphic, String or BitmapData).

description

Contents of the file with atlas description. You can get it with Assets.getText(path/to/description/file). Or you can just pass path to the description file in the assets directory.

Returns:

Newly created FlxAtlasFrames collection.

staticfromSparrow(Source:FlxGraphicAsset, Description:String):FlxAtlasFrames

Parsing method for Sparrow texture atlases (they can be generated with Shoebox http://renderhjs.net/shoebox/ for example).

Parameters:

Source

The image source (can be FlxGraphic, String or BitmapData).

Description

Contents of the XML file with atlas description. You can get it with Assets.getText(path/to/description.xml). Or you can just pass a path to the XML file in the assets directory.

Returns:

Newly created FlxAtlasFrames collection.

staticfromSpriteSheetPacker(Source:FlxGraphicAsset, Description:String):FlxAtlasFrames

Parsing method for Sprite Sheet Packer atlases (http://spritesheetpacker.codeplex.com/).

Parameters:

Source

The image source (can be FlxGraphic, String or BitmapData).

Description

Contents of the file with atlas description. You can get it with Assets.getText(path/to/description/file). Or you can just pass a path to the description file in the assets directory.

Returns:

Newly created FlxAtlasFrames collection.

staticfromTexturePackerJson(Source:FlxGraphicAsset, Description:FlxTexturePackerSource):FlxAtlasFrames

Parsing method for TexturePacker atlases in JSON format.

Parameters:

Source

The image source (can be FlxGraphic, String, or BitmapData).

Description

Contents of JSON file with atlas description. You can get it with Assets.getText(path/to/description.json). Or you can just a pass path to the JSON file in the assets directory. You can also directly pass in the parsed object.

Returns:

Newly created FlxAtlasFrames collection.

staticfromTexturePackerXml(Source:FlxGraphicAsset, Description:String):FlxAtlasFrames

Parsing method for TexturePacker atlases in generic XML format.

Parameters:

Source

The image source (can be FlxGraphic, String or BitmapData).

Description

Contents of the XML file with atlas description. You can get it with Assets.getText(path/to/description.xml). Or you can just pass a path to the XML file in the assets directory.

Returns:

Newly created FlxAtlasFrames collection.

Constructor

new(parent:FlxGraphic, ?border:FlxPoint)

Methods

Inherited Variables

Defined by FlxFramesCollection

read onlyborder:FlxPoint

How much space was trimmed around the original frames. Use addBorder() to add borders.

frames:Array<FlxFrame>

Array with all frames of this collection.

framesHash:Map<String, FlxFrame>

Hash of frames for this frame collection. Used only in FlxAtlasFrames and FlxBitmapFont (not implemented yet), but you can try to use it for other types of collections (give names to your frames).

read onlynumFrames:Int

Number of frames in this collection.

parent:FlxGraphic

Graphic object this frames belongs to.

read onlytype:FlxFrameCollectionType

Type of this frame collection. Used for faster type detection (less casting).

Inherited Methods

Defined by FlxFramesCollection

@:value({ flipY : false, flipX : false, angle : 0 })addAtlasFrame(frame:FlxRect, sourceSize:FlxPoint, offset:FlxPoint, ?name:String, angle:FlxFrameAngle = 0, flipX:Bool = false, flipY:Bool = false):FlxFrame

Adds new frame to this frame collection. This method runs additional check, and can add rotated frames (from texture atlases).

Parameters:

frame

Region of image.

sourceSize

Original size of packed image (if image had been cropped, then original size will be bigger than frame size).

offset

How frame region is located on original frame image (offset from top left corner of original image).

name

Name for this frame (name of packed image file).

angle

Rotation of packed image (can be 0, 90 or -90).

flipX

If packed image should be horizontally flipped.

flipY

If packed image should be vertically flipped.

Returns:

Newly created and added frame object.

addEmptyFrame(size:FlxRect):FlxFrame

Adds empty frame into this frame collection. An empty frame is doing almost nothing for all the time.

Parameters:

size

Dimensions of the frame to add.

Returns:

Newly added empty frame.

addSpriteSheetFrame(region:FlxRect):FlxFrame

Adds new regular (not rotated) FlxFrame to this frame collection.

Parameters:

region

Region of image which new frame will display.

Returns:

Newly created FlxFrame object for specified region of image.

destroy():Void

inlinegetByIndex(index:Int):FlxFrame

Finds frame in frames array by its index.

Parameters:

index

Index of the frame in the frames array.

Returns:

Frame with specified index in this frames collection (if there is one).

inlinegetByName(name:String):FlxFrame

Finds a frame in framesHash by its name.

Parameters:

name

The name of the frame to find.

Returns:

Frame with specified name (if there is one).

inlinegetFrameIndex(frame:FlxFrame):Int

Finds the index of the specified frame in the frames array.

Parameters:

frame

Frame to find.

Returns:

Index of the specified frame.

getIndexByName(name:String):Int

Finds frame index by its name.

Parameters:

name

Name of the frame.

Returns:

Index of the frame with specified name.

pushFrame(frameObj:FlxFrame):FlxFrame

Helper method for a adding frame to the collection.

Parameters:

frameObj

Frame to add.

Returns:

Added frame.

toString():String