GraphicsGroup

A Graphic is the base Excalibur primitive for something that can be drawn to the ExcaliburGraphicsContext. Sprite, Animation, GraphicsGroup, Canvas, Rectangle, Circle, and Polygon all derive from the Graphic abstract class.

Implementors of a Graphic must override the abstract Graphic._drawImage method to render an image to the graphics context. Graphic handles all the position, rotation, and scale transformations in Graphic._preDraw and Graphic._postDraw

Hierarchy

• Graphic
  • GraphicsGroup

Implements

• HasTick

Index

Constructors

• constructor

Properties

• id
• members
• opacity
• showDebug
• tint
• transform
• useAnchor

Accessors

• flipHorizontal
• flipVertical
• height
• localBounds
• origin
• rotation
• scale
• width

Methods

• clone
• cloneGraphicOptions
• draw
• isStale
• reset
• tick

Constructors

constructor

• new GraphicsGroup(options: GraphicsGroupingOptions & GraphicOptions): GraphicsGroup

• Overrides Graphic.constructor

  Parameters

  • options: GraphicsGroupingOptions & GraphicOptions

  Returns GraphicsGroup

Properties

readonlyid

id: number = ...

Inherited from Graphic.id

publicmembers

members: (Graphic | GraphicsGrouping)[] = []

publicopacity

opacity: number = 1

Inherited from Graphic.opacity

Gets or sets the opacity of the graphic, 0 is transparent, 1 is solid (opaque).

publicshowDebug

showDebug: boolean = false

Inherited from Graphic.showDebug

Gets or sets wether to show debug information about the graphic

publicoptionaltint

tint?: Color

Inherited from Graphic.tint

publictransform

transform: AffineMatrix = ...

Inherited from Graphic.transform

publicuseAnchor

useAnchor: boolean = true

Accessors

publicflipHorizontal

• get flipHorizontal(): boolean
• set flipHorizontal(value: boolean): void

• Inherited from Graphic.flipHorizontal

  Gets or sets the flipHorizontal, which will flip the graphic horizontally (across the y axis)

  ---

  Returns boolean

• Inherited from Graphic.flipHorizontal

  Parameters

  • value: boolean

  Returns void

publicflipVertical

• get flipVertical(): boolean
• set flipVertical(value: boolean): void

• Inherited from Graphic.flipVertical

  Gets or sets the flipVertical, which will flip the graphic vertically (across the x axis)

  ---

  Returns boolean

• Inherited from Graphic.flipVertical

  Parameters

  • value: boolean

  Returns void

publicheight

• get height(): number
• set height(value: number): void

• Inherited from Graphic.height

  Gets or sets the height of the graphic (always positive)

  ---

  Returns number

• Inherited from Graphic.height

  Parameters

  • value: number

  Returns void

publiclocalBounds

• get localBounds(): BoundingBox

• Overrides Graphic.localBounds

  Gets a copy of the bounds in pixels occupied by the graphic on the the screen. This includes scale.

  ---

  Returns BoundingBox

publicorigin

• get origin(): Vector
• set origin(value: Vector): void

• Inherited from Graphic.origin

  Gets or sets the origin of the graphic, if not set the center of the graphic is the origin

  ---

  Returns Vector

• Inherited from Graphic.origin

  Parameters

  • value: Vector

  Returns void

publicrotation

• get rotation(): number
• set rotation(value: number): void

• Inherited from Graphic.rotation

  Gets or sets the rotation of the graphic

  ---

  Returns number

• Inherited from Graphic.rotation

  Parameters

  • value: number

  Returns void

publicscale

• get scale(): Vector
• set scale(value: Vector): void

• Inherited from Graphic.scale

  Gets or sets the scale of the graphic, this affects the width and

  ---

  Returns Vector

• Inherited from Graphic.scale

  Parameters

  • value: Vector

  Returns void

publicwidth

• get width(): number
• set width(value: number): void

• Inherited from Graphic.width

  Gets or sets the width of the graphic (always positive)

  ---

  Returns number

• Inherited from Graphic.width

  Parameters

  • value: number

  Returns void

Methods

publicclone

• clone(): GraphicsGroup

• Overrides Graphic.clone

  Returns a new instance of the graphic that has the same properties

  ---

  Returns GraphicsGroup

publiccloneGraphicOptions

• cloneGraphicOptions(): GraphicOptions

• Inherited from Graphic.cloneGraphicOptions

  Returns GraphicOptions

publicdraw

• draw(ex: ExcaliburGraphicsContext, x: number, y: number): void

• Inherited from Graphic.draw

  Draw the whole graphic to the context including transform

  ---

  Parameters

  • ex: ExcaliburGraphicsContext

    The excalibur graphics context

  • x: number

  • y: number

  Returns void

publicisStale

• isStale(): boolean

• Inherited from Graphic.isStale

  Returns boolean

publicreset

• reset(): void

• Returns void

publictick

• tick(elapsed: number, idempotencyToken?: number): void

• Implementation of HasTick.tick

  Parameters

  • elapsed: number

    The amount of real world time in milliseconds that has elapsed that must be updated in the animation

  • optionalidempotencyToken: number

    Optional idempotencyToken prevents a ticking animation from updating twice per frame

  Returns void