๐จ WARNING ๐จ
There is a known bug with this build that is stopping extensions being added correctly
You can add the following to resolve the issue
import 'pixi.js/accessibility'
import 'pixi.js/app'
import 'pixi.js/events'
import 'pixi.js/filters'
import 'pixi.js/sprite-tiling'
import 'pixi.js/text'
import 'pixi.js/text-bitmap'
import 'pixi.js/text-html'
import 'pixi.js/graphics'
import 'pixi.js/mesh'
import 'pixi.js/spritesheet'
import 'pixi.js/rendering'
import 'pixi.js/sprite-nine-slice'
The next release will resolve this and you will not need to manually import these
โน๏ธ INFO
If you have any questions or issues we are actively monitoring our discord and github issues!
๐พ Download
Development Build:
Production Build:
Documentation:
- https://pixijs.download/v8.0.0-rc.1/docs/index.html
- Note: Documentation is still a WIP
Changed
๐ฅ Breaking
Based on the feedback received after the last release candidate build, we found it necessary to make some breaking changes to enhance the overall user experience before the final release.
-
Breaking: refactor views by @GoodBoyDigital in #10041
- We have decided that our decision to split scene objects into "views" was a mistake and increased complexity for users that want to extend things like the
Sprite
class to add custom functionality. - We have now refactored all scene objects to be flat similar to how previous versions of pixi has worked
- This also means that anything available from
sprite.view
should be available directly onsprite
now
- We have decided that our decision to split scene objects into "views" was a mistake and increased complexity for users that want to extend things like the
-
Breaking: rename fragColor to finalColor by @GoodBoyDigital in #9982
+ out vec4 finalColor; - out vec4 fragColor;
-
Breaking: Standardise filter uniform names by @GoodBoyDigital in #10012
- All filters now have consistent naming prefixed with
u
uSampler
renamed touTexture
mySampler
renamed touSampler
example:
- @group(0) @binding(1) var uSampler: texture_2d<f32>; - @group(0) @binding(2) var mySampler : sampler; - @group(0) @binding(3) var backTexture: texture_2d<f32>; + @group(0) @binding(1) var uTexture: texture_2d<f32>; + @group(0) @binding(2) var uSampler : sampler; + @group(0) @binding(3) var uBackTexture: texture_2d<f32>;
- All filters now have consistent naming prefixed with
-
Chore/rename-rg by @GoodBoyDigital in #10048
-
Breaking: rename
onUpdate
to_onUpdate
by @GoodBoyDigital in #10049onUpdate
was an internal function call, however we found it to be fairly common for libraries to implement their ownonUpdate
property e.g.onUpdate = new Signal()
- We have now renamed this to
_onUpdate
to make it easier to upgrade to v8
-
Breaking: flatten TextureSource.style options by @achamas-playco in #10025
- the
style
constructor property fromTextureSource
has been flattened to make it easier to apply styles
new TextureSource({ - style: { scaleMode: 'nearest' } + scaleMode: 'nearest' })
- the
-
Breaking: fix running on webworker by @Zyie in #9960
- Previous versions of v8 did not work correctly on a webworker. This has been fixed but did also introduce a breaking change
- Previously all
pixi.js/*
imports were wrongly being added by default. With this change you will now need to manually import the additional parts of pixi
e.g
import 'pixi.js/unsafe-eval' import 'pixi.js/maths-extras' import 'pixi.js/advanced-blend-modes' import 'pixi.js/prepare' import 'pixi.js/ktx' import 'pixi.js/basis' import 'pixi.js/dds'
-
Breaking: bundle builds by @Zyie in #9961
- We now have separate builds for
webworker
,unsafe-eval
, andmath-extras
- This means that if you are using
<script>
to use pixi you will need to add these extra packages- Note: this should behave the same as how v7 worked
- Note: this change only affects anyone using
<script>
. For anyone using package managers there should be no changes
- We now have separate builds for
๐ Added
- Feat: add WebGL 1 support by @GoodBoyDigital in #9997
- Feat: add geometry bounds by @GoodBoyDigital in #9970
- Feat: optimize getLocalBounds and add a cache by @GoodBoyDigital in #9975
- Feat: add v7 graphics compatibility by @achamas-playco in #9967
- Feat: allow ubos to be optional in webgl by @GoodBoyDigital in #9981
- Feat: add support for uint16 by @GoodBoyDigital in #10000
- Feat: add shader.from by @Zyie in #10031
- Feat: add graphics clone by @Zyie in #10052
- Feat: Add signal and once option to addEventListener by @Zyie in #10055
๐ Fixed
- Fix: root transform not updating by @GoodBoyDigital in #10002
- Fix: adjust texture.WHITE creation by @GoodBoyDigital in #9976
- Fix: fix alpha not being clamped by @GoodBoyDigital in #9977
- Fix: alpha transparency on renderer by @GoodBoyDigital in #10053
- Fix: allow mask to be null or undefined by @Zyie in #9962
- Fix: typo in spritesheetAsset.ts by @huxinfeng in #9949
- Fix: stencil mask in webgpu by @GoodBoyDigital in #10004
- Fix: depthTexture not working by @GoodBoyDigital in #10005
- Fix: stop text warning when using detectRenderMode by @Zyie in #10051
- Fix: path.join incorrectly joining urls that contain periods (v8) by @Zyie in #10050
- Fix: displacement scale y not updating by @GoodBoyDigital in #10058
๐งน Chores
- Chore: update documentation header content for assets by @bbazukun123 in #9954
- Chore: enhance accessibility documentation by @achamas-playco in #9979
- Chore: reorder readme sections by @achamas-playco in #9973
- Chore: enhance app docs by @achamas-playco in #9980
- Chore: enhance assets documentation by @achamas-playco in #9984
- Chore: enhance color documentation by @achamas-playco in #9985
- Chore: enhance events documentation by @achamas-playco in #9987
- Chore: enhance extensions docs by @achamas-playco in #9990
- Chore: enhance filters documentation by @achamas-playco in #9991
- Chore: enhance maths documentation by @achamas-playco in #9992
- Chore: enhance rendering documentation by @achamas-playco in #9993
- Chore: enhance scene documentation by @achamas-playco in #9994
- Chore: enhance ticker documentation by @achamas-playco in #9995
- Chore: enhance utils documentation by @achamas-playco in #9996
- Chore: enhance environment documentation by @achamas-playco in #9986
- Chore: assign @memberof to all documented symbols by @achamas-playco in #9999
- Chore: add webgl1 visual tests by @achamas-playco in #10007
- Chore: remove redundant
addResource
by @GoodBoyDigital in #10015 - Chore: rename visual tests by @Zyie in #10042
- Chore: update dependencies by @Zyie in #10033
- Chore: remove ObjectPool and update docs by @Zyie in #10032
- Chore: strict null checks for extensions by @Zyie in #10056
- Chore: deprecate app.view by @Zyie in #10059
New Contributors
- @huxinfeng made their first contribution in #9949
Full Changelog: v8.0.0-rc...v8.0.0-rc.1