## btedit btedit — buzztard graphical editor application |

## Synopsis

    #include "bt-edit.h"

    void                add_pixmap_directory                (const gchar *directory);
    GtkWidget *         gtk_image_new_from_filename         (const gchar *filename);
    GdkPixbuf *         gdk_pixbuf_new_from_filename        (const gchar *filename);
    GdkPixbuf *         gdk_pixbuf_new_from_theme           (const gchar *name,
                                                             gint size);
    void                bt_dialog_message                   (const BtMainWindow *self,
                                                             const gchar *title,
                                                             const gchar *headline,
                                                             const gchar *message);
    gboolean            bt_dialog_question                  (const BtMainWindow *self,
                                                             const gchar *title,
                                                             const gchar *headline,
                                                             const gchar *message);
    GtkToolbarStyle     gtk_toolbar_get_style_from_string   (const gchar *style_name);
    #define             GNOME_CANVAS_BROKEN_PROPERTIES

## Description

Implements the body of the buzztard GUI editor.

You can try to run the uninstalled program via

    1
    libtool --mode=execute buzztard-edit

to enable debug output add:

    1
    2
    --gst-debug="*:2,bt-*:3" for not-so-much-logdata or
    --gst-debug="*:2,bt-*:4" for a-lot-logdata

Example songs can be found in `./test/songs/`.

## Details

### add_pixmap_directory ()

    void                add_pixmap_directory                (const gchar *directory);

Use this function to set the directory containing installed pixmaps.

`directory` : | register another directory to search for pixmaps

### gtk_image_new_from_filename ()

    GtkWidget *         gtk_image_new_from_filename         (const gchar *filename);

Creates a new pixmap image widget for the image file.

`filename` : | the filename of the image file
Returns : | a new pixmap widget

### gdk_pixbuf_new_from_filename ()

    GdkPixbuf *         gdk_pixbuf_new_from_filename        (const gchar *filename);

Creates a new pixbuf image for the image file.

`filename` : | the filename of the image file
Returns : | a new pixbuf, `g_object_unref()` when done.

### gdk_pixbuf_new_from_theme ()

    GdkPixbuf *         gdk_pixbuf_new_from_theme           (const gchar *name,
                                                             gint size);

Creates a new pixbuf image from the icon `name` and `size`.

`name` : | the icon name
`size` : | the pixel size
Returns : | a new pixbuf, `g_object_unref()` when done.

### bt_dialog_message ()

    void                bt_dialog_message                   (const BtMainWindow *self,
                                                             const gchar *title,
                                                             const gchar *headline,
                                                             const gchar *message);

Displays a modal message dialog, that needs to be confirmed with "Okay".

`self` : | the applications main window
`title` : | the title of the message
`headline` : | the bold headline of the message
`message` : | the message itself

### bt_dialog_question ()

    gboolean            bt_dialog_question                  (const BtMainWindow *self,
                                                             const gchar *title,
                                                             const gchar *headline,
                                                             const gchar *message);

Displays a modal question dialog, that needs to be confirmed with "Okay" or aborted with "Cancel".

`self` : | the applications main window
`title` : | the title of the message
`headline` : | the bold headline of the message
`message` : | the message itself
Returns : | `TRUE` for Okay, `FALSE` otherwise

### gtk_toolbar_get_style_from_string ()

    GtkToolbarStyle     gtk_toolbar_get_style_from_string   (const gchar *style_name);

toolbar gconf to style conversion

`style_name` : | the style name returned from gconf settings
Returns : | the style id

### GNOME_CANVAS_BROKEN_PROPERTIES

    #define GNOME_CANVAS_BROKEN_PROPERTIES 1

gnome canvas has a broken design, it does not allow derived classes to have G_PARAM_CONSTRUCT_ONLY properties

## See Also

BtEditApplication