We're in full flow on the path to the final release of Phaser v4. After all of the changes and fixes that landed in Beta 8 today we published Release Candidate 1. This version is special in that not only does it include all the latest fixes, but it also fully syncs all of the 'main' branch changes from Phaser v3.88 as well, making it completely up to date. Hence, the switch to 'Release Candidate' rather than Beta.

Here are the changes in this version:

Changes

  • Mask filter now uses current camera by default.
  • GameObject#enableLighting now works even if the scene light manager is not enabled. The light manager must still be enabled for lights to render, but the game object flag can be set at any time.
  • YieldContext and RebindContext render nodes now unbind all texture units. These nodes are used for external renderer compatibility. An external renderer could change texture bindings, leading to unexpected textures being used, so we force texture rebind.

New Features

  • WebGLSnapshot (used in snapshot functions) supports unpremultiplication, which is on by default. This removes dark fringes on text and objects with alpha.
  • Add chainable setter methods to Filter component: setFiltersAutoFocus, setFiltersFocusContext, setFiltersForceComposite, setRenderFilters.
  • All enhancements from Phaser v3 development have been merged. This includes:
    • Transform#getWorldPoint
    • Layer#getDisplayList
    • DynamicTexture and RenderTexture changes:
    • forceEven parameter forces resolution to be divisible by 2.
    • clear(x, y, width, height) method now takes the listed optional parameters.
    • Rectangle now supports rounded corners.
    • Physics.Matter.Components.Transform#scale for setting scaleX and scaleY together.
    • WebGLRenderer reveals functions around context loss:
    • setExtensions
    • setContextHandlers
    • dispatchContextLost
    • dispatchContextRestored
    • Improvements to tile handling for non-orthogonal tiles.
    • Tween#isNumberTween
    • Many other fixes and tweaks.

Fixes

  • Fix WebGLSnapshot orientation.
  • Fix filters rendering outside intended camera scissor area.
  • Fix reversion in BitmapText kerning.
  • Fix CaptureFrame compatibility with Layer and Container.
  • Fix Grid using old methods. It was supposed to use 'stroke' just like other Shape objects, not a unique 'outline'.
  • Add @return tag to FilterList#addBlend (thanks @phasereditor2d!).
  • Fix RenderSteps parameter propagation into Layer and Container. This resolves some missing render operations in complex situations.
  • Fix DynamicTexture errors when rendering Masks.
  • Fix camera transform matrix order issues, as seen when rendering through transformed cameras.
  • Fix GL scissor sometimes failing to update. The actual issue was, we were storing the screen coordinates, but applying GL coordinates, which can be different in different-sized framebuffers. DrawingContext now takes screen coordinates, and sets GL coordinates in the WebGLGlobalWrapper.

You can test v4 RC1 now in the Phaser Sandbox, or download it from GitHub or npm using the beta tag.

Download Phaser v4 RC1