BtSettings

BtSettings — class for buzztrax settings handling

Functions

Properties

gchar * audiosink Read / Write
gchar * audiosink-device Read / Write
guint channels Read / Write
gboolean coherence-upnp-active Read / Write
guint coherence-upnp-port Read / Write
gchar * grid-density Read / Write
gboolean jack-transport-master Read / Write
gboolean jack-transport-slave Read / Write
guint latency Read / Write
gchar * missing-machines Read / Write
guint news-seen Read / Write
gchar * presented-tips Read / Write
gchar * record-folder Read / Write
gchar * sample-folder Read / Write
guint sample-rate Read / Write
gboolean show-tips Read / Write
gchar * song-folder Read / Write
gboolean statusbar-hide Read / Write
gchar * system-audiosink Read
gboolean tabs-hide Read / Write
gboolean toolbar-hide Read / Write
gchar * toolbar-style Read
gint window-height Read / Write
gint window-width Read / Write
gint window-xpos Read / Write
gint window-ypos Read / Write

Types and Values

struct BtSettings

Object Hierarchy

    GObject
    ╰── BtSettings

Includes

#include <libbtcore/core.h>

Description

Wraps the settings a GObject. Single settings are accessed via normal g_object_get() and g_object_set() calls. Changes in the settings will be notified to the application by the GObject::notify signal.

Functions

bt_settings_determine_audiosink_name ()

gboolean
bt_settings_determine_audiosink_name (const BtSettings * const self,
                                      gchar **element_name,
                                      gchar **device_name);

Check the settings for the configured audio sink. Pick a fallback if none has been chosen. Verify that the sink works.

Free the strings in the output variables, when done.

Parameters

self

the settings

 

element_name

out variable for the element name

 

device_name

out variable for the device property, if any

 

Returns

TRUE if a audiosink has been found.


bt_settings_make ()

BtSettings *
bt_settings_make (void);

Create a new instance. The type of the settings depends on the subsystem found during configuration run.

Settings are implemented as a singleton. Thus the first invocation will create the object and further calls will just give back a reference.

Returns

the instance or NULL in case of an error

Types and Values

struct BtSettings

struct BtSettings;

base object for a buzztrax based settings

Property Details

The “audiosink” property

  “audiosink”                gchar *

audio output gstreamer element.

Flags: Read / Write

Default value: NULL


The “audiosink-device” property

  “audiosink-device”         gchar *

audio output device name.

Flags: Read / Write

Default value: NULL


The “channels” property

  “channels”                 guint

number of audio output channels.

Flags: Read / Write

Allowed values: [1,2]

Default value: 2


The “coherence-upnp-active” property

  “coherence-upnp-active”    gboolean

activate Coherence UPnP based playback controller.

Flags: Read / Write

Default value: FALSE


The “coherence-upnp-port” property

  “coherence-upnp-port”      guint

the port number for the communication with the coherence backend.

Flags: Read / Write

Default value: 7654


The “grid-density” property

  “grid-density”             gchar *

machine view grid detail level.

Flags: Read / Write

Default value: "low"


The “jack-transport-master” property

  “jack-transport-master”    gboolean

sync other jack clients to buzztrax playback state.

Flags: Read / Write

Default value: FALSE


The “jack-transport-slave” property

  “jack-transport-slave”     gboolean

sync buzztrax to the playback state other jack clients.

Flags: Read / Write

Default value: FALSE


The “latency” property

  “latency”                  guint

target audio latency in ms.

Flags: Read / Write

Allowed values: [1,200]

Default value: 30


The “missing-machines” property

  “missing-machines”         gchar *

list of tip-numbers that were shown already.

Flags: Read / Write

Default value: NULL


The “news-seen” property

  “news-seen”                guint

version number for that the user has seen the news.

Flags: Read / Write

Default value: 0


The “presented-tips” property

  “presented-tips”           gchar *

list of missing machines to ignore.

Flags: Read / Write

Default value: NULL


The “record-folder” property

  “record-folder”            gchar *

default directory for recordings.

Flags: Read / Write

Default value: "/usr/src"


The “sample-folder” property

  “sample-folder”            gchar *

default directory for sample-waveforms.

Flags: Read / Write

Default value: "/usr/src"


The “sample-rate” property

  “sample-rate”              guint

audio output sample-rate.

Flags: Read / Write

Allowed values: [1,96000]

Default value: 44100


The “show-tips” property

  “show-tips”                gboolean

show tips on startup.

Flags: Read / Write

Default value: TRUE


The “song-folder” property

  “song-folder”              gchar *

default directory for songs.

Flags: Read / Write

Default value: "/usr/src"


The “statusbar-hide” property

  “statusbar-hide”           gboolean

hide bottom statusbar.

Flags: Read / Write

Default value: FALSE


The “system-audiosink” property

  “system-audiosink”         gchar *

system audio output gstreamer element.

Flags: Read

Default value: NULL


The “tabs-hide” property

  “tabs-hide”                gboolean

hide main page tabs.

Flags: Read / Write

Default value: FALSE


The “toolbar-hide” property

  “toolbar-hide”             gboolean

hide main toolbar.

Flags: Read / Write

Default value: FALSE


The “toolbar-style” property

  “toolbar-style”            gchar *

system tolbar style.

Flags: Read

Default value: "both"


The “window-height” property

  “window-height”            gint

last application window height.

Flags: Read / Write

Allowed values: >= -1

Default value: -1


The “window-width” property

  “window-width”             gint

last application window width.

Flags: Read / Write

Allowed values: >= -1

Default value: -1


The “window-xpos” property

  “window-xpos”              gint

last application window x-position.

Flags: Read / Write

Default value: 0


The “window-ypos” property

  “window-ypos”              gint

last application window y-position.

Flags: Read / Write

Default value: 0