# dots

The Dots tracer handles dot file generation setup and integrates with the pipeline-snapshot tracer when available. It ensures proper directory setup to collaborate with the `gst-dots-viewer` tool, and it handles file cleanup.

The tracer determines the output directory in the following order:

1. Uses GST_DEBUG_DUMP_DOT_DIR if set
2. Falls back to $XDG_CACHE_HOME/gstreamer-dots otherwise

The determined directory is created if it doesn't exist and set as `GST_DEBUG_DUMP_DOT_DIR` for the entire process.

When available, it instantiates the pipeline-snapshot tracer with the following configuration:

- dots-viewer-ws-url=ws://127.0.0.1:3000/snapshot/
- xdg-cache=true
- folder-mode=numbered

## Examples:

    # Basic usage - will delete existing .dot files
    GST_TRACERS=dots gst-launch-1.0 videotestsrc ! autovideosink

    # Keep existing .dot files
    GST_TRACERS="dots(no-delete=true)" gst-launch-1.0 videotestsrc ! autovideosink

## GstDotsTracer

    GObject
        ╰──GInitiallyUnowned
            ╰──GstObject
                ╰──GstTracer
                    ╰──GstDotsTracer

The GstDotsTracer structure.

Since : 1.26

### Properties

#### no-delete

    “no-delete” gboolean

Don't delete existing .dot files on startup.

Flags : Read / Write

Default value : false

Since : 1.26

The results of the search are