Graphics

Renders a PIXI.Graphics. Use the draw prop to interact with the Graphics API.

PIXI.Graphics description from PixiJS

source

The Graphics class is primarily used to render primitive shapes such as lines, circles and rectangles to the display, and to color and fill them. However, you can also use a Graphics object to build a list of primitives to use as a mask, or as a complex hitArea.

Usage

Draw prop

The draw prop is a helper prop that gets called inside of an $effect(). This means it only draws when the function itself or any state inside of it changes.

Svelte 5

<script>
  import { Graphics, tick } from 'svelte-pixi'

  let size = tick(t => 100 + Math.sin(t.lastTime / 700) * 50)

  function draw(graphics) {
    graphics.clear()
    graphics
      .circle(0, 0, $size)
      .fill('darksalmon')
  }

</script>

<Graphics
  x={375}
  y={200}
  {draw}
/>

Svelte 4 (deprecated)

<script>
  import { Graphics, tick } from 'svelte-pixi/svelte-4'

  let size = tick(t => 100 + Math.sin(t.lastTime / 700) * 50)

  $: draw = (graphics) => {
    graphics.clear()
    graphics
      .circle(0, 0, $size)
      .fill('darksalmon')
  }

</script>

<Graphics
  x={375}
  y={200}
  draw={draw}
/>

API

Svelte 5

Props

* denotes required

