<a id="ui-widgets"></a>

# Widgets

The Joulescope UI is built from widgets.  Each view, such as the Multimeter
view and the Oscilloscope view, is a set of widgets in the central widget
area.  [Meet the Joulescope UI](https://docs.joulescope.com/en/software/joulescope_ui/meet_ui.md#ui-meet-the-joulescope-ui) introduces the main views.  This
chapter describes each widget in detail.

To add a widget to the active view, select it from the **Widgets** menu.
Drag a widget’s title bar to rearrange it, or to undock it into its own
window.  Click the × on the title bar to close it.  The UI saves the widgets
in each view, with their settings, when it exits.

Most widgets share these conventions:

* Right-click (control-click on macOS) on a widget for a context menu.  The
  menu depends on where you click.
* Select **Settings** from the context menu to see and change all of the
  widget’s settings.  New widgets start from the widget defaults.  See
  [Settings](https://docs.joulescope.com/en/software/joulescope_ui/settings.md#ui-settings).
* Hover over a control to show its tooltip.
* Widgets that display one instrument have a source selection.  **default**
  follows the default device, which you set in the **Device Control**
  widget.  See [Multiple Instrument Support](https://docs.joulescope.com/en/software/joulescope_ui/multiple_instruments.md#ui-multiple-instrument-support).
* Widgets that display live data stop updating while the **Signal sample
  streaming** or **Statistics display** button on the **Side Bar** pauses
  that data.

* [Multimeter](https://docs.joulescope.com/en/software/joulescope_ui/widgets/multimeter.md)
  * [Display](https://docs.joulescope.com/en/software/joulescope_ui/widgets/multimeter.md#display)
  * [Update rate](https://docs.joulescope.com/en/software/joulescope_ui/widgets/multimeter.md#update-rate)
  * [Hold and Accrue](https://docs.joulescope.com/en/software/joulescope_ui/widgets/multimeter.md#hold-and-accrue)
  * [Mouse and context menu](https://docs.joulescope.com/en/software/joulescope_ui/widgets/multimeter.md#mouse-and-context-menu)
  * [Settings](https://docs.joulescope.com/en/software/joulescope_ui/widgets/multimeter.md#settings)
  * [Value and Accumulator widgets](https://docs.joulescope.com/en/software/joulescope_ui/widgets/multimeter.md#value-and-accumulator-widgets)
* [Waveform](https://docs.joulescope.com/en/software/joulescope_ui/widgets/waveform.md)
  * [Layout](https://docs.joulescope.com/en/software/joulescope_ui/widgets/waveform.md#layout)
  * [Signals](https://docs.joulescope.com/en/software/joulescope_ui/widgets/waveform.md#signals)
  * [Navigate](https://docs.joulescope.com/en/software/joulescope_ui/widgets/waveform.md#navigate)
  * [Markers and annotations](https://docs.joulescope.com/en/software/joulescope_ui/widgets/waveform.md#markers-and-annotations)
  * [Plot options](https://docs.joulescope.com/en/software/joulescope_ui/widgets/waveform.md#plot-options)
  * [Settings](https://docs.joulescope.com/en/software/joulescope_ui/widgets/waveform.md#settings)
* [Trigger](https://docs.joulescope.com/en/software/joulescope_ui/widgets/trigger.md)
  * [Run the trigger](https://docs.joulescope.com/en/software/joulescope_ui/widgets/trigger.md#run-the-trigger)
  * [Conditions](https://docs.joulescope.com/en/software/joulescope_ui/widgets/trigger.md#conditions)
  * [Start actions](https://docs.joulescope.com/en/software/joulescope_ui/widgets/trigger.md#start-actions)
  * [Stop actions](https://docs.joulescope.com/en/software/joulescope_ui/widgets/trigger.md#stop-actions)
  * [Timing](https://docs.joulescope.com/en/software/joulescope_ui/widgets/trigger.md#timing)
* [Spectrum](https://docs.joulescope.com/en/software/joulescope_ui/widgets/spectrum.md)
  * [Layout](https://docs.joulescope.com/en/software/joulescope_ui/widgets/spectrum.md#layout)
  * [Control bar](https://docs.joulescope.com/en/software/joulescope_ui/widgets/spectrum.md#control-bar)
  * [Span, FFT length and resolution](https://docs.joulescope.com/en/software/joulescope_ui/widgets/spectrum.md#span-fft-length-and-resolution)
  * [Window](https://docs.joulescope.com/en/software/joulescope_ui/widgets/spectrum.md#window)
  * [Scaling and units](https://docs.joulescope.com/en/software/joulescope_ui/widgets/spectrum.md#scaling-and-units)
  * [Traces and averaging](https://docs.joulescope.com/en/software/joulescope_ui/widgets/spectrum.md#traces-and-averaging)
  * [Waterfall](https://docs.joulescope.com/en/software/joulescope_ui/widgets/spectrum.md#waterfall)
  * [Markers and peaks](https://docs.joulescope.com/en/software/joulescope_ui/widgets/spectrum.md#markers-and-peaks)
  * [Navigate](https://docs.joulescope.com/en/software/joulescope_ui/widgets/spectrum.md#navigate)
  * [Status line](https://docs.joulescope.com/en/software/joulescope_ui/widgets/spectrum.md#status-line)
  * [Settings](https://docs.joulescope.com/en/software/joulescope_ui/widgets/spectrum.md#settings)
* [Efficiency](https://docs.joulescope.com/en/software/joulescope_ui/widgets/efficiency.md)
  * [Add the widget](https://docs.joulescope.com/en/software/joulescope_ui/widgets/efficiency.md#add-the-widget)
  * [Readout](https://docs.joulescope.com/en/software/joulescope_ui/widgets/efficiency.md#readout)
  * [Efficiency vs time](https://docs.joulescope.com/en/software/joulescope_ui/widgets/efficiency.md#efficiency-vs-time)
  * [Efficiency curve](https://docs.joulescope.com/en/software/joulescope_ui/widgets/efficiency.md#efficiency-curve)
  * [Settings](https://docs.joulescope.com/en/software/joulescope_ui/widgets/efficiency.md#settings)
  * [Status messages](https://docs.joulescope.com/en/software/joulescope_ui/widgets/efficiency.md#status-messages)
  * [Export](https://docs.joulescope.com/en/software/joulescope_ui/widgets/efficiency.md#export)
