Merge pull request #8073 from Unity-Technologies/internal/master

Internal/master

Author: UnityAljosha

Packages/com.unity.render-pipelines.core/Documentation~/Images/Preferences/AdvancedProperties_Settings.png

@@ -89,3 +89,7 @@ public class StandardRenderRequest : MonoBehaviour
 }
 ```
 
+## Other useful information
+
+- On [Universal Render Pipeline (URP)](https://docs.unity3d.com/Packages/com.unity.render-pipelines.universal@latest/User-Render-Requests.html).
+

Packages/com.unity.render-pipelines.core/Documentation~/Images/Preferences/HDRP_WaterSurface_General.png

@@ -0,0 +1,36 @@
+# Advanced Properties
+
+Unity Render Pipelines components expose standard properties by default that are suitable for most use-cases.
+However, there are components and Volume Overrides that include **advanced properties** which you can use to fine-tune the behavior of the component.
+
+There is a global state per user that stores if Unity displays **advanced properties** or not. 
+
+## Exposing advanced properties within the inspector
+
+Not every component or Volume Override includes advanced properties.
+If one does, it has a contextual menu to the right of each property section header that includes additional properties. To expose advanced properties for that section, open the contextual menu and click **Advanced Properties**.
+
+For an example, see the **Water Surface** component in [High Definition Render Pipeline (HDRP)](https://docs.unity3d.com/Packages/com.unity.render-pipelines.high-definition@latest).
+
+By default only standard properties are shown.
+
+![](Images/Preferences/HDRP_WaterSurface_General.png)
+
+When you select **Advanced Properties**:
+
+![](Images/Preferences/PopUpAdvanced.png)
+
+**Advanced Properties** become visible:
+
+![](Images/Preferences/HDRP_WaterSurface_General_Visible.png)
+
+For Volume Overrides, the already existing contextual menu has a **Advanced Properties** toggle as well.
+
+## Exposing advanced properties on preferences
+
+You can also access to this global preference by:
+
+1. Open the **Graphics** tab in the **Preferences** window (menu: **Edit > Preferences > Graphics**).
+2. Under **Properties**. Set **Advanced Properties** to **All Visible**.
+
+![](Images/Preferences/AdvancedProperties_Settings.png)

Packages/com.unity.render-pipelines.core/Documentation~/Images/Preferences/HDRP_WaterSurface_General_Visible.png

@@ -180,20 +180,12 @@ void IDrawer.Draw(TData data, Editor owner)
                 if (m_Enabler != null && !m_Enabler(data, owner))
                     return;
 
-                if (m_Anim != null)
-                    CoreEditorUtils.BeginAdditionalPropertiesHighlight(m_Anim);
-
-                for (var i = 0; i < m_ActionDrawers.Length; i++)
-                    m_ActionDrawers[i](data, owner);
-
-                if (m_Anim != null)
+                if (AdvancedProperties.BeginGroup(m_Anim))
                 {
-                    CoreEditorUtils.EndAdditionalPropertiesHighlight();
-
-                    // While the highlight is being changed, force the Repaint of the editor
-                    if (m_Anim.value > 0.0f)
-                        owner?.Repaint();
+                    for (var i = 0; i < m_ActionDrawers.Length; i++)
+                        m_ActionDrawers[i](data, owner);
                 }
+                AdvancedProperties.EndGroup();
             }
 
             bool IDrawer.Expand(int mask) => DefaultExpand(m_ActionDrawers, mask);
@@ -888,6 +880,7 @@ public static IDrawer AdditionalPropertiesFoldoutGroup<TEnum, TAPEnum>(GUIConten
             where TEnum : struct, IConvertible
             where TAPEnum : struct, IConvertible
         {
+            additionalContent ??= Group((s, o) => { });
             return AdditionalPropertiesFoldoutGroup(foldoutTitle, foldoutMask, foldoutState, additionalPropertiesMask, additionalPropertiesState, normalContent.Draw, additionalContent.Draw, options, customMenuContextAction, otherDocumentation);
         }
 
@@ -972,7 +965,10 @@ void SwitchEnabler(TData data, Editor owner)
 
             return FoldoutGroup(foldoutTitle, foldoutMask, foldoutState, options, customMenuContextAction, Enabler, SwitchEnabler,
                 otherDocumentation, normalContent,
-                ConditionalWithAdditionalProperties((serialized, owner) => additionalPropertiesState[additionalPropertiesMask] && foldoutState[foldoutMask], additionalPropertiesState.GetAnimation(additionalPropertiesMask), additionalContent).Draw
+                ConditionalWithAdditionalProperties(
+                    (serialized, owner) => additionalPropertiesState[additionalPropertiesMask] && foldoutState[foldoutMask],
+                    AdvancedProperties.s_AnimFloat,
+                    additionalContent).Draw
             );
         }
     }

Packages/com.unity.render-pipelines.core/Documentation~/Images/Preferences/PopUpAdvanced.png

@@ -822,14 +822,14 @@ static Action<Vector2> CreateMenuContextAction(Action<Vector2> contextAction, Fu
         {
             if (contextAction == null && (hasMoreOptions != null || customMenuContextAction != null))
             {
-                // If no contextual menu add one for the additional properties.
+                // If no contextual menu add one for the advanced properties.
                 contextAction = pos =>
                 {
                     var menu = new GenericMenu();
                     if (customMenuContextAction != null)
                         customMenuContextAction(menu);
                     if (hasMoreOptions != null)
-                        AddAdditionalPropertiesContext(menu, hasMoreOptions, toggleMoreOptions);
+                        menu.AddAdvancedPropertiesBoolMenuItem(hasMoreOptions, toggleMoreOptions);
                     menu.DropDown(new Rect(pos, Vector2.zero));
                 };
             }
@@ -877,12 +877,6 @@ static void ShowHelpButton(Rect contextMenuRect, string documentationURL, GUICon
                 Help.BrowseURL(documentationURL);
         }
 
-        static void AddAdditionalPropertiesContext(GenericMenu menu, Func<bool> hasMoreOptions, Action toggleMoreOptions)
-        {
-            menu.AddItem(EditorGUIUtility.TrTextContent("Show Additional Properties"), hasMoreOptions.Invoke(), () => toggleMoreOptions.Invoke());
-            menu.AddItem(EditorGUIUtility.TrTextContent("Show All Additional Properties..."), false, () => CoreRenderPipelinePreferences.Open());
-        }
-
         /// <summary>
         /// Draw a Color Field but convert the color to gamma space before displaying it in the shader.
         /// Using SetColor on a material does the conversion, but setting the color as vector3 in a constant buffer doesn't
@@ -1387,19 +1381,6 @@ internal static void TryToFixFilterMode(float pixelsPerPoint, Texture2D icon)
 
         #endregion
 
-        internal static void BeginAdditionalPropertiesHighlight(AnimFloat animation)
-        {
-            var oldColor = GUI.color;
-            GUI.color = Color.Lerp(CoreEditorStyles.backgroundColor * oldColor, CoreEditorStyles.backgroundHighlightColor, animation.value);
-            EditorGUILayout.BeginVertical(CoreEditorStyles.additionalPropertiesHighlightStyle);
-            GUI.color = oldColor;
-        }
-
-        internal static void EndAdditionalPropertiesHighlight()
-        {
-            EditorGUILayout.EndVertical();
-        }
-
         internal static T CreateAssetAt<T>(Scene scene, string targetName) where T : ScriptableObject
         {
             string path;

Packages/com.unity.render-pipelines.core/Documentation~/User-Render-Requests.md

@@ -1,6 +1,7 @@
 using System;
 using System.Collections.Generic;
 using System.Reflection;
+using UnityEngine.Rendering;
 
 namespace UnityEditor.Rendering
 {
@@ -12,7 +13,7 @@ public static class CoreRenderPipelinePreferences
         /// <summary>
         /// Path to the Render Pipeline Preferences
         /// </summary>
-        public static readonly string corePreferencePath = "Preferences/Core Render Pipeline";
+        public static readonly string corePreferencePath = "Preferences/Graphics";
 
         private static readonly List<ICoreRenderPipelinePreferencesProvider> s_Providers = new();
 
@@ -25,6 +26,14 @@ static void InitPreferenceProviders()
                     continue;
                 s_Providers.Add(Activator.CreateInstance(provider) as ICoreRenderPipelinePreferencesProvider);
             }
+
+            s_Providers.Sort((x, y) => GetDisplayInfoOrder(x.GetType()).CompareTo(GetDisplayInfoOrder(y.GetType())));
+        }
+
+        static int GetDisplayInfoOrder(Type type)
+        {
+            var attribute = type.GetCustomAttribute<DisplayInfoAttribute>();
+            return attribute?.order ?? int.MaxValue;
         }
 
         [SettingsProvider]
@@ -38,8 +47,11 @@ static SettingsProvider PreferenceGUI()
                     {
                         foreach (var providers in s_Providers)
                         {
-                            EditorGUILayout.LabelField(providers.header, EditorStyles.boldLabel);
-                            providers.PreferenceGUI();
+                            if (providers.header != null)
+                            {
+                                EditorGUILayout.LabelField(providers.header, EditorStyles.boldLabel);
+                                providers.PreferenceGUI();
+                            }
                         }
                     }
                 }