/* 
 * Motif Tools Library, Version 2.0
 * $Id: Xpm.h,v 2.10 1994/07/04 03:03:50 david Exp $
 * 
 * Written by David Flanagan.
 * Copyright (c) 1992, 1993, 1994 by Dovetail Systems.
 * All Rights Reserved.  See the file COPYRIGHT for details.
 * This is not free software.  See the file SHAREWARE for details.
 * There is no warranty for this software.  See NO_WARRANTY for details.
 */

/*
 * This file is derived in part from the XPM 3.0 distribution by
 * Arnaud Le Hors.  See the file COPYRIGHT for the Groupe Bull copyright.
 */

#ifndef _XmtXpm_h
#define _XmtXpm_h

#include <Xmt/Color.h>

/*
 * the visual types we recognize colors for.
 */
typedef enum {
    Mono=0, Gray4=1, Gray=2, Color=3
} XpmVisualClass;

#define NVISUALS 4

typedef struct {
    String symbolic_name;    /* a symbolic name for this color, quarkified */
    String default_colors[NVISUALS];  /* a color string for each Visual type */
} XpmColor, *XpmColorTable;

/*
 * structure containing data related to an Xpm pixmap.
 * Each pixel of the image is stored as a byte in the data field.
 * The values in this char array are indexes into the color table.
 * We use chars to conserve space, which means that images cannot
 * contain more than 256 colors.  Since this package is intended for
 * use for UI icons and the like, this is not an unreasonable
 * restriction.
 */
typedef struct {
    unsigned short width;
    unsigned short  height;
    XPoint hotspot;
    Boolean has_hotspot;
    unsigned short ncolors;
    XpmColorTable color_table;
    unsigned char *data;
} XmtImage;

_XFUNCPROTOBEGIN
#if NeedFunctionPrototypes
extern XmtImage *XmtParseXpmFile(StringConst);
extern XmtImage *XmtParseXpmData(String *);
extern XmtImage *XmtParseXpmString(StringConst);
extern void XmtFreeXmtImage(XmtImage *);
extern Boolean XmtCreateXImageFromXmtImage(Widget, Visual *, Colormap,
				    unsigned int, XmtColorTable, XmtImage *,
				    XImage **, XImage **, Pixel **, int *);
extern Boolean XmtCreatePixmapFromXmtImage(Widget, Drawable, Visual *,
				    Colormap, unsigned int, XmtColorTable,
				    XmtImage *, Pixmap *, Pixmap *,
				    Pixel **, int *);
#else
extern XmtImage *XmtParseXpmFile();
extern XmtImage *XmtParseXpmData();
extern XmtImage *XmtParseXpmString();
extern void XmtFreeXmtImage();
extern Boolean XmtCreateXImageFromXmtImage();
extern Boolean XmtCreatePixmapFromXmtImage();
#endif
_XFUNCPROTOEND

#endif  /* _XmtXpm_h */