## BtWaveformViewer

BtWaveformViewer — the waveform viewer widget

## Synopsis

    #include "bt-edit.h"

    struct              BtWaveformViewer;
    GtkWidget *         bt_waveform_viewer_new              ();
    void                bt_waveform_viewer_set_wave         (BtWaveformViewer *self,
                                                             int16_t *data,
                                                             int channels,
                                                             int length);

## Object Hierarchy

      GObject
       +----GInitiallyUnowned
             +----GtkObject
                   +----GtkWidget
                         +----BtWaveformViewer

## Implemented Interfaces

BtWaveformViewer implements AtkImplementorIface and GtkBuildable.

## Properties

      "loop-begin"               gint64                : Write
      "loop-end"                 gint64                : Write
      "playback-cursor"          gint64                : Write
      "wave-length"              gint64                : Read

## Description

Provides an viewer for audio waveforms.

## Details

### struct BtWaveformViewer

    struct BtWaveformViewer;

waveform view widget

### bt_waveform_viewer_new ()

    GtkWidget *         bt_waveform_viewer_new              ();

Create a new waveform viewer widget. Use `bt_waveform_viewer_set_wave()` to pass wave data.

Returns : | the widget

### bt_waveform_viewer_set_wave ()

    void                bt_waveform_viewer_set_wave         (BtWaveformViewer *self,
                                                             int16_t *data,
                                                             int channels,
                                                             int length);

Set wave data to show in the widget.

`self` : | the widget
`data` : | memory block of samples (interleaved for channels>1)
`channels` : | number channels
`length` : | number samples per channel

## Property Details

### The `"loop-begin"` property

      "loop-begin"               gint64                : Write

First sample of the loop or -1 if there is no loop.

Allowed values: >= -1

Default value: -1

### The `"loop-end"` property

      "loop-end"                 gint64                : Write

First sample after the loop or -1 if there is no loop.

Allowed values: >= -1

Default value: -1

### The `"playback-cursor"` property

      "playback-cursor"          gint64                : Write

Current playback position within a waveform or -1 if sample is not played.

Allowed values: >= -1

Default value: -1

### The `"wave-length"` property

      "wave-length"              gint64                : Read

The current waveform length.

Allowed values: >= 0

Default value: 0

## See Also

BtWave, BtMainPageWaves