ui: add custom range option to counter track display menu

Adds a 'Custom Range' mode to the counter track's Display submenu,
letting users specify exact min/max values for the Y axis. This is
useful when comparing counter tracks across different trace files,
where using the same fixed range makes values directly comparable.

When 'Custom Range' is selected, two numeric text inputs appear
inline in the submenu for min and max. Either field can be left
blank to fall back to the data-derived bound for that side. Rounding
is skipped for custom ranges to honour the user-specified values.
A yMax <= yMin guard prevents division-by-zero in the renderer.

Fixes: #4441

Author: Vikx001

ui/src/assets/components/base_counter_track.scss

@@ -0,0 +1,36 @@
+// Copyright (C) 2025 The Android Open Source Project
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+@import "../theme";
+
+.pf-counter-track {
+  &__custom-range {
+    display: flex;
+    align-items: center;
+    gap: 4px;
+    padding: 4px 8px;
+    font-family: var(--pf-font-compact);
+    font-size: var(--pf-font-size-m);
+
+    // Number inputs should be narrow so they fit alongside the labels.
+    .pf-text-input {
+      width: 64px;
+    }
+  }
+
+  &__custom-range-label {
+    color: var(--pf-color-text-muted);
+    white-space: nowrap;
+  }
+}

ui/src/assets/perfetto.scss

@@ -29,6 +29,7 @@
 
 // Widgets/components - keep these sorted alphabetically
 @import "components/aggregation_adapter";
+@import "components/base_counter_track";
 @import "components/datagrid";
 @import "components/json_settings_editor";
 @import "components/pivot_table";

ui/src/components/tracks/base_counter_track.ts

@@ -31,6 +31,7 @@ import {
 import {LONG, NUM} from '../../trace_processor/query_result';
 import {Button} from '../../widgets/button';
 import {MenuDivider, MenuItem, PopupMenu} from '../../widgets/menu';
+import {TextInput} from '../../widgets/text_input';
 import {checkerboardExcept} from '../checkerboard';
 import {valueIfAllEqual} from '../../base/array_utils';
 import {deferChunkedTask} from '../../base/chunked_task';
@@ -208,13 +209,20 @@ export interface CounterOptions {
   // zero = y-axis scale should cover the origin (zero)
   // minmax = y-axis scale should cover just the range of yRange
   // log = as minmax but also use a log scale
-  yDisplay: 'zero' | 'minmax' | 'log';
+  // custom = use yCustomMin/yCustomMax as the explicit bounds
+  yDisplay: 'zero' | 'minmax' | 'log' | 'custom';
 
   // Whether the range boundaries should be strict and use the precise min/max
   // values or whether they should be rounded down/up to the nearest human
   // readable value.
   yRangeRounding: 'strict' | 'human_readable';
 
+  // When yDisplay is 'custom', use these exact values as the y-axis min/max
+  // instead of deriving them from the data. Either can be undefined to fall
+  // back to the data-derived bound.
+  yCustomMin?: number;
+  yCustomMax?: number;
+
   // Scales the height of the chart.
   chartHeightSize: ChartHeightSize;
 
@@ -248,7 +256,7 @@ type yMode = z.infer<typeof ymodeSchema>;
 const yRangeSchema = z.union([z.literal('all'), z.literal('viewport')]);
 type YRange = z.infer<typeof yRangeSchema>;
 
-const yDisplaySchema = z.enum(['zero', 'minmax', 'log']);
+const yDisplaySchema = z.enum(['zero', 'minmax', 'log', 'custom']);
 type YDisplay = z.infer<typeof yDisplaySchema>;
 
 const yRangeRoundingSchema = z.union([
@@ -335,7 +343,7 @@ const yRangeSettingDescriptor: TrackSettingDescriptor<YRange> = {
 const yDisplaySettingDescriptor: TrackSettingDescriptor<YDisplay> = {
   id: 'yDisplay',
   name: 'Y-axis display',
-  description: 'zero, minmax, log',
+  description: 'zero, minmax, log, custom',
   schema: yDisplaySchema,
   defaultValue: 'zero',
   render(setter, values) {
@@ -356,6 +364,11 @@ const yDisplaySettingDescriptor: TrackSettingDescriptor<YDisplay> = {
         onclick: () => setter('log'),
         icon: value === 'log' ? radioIconChecked : radioIconUnchecked,
       }),
+      m(MenuItem, {
+        label: 'Custom Range',
+        onclick: () => setter('custom'),
+        icon: value === 'custom' ? radioIconChecked : radioIconUnchecked,
+      }),
     ]);
   },
 };
@@ -581,8 +594,46 @@ export abstract class BaseCounterTrack implements TrackRenderer {
             this.invalidate();
           },
         }),
