Changelog

All notable changes to this package will be documented in this file.

The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

[7.9.0-exp.1] - 2022-05-18

  • Added SRP Test Scene Asset. Which allows users to add scenes combined with SRP Assets. So that we can test 1 scene with several different SRP's.

[7.8.23-exp.2] - 2022-04-21

  • Added support for parametric CodeBasedGraphicsTests.
  • Added support for Playmode CodeBasedGraphicsTests.
  • Made Graphics Test Results window TreeView scrollable
  • Added compatibility between CodeBasedGraphicsTests and the ReferenceImagesBase folder

[7.8.23-exp.1] - 2022-04-11

  • Added support for new PS5 GraphicsDeviceType.

[7.8.22-exp.2] - 2022-04-06

  • Added UNITY_TESTS_FRAMEWORK defines for the package assemblies so they can be referred by test projects without adding to the testables section of the manifest.json file.

[7.8.22-exp.1] - 2022-04-04

  • Reworked CaptureSceneView to use the back-buffer instead of a screenshot.

[7.8.21-exp.2] - 2022-04-04

  • Fixed the issue in ImageAssert.cs with running the optimization for reference images.
  • Fixed the issue in the optimization implementation.

[7.8.21-exp.1] - 2022-03-22

  • Added CodeBasedGraphicsTestAttribute which allows a unit test to be marked as a graphics test, and root paths of reference images and actual images to be specified.
  • Added UnityEditor.TestTools.Graphics.EditorUtils class which provides a few utility functions. Please refer to the documentation page.
  • Added UnityEngine.TestTools.Graphics.TestUtils class which provides utility functions for generating test result folder path based on give test configurations.
  • Changed GraphicsTestCase class now provides new properties returning the test name and the CodeBasedGraphicsTestAttribute for unit test based graphics tests.

[7.8.20-exp.1] - 2022-03-21

  • Add Optimization feature available for reference images.

[7.8.19-exp.2] - 2022-02-16

  • Allow custom scene views as input to CaptureSceneView.

[7.8.19-exp.1] - 2022-02-16

  • Add the CaptureSceneView class that enables scene view graphics tests.

[7.8.18-exp.1] - 2022-02-15

  • Updated xbox references to reflect enum changes in the editor.

[7.8.17-exp.3] - 2022-02-07

  • Updated nuget.newtonsoft-json and xr.legacyinputhelpers dependencies.

[7.8.17-exp.2] - 2022-01-28

  • Fixed a missing clear in UTR framework in order to make Gamecore pass correctly the Graphic Compositor test.

[7.8.17-exp.1] - 2021-11-18

  • Add support for tests on Apple Silicon (M1) devices.
  • Moves reference images for M1 macs under OSXPlayer_AppleSilicon and OSXEditor_AppleSilicon.
  • Leaves reference image paths for Intel macs untouched (they remain under OSXPlayer and OSXEditor).

[7.8.16-preview] - 2021-08-06

  • Fixed an issue where the framework would build asset bundles for standalone when running in the editor, when using 1.2 version of Unity Test Framework package.

[7.8.15-preview] - 2021-07-29

  • Add [RequiresPlayMode] tags to the tests intended for PlayMode, allowing them to still run in PlayMode in the newest UTF versions.
  • Change the logic in SetupGraphicsTestCases to draw the targetPlatform from the settings directly, rather than from the filter.

[7.8.14-preview] - 2021-07-23

  • Add "GlobalResolutionSetter" component that lets you set different device resolution per platform

[7.8.12-preview] - 2021-05-26

  • Fix issue with test filter and XR reusable tests

[7.8.11-preview] - 2021-05-11

  • Bump com.unity.xr.management from 3.2.15 to 4.0.5

[7.8.10-preview] - 2021-04-26

  • Make StripParametricTestCharacters replace "," with "-".
  • Make StripParametricTestCharacters replace "(" with "_".
  • Make StripParametricTestCharacters replace ")" with "_".

[7.8.9-preview] - 2021-04-23

  • Make StripParametricTestCharacters replace "," with "_".

[7.8.8-preview] - 2021-04-08

  • Reenable AreEqual_WidthDifferentSizeImages_ThrowsAssertionException (was removed in 7.8.2-preview)
  • Bump com.unity.addressables from 1.16.15 to 1.17.15

[7.8.7-preview] - 2021-03-10

  • Remove BlackBerry player support.
  • Don't clear the GICache on every bake.

[7.8.6-preview] - 2020-03-08

  • Fix typo in GC Alloc messages
  • Remove unused code
  • Fix for undeterministic RuntimePlatform -> string conversion

[7.8.5-preview] - 2020-02-18

  • Fix buildOptions error
  • Avoid RenderTexture usage for GC tests when possible

