Particle | DuckEngine

classdesc: Creates a DuckEngine Particle
description: The Particle Class. A particle that can be emitted by a ParticleEmitter
since: 1.0.0

Hierarchy

GameObject<"either">
- Particle

Constructors

constructor

new Particle(shape: ShapeString, w: number, h: number, r: number, fillColorOrIMGPath: string, game: Game, scene: Scene): Particle

Overrides GameObject.constructor
- Defined in core/gameobjects/particles/particle.ts:54
description
Creates a Particle instance

since
1.0.0-beta

Parameters
- shape: ShapeString
  
  Shape of the particle
- w: number
  
  Width of the particle
- h: number
  
  Height of the particle
- r: number
  
  Radius of the particle
- fillColorOrIMGPath: string
  
  Color to fill the particle with, can be an image path
- game: Game
  
  Game instance
- scene: Scene
  
  Scene instance
Returns Particle

Properties

age

age: number

memberof: Particle
description: The age of the particle in seconds
property
since: 1.0.0

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

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<"either">[] | Group<Duck.TypeClasses.GameObjects.GameObject<"either">>

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

culled

culled: boolean

memberof: GameObject
description: Determines if the GameObject should be visible by the current scene's current camera
since: 2.1.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

floatVelocity

floatVelocity: Vector2

memberof: Particle
description: The float velocity of the Particle
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

options

options: Duck.Types.PhysicsBody.Config

memberof

PhysicsBody

description

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

defaults: { type: 'KinematicBody'}

since

2.0.0

originalFillColorOrIMGPath

originalFillColorOrIMGPath: string

memberof: Particle
description: The original fill color or img path of the Particle
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

texture

texture: Texture<"either">

memberof: GameObject
description: The texture of the GameObject
since: 1.0.0-beta

velocity

velocity: Vector2

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

visible

visible: boolean

memberof: GameObject
description: Determines if a GameObject should be rendered or not (note: Camera.cull and autoCull overwrite this property)
since: 2.0.0

w

w: number

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

zIndex

zIndex: number

memberof: GameObject
description: Determines the depth or zIndex of a GameObject
since: 2.0.0

Methods

_draw

_draw(): void

Overrides GameObject._draw
- Defined in core/gameobjects/particles/particle.ts:100
memberof
Particle

description
Draws the particle. Do not call manually, called automatically in scene loop

since
1.0.0-beta

Returns void

_update

_update(): void

Overrides GameObject._update
- Defined in core/gameobjects/particles/particle.ts:168
memberof
Particle

Modified from gameobject

description
Updates the gameobject's position by the velocity. Sets velocity to 0 on every tick. DO NOT CALL MANUALLY, CALLED IN SCENE.__tick(deltaTime)

since
2.0.0

Returns void

accelerateVelocity

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

Inherited from GameObject.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

applyFriction

applyFriction(frictionAmount: Vector2): void

Inherited from GameObject.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 GameObject.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 GameObject.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 GameObject.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 GameObject.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

bounceVelocityBounds

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

Inherited from GameObject.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 GameObject.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 GameObject.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 GameObject.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 GameObject.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 GameObject.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 GameObject.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 GameObject.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 GameObject.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 GameObject.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 GameObject.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 GameObject.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 GameObject.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

scaleHitbox

scaleHitbox(scale: Vector2): void

Inherited from GameObject.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 GameObject.setEnabled
- Defined in core/physics/physicsBody.ts:337
Parameters
- enabled: boolean
Returns boolean

setFillColor

setFillColor(fillColor: string): void

Inherited from GameObject.setFillColor
- Defined in core/gameobjects/gameObject.ts:146
memberof
GameObject

description
Sets the fill color of the GameObject

since
1.0.0-beta

Parameters
- fillColor: string
  
  Fill color
Returns void

setImagePath

setImagePath(imagePath: string): void

- Defined in core/gameobjects/particles/particle.ts:218
memberof
Particle

description
Sets the particle's image src. Only works if particle's shape was initially 'sprite'

since
1.0.0-beta

Parameters
- imagePath: string
  
  Image path
Returns void

setScale

setScale(scale: number | Scale): void

Inherited from GameObject.setScale
- Defined in core/gameobjects/gameObject.ts:126
memberof
GameObject

description
Sets the scale of the GameObject

since
1.0.0-beta

Parameters
- scale: number | Scale
  
  Scale of the gameobject, can be a number to change the radius
Returns void

setType

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

Inherited from GameObject.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 GameObject.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 GameObject.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 GameObject.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

setVisible

setVisible(visible: boolean): void

Inherited from GameObject.setVisible
- Defined in core/gameobjects/gameObject.ts:115
memberof
GameObject

description
Sets the visible property and calls the game.renderer.pipeline.pool method to immediately update the visibility

Note: this calls Game.renderer.pipeline.pool to immediately update the visibility

since
2.1.0

Parameters
- visible: boolean
  
  What to set the visible property to
Returns void

Hierarchy

Index

Constructors

Properties

Methods

Constructors

constructor

Parameters

shape: ShapeString

w: number

h: number

r: number

fillColorOrIMGPath: string

game: Game

scene: Scene

Returns Particle

Properties

age

attachOffset

attachedChildren

bounds

collider

collidesWith

culled

enabled

floatVelocity

game

h

hitbox

Readonly id

isAttached

options

originalFillColorOrIMGPath

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

texture

velocity

visible

w

zIndex

Methods

_draw

Returns void

_update

Returns void

accelerateVelocity

Parameters

target: Vector2

amount: number

Returns void

applyFriction

Parameters

frictionAmount: Vector2

Returns void

applyGravity

Parameters

gravity: Vector2

Returns void

attachChild