MCPcopy Create free account
hub / github.com/pixijs-userland/graphics-smooth

github.com/pixijs-userland/graphics-smooth @v1.1.1

Chat with this repo
repository ↗ · DeepWiki ↗ · release v1.1.1 ↗ · + Follow
185 symbols 398 edges 33 files ⚖ MIT 10 documented · 5% 1 cross-repo links ● updated 1y agov1.1.1 · 2024-12-20★ 17714 open issues

Browse by type

⨍ Functions 145◇ Types & classes 40
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

PixiJS Smooth Graphics

PixiJS v7 plugin for making smooth shapes using HHAA shader.

Build npm version

:link: Links

Features

This is very early version of the plugin.

Here's how it looks, compared to pixi graphics (antialias=false)

img_1.png

You can find examples in examples folder, you have to start the local webserver in repo folder to view them.

How to draw lines

This is drop-in replacement of PIXI.Graphics, API is compatible.

import { SmoothGraphics as Graphics } from '@pixi/graphics-smooth';

const graphics = new Graphics();

graphics.moveTo(100, 100);
graphics.lineTo(200, 200);

LineScaleMode

For lines, native mode is renamed to scaleMode, you can ignore scale of element or even set default value for it!

import { SmoothGraphics, LINE_SCALE_MODE, settings } from '@pixi/graphics-smooth';

graphics.lineStyle({ width: 2.0, scaleMode: LINE_SCALE_MODE.NONE }); // now its always 2 independent from scale

//alternatively
settings.LINE_SCALE_MODE = LINE_SCALE_MODE.NONE;

const graphics2 = new SmoothGraphics();
graphics.lineStyle(2.0, 0xffffff, 1.0); //the usual, but scaleMode works by default

settings.LINE_SCALE_MODE = LINE_SCALE_MODE.NORMAL;
graphics.lineStyle(2.0, 0xffffff, 1.0); //its normal again

Note: NONE was the only option for graphics-smooth <= 0.0.6. Please update your code if you used early versions!

How to draw fills

Fills have a bit of a problem - smoothing works good only on concave objects. It works only on circles and polygons. It is not implemented for rects and rounded rects yet.

graphics.beginFill(0xffffff, 1.0, true); //third param for beginFill

HHAA doesn't work with texture fill yet.

drawStar and other graphics-extras

That's what you have to do if you need functions from graphics-extras package:

import { SmoothGraphics } from '@pixi/graphics-smooth';
import { Graphics } from '@pixi/graphics';
import '@pixi/graphics-extras';

Object.assign(SmoothGraphics.prototype, {
    drawTorus: Graphics.prototype.drawTorus,
    drawChamferRect: Graphics.prototype.drawChamferRect,
    drawFilletRect: Graphics.prototype.drawFilletRect,
    drawRegularPolygon: Graphics.prototype.drawRegularPolygon,
    drawRoundedPolygon: Graphics.prototype.drawRoundedPolygon,
    drawStar: Graphics.prototype.drawStar,
});

For UMD:

PIXI.smooth.SmoothGraphics.prototype.drawStar = PIXI.Graphics.prototype.drawStar;

Pixel Perfect

You might notice that for diagonal lines, coverage differs from canvas2d a lot, especially if you do line animations. Solution is easy:

import { settings } from '@pixi/graphics-smooth';
settings.PIXEL_LINE = 1;

It has to be done before first GraphicsSmooth is created.

This setting is disabled by default because it adds extra computations in coverage calculation. It is not researched yet how it will affect performance.

What are we working on

  • better AA on fills
  • support for line textures
  • rope mode for line textures

Performance

Currently graphics geometry uses 11 floats per vertex, when original graphics used only 8. Number of vertices also differ, it might use up to 2x of original.

Uniforms are used to store styles depends on (lineWidth * scaleMode, lineAlignment, texture, matrix).

If style buffer is too big (for now its max 24), one more drawcall will spawn.

What are we working on

  • support instancing
  • support Uniform Buffer Objects
  • support batching of multiple graphics elements

Build & Test

npm install
npm start

Extension points exported contracts — how you extend this code

browse all types & interfaces →

Core symbols most depended-on inside this repo

browse all functions →

Shape

Method 128
Class 32
Function 17
Interface 6
Enum 2

Languages

TypeScript100%

Modules by API surface

src/SmoothGraphics.ts49 symbols
src/SmoothGraphicsGeometry.ts27 symbols
src/core/BatchDrawCall.ts14 symbols
src/core/SmoothGraphicsData.ts10 symbols
src/core/FillStyle.ts10 symbols
src/core/LineStyle.ts7 symbols
src/shapes/PolyBuilder.ts6 symbols
src/core/SegmentPacker.ts6 symbols
src/core/BatchPart.ts6 symbols
src/SmoothShader.ts6 symbols
src/shapes/RoundedRectangleBuilder.ts5 symbols
src/shapes/RectangleBuilder.ts5 symbols

Used by 1 indexed graphs manifest dependencies, hub-wide

For agents

$ claude mcp add graphics-smooth \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page