## 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);
    GtkToolbarStyle     gtk_toolbar_get_style_from_string   (const gchar *style_name);
    GtkTargetEntry *    gtk_target_table_make               (GdkAtom format_atom,
                                                             gint *n_targets);
    void                gtk_show_uri_simple                 (GtkWidget *widget,
                                                             const gchar *uri);
    #define             GNOME_CANVAS_BROKEN_PROPERTIES

## Description

Implements the body of the buzztard GUI editor.

You can try to run the uninstalled program via

      libtool --mode=execute buzztard-edit

to enable debug output add:

     --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.

### 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

### gtk_target_table_make ()

    GtkTargetEntry *    gtk_target_table_make               (GdkAtom format_atom,
                                                             gint *n_targets);

Generate the target table for pasting to clipboard. Use gtk_target_table_free (targets, n_targets);

`format_atom` : | format atom for the target list
`n_targets` : | out variable for the size of the table
Returns : | the table and the size in the out variable `n_targets`

### gtk_show_uri_simple ()

    void                gtk_show_uri_simple                 (GtkWidget *widget,
                                                             const gchar *uri);

Show the given `uri`. Uses same screen as `widget` (default if `widget` is NULL).

`widget` : | widget that triggered the action
`uri` : | the uri

### 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