Area | DuckEngine

classdesc: Creates a DuckEngine Area
description: The Area Class. Detects Hitboxes entering and leaving an area
since: 2.0.0

Hierarchy

PhysicsBody<"color">
- Area

Constructors

constructor

new Area(x: number, y: number, w: number, h: number, collisionFilter: PhysicsBody<Duck.Types.Texture.Type>[], game: Game, scene: Scene): Area

Overrides PhysicsBody.constructor
- Defined in core/physics/models/area.ts:63
description
Creates an Area instance

since
2.0.0

Parameters
- x: number
  
  X position of the area
- y: number
  
  Y position of the area
- w: number
  
  Width of the area
- h: number
  
  Height of the area
- collisionFilter: PhysicsBody<Duck.Types.Texture.Type>[]
  
  An array of PhysicsBodies, with Hitboxes attached to them, to check for when it leaves/enters the area
- game: Game
  
  Game instance
- scene: Scene
  
  Scene instance
Returns Area

Properties

attachOffset

attachOffset: Vector2

memberof: PhysicsBody
description: The offset between the PhysicsBody that self is attached to
since: 2.0.0

attachedChildren

attachedChildren: PhysicsBody<Duck.Types.Texture.Type>[]

memberof: PhysicsBody
description: PhysicsBodies that are attached
since: 2.0.0

bodies

bodies: PhysicsBody<Duck.Types.Texture.Type>[]

memberof: Area
description: An array of PhysicsBodies that are currently in the area
since: 2.0.0

bounds

bounds: BoundsLike

memberof: PhysicsBody
description: The bounds of the PhysicsBody
since: 2.0.0

collider

collider: undefined | Collider

memberof: PhysicsBody
description: The Collider instance of the PhysicsBody
since: 2.0.0

collidesWith

collidesWith: Duck.TypeClasses.GameObjects.GameObject<"color">[] | Group<Duck.TypeClasses.GameObjects.GameObject<"color">>

memberof: PhysicsBody
description: An array or group of GameObjects that can collide with the PhysicsBody
since: 2.0.0

collisionFilter

collisionFilter: PhysicsBody<Duck.Types.Texture.Type>[]

memberof: Area
description: An array of PhysicsBodies with Hitboxes to check for entering and leaving the area
since: 2.0.0

enabled

enabled: boolean

memberof: PhysicsBody
description: Determines if the PhysicsBody._update is called by the Scene.physicsServer used by Scene.physicsList , changing this value does nothing, must use PhysicsBody.setEnabled
since: 2.0.0

game

game: Game

memberof: PhysicsBody
description: The Game instance
since: 2.0.0

h

h: number

memberof: PhysicsBody
description: The height of the GameObject
since: 2.0.0

hitbox

hitbox: undefined | Hitbox

memberof: PhysicsBody
description: The Collider Hitbox of the PhysicsBody
since: 2.0.0

Readonly id

id: string

memberof: PhysicsBody
description: The unique identifier for a GameObject
since: 2.0.0

isAttached

isAttached: boolean

memberof: PhysicsBody
description: Determines if the PhysicsBody is attached to another PhysicsBody
since: 2.0.0

onBodyEnter

onBodyEnter: undefined | ((physicsBody: PhysicsBody<Duck.Types.Texture.Type>) => unknown)

memberof: Area
description: Callback to call when a PhysicsBody with a Hitbox enters
since: 2.0.0

onBodyLeave

onBodyLeave: undefined | ((physicsBody: PhysicsBody<Duck.Types.Texture.Type>) => unknown)

memberof: Area
description: Callback to call when a PhysicsBody with a Hitbox leaves the area
since: 2.0.0

options

options: Duck.Types.PhysicsBody.Config

memberof

PhysicsBody

description

PhysicsBody config, includes: type - KinematicBody | RigidBody | StaticBody

defaults: { type: 'KinematicBody'}

since

2.0.0

physics

physics: { addCollider: any; addHitbox: any; setBounds: any }

memberof: PhysicsBody
description: Object that has all the physics method
since: 2.0.0

Type declaration

addCollider:function
- addCollider(collidesWith: Duck.TypeClasses.GameObjects.GameObject<textureType>[]): undefined | Collider
- - Defined in core/physics/physicsBody.ts:183
  memberof
  PhysicsBody#physics
  
  description
  Adds a collider to the PhysicsBody
  
  since
  2.0.0
  
  Parameters
  - collidesWith: Duck.TypeClasses.GameObjects.GameObject<textureType>[]
    
    What the GameObject collides with
  Returns undefined | Collider