+
+        m(MenuItem, {
+          label: 'Custom Range',
+          icon:
+            options.yDisplay === 'custom'
+              ? 'radio_button_checked'
+              : 'radio_button_unchecked',
+          onclick: () => {
+            options.yDisplay = 'custom';
+            this.invalidate();
+          },
+        }),
       ),
 
+      options.yDisplay === 'custom' &&
+        m('.pf-counter-track__custom-range', [
+          m('span.pf-counter-track__custom-range-label', 'Min'),
+          m(TextInput, {
+            type: 'number',
+            placeholder: 'auto',
+            value: options.yCustomMin ?? '',
+            onInput: (v) => {
+              const parsed = parseFloat(v);
+              options.yCustomMin = isNaN(parsed) ? undefined : parsed;
+              this.invalidate();
+            },
+          }),
+          m('span.pf-counter-track__custom-range-label', 'Max'),
+          m(TextInput, {
+            type: 'number',
+            placeholder: 'auto',
+            value: options.yCustomMax ?? '',
+            onInput: (v) => {
+              const parsed = parseFloat(v);
+              options.yCustomMax = isNaN(parsed) ? undefined : parsed;
+              this.invalidate();
+            },
+          }),
+        ]),
+
       m(
         MenuItem,
         {
@@ -1080,6 +1131,11 @@ export abstract class BaseCounterTrack implements TrackRenderer {
       yMax = Math.max(0, yMax);
     }
 
+    if (options.yDisplay === 'custom') {
+      if (options.yCustomMin !== undefined) yMin = options.yCustomMin;
+      if (options.yCustomMax !== undefined) yMax = options.yCustomMax;
+    }
+
     if (options.yOverrideMaximum !== undefined) {
       yMax = Math.max(options.yOverrideMaximum, yMax);
     }
@@ -1088,7 +1144,11 @@ export abstract class BaseCounterTrack implements TrackRenderer {
       yMin = Math.min(options.yOverrideMinimum, yMin);
     }
 
-    if (options.yRangeRounding === 'human_readable') {
+    // Skip rounding when the user has specified an exact custom range.
+    if (
+      options.yRangeRounding === 'human_readable' &&
+      options.yDisplay !== 'custom'
+    ) {
       if (options.yDisplay === 'log') {
         yMax = Math.log(roundAway(Math.exp(yMax)));
         yMin = Math.log(roundAway(Math.exp(yMin)));
@@ -1098,11 +1158,16 @@ export abstract class BaseCounterTrack implements TrackRenderer {
       }
     }
 
+    // Ensure yMax > yMin to prevent division by zero in the renderer.
+    if (yMax <= yMin) {
+      yMax = yMin + 1;
+    }
+
     [yMin, yMax] = this.rangeSharer.share(options, [yMin, yMax]);
 
     let yLabel: string;
 
-    if (options.yDisplay === 'minmax') {
+    if (options.yDisplay === 'minmax' || options.yDisplay === 'custom') {
       yLabel = 'min - max';
     } else {
       let max = yMax;