Skip to content

Releases: pixijs/pixijs

v8.17.1

16 Mar 09:23
@Zyie Zyie
v8.17.1
6e59c6f

Choose a tag to compare

View all tags
v8.17.1 Latest
Latest

💾 Download

Installation:

npm install pixi.js@8.17.1

Development Build:

Production Build:

Documentation:

Changed

v8.17.0...v8.17.1

🐛 Fixed

  • fix: compressed textures ignoring resolution from URL (e.g. @0.75x) by @Zyie in #11960
  • fix: center-align text correctly when words exceed wordWrapWidth by @Zyie in #11966

🧹 Chores

  • chore: fix BitmapFont char keys from char codes to character strings by @Zyie in #11967
  • fix: add secrets: inherit to publish-switch workflow for S3 docs upload by @Zyie in #11962

Contributors

Zyie
Assets 35
  • advanced-blend-modes.js
    sha256:3ded5e4b6f64d49fbbca55d8fafcca25641ecfd7bf289873f812d42b5a94305f
    36.9 KB 2026-03-16T09:25:01Z
  • advanced-blend-modes.js.map
    sha256:a5591262ffb60888d37d7f95c751ef587644ad0c77f32a9a4252a787b4696de9
    66 KB 2026-03-16T09:25:01Z
  • advanced-blend-modes.min.js
    sha256:96a1718ceb19bfaf87a2ab23f093d305df3c4be2c1ea7434ed05b46da3e7ced1
    30.9 KB 2026-03-16T09:25:01Z
  • advanced-blend-modes.min.js.map
    sha256:a140392e8ec7af411a44769abe2e916d9cf1de5af8ffb2c41d8e100883d4f0f3
    62.2 KB 2026-03-16T09:25:01Z
  • gif.js
    sha256:1f4dca20a0a8dd34cde18a4a7f7b44ed3cd1010c92bb93c5aeee0162e18b0a48
    44.3 KB 2026-03-16T09:25:01Z
  • gif.js.map
    sha256:7506b469ef77f9401d1a0337b586441bcd113257921ee9c7347833eb46479078
    86.2 KB 2026-03-16T09:25:01Z
  • gif.min.js
    sha256:6872b0e920d0f27f20f35241931fce1eaadfd1a1cdc3a492fda1ad061d5da800
    14.6 KB 2026-03-16T09:25:01Z
  • gif.min.js.map
    sha256:5c164ee8b17a3f02afa72255352b23dfe265764576324d8146bedead7153db42
    70.2 KB 2026-03-16T09:25:01Z
  • math-extras.js
    sha256:93ad15be490a4731ddc221e1fa4e43e6d36efadf9bd3c085a6c50a9eee1c92bb
    6.63 KB 2026-03-16T09:25:01Z
  • math-extras.js.map
    sha256:bdd6155b36382b1fc809611aa66819e9d2f45bf5a1d412a8861242f54b2bbb99
    20.2 KB 2026-03-16T09:25:01Z
  • Source code (zip)
    2026-03-16T09:19:59Z
  • Source code (tar.gz)
    2026-03-16T09:19:59Z

v8.17.0

09 Mar 15:29
@Zyie Zyie
v8.17.0
4806c3b

Choose a tag to compare

View all tags
v8.17.0

💾 Download

Installation:

npm install pixi.js@8.17.0

Development Build:

Production Build:

Documentation:

Changed

v8.16.0...v8.17.0

🚨 Behavior Change

  • BlurFilter now uses an optimized halving strength scheme by default, which changes visual output compared to previous versions. Set legacy: true to restore the old behavior. 
    new BlurFilter({ legacy: true });
// or globally:
BlurFilter.defaultOptions.legacy = true;
  • Text with align: 'justify' now uses wordWrapWidth for width calculation instead of maxLineWidth, matching CSS behavior. The last line is no longer stretched.
  • breakWords: true in HTMLText now correctly uses CSS word-break: break-word instead of break-all to match behavior of other text renderers.

