Skip to content
ClassGame Objects & Sprites@public

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.

ts
export declare class FlxSpriteGroup<T extends FlxSprite = FlxSprite> extends FlxSprite

Constructors

ts
constructor(x?: number, y?: number, maxSize?: number)

Constructs a new instance of the FlxSpriteGroup class

ParameterTypeDescription
xnumber-
ynumber-
maxSizenumber-

Properties

PropertyModifiersTypeDescription
alpha-number-
color-number-
directAlpha-boolean-
groupreadonlyFlxGroup<T>-
lengthreadonlynumber-
maxSize-number-
membersreadonly(T | null)[]-
solid-boolean-

Methods

add()

ts
add(sprite: T): T

Parameters:

ParameterTypeDescription
spriteT-

Returns: T

callAll()

ts
callAll(functionName: string, recurse?: boolean): void

Parameters:

ParameterTypeDescription
functionNamestring-
recurseboolean-

Returns: void

clear()

ts
clear(): void

Returns: void

contains()

ts
contains(sprite: FlxSprite, recurse?: boolean): boolean

Parameters:

ParameterTypeDescription
spriteFlxSprite-
recurseboolean-

Returns: boolean

countDead()

ts
countDead(): number

Returns: number

countLiving()

ts
countLiving(): number

Returns: number

createGroup()

ts
protected createGroup(maxSize: number): FlxGroup<T>

Parameters:

ParameterTypeDescription
maxSizenumber-

Returns: FlxGroup<T>

createRenderHandle()

ts
createRenderHandle(): FlxRenderHandle

Returns: FlxRenderHandle

destroy()

ts
destroy(): void

Returns: void

draw()

ts
draw(): void

Returns: void

findMaxX()

ts
findMaxX(): number

Returns: number

findMaxY()

ts
findMaxY(): number

Returns: number

findMinX()

ts
findMinX(): number

Returns: number

findMinY()

ts
findMinY(): number

Returns: number

getFirstAlive()

ts
getFirstAlive(): T | null

Returns: T | null

getFirstAvailable()

ts
getFirstAvailable(objectClass?: FlxBasicConstructor<T>): T | null

Parameters:

ParameterTypeDescription
objectClassFlxBasicConstructor<T>-

Returns: T | null

getFirstDead()

ts
getFirstDead(): T | null

Returns: T | null

getFirstExtant()

ts
getFirstExtant(): T | null

Returns: T | null

getFirstNull()

ts
getFirstNull(): number

Returns: number

getMemberLocalPosition()

ts
getMemberLocalPosition(member: T, out?: FlxPoint): FlxPoint

Returns a member position relative to this composite's translation.

Parameters:

ParameterTypeDescription
memberT-
outFlxPoint-

Returns: FlxPoint

getRandom()

ts
getRandom(startIndex?: number, length?: number): T | null

Parameters:

ParameterTypeDescription
startIndexnumber-
lengthnumber-

Returns: T | null

getWorldPosition()

ts
getWorldPosition(local: Readonly<FlxPoint>, out?: FlxPoint): FlxPoint

Converts a translation-local point into authoritative world space.

Parameters:

ParameterTypeDescription
localReadonly<FlxPoint>-
outFlxPoint-

Returns: FlxPoint

kill()

ts
kill(): void

Returns: void

multiTransformChildren()

ts
multiTransformChildren<V>(transforms: readonly FlxSpriteTransform<T, V>[], values: readonly V[]): void

Applies several transforms to every existing direct member.

Parameters:

ParameterTypeDescription
transformsreadonly FlxSpriteTransform<T, V>[]-
valuesreadonly V[]-

Returns: void

onScreen()

ts
onScreen(camera?: FlxCameraLike): boolean

Parameters:

ParameterTypeDescription
cameraFlxCameraLike-

Returns: boolean

overlaps()

ts
overlaps(objectOrGroup: FlxBasic): boolean

Parameters:

ParameterTypeDescription
objectOrGroupFlxBasic-

Returns: boolean

overlapsAt()

ts
overlapsAt(x: number, y: number, objectOrGroup: FlxBasic): boolean

Parameters:

ParameterTypeDescription
xnumber-
ynumber-
objectOrGroupFlxBasic-

Returns: boolean

overlapsPoint()

ts
overlapsPoint(point: Readonly<FlxPoint>): boolean

Parameters:

ParameterTypeDescription
pointReadonly<FlxPoint>-

Returns: boolean

recycle()

ts
recycle(objectClass?: FlxBasicConstructor<T>): T | null

Parameters:

ParameterTypeDescription
objectClassFlxBasicConstructor<T>-

Returns: T | null

remove()

ts
remove(sprite: T, splice?: boolean): T | null

Parameters:

ParameterTypeDescription
spriteT-
spliceboolean-

Returns: T | null

replace()

ts
replace(oldObject: T, newObject: T): T | null

Parameters:

ParameterTypeDescription
oldObjectT-
newObjectT-

Returns: T | null

reset()

ts
reset(x: number, y: number): void

Parameters:

ParameterTypeDescription
xnumber-
ynumber-

Returns: void

revive()

ts
revive(): void

Returns: void

setAll()

ts
setAll(variableName: string, value: unknown, recurse?: boolean): void

Parameters:

ParameterTypeDescription
variableNamestring-
valueunknown-
recurseboolean-

Returns: void

setMemberLocalPosition()

ts
setMemberLocalPosition(member: T, x: number, y: number): T

Moves an owned member using translation-local coordinates.

Parameters:

ParameterTypeDescription
memberT-
xnumber-
ynumber-

Returns: T

sort()

ts
sort(index?: string, order?: number): void

Parameters:

ParameterTypeDescription
indexstring-
ordernumber-

Returns: void

transformChildren()

ts
transformChildren<V>(transform: FlxSpriteTransform<T, V>, value: V): void

Applies one property transform to every direct member in stable order.

Parameters:

ParameterTypeDescription
transformFlxSpriteTransform<T, V>-
valueV-

Returns: void

update()

ts
update(): void

Returns: void

Released under the MIT License.