UNPKG

chrome-devtools-frontend

Version:
1,391 lines (1,214 loc) 84.5 kB
/** * Copyright (C) 2013 Google Inc. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are * met: * * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above * copyright notice, this list of conditions and the following disclaimer * in the documentation and/or other materials provided with the * distribution. * * Neither the name of Google Inc. nor the names of its * contributors may be used to endorse or promote products derived from * this software without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */ import * as Common from '../../../../core/common/common.js'; import * as Host from '../../../../core/host/host.js'; import * as i18n from '../../../../core/i18n/i18n.js'; import * as Platform from '../../../../core/platform/platform.js'; import * as Root from '../../../../core/root/root.js'; import type * as SDK from '../../../../core/sdk/sdk.js'; import type * as TimelineModel from '../../../../models/timeline_model/timeline_model.js'; import * as UI from '../../legacy.js'; import * as ThemeSupport from '../../theme_support/theme_support.js'; import {ChartViewport, type ChartViewportDelegate} from './ChartViewport.js'; import {TimelineGrid, type Calculator} from './TimelineGrid.js'; import flameChartStyles from './flameChart.css.legacy.js'; const UIStrings = { /** *@description Aria accessible name in Flame Chart of the Performance panel */ flameChart: 'Flame Chart', /** *@description Text for the screen reader to announce a hovered group *@example {Network} PH1 */ sHovered: '{PH1} hovered', /** *@description Text for screen reader to announce a selected group. *@example {Network} PH1 */ sSelected: '{PH1} selected', /** *@description Text for screen reader to announce an expanded group *@example {Network} PH1 */ sExpanded: '{PH1} expanded', /** *@description Text for screen reader to announce a collapsed group *@example {Network} PH1 */ sCollapsed: '{PH1} collapsed', }; const str_ = i18n.i18n.registerUIStrings('ui/legacy/components/perf_ui/FlameChart.ts', UIStrings); const i18nString = i18n.i18n.getLocalizedString.bind(undefined, str_); export class FlameChartDelegate { windowChanged(_startTime: number, _endTime: number, _animate: boolean): void { } updateRangeSelection(_startTime: number, _endTime: number): void { } updateSelectedGroup(_flameChart: FlameChart, _group: Group|null): void { } } interface GroupExpansionState { [key: string]: boolean; } export class FlameChart extends Common.ObjectWrapper.eventMixin<EventTypes, typeof UI.Widget.VBox>(UI.Widget.VBox) implements Calculator, ChartViewportDelegate { private readonly groupExpansionSetting?: Common.Settings.Setting<GroupExpansionState>; private groupExpansionState: GroupExpansionState; private readonly flameChartDelegate: FlameChartDelegate; private useWebGL: boolean; private chartViewport: ChartViewport; private dataProvider: FlameChartDataProvider; private candyStripeCanvas: HTMLCanvasElement; private viewportElement: HTMLElement; private canvasGL!: HTMLCanvasElement; private canvas: HTMLCanvasElement; private entryInfo: HTMLElement; private readonly markerHighlighElement: HTMLElement; private readonly highlightElement: HTMLElement; private readonly selectedElement: HTMLElement; private rulerEnabled: boolean; private readonly rangeSelectionStart: number; private readonly rangeSelectionEnd: number; private barHeight: number; private textBaseline: number; private textPadding: number; private readonly markerRadius: number; private readonly headerLeftPadding: number; private arrowSide: number; private readonly expansionArrowIndent: number; private readonly headerLabelXPadding: number; private readonly headerLabelYPadding: number; private highlightedMarkerIndex: number; private highlightedEntryIndex: number; private selectedEntryIndex: number; private rawTimelineDataLength: number; private textWidth: Map<string, Map<string, number>>; private readonly markerPositions: Map<number, { x: number, width: number, }>; private lastMouseOffsetX: number; private selectedGroup: number; private keyboardFocusedGroup: number; private offsetWidth!: number; private offsetHeight!: number; private dragStartX!: number; private dragStartY!: number; private lastMouseOffsetY!: number; private minimumBoundaryInternal!: number; private maxDragOffset!: number; private shaderProgram?: WebGLProgram|null; private vertexBuffer?: WebGLBuffer|null; private colorBuffer?: WebGLBuffer|null; private uScalingFactor?: WebGLUniformLocation|null; private uShiftVector?: WebGLUniformLocation|null; private aVertexPosition?: number; private aVertexColor?: number; private vertexCount?: number; private prevTimelineData?: TimelineData; private timelineLevels?: number[][]|null; private visibleLevelOffsets?: Uint32Array|null; private visibleLevels?: Uint16Array|null; private groupOffsets?: Uint32Array|null; private rawTimelineData?: TimelineData|null; private forceDecorationCache?: Int8Array|null; private entryColorsCache?: string[]|null; private visibleLevelHeights?: Uint32Array; private totalTime?: number; constructor( dataProvider: FlameChartDataProvider, flameChartDelegate: FlameChartDelegate, groupExpansionSetting?: Common.Settings.Setting<GroupExpansionState>) { super(true); this.registerRequiredCSS(flameChartStyles); this.contentElement.classList.add('flame-chart-main-pane'); this.groupExpansionSetting = groupExpansionSetting; this.groupExpansionState = groupExpansionSetting && groupExpansionSetting.get() || {}; this.flameChartDelegate = flameChartDelegate; this.useWebGL = Root.Runtime.experiments.isEnabled('timelineWebGL'); this.chartViewport = new ChartViewport(this); this.chartViewport.show(this.contentElement); this.dataProvider = dataProvider; this.candyStripeCanvas = document.createElement('canvas'); this.createCandyStripePattern(); this.viewportElement = this.chartViewport.viewportElement; if (this.useWebGL) { this.canvasGL = (this.viewportElement.createChild('canvas', 'fill') as HTMLCanvasElement); this.initWebGL(); } this.canvas = (this.viewportElement.createChild('canvas', 'fill') as HTMLCanvasElement); this.canvas.tabIndex = 0; UI.ARIAUtils.setAccessibleName(this.canvas, i18nString(UIStrings.flameChart)); UI.ARIAUtils.markAsTree(this.canvas); this.setDefaultFocusedElement(this.canvas); this.canvas.classList.add('flame-chart-canvas'); this.canvas.addEventListener('mousemove', this.onMouseMove.bind(this), false); this.canvas.addEventListener('mouseout', this.onMouseOut.bind(this), false); this.canvas.addEventListener('click', this.onClick.bind(this), false); this.canvas.addEventListener('keydown', this.onKeyDown.bind(this), false); this.entryInfo = this.viewportElement.createChild('div', 'flame-chart-entry-info'); this.markerHighlighElement = this.viewportElement.createChild('div', 'flame-chart-marker-highlight-element'); this.highlightElement = this.viewportElement.createChild('div', 'flame-chart-highlight-element'); this.selectedElement = this.viewportElement.createChild('div', 'flame-chart-selected-element'); this.canvas.addEventListener('focus', () => { this.dispatchEventToListeners(Events.CanvasFocused); }, false); UI.UIUtils.installDragHandle( this.viewportElement, this.startDragging.bind(this), this.dragging.bind(this), this.endDragging.bind(this), null); this.rulerEnabled = true; this.rangeSelectionStart = 0; this.rangeSelectionEnd = 0; this.barHeight = 17; this.textBaseline = 5; this.textPadding = 5; this.markerRadius = 6; this.chartViewport.setWindowTimes( dataProvider.minimumBoundary(), dataProvider.minimumBoundary() + dataProvider.totalTime()); this.headerLeftPadding = 6; this.arrowSide = 8; this.expansionArrowIndent = this.headerLeftPadding + this.arrowSide / 2; this.headerLabelXPadding = 3; this.headerLabelYPadding = 2; this.highlightedMarkerIndex = -1; this.highlightedEntryIndex = -1; this.selectedEntryIndex = -1; this.rawTimelineDataLength = 0; this.textWidth = new Map(); this.markerPositions = new Map(); this.lastMouseOffsetX = 0; this.selectedGroup = -1; // Keyboard focused group is used to navigate groups irrespective of whether they are selectable or not this.keyboardFocusedGroup = -1; ThemeSupport.ThemeSupport.instance().addEventListener(ThemeSupport.ThemeChangeEvent.eventName, () => { this.scheduleUpdate(); }); } willHide(): void { this.hideHighlight(); } setBarHeight(value: number): void { this.barHeight = value; } setTextBaseline(value: number): void { this.textBaseline = value; } setTextPadding(value: number): void { this.textPadding = value; } enableRuler(enable: boolean): void { this.rulerEnabled = enable; } alwaysShowVerticalScroll(): void { this.chartViewport.alwaysShowVerticalScroll(); } disableRangeSelection(): void { this.chartViewport.disableRangeSelection(); } highlightEntry(entryIndex: number): void { if (this.highlightedEntryIndex === entryIndex) { return; } if (!this.dataProvider.entryColor(entryIndex)) { return; } this.highlightedEntryIndex = entryIndex; this.updateElementPosition(this.highlightElement, this.highlightedEntryIndex); this.dispatchEventToListeners(Events.EntryHighlighted, entryIndex); } hideHighlight(): void { this.entryInfo.removeChildren(); this.highlightedEntryIndex = -1; this.updateElementPosition(this.highlightElement, this.highlightedEntryIndex); this.dispatchEventToListeners(Events.EntryHighlighted, -1); } private createCandyStripePattern(): void { // Set the candy stripe pattern to 17px so it repeats well. const size = 17; this.candyStripeCanvas.width = size; this.candyStripeCanvas.height = size; const ctx = this.candyStripeCanvas.getContext('2d'); if (!ctx) { return; } // Rotate the stripe by 45deg to the right. ctx.translate(size * 0.5, size * 0.5); ctx.rotate(Math.PI * 0.25); ctx.translate(-size * 0.5, -size * 0.5); ctx.fillStyle = 'rgba(255, 0, 0, 0.4)'; for (let x = -size; x < size * 2; x += 3) { ctx.fillRect(x, -size, 1, size * 3); } } private resetCanvas(): void { const ratio = window.devicePixelRatio; const width = Math.round(this.offsetWidth * ratio); const height = Math.round(this.offsetHeight * ratio); this.canvas.width = width; this.canvas.height = height; this.canvas.style.width = `${width / ratio}px`; this.canvas.style.height = `${height / ratio}px`; if (this.useWebGL) { this.canvasGL.width = width; this.canvasGL.height = height; this.canvasGL.style.width = `${width / ratio}px`; this.canvasGL.style.height = `${height / ratio}px`; } } windowChanged(startTime: number, endTime: number, animate: boolean): void { this.flameChartDelegate.windowChanged(startTime, endTime, animate); } updateRangeSelection(startTime: number, endTime: number): void { this.flameChartDelegate.updateRangeSelection(startTime, endTime); } setSize(width: number, height: number): void { this.offsetWidth = width; this.offsetHeight = height; } private startDragging(event: MouseEvent): boolean { this.hideHighlight(); this.maxDragOffset = 0; this.dragStartX = event.pageX; this.dragStartY = event.pageY; return true; } private dragging(event: MouseEvent): void { const dx = event.pageX - this.dragStartX; const dy = event.pageY - this.dragStartY; this.maxDragOffset = Math.max(this.maxDragOffset, Math.sqrt(dx * dx + dy * dy)); } private endDragging(_event: MouseEvent): void { this.updateHighlight(); } private timelineData(): TimelineData|null { if (!this.dataProvider) { return null; } const timelineData = this.dataProvider.timelineData(); if (timelineData !== this.rawTimelineData || (timelineData && timelineData.entryStartTimes.length !== this.rawTimelineDataLength)) { this.processTimelineData(timelineData); } return this.rawTimelineData || null; } private revealEntry(entryIndex: number): void { const timelineData = this.timelineData(); if (!timelineData) { return; } const timeLeft = this.chartViewport.windowLeftTime(); const timeRight = this.chartViewport.windowRightTime(); const entryStartTime = timelineData.entryStartTimes[entryIndex]; const entryTotalTime = timelineData.entryTotalTimes[entryIndex]; const entryEndTime = entryStartTime + entryTotalTime; let minEntryTimeWindow = Math.min(entryTotalTime, timeRight - timeLeft); const level = timelineData.entryLevels[entryIndex]; this.chartViewport.setScrollOffset(this.levelToOffset(level), this.levelHeight(level)); const minVisibleWidthPx = 30; const futurePixelToTime = (timeRight - timeLeft) / this.offsetWidth; minEntryTimeWindow = Math.max(minEntryTimeWindow, futurePixelToTime * minVisibleWidthPx); if (timeLeft > entryEndTime) { const delta = timeLeft - entryEndTime + minEntryTimeWindow; this.windowChanged(timeLeft - delta, timeRight - delta, /* animate */ true); } else if (timeRight < entryStartTime) { const delta = entryStartTime - timeRight + minEntryTimeWindow; this.windowChanged(timeLeft + delta, timeRight + delta, /* animate */ true); } } setWindowTimes(startTime: number, endTime: number, animate?: boolean): void { this.chartViewport.setWindowTimes(startTime, endTime, animate); this.updateHighlight(); } private onMouseMove(event: Event): void { const mouseEvent = (event as MouseEvent); this.lastMouseOffsetX = mouseEvent.offsetX; this.lastMouseOffsetY = mouseEvent.offsetY; if (!this.enabled()) { return; } if (this.chartViewport.isDragging()) { return; } if (this.coordinatesToGroupIndex(mouseEvent.offsetX, mouseEvent.offsetY, true /* headerOnly */) >= 0) { this.hideHighlight(); this.viewportElement.style.cursor = 'pointer'; return; } this.updateHighlight(); } private updateHighlight(): void { const entryIndex = this.coordinatesToEntryIndex(this.lastMouseOffsetX, this.lastMouseOffsetY); if (entryIndex === -1) { this.hideHighlight(); const group = this.coordinatesToGroupIndex(this.lastMouseOffsetX, this.lastMouseOffsetY, false /* headerOnly */); if (group >= 0 && this.rawTimelineData && this.rawTimelineData.groups && this.rawTimelineData.groups[group].selectable) { this.viewportElement.style.cursor = 'pointer'; } else { this.viewportElement.style.cursor = 'default'; } return; } if (this.chartViewport.isDragging()) { return; } this.updatePopover(entryIndex); this.viewportElement.style.cursor = this.dataProvider.canJumpToEntry(entryIndex) ? 'pointer' : 'default'; this.highlightEntry(entryIndex); } private onMouseOut(): void { this.lastMouseOffsetX = -1; this.lastMouseOffsetY = -1; this.hideHighlight(); } private updatePopover(entryIndex: number): void { if (entryIndex === this.highlightedEntryIndex) { this.updatePopoverOffset(); return; } this.entryInfo.removeChildren(); const popoverElement = this.dataProvider.prepareHighlightedEntryInfo(entryIndex); if (popoverElement) { this.entryInfo.appendChild(popoverElement); this.updatePopoverOffset(); } } private updatePopoverOffset(): void { const mouseX = this.lastMouseOffsetX; const mouseY = this.lastMouseOffsetY; const parentWidth = this.entryInfo.parentElement ? this.entryInfo.parentElement.clientWidth : 0; const parentHeight = this.entryInfo.parentElement ? this.entryInfo.parentElement.clientHeight : 0; const infoWidth = this.entryInfo.clientWidth; const infoHeight = this.entryInfo.clientHeight; const /** @const */ offsetX = 10; const /** @const */ offsetY = 6; let x; let y; for (let quadrant = 0; quadrant < 4; ++quadrant) { const dx = quadrant & 2 ? -offsetX - infoWidth : offsetX; const dy = quadrant & 1 ? -offsetY - infoHeight : offsetY; x = Platform.NumberUtilities.clamp(mouseX + dx, 0, parentWidth - infoWidth); y = Platform.NumberUtilities.clamp(mouseY + dy, 0, parentHeight - infoHeight); if (x >= mouseX || mouseX >= x + infoWidth || y >= mouseY || mouseY >= y + infoHeight) { break; } } this.entryInfo.style.left = x + 'px'; this.entryInfo.style.top = y + 'px'; } private onClick(event: Event): void { const mouseEvent = (event as MouseEvent); this.focus(); // onClick comes after dragStart and dragEnd events. // So if there was drag (mouse move) in the middle of that events // we skip the click. Otherwise we jump to the sources. const clickThreshold = 5; if (this.maxDragOffset > clickThreshold) { return; } this.selectGroup(this.coordinatesToGroupIndex(mouseEvent.offsetX, mouseEvent.offsetY, false /* headerOnly */)); this.toggleGroupExpand(this.coordinatesToGroupIndex(mouseEvent.offsetX, mouseEvent.offsetY, true /* headerOnly */)); const timelineData = this.timelineData(); if (mouseEvent.shiftKey && this.highlightedEntryIndex !== -1 && timelineData) { const start = timelineData.entryStartTimes[this.highlightedEntryIndex]; const end = start + timelineData.entryTotalTimes[this.highlightedEntryIndex]; this.chartViewport.setRangeSelection(start, end); } else { this.chartViewport.onClick(mouseEvent); this.dispatchEventToListeners(Events.EntryInvoked, this.highlightedEntryIndex); } } private selectGroup(groupIndex: number): void { if (groupIndex < 0 || this.selectedGroup === groupIndex) { return; } if (!this.rawTimelineData) { return; } const groups = this.rawTimelineData.groups; if (!groups) { return; } this.keyboardFocusedGroup = groupIndex; this.scrollGroupIntoView(groupIndex); const groupName = groups[groupIndex].name; if (!groups[groupIndex].selectable) { this.deselectAllGroups(); UI.ARIAUtils.alert(i18nString(UIStrings.sHovered, {PH1: groupName})); } else { this.selectedGroup = groupIndex; this.flameChartDelegate.updateSelectedGroup(this, groups[groupIndex]); this.resetCanvas(); this.draw(); UI.ARIAUtils.alert(i18nString(UIStrings.sSelected, {PH1: groupName})); } } private deselectAllGroups(): void { this.selectedGroup = -1; this.flameChartDelegate.updateSelectedGroup(this, null); this.resetCanvas(); this.draw(); } private deselectAllEntries(): void { this.selectedEntryIndex = -1; this.resetCanvas(); this.draw(); } private isGroupFocused(index: number): boolean { return index === this.selectedGroup || index === this.keyboardFocusedGroup; } private scrollGroupIntoView(index: number): void { if (index < 0) { return; } if (!this.rawTimelineData) { return; } const groups = this.rawTimelineData.groups; const groupOffsets = this.groupOffsets; if (!groupOffsets || !groups) { return; } const groupTop = groupOffsets[index]; let nextOffset = groupOffsets[index + 1]; if (index === groups.length - 1) { nextOffset += groups[index].style.padding; } // For the top group, scroll all the way to the top of the chart // to accommodate the bar with time markers const scrollTop = index === 0 ? 0 : groupTop; const scrollHeight = Math.min(nextOffset - scrollTop, this.chartViewport.chartHeight()); this.chartViewport.setScrollOffset(scrollTop, scrollHeight); } private toggleGroupExpand(groupIndex: number): void { if (groupIndex < 0 || !this.isGroupCollapsible(groupIndex)) { return; } if (!this.rawTimelineData || !this.rawTimelineData.groups) { return; } this.expandGroup(groupIndex, !this.rawTimelineData.groups[groupIndex].expanded /* setExpanded */); } private expandGroup( groupIndex: number, setExpanded: boolean|undefined = true, propagatedExpand: boolean|undefined = false): void { if (groupIndex < 0 || !this.isGroupCollapsible(groupIndex)) { return; } if (!this.rawTimelineData) { return; } const groups = this.rawTimelineData.groups; if (!groups) { return; } const group = groups[groupIndex]; group.expanded = setExpanded; this.groupExpansionState[group.name] = group.expanded; if (this.groupExpansionSetting) { this.groupExpansionSetting.set(this.groupExpansionState); } this.updateLevelPositions(); this.updateHighlight(); if (!group.expanded) { const timelineData = this.timelineData(); if (timelineData) { const level = timelineData.entryLevels[this.selectedEntryIndex]; if (this.selectedEntryIndex >= 0 && level >= group.startLevel && (groupIndex >= groups.length - 1 || groups[groupIndex + 1].startLevel > level)) { this.selectedEntryIndex = -1; } } } this.updateHeight(); this.resetCanvas(); this.draw(); this.scrollGroupIntoView(groupIndex); // We only want to read expanded/collapsed state on user inputted expand/collapse if (!propagatedExpand) { const groupName = groups[groupIndex].name; const content = group.expanded ? i18nString(UIStrings.sExpanded, {PH1: groupName}) : i18nString(UIStrings.sCollapsed, {PH1: groupName}); UI.ARIAUtils.alert(content); } } private onKeyDown(e: KeyboardEvent): void { if (!UI.KeyboardShortcut.KeyboardShortcut.hasNoModifiers(e) || !this.timelineData()) { return; } const eventHandled = this.handleSelectionNavigation(e); // Handle keyboard navigation in groups if (!eventHandled && this.rawTimelineData && this.rawTimelineData.groups) { this.handleKeyboardGroupNavigation(e); } } bindCanvasEvent(eventName: string, onEvent: (arg0: Event) => void): void { this.canvas.addEventListener(eventName, onEvent); } private handleKeyboardGroupNavigation(event: Event): void { const keyboardEvent = (event as KeyboardEvent); let handled = false; let entrySelected = false; if (keyboardEvent.code === 'ArrowUp') { handled = this.selectPreviousGroup(); } else if (keyboardEvent.code === 'ArrowDown') { handled = this.selectNextGroup(); } else if (keyboardEvent.code === 'ArrowLeft') { if (this.keyboardFocusedGroup >= 0) { this.expandGroup(this.keyboardFocusedGroup, false /* setExpanded */); handled = true; } } else if (keyboardEvent.code === 'ArrowRight') { if (this.keyboardFocusedGroup >= 0) { this.expandGroup(this.keyboardFocusedGroup, true /* setExpanded */); this.selectFirstChild(); handled = true; } } else if (keyboardEvent.key === 'Enter') { entrySelected = this.selectFirstEntryInCurrentGroup(); handled = entrySelected; } if (handled && !entrySelected) { this.deselectAllEntries(); } if (handled) { keyboardEvent.consume(true); } } private selectFirstEntryInCurrentGroup(): boolean { if (!this.rawTimelineData) { return false; } const allGroups = this.rawTimelineData.groups; if (this.keyboardFocusedGroup < 0 || !allGroups) { return false; } const group = allGroups[this.keyboardFocusedGroup]; const startLevelInGroup = group.startLevel; // Return if no levels in this group if (startLevelInGroup < 0) { return false; } // Make sure this is the innermost nested group with this startLevel // This is because a parent group also contains levels of all its child groups // So check if the next group has the same level, if it does, user should // go to that child group to select this entry if (this.keyboardFocusedGroup < allGroups.length - 1 && allGroups[this.keyboardFocusedGroup + 1].startLevel === startLevelInGroup) { return false; } if (!this.timelineLevels) { return false; } // Get first (default) entry in startLevel of selected group const firstEntryIndex = this.timelineLevels[startLevelInGroup][0]; this.expandGroup(this.keyboardFocusedGroup, true /* setExpanded */); this.setSelectedEntry(firstEntryIndex); return true; } private selectPreviousGroup(): boolean { if (this.keyboardFocusedGroup <= 0) { return false; } const groupIndexToSelect = this.getGroupIndexToSelect(-1 /* offset */); this.selectGroup(groupIndexToSelect); return true; } private selectNextGroup(): boolean { if (!this.rawTimelineData || !this.rawTimelineData.groups) { return false; } if (this.keyboardFocusedGroup >= this.rawTimelineData.groups.length - 1) { return false; } const groupIndexToSelect = this.getGroupIndexToSelect(1 /* offset */); this.selectGroup(groupIndexToSelect); return true; } private getGroupIndexToSelect(offset: number): number { if (!this.rawTimelineData || !this.rawTimelineData.groups) { throw new Error('No raw timeline data'); } const allGroups = this.rawTimelineData.groups; let groupIndexToSelect = this.keyboardFocusedGroup; let groupName, groupWithSubNestingLevel; do { groupIndexToSelect += offset; groupName = this.rawTimelineData.groups[groupIndexToSelect].name; groupWithSubNestingLevel = this.keyboardFocusedGroup !== -1 && allGroups[groupIndexToSelect].style.nestingLevel > allGroups[this.keyboardFocusedGroup].style.nestingLevel; } while (groupIndexToSelect > 0 && groupIndexToSelect < allGroups.length - 1 && (!groupName || groupWithSubNestingLevel)); return groupIndexToSelect; } private selectFirstChild(): void { if (!this.rawTimelineData || !this.rawTimelineData.groups) { return; } const allGroups = this.rawTimelineData.groups; if (this.keyboardFocusedGroup < 0 || this.keyboardFocusedGroup >= allGroups.length - 1) { return; } const groupIndexToSelect = this.keyboardFocusedGroup + 1; if (allGroups[groupIndexToSelect].style.nestingLevel > allGroups[this.keyboardFocusedGroup].style.nestingLevel) { this.selectGroup(groupIndexToSelect); } } private handleSelectionNavigation(event: KeyboardEvent): boolean { if (this.selectedEntryIndex === -1) { return false; } const timelineData = this.timelineData(); if (!timelineData) { return false; } function timeComparator(time: number, entryIndex: number): number { if (!timelineData) { throw new Error('No timeline data'); } return time - timelineData.entryStartTimes[entryIndex]; } function entriesIntersect(entry1: number, entry2: number): boolean { if (!timelineData) { throw new Error('No timeline data'); } const start1 = timelineData.entryStartTimes[entry1]; const start2 = timelineData.entryStartTimes[entry2]; const end1 = start1 + timelineData.entryTotalTimes[entry1]; const end2 = start2 + timelineData.entryTotalTimes[entry2]; return start1 < end2 && start2 < end1; } const keyboardEvent = (event as KeyboardEvent); const keys = UI.KeyboardShortcut.Keys; if (keyboardEvent.keyCode === keys.Left.code || keyboardEvent.keyCode === keys.Right.code) { const level = timelineData.entryLevels[this.selectedEntryIndex]; const levelIndexes = this.timelineLevels ? this.timelineLevels[level] : []; let indexOnLevel = Platform.ArrayUtilities.lowerBound(levelIndexes, this.selectedEntryIndex, (a, b) => a - b); indexOnLevel += keyboardEvent.keyCode === keys.Left.code ? -1 : 1; event.consume(true); if (indexOnLevel >= 0 && indexOnLevel < levelIndexes.length) { this.dispatchEventToListeners(Events.EntrySelected, levelIndexes[indexOnLevel]); } return true; } if (keyboardEvent.keyCode === keys.Up.code || keyboardEvent.keyCode === keys.Down.code) { let level = timelineData.entryLevels[this.selectedEntryIndex]; level += keyboardEvent.keyCode === keys.Up.code ? -1 : 1; if (level < 0 || (this.timelineLevels && level >= this.timelineLevels.length)) { this.deselectAllEntries(); keyboardEvent.consume(true); return true; } const entryTime = timelineData.entryStartTimes[this.selectedEntryIndex] + timelineData.entryTotalTimes[this.selectedEntryIndex] / 2; const levelIndexes = this.timelineLevels ? this.timelineLevels[level] : []; let indexOnLevel = Platform.ArrayUtilities.upperBound(levelIndexes, entryTime, timeComparator) - 1; if (!entriesIntersect(this.selectedEntryIndex, levelIndexes[indexOnLevel])) { ++indexOnLevel; if (indexOnLevel >= levelIndexes.length || !entriesIntersect(this.selectedEntryIndex, levelIndexes[indexOnLevel])) { if (keyboardEvent.code === 'ArrowDown') { return false; } // Stay in the current group and give focus to the parent group instead of entries this.deselectAllEntries(); keyboardEvent.consume(true); return true; } } keyboardEvent.consume(true); this.dispatchEventToListeners(Events.EntrySelected, levelIndexes[indexOnLevel]); return true; } if (event.key === 'Enter') { event.consume(true); this.dispatchEventToListeners(Events.EntryInvoked, this.selectedEntryIndex); return true; } return false; } private coordinatesToEntryIndex(x: number, y: number): number { if (x < 0 || y < 0) { return -1; } const timelineData = this.timelineData(); if (!timelineData) { return -1; } y += this.chartViewport.scrollOffset(); if (!this.visibleLevelOffsets) { throw new Error('No visible level offsets'); } const cursorLevel = Platform.ArrayUtilities.upperBound(this.visibleLevelOffsets, y, Platform.ArrayUtilities.DEFAULT_COMPARATOR) - 1; if (cursorLevel < 0 || (this.visibleLevels && !this.visibleLevels[cursorLevel])) { return -1; } const offsetFromLevel = y - this.visibleLevelOffsets[cursorLevel]; if (offsetFromLevel > this.levelHeight(cursorLevel)) { return -1; } // Check markers first. for (const [index, pos] of this.markerPositions) { if (timelineData.entryLevels[index] !== cursorLevel) { continue; } if (pos.x <= x && x < pos.x + pos.width) { return index as number; } } // Check regular entries. const entryStartTimes = timelineData.entryStartTimes; const entriesOnLevel: number[] = this.timelineLevels ? this.timelineLevels[cursorLevel] : []; if (!entriesOnLevel || !entriesOnLevel.length) { return -1; } const cursorTime = this.chartViewport.pixelToTime(x); const indexOnLevel = Math.max( Platform.ArrayUtilities.upperBound( entriesOnLevel, cursorTime, (time, entryIndex) => time - entryStartTimes[entryIndex]) - 1, 0); function checkEntryHit(this: FlameChart, entryIndex: number|undefined): boolean { if (entryIndex === undefined) { return false; } if (!timelineData) { return false; } const startTime = entryStartTimes[entryIndex]; const duration = timelineData.entryTotalTimes[entryIndex]; const startX = this.chartViewport.timeToPosition(startTime); const endX = this.chartViewport.timeToPosition(startTime + duration); const barThresholdPx = 3; return startX - barThresholdPx < x && x < endX + barThresholdPx; } let entryIndex: number = entriesOnLevel[indexOnLevel]; if (checkEntryHit.call(this, entryIndex)) { return entryIndex; } entryIndex = entriesOnLevel[indexOnLevel + 1]; if (checkEntryHit.call(this, entryIndex)) { return entryIndex; } return -1; } private coordinatesToGroupIndex(x: number, y: number, headerOnly: boolean): number { if (!this.rawTimelineData || !this.rawTimelineData.groups || !this.groupOffsets) { return -1; } if (x < 0 || y < 0) { return -1; } y += this.chartViewport.scrollOffset(); const groups = this.rawTimelineData.groups || []; const group = Platform.ArrayUtilities.upperBound(this.groupOffsets, y, Platform.ArrayUtilities.DEFAULT_COMPARATOR) - 1; if (group < 0 || group >= groups.length) { return -1; } const height = headerOnly ? groups[group].style.height : this.groupOffsets[group + 1] - this.groupOffsets[group]; if (y - this.groupOffsets[group] >= height) { return -1; } if (!headerOnly) { return group; } const context = (this.canvas.getContext('2d') as CanvasRenderingContext2D); context.save(); context.font = groups[group].style.font; const right = this.headerLeftPadding + this.labelWidthForGroup(context, groups[group]); context.restore(); if (x > right) { return -1; } return group; } private markerIndexAtPosition(x: number): number { const timelineData = this.timelineData(); if (!timelineData) { return -1; } const markers = timelineData.markers; if (!markers) { return -1; } const /** @const */ accurracyOffsetPx = 4; const time = this.chartViewport.pixelToTime(x); const leftTime = this.chartViewport.pixelToTime(x - accurracyOffsetPx); const rightTime = this.chartViewport.pixelToTime(x + accurracyOffsetPx); const left = this.markerIndexBeforeTime(leftTime); let markerIndex = -1; let distance: number = Infinity; for (let i = left; i < markers.length && markers[i].startTime() < rightTime; i++) { const nextDistance = Math.abs(markers[i].startTime() - time); if (nextDistance < distance) { markerIndex = i; distance = nextDistance; } } return markerIndex; } private markerIndexBeforeTime(time: number): number { const timelineData = this.timelineData(); if (!timelineData) { throw new Error('No timeline data'); } const markers = timelineData.markers; if (!markers) { throw new Error('No timeline markers'); } return Platform.ArrayUtilities.lowerBound( timelineData.markers, time, (markerTimestamp, marker) => markerTimestamp - marker.startTime()); } private draw(): void { const timelineData = this.timelineData(); if (!timelineData) { return; } const visibleLevelOffsets = this.visibleLevelOffsets ? this.visibleLevelOffsets : new Uint32Array(); const width = this.offsetWidth; const height = this.offsetHeight; const context = (this.canvas.getContext('2d') as CanvasRenderingContext2D); context.save(); const ratio = window.devicePixelRatio; const top = this.chartViewport.scrollOffset(); context.scale(ratio, ratio); context.fillStyle = 'rgba(0, 0, 0, 0)'; context.fillRect(0, 0, width, height); context.translate(0, -top); const defaultFont = '11px ' + Host.Platform.fontFamily(); context.font = defaultFont; const candyStripePattern = context.createPattern(this.candyStripeCanvas, 'repeat'); const entryTotalTimes = timelineData.entryTotalTimes; const entryStartTimes = timelineData.entryStartTimes; const entryLevels = timelineData.entryLevels; const timeToPixel = this.chartViewport.timeToPixel(); const titleIndices = []; const markerIndices = []; const textPadding = this.textPadding; const minTextWidth = 2 * textPadding + UI.UIUtils.measureTextWidth(context, '…'); const minTextWidthDuration = this.chartViewport.pixelToTimeOffset(minTextWidth); const minVisibleBarLevel = Math.max( Platform.ArrayUtilities.upperBound(visibleLevelOffsets, top, Platform.ArrayUtilities.DEFAULT_COMPARATOR) - 1, 0); this.markerPositions.clear(); let mainThreadTopLevel = -1; // Find the main thread so that we can mark tasks longer than 50ms. if ('groups' in timelineData && Array.isArray(timelineData.groups)) { const mainThread = timelineData.groups.find(group => { if (!group.track) { return false; } return group.track.name === 'CrRendererMain'; }); if (mainThread) { mainThreadTopLevel = mainThread.startLevel; } } const colorBuckets = new Map<string, { indexes: number[], }>(); for (let level = minVisibleBarLevel; level < this.dataProvider.maxStackDepth(); ++level) { if (this.levelToOffset(level) > top + height) { break; } if (!this.visibleLevels || !this.visibleLevels[level]) { continue; } if (!this.timelineLevels) { continue; } // Entries are ordered by start time within a level, so find the last visible entry. const levelIndexes = this.timelineLevels[level]; const rightIndexOnLevel = Platform.ArrayUtilities.lowerBound( levelIndexes, this.chartViewport.windowRightTime(), (time, entryIndex) => time - entryStartTimes[entryIndex]) - 1; let lastDrawOffset = Infinity; for (let entryIndexOnLevel = rightIndexOnLevel; entryIndexOnLevel >= 0; --entryIndexOnLevel) { const entryIndex = levelIndexes[entryIndexOnLevel]; const duration = entryTotalTimes[entryIndex]; if (isNaN(duration)) { markerIndices.push(entryIndex); continue; } if (duration >= minTextWidthDuration || (this.forceDecorationCache && this.forceDecorationCache[entryIndex])) { titleIndices.push(entryIndex); } const entryStartTime = entryStartTimes[entryIndex]; const entryOffsetRight = entryStartTime + duration; if (entryOffsetRight <= this.chartViewport.windowLeftTime()) { break; } if (this.useWebGL) { continue; } const barX = this.timeToPositionClipped(entryStartTime); // Check if the entry entirely fits into an already drawn pixel, we can just skip drawing it. if (barX >= lastDrawOffset) { continue; } lastDrawOffset = barX; if (this.entryColorsCache) { const color = this.entryColorsCache[entryIndex]; let bucket = colorBuckets.get(color); if (!bucket) { bucket = {indexes: []}; colorBuckets.set(color, bucket); } bucket.indexes.push(entryIndex); } } } if (this.useWebGL) { this.drawGL(); } else { context.save(); this.forEachGroupInViewport((offset, index, group, isFirst, groupHeight) => { if (this.isGroupFocused(index)) { context.fillStyle = ThemeSupport.ThemeSupport.instance().getComputedValue('--selected-group-background', this.contentElement); context.fillRect(0, offset, width, groupHeight - group.style.padding); } }); context.restore(); for (const [color, {indexes}] of colorBuckets) { context.beginPath(); for (let i = 0; i < indexes.length; ++i) { const entryIndex = indexes[i]; const duration = entryTotalTimes[entryIndex]; if (isNaN(duration)) { continue; } const entryStartTime = entryStartTimes[entryIndex]; const barX = this.timeToPositionClipped(entryStartTime); const barLevel = entryLevels[entryIndex]; const barHeight = this.levelHeight(barLevel); const barY = this.levelToOffset(barLevel); const barRight = this.timeToPositionClipped(entryStartTime + duration); const barWidth = Math.max(barRight - barX, 1); context.rect(barX, barY, barWidth - 0.4, barHeight - 1); } context.fillStyle = color; context.fill(); // Draw long task regions. context.beginPath(); for (let i = 0; i < indexes.length; ++i) { const entryIndex = indexes[i]; const duration = entryTotalTimes[entryIndex]; const showLongDurations = entryLevels[entryIndex] === mainThreadTopLevel; if (!showLongDurations) { continue; } if (isNaN(duration) || duration < 50) { continue; } const entryStartTime = entryStartTimes[entryIndex]; const barX = this.timeToPositionClipped(entryStartTime + 50); const barLevel = entryLevels[entryIndex]; const barHeight = this.levelHeight(barLevel); const barY = this.levelToOffset(barLevel); const barRight = this.timeToPositionClipped(entryStartTime + duration); const barWidth = Math.max(barRight - barX, 1); context.rect(barX, barY, barWidth - 0.4, barHeight - 1); } if (candyStripePattern) { context.fillStyle = candyStripePattern; context.fill(); } } } context.textBaseline = 'alphabetic'; context.beginPath(); let lastMarkerLevel = -1; let lastMarkerX: number = -Infinity; // Markers are sorted top to bottom, right to left. for (let m = markerIndices.length - 1; m >= 0; --m) { const entryIndex = markerIndices[m]; const title = this.dataProvider.entryTitle(entryIndex); if (!title) { continue; } const entryStartTime = entryStartTimes[entryIndex]; const level = entryLevels[entryIndex]; if (lastMarkerLevel !== level) { lastMarkerX = -Infinity; } const x = Math.max(this.chartViewport.timeToPosition(entryStartTime), lastMarkerX); const y = this.levelToOffset(level); const h = this.levelHeight(level); const padding = 4; const width = Math.ceil(UI.UIUtils.measureTextWidth(context, title)) + 2 * padding; lastMarkerX = x + width + 1; lastMarkerLevel = level; this.markerPositions.set(entryIndex, {x, width}); context.fillStyle = this.dataProvider.entryColor(entryIndex); context.fillRect(x, y, width, h - 1); context.fillStyle = 'white'; context.fillText(title, x + padding, y + h - this.textBaseline); } context.strokeStyle = 'rgba(0, 0, 0, 0.2)'; context.stroke(); for (let i = 0; i < titleIndices.length; ++i) { const entryIndex = titleIndices[i]; const entryStartTime = entryStartTimes[entryIndex]; const barX = this.timeToPositionClipped(entryStartTime); const barRight = Math.min(this.timeToPositionClipped(entryStartTime + entryTotalTimes[entryIndex]), width) + 1; const barWidth = barRight - barX; const barLevel = entryLevels[entryIndex]; const barY = this.levelToOffset(barLevel); let text = this.dataProvider.entryTitle(entryIndex); if (text && text.length) { context.font = this.dataProvider.entryFont(entryIndex) || defaultFont; text = UI.UIUtils.trimTextMiddle(context, text, barWidth - 2 * textPadding); } const unclippedBarX = this.chartViewport.timeToPosition(entryStartTime); const barHeight = this.levelHeight(barLevel); if (this.dataProvider.decorateEntry( entryIndex, context, text, barX, barY, barWidth, barHeight, unclippedBarX, timeToPixel)) { continue; } if (!text || !text.length) { continue; } context.fillStyle = this.dataProvider.textColor(entryIndex); context.fillText(text, barX + textPadding, barY + barHeight - this.textBaseline); } context.restore(); this.drawGroupHeaders(width, height); this.drawFlowEvents(context, width, height); this.drawMarkers(); const dividersData = TimelineGrid.calculateGridOffsets(this); const navStartTimes = Array.from(this.dataProvider.navStartTimes().values()); let navStartTimeIndex = 0; const drawAdjustedTime = (time: number): string => { if (navStartTimes.length === 0) { return this.formatValue(time, dividersData.precision); } // Track when the time crosses the boundary to the next nav start record, // and when it does, move the nav start array index accordingly. const hasNextNavStartTime = navStartTimes.length > navStartTimeIndex + 1; if (hasNextNavStartTime && time > navStartTimes[navStartTimeIndex + 1].startTime) { navStartTimeIndex++; } // Adjust the time by the nearest nav start marker's value. const nearestMarker = navStartTimes[navStartTimeIndex]; if (nearestMarker) { time -= nearestMarker.startTime - this.zeroTime(); } return this.formatValue(time, dividersData.precision); }; TimelineGrid.drawCanvasGrid(context, dividersData); if (this.rulerEnabled) { TimelineGrid.drawCanvasHeaders(context, dividersData, drawAdjustedTime, 3, HeaderHeight); } this.updateElementPosition(this.highlightElement, this.highlightedEntryIndex); this.updateElementPosition(this.selectedElement, this.selectedEntryIndex); this.updateMarkerHighlight(); } private initWebGL(): void { const gl = (this.canvasGL.getContext('webgl') as WebGLRenderingContext | null); if (!gl) { console.error('Failed to obtain WebGL context.'); this.useWebGL = false; // Fallback to use canvas. return; } const vertexShaderSource = ` attribute vec2 aVertexPosition; attribute float aVertexColor; uniform vec2 uScalingFactor; uniform vec2 uShiftVector; varying mediump vec2 vPalettePosition; void main() { vec2 shiftedPosition = aVertexPosition - uShiftVector; gl_Position = vec4(shiftedPosition * uScalingFactor + vec2(-1.0, 1.0), 0.0, 1.0); vPalettePosition = vec2(aVertexColor, 0.5); }`; const fragmentShaderSource = ` varying mediump vec2 vPalettePosition; uniform sampler2D uSampler; void main() { gl_FragColor = texture2D(uSampler, vPalettePosition); }`; function loadShader(gl: WebGLRenderingContext, type: number, source: string): WebGLShader|null { const shader = gl.createShader(type); if (!shader) { return null; } gl.shaderSource(shader, source); gl.compileShader(shader); if (gl.getShaderParameter(shader, gl.COMPILE_STATUS)) { return shader; } console.error('Shader compile error: ' + gl.getShaderInfoLog(shader)); gl.deleteShader(shader); return null; } const vertexShader = loadShader(gl, gl.VERTEX_SHADER, vertexShaderSource); const fragmentShader = loadShader(gl, gl.FRAGMENT_SHADER, fragmentShaderSource); const shaderProgram = gl.createProgram(); if (!shaderProgram || !vertexShader || !fragmentShader) { return; } gl.attachShader(shaderProgram, vertexShader); gl.attachShader(shaderProgram, fragmentShader); gl.linkProgram(shaderProgram); if (gl.getProgramParameter(shaderProgram, gl.LINK_STATUS)) { this.shaderProgram = shaderProgram; gl.useProgram(shaderProgram); } else { this.shaderProgram = null; throw new Error('Unable to initialize the shader program: ' + gl.getProgramInfoLog(shaderProgram)); } this.vertexBuffer = gl.createBuffer(); this.colorBuffer = gl.createBuffer(); this.uScalingFactor = gl.getUniformLocation(shaderProgram, 'uScalingFactor'); this.uShiftVector = gl.getUniformLocation(shaderProgram, 'uShiftVector'); const uSampler = gl.getUniformLocation(shaderProgram, 'uSampler'); gl.uniform1i(uSampler, 0); this.aVertexPosition = gl.getAttribLocation(this.shaderProgram, 'aVertexPosition'); this.aVertexColor = gl.getAttribLocation(this.shaderProgram, 'aVertexColor'); gl.enableVertexAttribArray(this.aVertexPosition); gl.enableVertexAttribArray(this.aVertexColor); } private setupGLGeometry(): void { const gl = (this.canvasGL.getContext('webgl') as WebGLRenderingContext | null); if (!gl) { return; } const timelineData = this.timelineData(); if (!timelineData) { return; } const entryTotalTimes = timelineData.entryTotalTimes; const entryStartTimes = timelineData.entryStartTimes; const entryLevels = timelineData.entryLevels; const verticesPerBar = 6; const vertexArray = ne