Frame Control and Range Selection | Profile Analyzer | 0.6.0-preview.1
docs.unity3d.com
    Show / Hide Table of Contents

    Frame Control and Range Selection

    The Single and Compare View's working set of frames can be reduced by making a range in the Frame Control

    Frame Control

    Single View

    FrameRange.

    Compare View

    FrameRange.

    • Use the Pair Graph Selection to enable range selections, range moving and other graph commands to be reflected in both graphs.

    The y-axis of the Frame Control is adjusted by the drop down on the left edge of the graph, you can choose the maximum value from the data set or one of the traditional frame boundaries supplied (16.67ms or 60Hz, 33.33ms or 30Hz, 66.67ms or 15Hz)

    Note: To get the best out of range comparisons it is very important to compare the same number of frames or range length, if this is not the case then you will get a natural bias towards the time spent in the larger set. Enabling Paired Graph Selection will help you select the same number of frames, you can then optionally disable it to move the newly created selection around each graph independently.

    Selecting a Frame Range

    The Profile Analyzer uses all the frames in the currently open set unless you select a sub-range. Selecting a sub-range limits the analysis to just those frames allowing you to focus in on a specific frame or set of frames that look to be exhibiting an interesting behaviour. To help visualize which frames are in the current selection the [start frame], [frame count] and [end frame] numbers will appear on the x-axis of the frame graph.

    Note: The following commands are only paired to both Frame Controls when the Pair Graph Selection option is ticked.

    Range Controls

    • Making a Range in the Frame Control

      • Left Mouse Button Down -> Drag -> Left Mouse Button Up.
    • Moving the Selected Range in the Frame Control.

      • In the currently selected range press SHIFT + Left Mouse Button Down -> Drag -> Left Mouse Button Up.
    • Growing the Selected Range in the Frame Control.

      • In the currently selected range press the '+' key to extend both the start and stop frames by one.
    • Extending the Start of the Selected Range in the Frame Control.

      • In the currently selected range press the '<' key to extend the selection by including the frame to the left of the current start position.
    • Extending the End of the Selected Range in the Frame Control.

      • In the currently selected range press the '>' key to extend the selection by including the frame to the right of the current end position.
    • Shrinking the Selected Range in the Frame Control.

      • In the currently selected range press the '-' key to reduce both the start and stop frames by one.

    Note: Holding down SHIFT will speed up the operations listed above. Holding down ALT will invert the operation, for example making an extend range start frame into a reduce frame start frame operation.

    Range Control Context Menu Commands

    Right Click in the Frame Control to bring up the context menu for the following controls.

    • Clear Selection

      • Clears the selected range. The analysis will then be performed on the whole data set.
    • Invert Selection

      • Inverts the selected range.
    • Select Shortest Frame

      • Selects the frame with the shortest time.
    • Select Longest Frame

      • Selects the frame with the longest time.
    • Select Median Frame

      • Selects the frame with the Median time.
    • Zoom Selection

      • Zooms the frame time graph display to show just the selected range.
    • Zoom All

      • Zoom out to show all Frames. The current selection range will be highlighted.

    Frame Control Context Menu Commands

    • Show Selected Marker

      • Toggle whether or not you would like to see the currently selected markers time for each frame overlaid on the graph.
    • Show Filtered Threads

      • Toggle whether or not you would like to see the currently filtered thread times for each frame overlaid on the graph.
    • Show Frame Lines

      • Toggle whether or not you would like to see the common frame boundaries as a horizontal line on the graph.
    • Order By Frame Duration

      • Toggle the order of the frames on the horizontal axis from Frame Index (0, 1, 2, 3) to Frame start time (16.67, 16.69) - useful for grouping similarly performant frames together.

    Note: The above commands are always paired to both Frame Controls

    Back to manual

    Back to top
    Copyright © 2023 Unity Technologies — Terms of use
    • Legal
    • Privacy Policy
    • Cookies
    • Do Not Sell or Share My Personal Information
    • Your Privacy Choices (Cookie Settings)
    "Unity", Unity logos, and other Unity trademarks are trademarks or registered trademarks of Unity Technologies or its affiliates in the U.S. and elsewhere (more info here). Other names or brands are trademarks of their respective owners.
    Generated by DocFX on 18 October 2023