// Unity C# reference source // Copyright (c) Unity Technologies. For terms of use, see // https://unity3d.com/legal/licenses/Unity_Reference_Only_License using System; using System.Collections.Generic; using System.Collections.ObjectModel; using Unity.Profiling.Editor; using UnityEditor; using UnityEditor.Profiling; using UnityEngine; using System.Globalization; namespace UnityEditorInternal.Profiling { [Serializable] internal abstract class ProfilerModuleBase : ProfilerModule { protected List m_LegacyChartCounters; protected List m_LegacyDetailCounters; [SerializeField] protected Vector2 m_PaneScroll; // We cannot provide counters in the constructor for legacy modules. All concrete module types now use a parameterless constructor that invokes this base constructor, causing this to be called in serialization. Access to ProfilerDriver.GetGraphStatisticsPropertiesForArea is banned during (de)serialization, which is used by these modules to construct their counter lists. Therefore, we initialize with a null list and provide it later in Initialize(). protected ProfilerModuleBase(ProfilerModuleChartType defaultChartType = ProfilerModuleChartType.Line) : base(null, defaultChartType) {} internal override void LegacyModuleInitialize() { base.LegacyModuleInitialize(); // Construct legacy counter lists. m_LegacyChartCounters = CollectDefaultChartCounters(); if (m_LegacyChartCounters.Count > maximumNumberOfChartCounters) { throw new ArgumentException($"Chart counters cannot contain more than {maximumNumberOfChartCounters} counters."); } m_LegacyDetailCounters = CollectDefaultDetailCounters(); InternalUpdateBaseCountersAndAutoEnabledCategoryNames(); } public ReadOnlyCollection chartCounters => m_LegacyChartCounters.AsReadOnly(); public ReadOnlyCollection detailCounters => m_LegacyDetailCounters.AsReadOnly(); // Modules that use legacy stats override `usesCounters` to use the legacy GetGraphStatisticsPropertiesForArea functionality instead of Profiler Counters. public virtual bool usesCounters => true; private protected override string activeStatePreferenceKey { get { if (!string.IsNullOrEmpty(legacyPreferenceKey)) { // Use the legacy preference key to maintain user settings on built-in modules. return legacyPreferenceKey; } return base.activeStatePreferenceKey; } } int maximumNumberOfChartCounters { get => ChartModelBuilder.k_MaximumSeriesCount; } public virtual void DrawToolbar(Rect position) {} public virtual void DrawDetailsView(Rect position) {} public override ProfilerModuleViewController CreateDetailsViewController() { return new LegacyDetailsViewController(ProfilerWindow, this); } public void SetCounters(List chartCounters, List detailCounters) { if (chartCounters.Count > maximumNumberOfChartCounters) { throw new ArgumentException($"Chart counters cannot contain more than {maximumNumberOfChartCounters} counters."); } if (active) { // Release existing categories prior to updating counters. ProfilerWindow.SetCategoriesInUse(GetAutoEnabledCategoryNames, false); } // Capture each chart counter's enabled state prior to assignment. Dictionary counterEnabledStates = null; if (ChartModelBuilder != null) { counterEnabledStates = new Dictionary(); for (int i = 0; i < m_LegacyChartCounters.Count; ++i) { var counter = m_LegacyChartCounters[i]; var enabled = ChartModelBuilder.Model.series[i].enabled; counterEnabledStates.Add(counter, enabled); } } m_LegacyChartCounters = chartCounters; m_LegacyDetailCounters = detailCounters; InternalUpdateBaseCountersAndAutoEnabledCategoryNames(); if (ChartModelBuilder != null) Rebuild(); // Restore each chart counter's enabled state after assignment. if (counterEnabledStates != null && counterEnabledStates.Count > 0) { for (int i = 0; i < m_LegacyChartCounters.Count; ++i) { var counter = m_LegacyChartCounters[i]; bool enabled; if (!counterEnabledStates.TryGetValue(counter, out enabled)) { // A new counter is enabled by default. enabled = true; } ChartModelBuilder.Model.series[i].enabled = enabled; } } if (active) { // Retain new categories after updating counters. ProfilerWindow.SetCategoriesInUse(GetAutoEnabledCategoryNames, true); } } /// /// Override this method to customize the text displayed in the module's details view. /// protected virtual string GetDetailsViewText() { string detailsViewText = (usesCounters) ? ConstructTextSummaryFromDetailCounters() : ProfilerDriver.GetOverviewText(area, ProfilerWindow.GetActiveVisibleFrameIndex()); return detailsViewText; } /// /// Override this method to provide the module's default chart counters. Modules that define a ProfilerArea, and therefore use legacy stats instead of counters, do not need to override this method. /// protected virtual List CollectDefaultChartCounters() { var chartCounters = new List(); if (!usesCounters) { // Legacy modules can define ProfilerArea-based stats instead of counters. In that case, convert the area to a category name. var legacyStats = ProfilerDriver.GetGraphStatisticsPropertiesForArea(area); var categoryName = LegacyProfilerAreaUtility.ProfilerAreaToCategoryName(area); foreach (var legacyStatName in legacyStats) { var counter = new ProfilerCounterData() { m_Category = categoryName, m_Name = legacyStatName }; chartCounters.Add(counter); } } return chartCounters; } /// /// Override this method to provide the module's default detail counters. /// protected virtual List CollectDefaultDetailCounters() { return new List(); } protected void DrawEmptyToolbar() { EditorGUILayout.BeginHorizontal(EditorStyles.toolbar); GUILayout.FlexibleSpace(); EditorGUILayout.EndHorizontal(); } protected void DrawDetailsViewText(Rect position) { string activeText = GetDetailsViewText(); float height = EditorStyles.wordWrappedLabel.CalcHeight(GUIContent.Temp(activeText), position.width); m_PaneScroll = GUILayout.BeginScrollView(m_PaneScroll, ProfilerWindow.Styles.background); EditorGUILayout.SelectableLabel(activeText, EditorStyles.wordWrappedLabel, GUILayout.MinHeight(height)); GUILayout.EndScrollView(); } protected static long GetCounterValue(FrameDataView frameData, string name) { var id = frameData.GetMarkerId(name); if (id == FrameDataView.invalidMarkerId) return -1; return frameData.GetCounterValueAsLong(id); } protected static string GetCounterValueAsBytes(FrameDataView frameData, string name) { var id = frameData.GetMarkerId(name); if (id == FrameDataView.invalidMarkerId) return "N/A"; return EditorUtility.FormatBytes(frameData.GetCounterValueAsLong(id)); } protected static string GetCounterValueAsNumber(FrameDataView frameData, string name) { var id = frameData.GetMarkerId(name); if (id == FrameDataView.invalidMarkerId) return "N/A"; return FormatNumber(frameData.GetCounterValueAsLong(id)); } protected static string FormatNumber(long num) { if (num < 1000) return num.ToString(CultureInfo.InvariantCulture.NumberFormat); if (num < 1000000) return (num * 0.001).ToString("f1", CultureInfo.InvariantCulture.NumberFormat) + "k"; return (num * 0.000001).ToString("f1", CultureInfo.InvariantCulture.NumberFormat) + "M"; } string ConstructTextSummaryFromDetailCounters() { string detailsViewText = null; using (var rawFrameDataView = ProfilerDriver.GetRawFrameDataView(ProfilerWindow.GetActiveVisibleFrameIndex(), 0)) { if (rawFrameDataView.valid) { var stringBuilder = new System.Text.StringBuilder(); foreach (var counterData in m_LegacyDetailCounters) { var category = counterData.m_Category; var counter = counterData.m_Name; var counterValue = ProfilerDriver.GetFormattedCounterValue(rawFrameDataView.frameIndex, category, counter); stringBuilder.AppendLine($"{counter}: {counterValue}"); } detailsViewText = stringBuilder.ToString(); } } return detailsViewText; } public void SetNameAndUpdateAllPreferences(string name) { EditorPrefs.DeleteKey(activeStatePreferenceKey); EditorPrefs.DeleteKey(orderIndexPreferenceKey); SetName(name); SaveActiveState(); orderIndex = orderIndex; ChartModelBuilder.SetName(DisplayName); } // ProfilerModule (base class) does not publicly support changing the chart's counters - it expects it to remain constant. We can do this internally from ProfilerModuleBase as long as we also update the auto-enabled category names. void InternalUpdateBaseCountersAndAutoEnabledCategoryNames() { // Pass legacy counter lists to base module. InternalSetChartCounters(ProfilerCounterDataUtility.ConvertFromLegacyCounterDatas(m_LegacyChartCounters)); // Construct auto-enabled category names from chart and detail counters. var categories = new HashSet(); foreach (var chartCounter in chartCounters) { var categoryName = chartCounter.m_Category; categories.Add(categoryName); } foreach (var detailCounter in detailCounters) { var categoryName = detailCounter.m_Category; categories.Add(categoryName); } var autoEnabledCategoryNames = new string[categories.Count]; categories.CopyTo(autoEnabledCategoryNames); // Pass auto-enabled category names to base module. InternalSetAutoEnabledCategoryNames(autoEnabledCategoryNames); } } }