🎁 Added

  • feat: add tagged text support to canvasTextSplit by @Zyie in #11949
    • SplitText now supports tagStyles, so styled runs (e.g. <red>Hello</red> <blue>World</blue>) are correctly split into per-character Text objects with individual styles preserved.
  • feat: Improves text rendering and layout handling by @Zyie in #11947
    • Bitmap text now supports whiteSpace modes (normal, pre, nowrap, pre-line, pre-wrap) with proper space/newline collapsing
    • Bitmap text word wrap supports break-after characters (hyphens, en-dash, em-dash, soft hyphen)
    • Canvas text and split text now render align: 'justify' by distributing extra word spacing
    • Dynamic bitmap fonts scale drop shadow blur and distance proportionally to font size
    • Bitmap font xAdvance now uses true advance width from measureText() instead of bounding-box width
    • Kerning values correctly scaled by fontScale in dynamic bitmap fonts
  • feat: add visibleChanged event to container by @ikigai-bjorn-s in #11940 
    container.on('visibleChanged', (visible) => {
    console.log('Visibility changed to:', visible);
});
  • feat: Add function for removing aliases from resolver by @Sertion in #11921

🐛 Fixed

  • fix: prevent filter corruption with TexturePool mipmap separation by @vkarponen in #11865
  • fix: blur by reducing strength on each pass by @Zyie in #11909
  • fix: Reduce work done by the blur shader by @Sertion in #11917
  • fix: Correctly handle offset in ColorMatrixFilter by @Sertion in #11925
  • fix: Apply global filter offset to ParticleContainer rendering by @GoodBoyDigital in #11882
  • fix: respect texture trim offset in NineSliceSprite by @shtse8 in #11919
  • fix: return valid empty bounds from empty Graphics by @GoodBoyDigital in #11908
  • fix: Graphics getLocalBounds returns stale data between operations in same frame by @GoodBoyDigital in #11886
  • fix: Graphics bounds account for miter joins at sharp angles by @GoodBoyDigital in #11884
  • fix: BindGroup crash when resource destroyed in batched group by @GoodBoyDigital in #11876
  • fix: remove listener from old resource in BindGroup.setResource by @GoodBoyDigital in #11901
  • fix: removeAllListeners() on Renderer.destroy() by @taye in #11951
  • fix: correct minFPS/maxFPS mutual clamping in Ticker by @Zyie in #11952
  • fix: invalidate cached source in color.setAlpha() to prevent stale alpha reuse by @darthvader58 in #11924
  • fix: emit removed event when using addChildAt by @aSipz in #11912
  • fix: guard against missing characters and kerning data in bitmap text by @stargazer-2697 in #11907
  • fix: copy modifier keys from TouchEvent to normalized touch objects by @kaigritun in #11906
  • fix: use quotes when loading a Web font to support old versions of Chrome by @adngdb in #11902
  • fix: move DOMPipe registration to init.ts to fix Web Worker support by @Zyie in #11953
  • fix: clarify BackgroundLoader cache behavior in documentation by @imuday984 in #11935

🧹 Chores

  • chore: Add PixiJS development playground by @GoodBoyDigital in #11878
  • chore: overhaul documentation system with TypeDoc plugins, examples, and guides by @Zyie in #11905
  • chore: consolidate build and test scripts by @Zyie in #11910
  • chore: expand build, test, and API documentation by @Zyie in #11956
  • chore: combine visual test diff output into single labeled image by @Zyie in #11954
  • chore: add ESLint rule enforcing ~/ imports in test and scene files by @Zyie in #11899
  • chore: reorganizes visual scene tests into logical subdirectories by @Zyie in #11872
  • chore: Improve test server setup by dynamically allocating port by @Zyie in #11874
  • chore: increase HTMLText visual test wait from 250ms to 350ms by @Zyie in #11891
  • chore: remove tsc-silent dependency by @Zyie
  • docs: document filters + RenderLayer limitation by @GoodBoyDigital in #11883

New Contributors

Contributors

Sertion, adngdb, and 11 other contributors
Loading

v8.16.0

03 Feb 16:55
@Zyie Zyie
v8.16.0
94156d3

Choose a tag to compare

View all tags
v8.16.0

💾 Download

Installation:

npm install pixi.js@8.16.0

Development Build:

Production Build:

Documentation:

Changed

v8.15.0...v8.16.0