[7.8.4-preview] - 2020-02-10

  • More build options in ApplySettings

[7.8.3-preview] - 2021-02-03

  • Add support for new console platforms
  • Fixes for the CHANGELOG.md validation
  • NDA platform validator configuration added

[7.8.2-preview] - 2021-01-29

  • Disable AreEqual_WidthDifferentSizeImages_ThrowsAssertionException

[7.8.1-preview] - 2021-01-28

  • Test filter sort now uses stable sorting with additional properties

[7.8.0-preview] - 2021-01-07

  • Reference dependencies needed for isolation testing

[7.7.1-preview] - 2020-11-30

  • Add support for new GraphicsDeviceTypes

[7.7.0-preview] - 2020-11-16

  • Add support for XR reusable tests

[7.6.0-preview] - 2020-11-04

  • Add SetupProject class

[7.5.1-preview] - 2020-10-07

  • Update SetupGraphicsTestCases.cs to support "Player Build: BuildConfiguration" setting for Hybrid scenes

[7.5.0-preview] - 2020-09-24

  • Bump XR Management version from 3.0.6 to 3.2.15

[7.4.1-preview] - 2020-09-09

  • Disabled ImageAssertTests.PerPixelTest on device to avoid issues with TestCaseSource.

[7.4.0-preview] - 2020-08-27

  • Added the ability to test the number of incorrect pixels against a set ratio.
  • Added the ability to test the sRGB-encoded color channels against a threshold.
  • Added the ability to test the alpha channel against a threshold.

[7.3.0-preview] - 2020-07-09

  • Added optional callback on ImageAssert triggered after all cameras are rendered.

[7.2.3-preview] - 2020-07-06

  • Enable multiple scenes per test filter and clean up UI a bit.
  • Fixes a memory allocation in the Profiler.Get function that was counted as memory allocation in the render loop of SRP.

[7.2.2-preview] - 2020-06-08

  • Wrap built in xr checks in 2020_2_OR_NEWER due to built in xr deprecation in 2020.2 and higher.
  • Test filter fixes for multiple matching filters

[7.2.1-preview] - 2020-05-01

  • Backwards compatibility to 2019.3

[7.2.0-preview] - 2020-04-30

  • Add the option for tests to use the back buffer instead of rendering to a render texture first
  • Fix LoadedXRDevice to use XR SDK first

[7.1.13-preview] - 2020-04-06

  • Update reference versions of json and utp

[7.1.12-preview] - 2020-03-24

  • Bug fix for where all scenes would be baked when only one was selected.
  • Bug fix for Xbox where tests would fail due to XR APIs

[7.1.11-preview] - 2020-03-20

  • Fix for OSX Metal automation

[7.1.10-preview] - 2020-03-20

  • Add build targets for DX12 and OSX Metal

[7.1.9-preview] - 2010-03-19

  • Use Standalone XR settings for Editor play mode XR

[7.1.8-preview] - 2020-03-18

  • Fix Test Result Window

[7.1.7-preview] - 2020-03-17

  • Change MockHMD folder to None for playmode

[7.1.6-preview] - 2020-03-16

  • Improved messaging in GC Alloc
  • Test filters no longer override disabled tests in build settings
  • Adds a check so if vr is supported and that array is empty, set xrsdk to MockHMD

[7.1.5-preview] - 2020-02-14

  • Fixing issues where Standalone tests wouldn't work for some projects

[7.1.4-preview] - 2020-02-13

  • Adding GC Alloc changes for HDRP

[7.1.3-preview] - 2019-11-25

  • Updating dependency names

[7.1.2-preview] - 2019-11-04

  • Adding com.unity.nuget.test-protocol and com.unity.newtonsoft-json as dependencies

[7.1.1-preview] - 2019-09-23

  • Adding script for testing with different Graphics APIs

[7.1.0-preview] - 2019-09-09

  • Separated Graphics Test Framework into its own repository

[6.6.0] - 2019-04-01

[6.5.0] - 2019-03-07

[6.4.0] - 2019-02-21

[6.3.0] - 2019-02-18

[6.2.0] - 2019-02-15

[6.1.0] - 2019-02-13

[6.0.0] - 2019-02-23

[5.2.0] - 2018-11-27

[5.1.0] - 2018-11-18

[5.0.0-preview] - 2018-09-28

[4.0.0-preview] - 2019-09-21

[3.3.0] - 2018-08-03

[3.2.0] - 2018-07-30

[3.1.0] - 2018-07-26

[0.1.0] - 2018-05-04

This is the first release of Unity Package com.unity.testframework.graphics.

  • ImageAssert for comparing images
  • Automatic management of reference images and test case generation