addHitbox:function
- addHitbox(w?: number, h?: number, offset?: Vector2): Hitbox
- - Defined in core/physics/physicsBody.ts:195
  memberof
  PhysicsBody#physics
  
  description
  Adds a hitbox to the PhysicsBody
  
  since
  2.0.0
  
  Parameters
  - Optional w: number
  - Optional h: number
  - Optional offset: Vector2
  Returns Hitbox
setBounds:function
- setBounds(x: number, y: number, w: number, h: number): void
- - Defined in core/physics/physicsBody.ts:206
  memberof
  GameObject#physics
  
  description
  Adds bounds to the GameObject
  
  since
  2.0.0
  
  Parameters
  - x: number
    
    X position
  - y: number
    
    Y position
  - w: number
    
    Width of the bounds
  - h: number
    
    Height of the bounds
  Returns void

position

position: Vector2

memberof: PhysicsBody
description: The current global position of the GameObject
since: 2.0.0

r

r: number

memberof: PhysicsBody
description: The radius of the GameObject
since: 2.0.0

scene

scene: Scene

memberof: PhysicsBody
description: The Scene instance
since: 2.0.0

Readonly shape

shape: ShapeString

memberof: PhysicsBody
description: The shape of the GameObject, 'rect', 'circle', 'roundrect', or 'sprite'
since: 2.0.0

velocity

velocity: Vector2

memberof: PhysicsBody
description: The velocity of the PhysicsBody
since: 2.0.0

w

w: number

memberof: PhysicsBody
description: The width of the GameObject
since: 2.0.0

Methods

_update

_update(): void

Overrides PhysicsBody._update
- Defined in core/physics/models/area.ts:90
memberof
Area

description
Updates the Area, check for Hitbox intersections with the passed collisionFilter array of PhysicsBodies

DO NOT CALL MANUALLY! CALLED IN SCENE.PHYSICS SERVER.__tick

since
2.0.0

Returns void

accelerateVelocity

accelerateVelocity(target: Vector2, amount: number): void

Inherited from PhysicsBody.accelerateVelocity
- Defined in core/physics/physicsBody.ts:580
memberof
PhysicsBody

description
Accelerates the velocity by an amount, PhysicsBody.options.type must be KinematicBody

since
2.0.0

Parameters
- target: Vector2
  
  The target velocity
- amount: number
  
  The value to increase the velocity by
Returns void

Protected addBody

addBody(physicsBody: PhysicsBody<Duck.Types.Texture.Type>): void

- Defined in core/physics/models/area.ts:105
Parameters
- physicsBody: PhysicsBody<Duck.Types.Texture.Type>
Returns void

applyFriction

applyFriction(frictionAmount: Vector2): void

Inherited from PhysicsBody.applyFriction
- Defined in core/physics/physicsBody.ts:604
memberof
PhysicsBody

description
Applies friction to the velocity by an amount, PhysicsBody.options.type must be KinematicBody or RigidBody

since
2.0.0

Parameters
- frictionAmount: Vector2
  
  The value to decrease the velocity by
Returns void

applyGravity

applyGravity(gravity: Vector2): void

Inherited from PhysicsBody.applyGravity
- Defined in core/physics/physicsBody.ts:631
memberof
PhysicsBody

description
Applies gravity to the velocity by a Vector2, PhysicsBody.options.type must be KinematicBody or RigidBody

since
2.0.0

Parameters
- gravity: Vector2
  
  The Vector2 to add to the velocity by
Returns void

attachChild

attachChild(object: PhysicsBody<Duck.Types.Texture.Type>, diffOffset?: Vector2): void

Inherited from PhysicsBody.attachChild
- Defined in core/physics/physicsBody.ts:434
memberof
PhysicsBody

description
Attaches a child PhysicsBody to self, makes child unmovable and follows the self accordingly

since
2.0.0

Parameters
- object: PhysicsBody<Duck.Types.Texture.Type>
  
  PhysicsBody to attach
- Optional diffOffset: Vector2
Returns void

attachTo

attachTo(object: PhysicsBody<Duck.Types.Texture.Type>, diffOffset?: Vector2): void

Inherited from PhysicsBody.attachTo
- Defined in core/physics/physicsBody.ts:413
memberof
PhysicsBody

description
Attaches self to another PhysicsBody, makes self unmovable and follows the PhysicsBody accordingly

since
2.0.0

Parameters
- object: PhysicsBody<Duck.Types.Texture.Type>
  
  PhysicsBody to attach to
- Optional diffOffset: Vector2
Returns void

autoFitHitbox

autoFitHitbox(offset?: Vector2): void

Inherited from PhysicsBody.autoFitHitbox
- Defined in core/physics/physicsBody.ts:728
memberof
PhysicsBody