🚨 Behavior Change

  • SplitText now more accurately splits Text across a wider range of TextStyle configurations. This may result in slight changes to character positioning.
  • Using SplitText.from from an existing Text now correctly transfers the source anchor to the new instance by mapping the anchor to pivot coordinates. This changes layout and positioning compared to previous behavior.
  • SplitBitmapText now correctly defaults to a white fill, matching the behavior of BitmapText.
  • HTMLText now correctly respects breakWords and no longer cuts off words that exceed wordWrapWidth.
  • HTMLText now respects the alpha value of its fill and stroke.
  • Text now correctly aligns when using align: 'right' or align: 'center', resulting in a small positional adjustment.
  • Container.cullArea is now correctly interpreted in the container’s local coordinate space and transformed to global coordinates before culling checks. 
    // cullArea is defined in local space and transformed during culling
container.cullArea = new Rectangle(0, 0, 100, 100);
  • graphics.texture(texture, 0x000000) will now correctly apply a black tint

🎁 Added

  • feat: Canvas renderer by @krzys @Zyie in #11815
    • Note: This feature is experimental, please let us know if you run into any issues.
     await app.init({
      preference: 'canvas'
  });
  • feat: tagged text by @Zyie in #11827
    • Note: Currently only works for Text/HTMLText, BitmapText support coming soon
     const text = new Text({
  text: '<bold>Important:</bold> This is <highlight>highlighted</highlight> text',
  style: {
      fontFamily: 'Arial',
      fontSize: 28,
      fill: 'white',
      tagStyles: {
          bold: { fontWeight: 'bold', fill: 'yellow' },
          highlight: { fill: 'cyan', fontSize: 32 }
      }
  }
 });
  • feat: improve stability of SplitText by @Zyie in #11858
    • SplitText now fully mirrors Text behavior and regenerates automatically when its TextStyle changes via text.styleChanged()
    splitText.style.fontSize = 32
splitText.styleChanged()
  • feat: external texture support by @astralarya @GoodBoyDigital in #11846 #11861
  • feat: add parseSync to spritesheet by @jimhigson in #11794
  • feat: improved Pool typing for pool.get() method by @unstoppablecarl in #11799
  • feat: add cube texture by @GoodBoyDigital in #11800
  • by @GoodBoyDigital in
  • feat: Implement mip level rendering support in the rendering system by @GoodBoyDigital in #11801
  • feat: render to array layer by @GoodBoyDigital in #11803

🐛 Fixed

🧹 Chores

  • chore: add visual tests for text rendering features by @Zyie in #11825
  • chore: Upgrades dependencies by @Zyie in #11806
  • chore: guide to use envinfo to get environment information by @typed SIGTERM in #11859
  • chore: optimize fastCopy with waterfall typed array selection by @GoodBoyDigital in #11798
  • chore: use texImage2D instead of texSubImage2D for video in Safari by @GoodBoyDigital in #11867

New Contributors

Contributors

jimhigson, astralarya, and 11 other contributors
Loading

v8.15.0

05 Jan 10:10
@Zyie Zyie
v8.15.0
d7e9a5d

Choose a tag to compare

View all tags
v8.15.0

💾 Download

Installation:

npm install pixi.js@8.15.0

Development Build:

Production Build:

Documentation:

Changed

v8.14.3...v8.15.0

🎁 Added

  • feat: add unified GC by @Zyie in #11786
    • Deprecated TextureGCSystem/RenderableGCSystem in favor of GCSystem. 
      // old 
app.init({
    textureGCActive: true,
    textureGCMaxIdle: 60000,
    textureGCCheckCountMax: 30000,
    renderableGCActive: true,
    renderableGCMaxUnusedTime: 60000,
    renderableGCFrequency: 30000,
});

// new
app.init({
  gcActive: true,
  gcMaxUnusedTime: 60000,
  gcFrequency: 30000,
});
    • feat: Adds auto-GC option to view containers by @Zyie in #11810
      • Disable automatic garbage collection for a node. 
         new Sprite({
     autoGarbageCollect: false,
 });
  • feat: add unload method to reset GPU data by @Zyie in #11762

    • You can now manually unload a node by calling its unload method. This releases any GPU resources associated with the node. The node can still be used afterward—it will be re-created automatically when needed.

      sprite.unload();
