FlxSpriteGroup
A transformable sprite composite backed by a logical FlxGroup.
Members use world-space x/y while owned. add() interprets an incoming member position as local to the composite and translates it into world space; remove() converts it back to local space. Collision expands to the member AABBs rather than treating the composite as one rectangle.
export declare class FlxSpriteGroup<T extends FlxSprite = FlxSprite> extends FlxSpriteConstructors
constructor(x?: number, y?: number, maxSize?: number)Constructs a new instance of the FlxSpriteGroup class
| Parameter | Type | Description |
|---|---|---|
x | number | - |
y | number | - |
maxSize | number | - |
Properties
| Property | Modifiers | Type | Description |
|---|---|---|---|
alpha | - | number | - |
color | - | number | - |
directAlpha | - | boolean | - |
group | readonly | FlxGroup<T> | - |
length | readonly | number | - |
maxSize | - | number | - |
members | readonly | (T | null)[] | - |
solid | - | boolean | - |
Methods
add()
add(sprite: T): TParameters:
| Parameter | Type | Description |
|---|---|---|
sprite | T | - |
Returns: T
callAll()
callAll(functionName: string, recurse?: boolean): voidParameters:
| Parameter | Type | Description |
|---|---|---|
functionName | string | - |
recurse | boolean | - |
Returns: void
clear()
clear(): voidReturns: void
contains()
contains(sprite: FlxSprite, recurse?: boolean): booleanParameters:
| Parameter | Type | Description |
|---|---|---|
sprite | FlxSprite | - |
recurse | boolean | - |
Returns: boolean
countDead()
countDead(): numberReturns: number
countLiving()
countLiving(): numberReturns: number
createGroup()
protected createGroup(maxSize: number): FlxGroup<T>Parameters:
| Parameter | Type | Description |
|---|---|---|
maxSize | number | - |
Returns: FlxGroup<T>
createRenderHandle()
createRenderHandle(): FlxRenderHandleReturns: FlxRenderHandle
destroy()
destroy(): voidReturns: void
draw()
draw(): voidReturns: void
findMaxX()
findMaxX(): numberReturns: number
findMaxY()
findMaxY(): numberReturns: number
findMinX()
findMinX(): numberReturns: number
findMinY()
findMinY(): numberReturns: number
getFirstAlive()
getFirstAlive(): T | nullReturns: T | null
getFirstAvailable()
getFirstAvailable(objectClass?: FlxBasicConstructor<T>): T | nullParameters:
| Parameter | Type | Description |
|---|---|---|
objectClass | FlxBasicConstructor<T> | - |
Returns: T | null
getFirstDead()
getFirstDead(): T | nullReturns: T | null
getFirstExtant()
getFirstExtant(): T | nullReturns: T | null
getFirstNull()
getFirstNull(): numberReturns: number
getMemberLocalPosition()
getMemberLocalPosition(member: T, out?: FlxPoint): FlxPointReturns a member position relative to this composite's translation.
Parameters:
| Parameter | Type | Description |
|---|---|---|
member | T | - |
out | FlxPoint | - |
Returns: FlxPoint
getRandom()
getRandom(startIndex?: number, length?: number): T | nullParameters:
| Parameter | Type | Description |
|---|---|---|
startIndex | number | - |
length | number | - |
Returns: T | null
getWorldPosition()
getWorldPosition(local: Readonly<FlxPoint>, out?: FlxPoint): FlxPointConverts a translation-local point into authoritative world space.
Parameters:
| Parameter | Type | Description |
|---|---|---|
local | Readonly<FlxPoint> | - |
out | FlxPoint | - |
Returns: FlxPoint
kill()
kill(): voidReturns: void
multiTransformChildren()
multiTransformChildren<V>(transforms: readonly FlxSpriteTransform<T, V>[], values: readonly V[]): voidApplies several transforms to every existing direct member.
Parameters:
| Parameter | Type | Description |
|---|---|---|
transforms | readonly FlxSpriteTransform<T, V>[] | - |
values | readonly V[] | - |
Returns: void
onScreen()
onScreen(camera?: FlxCameraLike): booleanParameters:
| Parameter | Type | Description |
|---|---|---|
camera | FlxCameraLike | - |
Returns: boolean
overlaps()
overlaps(objectOrGroup: FlxBasic): booleanParameters:
| Parameter | Type | Description |
|---|---|---|
objectOrGroup | FlxBasic | - |
Returns: boolean
overlapsAt()
overlapsAt(x: number, y: number, objectOrGroup: FlxBasic): booleanParameters:
| Parameter | Type | Description |
|---|---|---|
x | number | - |
y | number | - |
objectOrGroup | FlxBasic | - |
Returns: boolean
overlapsPoint()
overlapsPoint(point: Readonly<FlxPoint>): booleanParameters:
| Parameter | Type | Description |
|---|---|---|
point | Readonly<FlxPoint> | - |
Returns: boolean
recycle()
recycle(objectClass?: FlxBasicConstructor<T>): T | nullParameters:
| Parameter | Type | Description |
|---|---|---|
objectClass | FlxBasicConstructor<T> | - |
Returns: T | null
remove()
remove(sprite: T, splice?: boolean): T | nullParameters:
| Parameter | Type | Description |
|---|---|---|
sprite | T | - |
splice | boolean | - |
Returns: T | null
replace()
replace(oldObject: T, newObject: T): T | nullParameters:
| Parameter | Type | Description |
|---|---|---|
oldObject | T | - |
newObject | T | - |
Returns: T | null
reset()
reset(x: number, y: number): voidParameters:
| Parameter | Type | Description |
|---|---|---|
x | number | - |
y | number | - |
Returns: void
revive()
revive(): voidReturns: void
setAll()
setAll(variableName: string, value: unknown, recurse?: boolean): voidParameters:
| Parameter | Type | Description |
|---|---|---|
variableName | string | - |
value | unknown | - |
recurse | boolean | - |
Returns: void
setMemberLocalPosition()
setMemberLocalPosition(member: T, x: number, y: number): TMoves an owned member using translation-local coordinates.
Parameters:
| Parameter | Type | Description |
|---|---|---|
member | T | - |
x | number | - |
y | number | - |
Returns: T
sort()
sort(index?: string, order?: number): voidParameters:
| Parameter | Type | Description |
|---|---|---|
index | string | - |
order | number | - |
Returns: void
transformChildren()
transformChildren<V>(transform: FlxSpriteTransform<T, V>, value: V): voidApplies one property transform to every direct member in stable order.
Parameters:
| Parameter | Type | Description |
|---|---|---|
transform | FlxSpriteTransform<T, V> | - |
value | V | - |
Returns: void
update()
update(): voidReturns: void