## MatePixmap MatePixmap |

## Synopsis

    #include <libmateui/libmateui.h>

                        MatePixmapPrivate;
    struct              MatePixmap;
    GtkWidget *         mate_pixmap_new_from_file          (const gchar *filename);
    GtkWidget *         mate_pixmap_new_from_file_at_size  (const gchar *filename,
                                                             gint width,
                                                             gint height);
    GtkWidget *         mate_pixmap_new_from_xpm_d         (const gchar **xpm_data);
    GtkWidget *         mate_pixmap_new_from_xpm_d_at_size (const gchar **xpm_data,
                                                             gint width,
                                                             gint height);
    GtkWidget *         mate_pixmap_new_from_mate_pixmap  (MatePixmap *gpixmap);
    void                mate_pixmap_load_file              (MatePixmap *gpixmap,
                                                             const char *filename);
    void                mate_pixmap_load_file_at_size      (MatePixmap *gpixmap,
                                                             const char *filename,
                                                             int width,
                                                             int height);
    void                mate_pixmap_load_xpm_d             (MatePixmap *gpixmap,
                                                             const char **xpm_data);
    void                mate_pixmap_load_xpm_d_at_size     (MatePixmap *gpixmap,
                                                             const char **xpm_data,
                                                             int width,
                                                             int height);

## Object Hierarchy

      GObject
       +----GInitiallyUnowned
             +----GtkObject
                   +----GtkWidget
                         +----GtkMisc
                               +----GtkImage
                                     +----MatePixmap

## Implemented Interfaces

MatePixmap implements AtkImplementorIface and GtkBuildable.

## Description

## Details

### MatePixmapPrivate

    typedef struct _MatePixmapPrivate MatePixmapPrivate;

### Warning

`MatePixmapPrivate` is deprecated and should not be used in newly-written code.

### struct MatePixmap

    struct MatePixmap;

### Warning

`MatePixmap` is deprecated and should not be used in newly-written code.

### mate_pixmap_new_from_file ()

    GtkWidget *         mate_pixmap_new_from_file          (const gchar *filename);

### Warning

`mate_pixmap_new_from_file` is deprecated and should not be used in newly-written code.

Note that the new_from_file functions give you no way to detect errors; if the file isn't found/loaded, you get an empty widget. to detect errors just do:

<programlisting> pixbuf = gdk_pixbuf_new_from_file (filename); if (pixbuf != NULL) { gpixmap = gtk_image_new_from_pixbuf (pixbuf); } else { // handle your error... } </programlisting>

`filename` : | The filename of the file to be loaded.
Returns : | A newly allocated `MatePixmap` with the file at `filename` loaded.

### mate_pixmap_new_from_file_at_size ()

    GtkWidget *         mate_pixmap_new_from_file_at_size  (const gchar *filename,
                                                             gint width,
                                                             gint height);

### Warning

`mate_pixmap_new_from_file_at_size` is deprecated and should not be used in newly-written code.

Loads a new `MatePixmap` from a file, and scales it (if necessary) to the size indicated by `height` and `width`. If either are set to -1, then the "natural" dimension of the image is used in place. See `mate_pixmap_new_from_file` for information on error handling.

`filename` : | The filename of the file to be loaded.
`width` : | The width to scale the image to.
`height` : | The height to scale the image to.
Returns : | value: A newly allocated `MatePixmap` with the file at `filename` loaded.

### mate_pixmap_new_from_xpm_d ()

    GtkWidget *         mate_pixmap_new_from_xpm_d         (const gchar **xpm_data);

### Warning

`mate_pixmap_new_from_xpm_d` is deprecated and should not be used in newly-written code.

Loads a new `MatePixmap` from the `xpm_data`, and scales it (if necessary) to the size indicated by `height` and `width`. If either are set to -1, then the "natural" dimension of the image is used in place.

`xpm_data` : | The xpm data to be loaded.
Returns : | value: A newly allocated `MatePixmap` with the image from `xpm_data` loaded.

### mate_pixmap_new_from_xpm_d_at_size ()

    GtkWidget *         mate_pixmap_new_from_xpm_d_at_size (const gchar **xpm_data,
                                                             gint width,
                                                             gint height);

### Warning

`mate_pixmap_new_from_xpm_d_at_size` is deprecated and should not be used in newly-written code.

Loads a new `MatePixmap` from the `xpm_data`, and scales it (if necessary) to the size indicated by `height` and `width`. If either are set to -1, then the "natural" dimension of the image is used in place.

`xpm_data` : | The xpm data to be loaded.
`width` : | The width to scale the image to.
`height` : | The height to scale the image to.
Returns : | value: A newly allocated `MatePixmap` with the image from `xpm_data` loaded.

### mate_pixmap_new_from_mate_pixmap ()

    GtkWidget *         mate_pixmap_new_from_mate_pixmap  (MatePixmap *gpixmap);

### Warning

`mate_pixmap_new_from_mate_pixmap` is deprecated and should not be used in newly-written code.

`gpixmap` : |
Returns : |

### mate_pixmap_load_file ()

    void                mate_pixmap_load_file              (MatePixmap *gpixmap,
                                                             const char *filename);

### Warning

`mate_pixmap_load_file` is deprecated and should not be used in newly-written code.

`gpixmap` : |
`filename` : |

### mate_pixmap_load_file_at_size ()

    void                mate_pixmap_load_file_at_size      (MatePixmap *gpixmap,
                                                             const char *filename,
                                                             int width,
                                                             int height);

### Warning

`mate_pixmap_load_file_at_size` is deprecated and should not be used in newly-written code.

`gpixmap` : |
`filename` : |
`width` : |
`height` : |

### mate_pixmap_load_xpm_d ()

    void                mate_pixmap_load_xpm_d             (MatePixmap *gpixmap,
                                                             const char **xpm_data);

### Warning

`mate_pixmap_load_xpm_d` is deprecated and should not be used in newly-written code.

`gpixmap` : |
`xpm_data` : |

### mate_pixmap_load_xpm_d_at_size ()

    void                mate_pixmap_load_xpm_d_at_size     (MatePixmap *gpixmap,
                                                             const char **xpm_data,
                                                             int width,
                                                             int height);

### Warning

`mate_pixmap_load_xpm_d_at_size` is deprecated and should not be used in newly-written code.

`gpixmap` : |
`xpm_data` : |
`width` : |
`height` : |