text.unload();
mesh.unload();

    • feat: move GPU context storage to GraphicsContext._gpuData by @Zyie in #11763

    • feat: move GPU data to Geometry._gpuData by @Zyie in #11772

    • feat: move GPUData to TextureSource by @Zyie in #11774

    • feat: move GL/GPU buffer storage to Buffer._gpuData and manage buffers list by @Zyie in #11775

    • feat: add descriptive names GCManagedHash by @Zyie in #11811

    • feat: update text GPU lifecycle and resolution updates by @Zyie in #11781

  • feat: ParticleContainer type improvements by @unstoppablecarl in #11708
  • feat: allow RenderTexture.create to accept dynamic option by @seanzhaoxiaoxiao in #11767

🐛 Fixed

🧹 Chores

  • chore: Improve JSDoc documentation across modules by @Zyie in #11812
  • chore: refactors CI workflows for trusted publishing by @Zyie in #11820

New Contributors

Contributors

unstoppablecarl, laino, and 5 other contributors
Loading

v8.15.0-rc

08 Dec 17:43
@Zyie Zyie
v8.15.0-rc
6c56e1b

Choose a tag to compare

View all tags
v8.15.0-rc Pre-release
Pre-release

💾 Download

Installation:

npm install pixi.js@8.15.0-rc

Development Build:

Production Build:

Documentation:

Changed

v8.14.3...v8.15.0-rc

🎁 Added

  • feat: allow RenderTexture.create to accept dynamic option by @seanzhaoxiaoxiao in #11767
  • feat: add unload method to reset GPU data by @Zyie in #11762
  • feat: add unified GC by @Zyie in #11786
    • feat: move GPU context storage to GraphicsContext._gpuData by @Zyie in #11763
    • feat: move GPU data to Geometry._gpuData by @Zyie in #11772
    • feat: move GPUData to TextureSource by @Zyie in #11774
    • feat: move GL/GPU buffer storage to Buffer._gpuData and manage buffers list by @Zyie in #11775
    • feat: update text GPU lifecycle and resolution updates by @Zyie in #11781
  • feat: ParticleContainer type improvements by @unstoppablecarl in #11708

🐛 Fixed

New Contributors

Contributors

unstoppablecarl, laino, and 5 other contributors
Loading

v8.14.3

20 Nov 12:35
@Zyie Zyie
v8.14.3
e17c886

Choose a tag to compare

View all tags
v8.14.3

💾 Download

Installation:

npm install pixi.js@8.14.3

Development Build:

Production Build:

Documentation:

Changed

v8.14.2...v8.14.3

🐛 Fixed

  • fix: Only create stage Container on init if it doesn't exist by @lunarraid in #11766

Contributors

lunarraid
Loading

v8.14.2

18 Nov 09:23
@Zyie Zyie
v8.14.2
506a83c

Choose a tag to compare

View all tags
v8.14.2

💾 Download

Installation:

npm install pixi.js@8.14.2

Development Build:

Production Build:

Documentation:

Changed

v8.14.1...v8.14.2

🐛 Fixed

  • fix: graphics memory leak and cleanup by @Zyie in #11753
  • fix: typo in Application example: replace '-' with '=' in asset loading by @Aryaman1792 in #11750
  • fix: parse resolution and format from URLs in object sources in assets resolver by @stereopasa in #11747
  • fix: track item count in Pool class and add related tests by @Zyie in #11760
  • fix: bitmanFontXMLParser should recognize xml fonts with versions by @rafalaidlaw in #11761
  • fix: Remove automatically added 'resize' event listener from TextureSource on Texture destroy() by @Romans-I-XVI in #11764
  • fix: resolve a typescript annoyance with Container.filters by @jimhigson in #11757
  • fix: enable proper application reinitialization by @Zyie in #11759
  • fix: correct uBackTexture binding for filters with blendRequired by @GoodBoyDigital in #11754

🧹 Chores

  • chore: add mention of uBackTexture to Filter docs (otherwise undocumented) by @jimhigson in #11756

New Contributors

Contributors

jimhigson, GoodBoyDigital, and 5 other contributors
Loading

v8.14.1

10 Nov 09:32
@Zyie Zyie
v8.14.1
10a92cf

Choose a tag to compare

View all tags
v8.14.1

💾 Download

Installation:

npm install pixi.js@8.14.1

Development Build:

Production Build:

Documentation:

Changed

v8.14.0...v8.14.1

