GPUWatch 2.0 Userguide



What's New on GPUWatch 2.0?



We focused on making GPUWatch more user-friendly in 2.0. We improved in 3 aspects.

  • Better Readability
  • Better Conveniency
  • More Information

Now you can use a more useful GPUWatch at any Galaxy device with Androidl R OS.

Appearance of overlay widgets is more readable through thick graph line and text, noticeable legend area. Of course, you can manipulate these details of widgets. Also, metrics on different categories are able to be combined into one widget as Custom Widget, so that you can get hints of relation between two metrics. GPUWatch v2.0 measures for the context of application on the top automatically. you don't need to choose a specific application to measure or rendering API for it anymore. GPUWatch v2.0 makes manipulation easier through supplying a shortcut on the Notification panel.





Supported Devices


Device
 Android P
GPUWatch v1.0

 Android Q
GPUWatch v1.5

 Android R
GPUWatch v2.0
Galaxy S9 series △* ✓ ✓
Galaxy S10 series ✓ ✓ ✓
Galaxy S20 series ✓ ✓
Galaxy Note9 series △* ✓ ✓
Galaxy Note10 series ✓ ✓ ✓
Galaxy Note20 series ✓ ✓
Galaxy Fold ✓ ✓ ✓
Galaxy Z Flip ✓ ✓
Galaxy Z Fold2 ✓ ✓
Other Samsung mobile phones ✓

※ Only devices launched in Europe and Korea




How to Use



You can easily turn on the GPUWatch overlay for profiling your application:

  • Settings ⇒ Developer Options ⇒ GPUWatch ON
  • Launch the App to measure




General Settings



You can change the common settings of GPUWatch with the General Settings menu.




Item
Description
Update Interval Each metric of widgets is calculated from values measured over a time period which are set in update interval setting.
Background Color Choose a background color for widgets.
Background Transparency Set up the desired transparency level for widgets.
Graph Grid Show / hide grid in graph widgets.
Margins Enable / disable margins between widgets.



Notification Manipulations



For quick user interaction with GPUWatch and for additional configuration of widgets, GPUWatch offers several buttons in the Notification Panel.




Item
Description
Off Disable GPUWatch. Equivalent to disabling GPUWatch from Developer Options of Settings.
Hide / Show Widgets Hide/Show all widgets without disabling the GPUWatch.
Lock / Unlock Widgets Unlock for the user to move widgets around the screen by drag action and move them to the required positions.
Lock the position of widgets.
Select Context Select EGL_CONTEXT or vkDevice for profiling if application has several.
Settings Open GPUWatch settings.



Widget Manipulations



Widgets are the key component of GPUWatch. GPUWatch shows measured values through widgets. When you add preset widgets that have metrics you want to measure, GPUWatch starts to measure the metrics for an application at the top. Also you can add/move/delete widgets freely where you want. You can also use a special type widget : ‘Custom Widget’. It’s a combination of preset widget items. With this, you can have insight of relation between several metrics.


Preset widget category

GPUWatch has categorized preset widgets. Each category is shown in a maximum 2 types of widget: Graph, Text. But some categories such as ContextInfo are shown only 1 type of widget.


Category
Graph widget
Text widget
Details
FPS
(Surface)

 FPS drawn by SurfaceFlinger. (A service used to composite surfaces to the display)
-Curr Avg : Averaged FPS between two measurements during update interval.
Load Load of processor. 0% means idle, 100% means fully loaded.
-CPU: CPU load of all cores.
-GPU: GPU load.
Context
Information
NONE
 Some useful context information.
-API:Rendering API the application is using. The value formed by " GRAPHICS_API #CONTEXT_NUMBER"
(PID:Process ID, GRAPHICS_API:can be OpenGL,Vulkan,GLOV_GL or GLOV_VK)
-RES: Surface resolution.
-DriverType: Graphic driver loaded for the application. The value can be System Driver or Game Driver.


How to add widgets

When you add widgets, measure starts. you can add widgets from presets or mix preset items to one widget using CustomWidget.


How to add preset widgets

  • Push Add widgets button.
  • Select 'Widgets from presets' button.
  • Choose widgets from the 'Graph' or 'Text' widget type.
  • Push 'OK'.



How to add custom widgets

  • Push Add widgets button.
  • Select 'Custom Widget'.
  • Choose metrics to combine into a custom widget from 'Graph' or 'Text' widget type.
    Note: Only metrics could be selected of the same type. The maximal number of the metrics in Custom Graph Widget can't exceed 3. This is taken into account when configuring only Custom Graph widget not Custom Text widget.



How to change widget position

By unlocking widgets using the Notification Panel button, you can move widgets around the screen and finally set the best possible position. When you move widgets, GPUWatch lets you know whether widgets can be set on the position. The red area means the space where moving widget is impossible. Green area is where possible. After positioning all widgets to desired, you have to lock widgets not to disturb game play.




How to change widget settings

You can change configuration for each widget including size, color, values to observe and others. There are 2 ways to access this settings menu.

  • GPUWatch main menu > Widget list > Touch a widget
  • Double touch a widget in unlock mode.




Working with GPUWatch

After setting all the parameters and configuring the necessary widgets, just launch an application to measure.GPUWatch will start working automatically.