Release notes

What’s new #

Content Development #

Player CLI improvements

The Player command line arguments have had a complete overhaul. They now support several new things:

• Viewing all command line arguments through --help.
• A lot of previously hidden command line arguments have been made public.
• All player command line arguments can now be set through a config file, using toml syntax.
• All command line arguments are now more flexible in terms of syntax, for example accepting --arg value, --arg=value, --arg="value", etc.

WebP images support

Prysm can now load and use images with WebP format. The support is limited to simple images without filters and animations.

Unreal Engine #

Custom Effects feature support for UMG Widgets

The Custom Effects feature can now be used with UMG Widgets, which includes both HUD Widgets, and Widgets attached to an Actor as a component.

Multi Touch support for UMG Widgets

The MultiTouchEventsHandling option of the UMG Widgets indicates whether Touch events (Touch Down, Touch Move and Touch Up) should be gathered and handled by the UI together at the end of the Input frame or separately - one by one.

Please note that Multi Touch events handling will have a side effect on the input propagation as we can no longer check whether the UI handles every single touch or not, because events are processed later in bulk.

Migration guide #

Pixel Shader Changes

Changes in shaders #

If you rely on custom shaders, the pixel shader additional flags in CohCommonPS.ihlsl should be updated with the following new values:

static const int PSAF_GammaTextureSpace_0 = 0x10;
static const int PSAF_GammaTextureSpace_1 = 0x20;

The newly introduced flags PSAF_GammaTextureSpace_0 and PSAF_GammaTextureSpace_1 specify whether the shader should manually perform a Linear-to-sRGB color space conversion for texture slots txBuffer and txBuffer1, respectively. This conversion is intended to be applied after sampling textures that store color information, rather than non-color data such as signed distance fields. For example:

float4 source = SAMPLE2D(txBuffer, input.Additional.xy);
if (IS_SET(int(perCommandData.y), PSAF_GammaTextureSpace_0))
{
    source.rgb = LinearToSRGB(source.rgb);
}
...
float4 source1 = SAMPLE2D(txBuffer1, input.Additional.xy);
if (IS_SET(int(perCommandData.y), PSAF_GammaTextureSpace_1))
{
    source1.rgb = LinearToSRGB(source1.rgb);
}

Player CLI improvements

The Player config file is now in toml format (previously json) and all command line arguments are now configurable through it (previously, only coui-root and fonts were configurable). The Player’s default Config file is already converted to the new format and does not require changes. However, if you had any custom changes to your Config file, they would need to be ported to the new toml syntax.

An example on how to use the new coui-root and font registration, see the Player’s provided Config file, which can be found at <package_root>/Player/Config.toml.

Separating Mobile and PC packages

Introducing new Mobile packages #

We’ve removed the Android and iOS libraries and samples from the common packaging, thus significantly reducing the size of the Prysm PC packages.

By splitting them into a separate Mobile package, we make sure you can download only what you need. From now on, you can treat the new Mobile packages in the same way you treat the console packages.

This is done for all of our package types, namely:

• Native fragments
• Unity 3D UPM packages
• Unreal Engine zips and installers

Changelog #

Version 1.67.0 #