🐛 Fixed

  • fix: bytesPerRow calculation for BufferImageSource in WebGPU by @koteelok in #11718
  • fix: Guards mask reset from null reference by @Zyie in #11719
  • fix: Prevents errors during worker manager reset by @Zyie in #11720

🧹 Chores

Contributors

bigtimebuddy, Zyie, and koteelok
Loading

v8.14.0

06 Oct 21:29
@Zyie Zyie
v8.14.0
4cfcbc0

Choose a tag to compare

View all tags
v8.14.0

💾 Download

Installation:

npm install pixi.js@8.14.0

Development Build:

Production Build:

Documentation:

Changed

v8.13.2...v8.14.0

🎁 Added

  • feat: add asset loading strategies by @Zyie in #11693
    • Three new loading strategies have been introduced: throw, skip, and retry
      • throw: The default strategy and matches the behavior of previous versions. With this strategy enabled any asset that fails to load will throw an error and the promise will reject.
      • skip: If any asset fails to load not error is thrown and the loader continues to load other assets
      • retry: Allow for multiple attempts at loading an asset before an error is thrown. The number of attempts and the delay between attempts are configurable
    const options: LoadOptions = {
  strategy: 'retry',
  retryCount: 5, // Retry up to 5 times
};
await Assets.load('unstable-asset.png', options);
    await Assets.init({
    basePath,
    loadOptions: { strategy: 'skip', onError: (error, asset) => console.log(error, asset.url) },
});

Assets.addBundle('testBundle', [
    { alias: 'bunny', src: 'textures/bunny_no_img.png' },
    { alias: 'bunny2', src: 'textures/bunny.png' },
]);

// only bunny2 is defined and did not throw an error
const assets = await Assets.loadBundle('testBundle');
  • feat: Adds progress size to asset loading by @Zyie in #11699
    • You can provide progressSize when loading assets to get a more accurate loading percentage. If no size is provide the default value is 1.
    const assets = [
    {
        src: [
            {
                src: 'textures/texture.webp',
                progressSize: 900,
            },
        ],
        alias: ['bunny-array', 'bunny-array2'],
    },
    {
        src: 'textures/bunny.png',
        progressSize: 100,
    }
];
const res = await Assets.load(assets, progressMock);
  • feat: added rotate to Point math-extras by @unstoppablecarl in #11704 
      // Basic point rotation
  const point = new Point(10, 20);
  const degrees = 45
  const radians = degrees * (Math.PI / 180)
  const result = point.rotate(radians);
  console.log(result); // {x: -7.071067811865474, y: 21.213203435596427}

  // Using output point for efficiency
  const output = new Point(10, 20);
  point.rotate(90 * (Math.PI / 180), output);
  console.log(result); // {x: -7.071067811865474, y: 21.213203435596427}
  • feat: add change guards to TextStyle setters to prevent redundant updates by @mayakwd in #11677

🐛 Fixed

  • fix: incorrect accessibility div when recycled from the pool (#11679) by @brentmc in #11680
  • fix: use updated childrenRenderablesToUpdate index in validateRenderables by @davidetan in #11688
  • fix: modify conditional to skip draw call when instanceCount < 1 by @jaburwock in #11639
  • fix: respect filter enabled state by @mayakwd in #11674
  • fix: ensure updateTextBounds is called regardless of style and resolution change by @mayakwd in #11676
  • fix: Allow IRenderLayer as part of the ContainerOptions children array by @albinkong in #11687
  • fix: removes accessibility system event listeners correctly by @Zyie in #11700

🧹 Chores

New Contributors

Contributors

brentmc, unstoppablecarl, and 6 other contributors
Loading

v8.13.2

10 Sep 07:41
@Zyie Zyie
v8.13.2
8eee29c

Choose a tag to compare

View all tags
v8.13.2

💾 Download

Installation:

npm install pixi.js@8.13.2

Development Build:

Production Build:

Documentation:

Changed

v8.13.1...v8.13.2

🐛 Fixed

  • fix: application destroy for graphics by @Zyie in #11659
  • fix: recalculate the boundaries of GraphicsContext regardless of rendering dirty state by @mayakwd in #11671
  • fix: destroy of prepared but not rendered text should not throw an error by @mayakwd in #11672

Contributors

mayakwd and Zyie
Loading