description
Auto scales the PhysicsBody.hitbox to fit the shape

since
2.0.0

Parameters
- Optional offset: Vector2
Returns void

bodyIsInArea

bodyIsInArea(physicsBody: PhysicsBody<Duck.Types.Texture.Type>): boolean

- Defined in core/physics/models/area.ts:136
memberof
Area

description
Checks if the body is currently in the area

Parameters
- physicsBody: PhysicsBody<Duck.Types.Texture.Type>
  
  PhysicsBody to check
Returns boolean

bounceVelocityBounds

bounceVelocityBounds(bounds?: BoundsLike, restitution?: number): void

Inherited from PhysicsBody.bounceVelocityBounds
- Defined in core/physics/physicsBody.ts:666
memberof
PhysicsBody

description
Applies gravity to the velocity by a Vector2, PhysicsBody.options.type must be KinematicBody or RigidBody

since
2.0.0

Parameters
- bounds: BoundsLike = ...
- restitution: number = 1
Returns void

detachChild

detachChild(object: PhysicsBody<Duck.Types.Texture.Type>): void

Inherited from PhysicsBody.detachChild
- Defined in core/physics/physicsBody.ts:477
memberof
PhysicsBody

description
Detaches PhysicsBody from self

since
2.0.0

Parameters
- object: PhysicsBody<Duck.Types.Texture.Type>
  
  PhysicsBody to detach
Returns void

detachFrom

detachFrom(object: PhysicsBody<Duck.Types.Texture.Type>): void

Inherited from PhysicsBody.detachFrom
- Defined in core/physics/physicsBody.ts:454
memberof
PhysicsBody

description
Detaches self from another PhysicsBody

since
2.0.0

Parameters
- object: PhysicsBody<Duck.Types.Texture.Type>
  
  PhysicsBody to detach from
Returns void

getBottom

getBottom(): number

Inherited from PhysicsBody.getBottom
- Defined in core/physics/physicsBody.ts:758
memberof
PhysicsBody

description
Gets the bottom most coordinate of the PhysicsBody

since
2.0.0

Returns number

getCenter

getCenter(): Vector2

Inherited from PhysicsBody.getCenter
- Defined in core/physics/physicsBody.ts:788
memberof
PhysicsBody

description
Gets the center coordinates of the PhysicsBody

since
2.0.0

Returns Vector2

getCenterX

getCenterX(): number

Inherited from PhysicsBody.getCenterX
- Defined in core/physics/physicsBody.ts:819
memberof
PhysicsBody

description
Gets the centerX coordinate of the PhysicsBody

since
2.0.0

Returns number

getCenterY

getCenterY(): number

Inherited from PhysicsBody.getCenterY
- Defined in core/physics/physicsBody.ts:805
memberof
PhysicsBody

description
Gets the centerY coordinate of the PhysicsBody

since
2.0.0

Returns number

getLeft

getLeft(): number

Inherited from PhysicsBody.getLeft
- Defined in core/physics/physicsBody.ts:768
memberof
PhysicsBody

description
Gets the left most coordinate of the PhysicsBody

since
2.0.0

Returns number

getRight

getRight(): number

Inherited from PhysicsBody.getRight
- Defined in core/physics/physicsBody.ts:778
memberof
PhysicsBody

description
Gets the right most coordinate of the PhysicsBody

since
2.0.0

Returns number

getTop

getTop(): number

Inherited from PhysicsBody.getTop
- Defined in core/physics/physicsBody.ts:748
memberof
PhysicsBody

description
Gets the top most coordinate of the PhysicsBody

since
2.0.0

Returns number

isColliding

isColliding(obj: PhysicsBody<Duck.Types.Texture.Type>): undefined | false | CollisionResponseType

Inherited from PhysicsBody.isColliding
- Defined in core/physics/physicsBody.ts:834
memberof
PhysicsBody

description
Checks and returns the Collision Type if two hitboxes are colliding

since
2.0.0

Parameters
- obj: PhysicsBody<Duck.Types.Texture.Type>
  
  PhysicsBody to check their hitbox with
Returns undefined | false | CollisionResponseType

isCollidingGroup

isCollidingGroup(objects: PhysicsBody<Duck.Types.Texture.Type>[] | Group<PhysicsBody<Duck.Types.Texture.Type>>): false | "top" | "left" | "right" | "bottom"

Inherited from PhysicsBody.isCollidingGroup
- Defined in core/physics/physicsBody.ts:851
memberof
PhysicsBody

description
Checks and returns the Collision Type if multiple hitboxes are colliding

since
2.0.0