Name	Description
accessible	boolean Flag for if the object is accessible. If true AccessibilityManager will overlay a shadow div with attributes set
accessibleChildren	boolean Setting to false will prevent any children inside this container to be accessible. Defaults to true.
accessibleHint	nullstring Sets the aria-label attribute of the shadow div
accessiblePointerEvents	"visible""fill""stroke""auto""none""visiblePainted""visibleFill""visibleStroke""painted""all""inherit" Specify the pointer-events the accessible div will use Defaults to auto.
accessibleTitle	nullstring Sets the title attribute of the shadow div If accessibleTitle AND accessibleHint has not been this will default to 'container [tabIndex]'
accessibleType	string Specify the type of div the accessible layer is. Screen readers treat the element differently depending on this type. Defaults to button.
alpha	number
angle	number The angle of the object in degrees. 'rotation' and 'angle' have the same effect on a display object; rotation is in radians, angle is in degrees.
blendMode	"none""inherit""normal""add""multiply""screen""darken""lighten""erase""color-dodge""color-burn""linear-burn""linear-dodge""linear-light""hard-light""soft-light""pin-light""difference""exclusion""overlay""saturation""color""luminosity""normal-npm""add-npm""screen-npm""subtract""divide""vivid-light""hard-mix""negation""min""max"
boundsArea	PIXI.Rectangle An optional bounds area for this container. Setting this rectangle will stop the renderer from recursively measuring the bounds of each children and instead use this single boundArea. This is great for optimisation! If for example you have a 1000 spinning particles and you know they all sit within a specific bounds, then setting it will mean the renderer will not need to measure the 1000 children to find the bounds. Instead it will just use the bounds you set.
cacheAsBitmap	boolean Legacy property for backwards compatibility with PixiJS v7 and below. Use cacheAsTexture instead.
cacheAsTexture	PIXI.CacheAsTextureOptionsboolean
cullable	boolean Should this object be rendered if the bounds of this object are out of frame? Culling has no effect on whether updateTransform is called.
cullableChildren	boolean Determines if the children to the container can be culled Setting this to false allows PixiJS to bypass a recursive culling function Which can help to optimize very complex scenes
cullArea	PIXI.Rectangle If set, this shape is used for culling instead of the bounds of this object. It can improve the culling performance of objects with many children. The culling area is defined in local space.
cursor	string The cursor preferred when the mouse pointer is hovering over.
draw	(graphics: PIXI.Graphics) => any Call your drawing functions on the PIXI.Graphics instance here. It will only draw on mount and when the function or state inside of the function changes.
effects	PIXI.Effect[]
eventMode	"auto""none""passive""static""dynamic" The mode of interaction for this object
filterArea	PIXI.Rectangle
filters	PIXI.FilterPIXI.Filter[]
height	number The height of the Container, setting this will actually modify the scale to achieve the value set.
hitArea	nullPIXI.IHitArea The hit-area specifies the area for which pointer events should be captured by this event target.
instance	T
interactive	boolean Whether this event target should fire UI events.
interactiveChildren	boolean Whether this event target has any children that need UI events. This can be used optimize event propagation.
isRenderGroup	boolean
label	string
mask	numberPIXI.Container<PIXI.ContainerChild>Partial<PIXI.MaskOptionsAndMask>
name	string
onadded	() => void Called when the instance is added to its parent or stage
onclick	nullPIXI.FederatedEventHandler<PIXI.FederatedPointerEvent> Handler for 'click' event
oncreate	(instance: T) => void Called on creation of the component. You can use this to do any setup on the instance directly
onglobalmousemove	nullPIXI.FederatedEventHandler<PIXI.FederatedPointerEvent> Handler for 'globalmousemove' event
onglobalpointermove	nullPIXI.FederatedEventHandler<PIXI.FederatedPointerEvent> Handler for 'globalpointermove' event
onglobaltouchmove	nullPIXI.FederatedEventHandler<PIXI.FederatedPointerEvent> Handler for 'globaltouchmove' event
onmousedown	nullPIXI.FederatedEventHandler<PIXI.FederatedPointerEvent> Handler for 'mousedown' event
onmouseenter	nullPIXI.FederatedEventHandler<PIXI.FederatedPointerEvent> Handler for 'mouseenter' event
onmouseleave	nullPIXI.FederatedEventHandler<PIXI.FederatedPointerEvent> Handler for 'mouseleave' event
onmousemove	nullPIXI.FederatedEventHandler<PIXI.FederatedPointerEvent> Handler for 'mousemove' event
onmouseout	nullPIXI.FederatedEventHandler<PIXI.FederatedPointerEvent> Handler for 'mouseout' event
onmouseover	nullPIXI.FederatedEventHandler<PIXI.FederatedPointerEvent> Handler for 'mouseover' event
onmouseup	nullPIXI.FederatedEventHandler<PIXI.FederatedPointerEvent> Handler for 'mouseup' event
onmouseupoutside	nullPIXI.FederatedEventHandler<PIXI.FederatedPointerEvent> Handler for 'mouseupoutside' event
onpointercancel	nullPIXI.FederatedEventHandler<PIXI.FederatedPointerEvent> Handler for 'pointercancel' event
onpointerdown	nullPIXI.FederatedEventHandler<PIXI.FederatedPointerEvent> Handler for 'pointerdown' event
onpointerenter	nullPIXI.FederatedEventHandler<PIXI.FederatedPointerEvent> Handler for 'pointerenter' event
onpointerleave	nullPIXI.FederatedEventHandler<PIXI.FederatedPointerEvent> Handler for 'pointerleave' event
onpointermove	nullPIXI.FederatedEventHandler<PIXI.FederatedPointerEvent> Handler for 'pointermove' event
onpointerout	nullPIXI.FederatedEventHandler<PIXI.FederatedPointerEvent> Handler for 'pointerout' event
onpointerover	nullPIXI.FederatedEventHandler<PIXI.FederatedPointerEvent> Handler for 'pointerover' event
onpointertap	nullPIXI.FederatedEventHandler<PIXI.FederatedPointerEvent> Handler for 'pointertap' event
onpointerup	nullPIXI.FederatedEventHandler<PIXI.FederatedPointerEvent> Handler for 'pointerup' event
onpointerupoutside	nullPIXI.FederatedEventHandler<PIXI.FederatedPointerEvent> Handler for 'pointerupoutside' event
onremoved	() => void Called when the instance removed from its parent or stage
onrightclick	nullPIXI.FederatedEventHandler<PIXI.FederatedPointerEvent> Handler for 'rightclick' event
onrightdown	nullPIXI.FederatedEventHandler<PIXI.FederatedPointerEvent> Handler for 'rightdown' event
onrightup	nullPIXI.FederatedEventHandler<PIXI.FederatedPointerEvent> Handler for 'rightup' event
onrightupoutside	nullPIXI.FederatedEventHandler<PIXI.FederatedPointerEvent> Handler for 'rightupoutside' event
ontap	nullPIXI.FederatedEventHandler<PIXI.FederatedPointerEvent> Handler for 'tap' event
ontouchcancel	nullPIXI.FederatedEventHandler<PIXI.FederatedPointerEvent> Handler for 'touchcancel' event
ontouchend	nullPIXI.FederatedEventHandler<PIXI.FederatedPointerEvent> Handler for 'touchend' event
ontouchendoutside	nullPIXI.FederatedEventHandler<PIXI.FederatedPointerEvent> Handler for 'touchendoutside' event
ontouchmove	nullPIXI.FederatedEventHandler<PIXI.FederatedPointerEvent> Handler for 'touchmove' event
ontouchstart	nullPIXI.FederatedEventHandler<PIXI.FederatedPointerEvent> Handler for 'touchstart' event
pivot	number[number, number]{ x: number; y: number }PIXI.Point The center of rotation, scaling, and skewing for this display object in its local space. The position is the projection of pivot in the parent's local space. By default, the pivot is the origin (0, 0).
position	number[number, number]{ x: number; y: number }PIXI.Point The coordinate of the object relative to the local coordinates of the parent.
renderable	boolean Can this object be rendered, if false the object will not be drawn but the transform will still be updated.
rotation	number The rotation of the object in radians. 'rotation' and 'angle' have the same effect on a display object; rotation is in radians, angle is in degrees.
scale	number[number, number]{ x: number; y: number }PIXI.Point The scale factors of this object along the local coordinate axes. The default scale is (1, 1).
skew	number[number, number]{ x: number; y: number }PIXI.Point The skew factor for the object in radians.
sortableChildren	boolean
tabIndex	number
tint	number
visible	boolean The visibility of the object. If false the object will not be drawn, and the transform will not be updated.
width	number The width of the Container, setting this will actually modify the scale to achieve the value set.
x	number The position of the container on the x axis relative to the local coordinates of the parent. An alias to position.x
y	number The position of the container on the y axis relative to the local coordinates of the parent. An alias to position.y
zIndex	number

