Release notes

Changelog #

Version 1.66.0 #

Migration guide #

Pixel Shader Changes

Changes to the Data_PS constant buffer data layout #

With the new release, our Pixel Shader (PS) Constant Buffer Data_PS has had its data layout altered to accommodate more flexible per command data storage. All custom shaders accessing elements from the CB will have to be modified to use the correct elements.

Previous constant buffer offsets usage example:

	int vs, ps, shaderType;
	decode(input.VaryingData, vs, ps, shaderType);
	// ps will point to the color that should be used for this pixel
	// ps + 1 will point to a float4 that contains other per command data
	float4 inColor = Data_PS[ps];
	float4 perCommandData = Data_PS[++ps];
	// perCommandData.w is the index of data used by several batched commands. The format
	// of this shared data is custom for every command type.
	int sharedCBOffset = int(perCommandData.w);

Current constant buffer offsets usage example:

	int vs, ps, shaderType;
	decode(input.VaryingData, vs, ps, shaderType);
	// ps will point to a float4 that contains the shared CB offset and some per command user data
	// ps + 1 will point to the color that should be used for this pixel
	float4 perCommandData = Data_PS[ps];
	float4 inColor = Data_PS[++ps];
	// perCommandData.x is the index of data used by several batched commands. The format
	// of this shared data is custom for every command type.
	int sharedCBOffset = int(perCommandData.x);

Below is a table, mapping the Pixel Shader CB elements' previous and new location inside the Data_PS CB along with their usage:

The SHARED_PS_DATA_OFFSET, which was used to calculate the offset of the AA Clipping data, will now be used to find the initial per batch data(containing the shouldClip, additional flags and the color matrix offset), while a new offset called SHARED_PS_AA_CLIPPING_DATA_OFFSET will be used for the original purpose.

Before:

/* CohClipMasking.ihlsl */
#define SHARED_PS_DATA_OFFSET -1

Now:

/* CohCommonPS.ihlsl */
#define SHARED_PS_DATA_OFFSET -1
#define SHARED_PS_AA_CLIPPING_DATA_OFFSET -2