diff --git a/docs/user-manual/editor/editor-migrations.md b/docs/user-manual/editor/editor-migrations.md new file mode 100644 index 0000000000..f5deaf23b5 --- /dev/null +++ b/docs/user-manual/editor/editor-migrations.md @@ -0,0 +1,34 @@ +--- +title: Editor Migrations +sidebar_position: 13 +--- + +## Introduction + +This page outlines the migrations of data between different editor versions. + +### Migration from 1.48.0 to 1.50.0 + +This Editor has been updated to now use Engine V2 internally. This change may cause some small visual changes for some projects. We have collated a list of the most common issues and how to fix them. + +#### Cubemap edge filtering + + + +If your cubemap skybox has pronounced edges such as this example above, navigate to your cubemap asset and delete and regenerate the prefiltered data to remove them. + + + +#### Gamma Correction + + + +If you have a project with gamma correction set to 1.0, your scene may appear more saturated such as the example above (new editor on the right). Under the rendering settings, change your gamma correction to 2.2 to achieve a similar effect as before. + +:::note + +Your scene will be rendered with the more correct linear workflow. However, there will be slight visual changes related to lighting and alpha blending. + +::: + + diff --git a/docs/user-manual/editor/engine-compatibility.md b/docs/user-manual/editor/engine-compatibility.md new file mode 100644 index 0000000000..41dd2e8cfe --- /dev/null +++ b/docs/user-manual/editor/engine-compatibility.md @@ -0,0 +1,61 @@ +--- +title: Engine Compatibility +sidebar_position: 12 +--- + +## Introduction + +The Editor supports two major release streams of the engine: + +- The latest release of engine v1.x.x (**Engine V1**) + - This supports WebGL1 and WebGL2, and receives critical bug fixes. It does not receive any new features. +- The latest release of engine v2.x.x (**Engine V2**) + - This supports WebGL2 and WebGPU but not WebGL1 for rendering. It receives both new features and fixes. + +You are free to switch between these at any time. + +### Switching projects between Engine V1 and V2 + +This process will involve migration and updating of scripts given differences in our Engine API between Engine V1 and V2. All details regarding the engine changes can be found [here](/user-manual/engine/migrations) + +To initiate this navigate to the settings panel and click the `SWITCH TO ENGINE V2` button to convert your project to using Engine V2 (This will require a confirmation before converting). If you wish to switch back, there is a `SWITCH TO ENGINE V1` button in the same location for Project V2. + +> **Note:** Once the switch has been confirmed **all users** in the current project will be reloaded. + + + +#### Scripting + +Given the changes in API for the engine you may wish to test your project in the launcher with Engine V1 or V2. You can do this by enabling the Force Engine V2 or Force Engine V1 checkboxes in the launcher options: + + + +Additionally, conditionally checking the Engine version at runtime will allow your script to be made compatible with both versions of the engine during the transition time. + + + +#### Gamma and Tonemap + +These settings were previously found under the rendering section of the Settings panel. However, in Engine V2, these have been moved to be set per camera. Each camera component will now have these additional fields: + + + +The viewport settings are now located inside the EDITOR section of the Settings panel: + + + +:::note + +If you change the settings per camera and switch back to Project V1, your per-camera settings will be lost. + +::: + +#### sRGB Textures + + + +For Engine V2, textures must be set as sRGB or not, depending on their use case. The textures that store color data, such as diffuse and emissive maps, should use sRGB for accurate color representation. This is found under the texture asset panel as shown above. These will be automatically set. However, if there are conflicts, the console will display them: + + + +Click on the console message to open up the conflicting reference. If you wish to use the same texture for both sRGB and not, it is advised to duplicate your texture to cover both cases. diff --git a/static/img/user-manual/editor/editor-v2/console-texture.png b/static/img/user-manual/editor/editor-v2/console-texture.png new file mode 100644 index 0000000000..0528db199b Binary files /dev/null and b/static/img/user-manual/editor/editor-v2/console-texture.png differ diff --git a/static/img/user-manual/editor/editor-v2/edge-filter.png b/static/img/user-manual/editor/editor-v2/edge-filter.png new file mode 100644 index 0000000000..241b4bd674 Binary files /dev/null and b/static/img/user-manual/editor/editor-v2/edge-filter.png differ diff --git a/static/img/user-manual/editor/editor-v2/gamma-compare.png b/static/img/user-manual/editor/editor-v2/gamma-compare.png new file mode 100644 index 0000000000..e616d14c97 Binary files /dev/null and b/static/img/user-manual/editor/editor-v2/gamma-compare.png differ diff --git a/static/img/user-manual/editor/editor-v2/gamma-tonemap-settings.png b/static/img/user-manual/editor/editor-v2/gamma-tonemap-settings.png new file mode 100644 index 0000000000..5e46b566ff Binary files /dev/null and b/static/img/user-manual/editor/editor-v2/gamma-tonemap-settings.png differ diff --git a/static/img/user-manual/editor/editor-v2/gamma-tonemap.png b/static/img/user-manual/editor/editor-v2/gamma-tonemap.png new file mode 100644 index 0000000000..94db3ac132 Binary files /dev/null and b/static/img/user-manual/editor/editor-v2/gamma-tonemap.png differ diff --git a/static/img/user-manual/editor/editor-v2/launcher-options.png b/static/img/user-manual/editor/editor-v2/launcher-options.png new file mode 100644 index 0000000000..fa5df3f083 Binary files /dev/null and b/static/img/user-manual/editor/editor-v2/launcher-options.png differ diff --git a/static/img/user-manual/editor/editor-v2/prefiltered-data.png b/static/img/user-manual/editor/editor-v2/prefiltered-data.png new file mode 100644 index 0000000000..b6d548f291 Binary files /dev/null and b/static/img/user-manual/editor/editor-v2/prefiltered-data.png differ diff --git a/static/img/user-manual/editor/editor-v2/scripting-engine.png b/static/img/user-manual/editor/editor-v2/scripting-engine.png new file mode 100644 index 0000000000..718dde46b9 Binary files /dev/null and b/static/img/user-manual/editor/editor-v2/scripting-engine.png differ diff --git a/static/img/user-manual/editor/editor-v2/srgb-texture.png b/static/img/user-manual/editor/editor-v2/srgb-texture.png new file mode 100644 index 0000000000..4482f8ddcf Binary files /dev/null and b/static/img/user-manual/editor/editor-v2/srgb-texture.png differ diff --git a/static/img/user-manual/editor/editor-v2/switch-engine.png b/static/img/user-manual/editor/editor-v2/switch-engine.png new file mode 100644 index 0000000000..2fa61eacc2 Binary files /dev/null and b/static/img/user-manual/editor/editor-v2/switch-engine.png differ diff --git a/static/img/user-manual/editor/editor-v2/viewport-camera.png b/static/img/user-manual/editor/editor-v2/viewport-camera.png new file mode 100644 index 0000000000..a189570473 Binary files /dev/null and b/static/img/user-manual/editor/editor-v2/viewport-camera.png differ