Snippets

Name	Type
children	Snippet<[instance: T]>

Svelte 4 (deprecated)

Props

Name	Description
blendMode 'normal'	PIXI.BLEND_MODES The blend mode to be applied to the graphic shape. Apply a value of 'normal' to reset the blend mode. Note that, since each primitive in the GraphicsGeometry list is rendered sequentially, modes such as PIXI.BLEND_MODES.ADD and PIXI.BLEND_MODES.MULTIPLY will be applied per-primitive.
draw	(graphics: Graphics) => any Call your drawing functions on the PIXI.Graphics instance here
instance	PIXI.Graphics The PIXI.Graphics instance. Can be set or bound to.
tint 0xffffff	number The tint applied to each graphic shape. This is a hex value. A value of 0xFFFFFF will remove any tint effect.

Additional props are passed on to Container

Slots

Name	Props	Fallback
default	{}

Events

Name	Type	Detail
added	forwarded
click	forwarded
create	forwarded
globalmousemove	forwarded
globalpointermove	forwarded
globaltouchmove	forwarded
mousedown	forwarded
mousemove	forwarded
mouseout	forwarded
mouseover	forwarded
mouseup	forwarded
mouseupoutside	forwarded
pointercancel	forwarded
pointerdown	forwarded
pointermove	forwarded
pointerout	forwarded
pointerover	forwarded
pointertap	forwarded
pointerup	forwarded
pointerupoutside	forwarded
removed	forwarded
removedFrom	forwarded
rightclick	forwarded
rightdown	forwarded
rightup	forwarded
rightupoutside	forwarded
tap	forwarded
touchcancel	forwarded
touchend	forwarded
touchendoutside	forwarded
touchmove	forwarded
touchstart	forwarded