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.