Parameters
- objects: PhysicsBody<Duck.Types.Texture.Type>[] | Group<PhysicsBody<Duck.Types.Texture.Type>>
  
  PhysicsBodies to check their hitbox with
Returns false | "top" | "left" | "right" | "bottom"

reflectVelocity

reflectVelocity(): void

Inherited from PhysicsBody.reflectVelocity
- Defined in core/physics/physicsBody.ts:701
memberof
PhysicsBody

description
Reflects the velocity, sets the velocity as the opposite value of the velocity, PhysicsBody.options.type must be KinematicBody or RigidBody

example
myPhysicsBody.setVelocity('x', 3); myPhysicsBody.reflect(); // velocity: 0, -3

since
2.0.0

Returns void

Protected removeBody

removeBody(physicsBody: PhysicsBody<Duck.Types.Texture.Type>): void

- Defined in core/physics/models/area.ts:116
Parameters
- physicsBody: PhysicsBody<Duck.Types.Texture.Type>
Returns void

scaleHitbox

scaleHitbox(scale: Vector2): void

Inherited from PhysicsBody.scaleHitbox
- Defined in core/physics/physicsBody.ts:738
memberof
PhysicsBody

description
Scales the PhysicsBody.hitbox

since
2.0.0

Parameters
- scale: Vector2
  
  Scale Vector2, x is width, y is height
Returns void

setEnabled

setEnabled(enabled: boolean): boolean

Inherited from PhysicsBody.setEnabled
- Defined in core/physics/physicsBody.ts:337
Parameters
- enabled: boolean
Returns boolean

setType

setType(type: Duck.Types.PhysicsBody.Type): Duck.Types.PhysicsBody.Config

Inherited from PhysicsBody.setType
- Defined in core/physics/physicsBody.ts:401
memberof
PhysicsBody

description
Sets the PhysicsBody type, PhysicsBody type determines what can be applied and what effects the body

since
2.0.0

Parameters
- type: Duck.Types.PhysicsBody.Type
  
  The type of the PhysicsBody, 'KinematicBody' | 'RigidBody' | 'StaticBody'
Returns Duck.Types.PhysicsBody.Config

setVelocity

setVelocity(axis: "x" | "y", pxPerSecond: number): void

Inherited from PhysicsBody.setVelocity
- Defined in core/physics/physicsBody.ts:501
memberof
PhysicsBody

description
Sets the velocity based on an axis, PhysicsBody.options.type must be KinematicBody

since
2.0.0

Parameters
- axis: "x" | "y"
  
  The axis to set the velocity of
- pxPerSecond: number
  
  The value to set the velocity axis as, in pixels per second
Returns void

setVelocityX

setVelocityX(pxPerSecond: number): void

Inherited from PhysicsBody.setVelocityX
- Defined in core/physics/physicsBody.ts:531
memberof
PhysicsBody

description
Sets the velocity.x, PhysicsBody.options.type must be KinematicBody

since
2.0.0

Parameters
- pxPerSecond: number
  
  The value to set the velocity axis as, in pixels per second
Returns void

setVelocityY

setVelocityY(pxPerSecond: number): void

Inherited from PhysicsBody.setVelocityY
- Defined in core/physics/physicsBody.ts:555
memberof
PhysicsBody

description
Sets the velocity.y, PhysicsBody.options.type must be KinematicBody

since
2.0.0

Parameters
- pxPerSecond: number
  
  The value to set the velocity.y as, in pixels per second
Returns void

Hierarchy

Index

Constructors

Properties

Methods

Constructors

constructor

Parameters

x: number

y: number

w: number

h: number

collisionFilter: PhysicsBody<Duck.Types.Texture.Type>[]

game: Game

scene: Scene

Returns Area

Properties

attachOffset

attachedChildren

bodies

bounds

collider

collidesWith

collisionFilter

enabled

game

h

hitbox

Readonly id

isAttached

onBodyEnter

onBodyLeave

options

physics

Type declaration

addCollider:function

Parameters

collidesWith: Duck.TypeClasses.GameObjects.GameObject<textureType>[]

Returns undefined | Collider

addHitbox:function

Parameters

Optional w: number

Optional h: number

Optional offset: Vector2

Returns Hitbox

setBounds:function

Parameters

x: number

y: number

w: number

h: number

Returns void

position

r

scene

Readonly shape

velocity

w

Methods

_update

Returns void

accelerateVelocity

Parameters

target: Vector2

amount: number

Returns void

Protected addBody

Parameters

physicsBody: PhysicsBody<Duck.Types.Texture.Type>

Returns void

applyFriction

Parameters

frictionAmount: Vector2

Returns void

applyGravity

Parameters

gravity: Vector2

Returns void

attachChild

Parameters