tk.h

Go to the documentation of this file.

/*
 * tk.h --
 *
 *      Declarations for Tk-related things that are visible
 *      outside of the Tk module itself.
 *
 * Copyright (c) 1989-1994 The Regents of the University of California.
 * Copyright (c) 1994 The Australian National University.
 * Copyright (c) 1994-1998 Sun Microsystems, Inc.
 * Copyright (c) 1998-2000 Ajuba Solutions.
 *
 * See the file "license.terms" for information on usage and redistribution
 * of this file, and for a DISCLAIMER OF ALL WARRANTIES.
 *
 * RCS: @(#) $Id: tk.h,v 14.1 2004/11/16 19:42:10 morrison Exp $
 */

#include "common.h"

#ifndef _TK
#define _TK

/*
 * For C++ compilers, use extern "C"
 */

#ifdef __cplusplus
extern "C" {
#endif

/*
 * When version numbers change here, you must also go into the following files
 * and update the version numbers:
 *
 * library/tk.tcl       (only if Major.minor changes, not patchlevel)
 * unix/configure.in    (2 LOC Major, 2 LOC minor, 1 LOC patch)
 * win/configure.in     (as above)
 * win/makefile.vc      (not patchlevel)
 * README               (sections 0 and 1)
 * mac/README           (not patchlevel)
 * macosx/Wish.pbproj/project.pbxproj
 *                      (14 LOC total, 4 LOC patch)
 * win/README           (not patchlevel)
 * unix/README          (not patchlevel)
 * unix/tk.spec         (3 LOC Major/Minor, 2 LOC patch)
 * win/tcl.m4           (not patchlevel)
 *
 * You may also need to update some of these files when the numbers change
 * for the version of Tcl that this release of Tk is compiled against.
 */

#define TK_MAJOR_VERSION   8
#define TK_MINOR_VERSION   4
#define TK_RELEASE_LEVEL   TCL_FINAL_RELEASE
#define TK_RELEASE_SERIAL  6

#define TK_VERSION      "8.4"
#define TK_PATCH_LEVEL  "8.4.6"

/*
 * The following definitions set up the proper options for Macintosh
 * compilers.  We use this method because there is no autoconf equivalent.
 */

#if defined(MAC_TCL) || defined(MAC_OSX_TK)
#   ifndef REDO_KEYSYM_LOOKUP
#       define REDO_KEYSYM_LOOKUP
#   endif
#endif

#ifndef _TCL
#   include <tcl.h>
#   if (TCL_MAJOR_VERSION != 8) || (TCL_MINOR_VERSION != 4)
#       error Tk 8.4 must be compiled with tcl.h from Tcl 8.4
#   endif
#endif

/* 
 * A special definition used to allow this header file to be included
 * from windows or mac resource files so that they can obtain version
 * information.  RC_INVOKED is defined by default by the windows RC tool
 * and manually set for macintosh.
 *
 * Resource compilers don't like all the C stuff, like typedefs and
 * procedure declarations, that occur below, so block them out.
 */
    
#ifndef RC_INVOKED
    
#ifndef _XLIB_H
#   if defined (MAC_TCL)
#       include <Xlib.h>
#       include <X.h>
#   elif defined(MAC_OSX_TK)
#       include <X11/Xlib.h>
#       include <X11/X.h>
#   else
#       include <X11/Xlib.h>
#   endif
#endif
#ifdef __STDC__
#   include <stddef.h>
#endif

#ifdef BUILD_tk
# undef TCL_STORAGE_CLASS
# define TCL_STORAGE_CLASS DLLEXPORT
#endif

/*
 * Decide whether or not to use input methods.
 */

#ifdef XNQueryInputStyle
#define TK_USE_INPUT_METHODS
#endif

/*
 * Dummy types that are used by clients:
 */

typedef struct Tk_BindingTable_ *Tk_BindingTable;
typedef struct Tk_Canvas_ *Tk_Canvas;
typedef struct Tk_Cursor_ *Tk_Cursor;
typedef struct Tk_ErrorHandler_ *Tk_ErrorHandler;
typedef struct Tk_Font_ *Tk_Font;
typedef struct Tk_Image__ *Tk_Image;
typedef struct Tk_ImageMaster_ *Tk_ImageMaster;
typedef struct Tk_OptionTable_ *Tk_OptionTable;
typedef struct Tk_PostscriptInfo_ *Tk_PostscriptInfo;
typedef struct Tk_TextLayout_ *Tk_TextLayout;
typedef struct Tk_Window_ *Tk_Window;
typedef struct Tk_3DBorder_ *Tk_3DBorder;
typedef struct Tk_Style_ *Tk_Style;
typedef struct Tk_StyleEngine_ *Tk_StyleEngine;
typedef struct Tk_StyledElement_ *Tk_StyledElement;

/*
 * Additional types exported to clients.
 */

typedef CONST char *Tk_Uid;

/*
 * The enum below defines the valid types for Tk configuration options
 * as implemented by Tk_InitOptions, Tk_SetOptions, etc.
 */

typedef enum {
    TK_OPTION_BOOLEAN,
    TK_OPTION_INT,
    TK_OPTION_DOUBLE,
    TK_OPTION_STRING,
    TK_OPTION_STRING_TABLE,
    TK_OPTION_COLOR,
    TK_OPTION_FONT,
    TK_OPTION_BITMAP,
    TK_OPTION_BORDER,
    TK_OPTION_RELIEF,
    TK_OPTION_CURSOR,
    TK_OPTION_JUSTIFY,
    TK_OPTION_ANCHOR,
    TK_OPTION_SYNONYM,
    TK_OPTION_PIXELS,
    TK_OPTION_WINDOW,
    TK_OPTION_END,
    TK_OPTION_CUSTOM,
    TK_OPTION_STYLE
} Tk_OptionType;

/*
 * Structures of the following type are used by widgets to specify
 * their configuration options.  Typically each widget has a static
 * array of these structures, where each element of the array describes
 * a single configuration option.  The array is passed to
 * Tk_CreateOptionTable.
 */

typedef struct Tk_OptionSpec {
    Tk_OptionType type;         /* Type of option, such as TK_OPTION_COLOR; 
                                 * see definitions above. Last option in
                                 * table must have type TK_OPTION_END. */
    char *optionName;           /* Name used to specify option in Tcl   
                                 * commands. */
    char *dbName;               /* Name for option in option database. */
    char *dbClass;              /* Class for option in database. */
    char *defValue;             /* Default value for option if not specified
                                 * in command line, the option database,
                                 * or the system. */
    int objOffset;              /* Where in record to store a Tcl_Obj * that
                                 * holds the value of this option, specified
                                 * as an offset in bytes from the start of
                                 * the record. Use the Tk_Offset macro to
                                 * generate values for this.  -1 means don't
                                 * store the Tcl_Obj in the record. */
    int internalOffset;         /* Where in record to store the internal
                                 * representation of the value of this option,
                                 * such as an int or XColor *.  This field
                                 * is specified as an offset in bytes
                                 * from the start of the record. Use the
                                 * Tk_Offset macro to generate values for it.
                                 * -1 means don't store the internal
                                 * representation in the record. */
    int flags;                  /* Any combination of the values defined
                                 * below. */
    ClientData clientData;      /* An alternate place to put option-specific
                                 * data. Used for the monochrome default value
                                 * for colors, etc. */
    int typeMask;               /* An arbitrary bit mask defined by the
                                 * class manager; typically bits correspond
                                 * to certain kinds of options such as all
                                 * those that require a redisplay when they
                                 * change.  Tk_SetOptions returns the bit-wise
                                 * OR of the typeMasks of all options that
                                 * were changed. */
} Tk_OptionSpec;

/*
 * Flag values for Tk_OptionSpec structures.  These flags are shared by
 * Tk_ConfigSpec structures, so be sure to coordinate any changes
 * carefully.
 */

#define TK_OPTION_NULL_OK               (1 << 0)
#define TK_OPTION_DONT_SET_DEFAULT      (1 << 3)

/*
 * The following structure and function types are used by TK_OPTION_CUSTOM
 * options; the structure holds pointers to the functions needed by the Tk
 * option config code to handle a custom option.
 */

typedef int (Tk_CustomOptionSetProc) _ANSI_ARGS_((ClientData clientData,
        Tcl_Interp *interp, Tk_Window tkwin, Tcl_Obj **value, char *widgRec,
        int offset, char *saveInternalPtr, int flags));
typedef Tcl_Obj *(Tk_CustomOptionGetProc) _ANSI_ARGS_((ClientData clientData,
        Tk_Window tkwin, char *widgRec, int offset));
typedef void (Tk_CustomOptionRestoreProc) _ANSI_ARGS_((ClientData clientData,
        Tk_Window tkwin, char *internalPtr, char *saveInternalPtr));
typedef void (Tk_CustomOptionFreeProc) _ANSI_ARGS_((ClientData clientData,
        Tk_Window tkwin, char *internalPtr));
    
typedef struct Tk_ObjCustomOption {
    char *name;                         /* Name of the custom option. */
    Tk_CustomOptionSetProc *setProc;    /* Function to use to set a record's
                                         * option value from a Tcl_Obj */
    Tk_CustomOptionGetProc *getProc;    /* Function to use to get a Tcl_Obj
                                         * representation from an internal
                                         * representation of an option. */
    Tk_CustomOptionRestoreProc *restoreProc;    /* Function to use to restore a
                                                 * saved value for the internal
                                                 * representation. */
    Tk_CustomOptionFreeProc *freeProc;  /* Function to use to free the internal
                                         * representation of an option. */
    ClientData clientData;              /* Arbitrary one-word value passed to
                                         * the handling procs. */
} Tk_ObjCustomOption;


/*
 * Macro to use to fill in "offset" fields of the Tk_OptionSpec.
 * struct.  Computes number of bytes from beginning of structure
 * to a given field.
 */

#ifdef offsetof
#define Tk_Offset(type, field) ((int) offsetof(type, field))
#else
#define Tk_Offset(type, field) ((int) ((char *) &((type *) 0)->field))
#endif

/*
 * The following two structures are used for error handling.  When
 * configuration options are being modified, the old values are
 * saved in a Tk_SavedOptions structure.  If an error occurs, then the
 * contents of the structure can be used to restore all of the old
 * values.  The contents of this structure are for the private use
 * Tk.  No-one outside Tk should ever read or write any of the fields
 * of these structures.
 */

typedef struct Tk_SavedOption {
    struct TkOption *optionPtr;         /* Points to information that describes
                                         * the option. */
    Tcl_Obj *valuePtr;                  /* The old value of the option, in
                                         * the form of a Tcl object; may be
                                         * NULL if the value wasn't saved as
                                         * an object. */
    double internalForm;                /* The old value of the option, in
                                         * some internal representation such
                                         * as an int or (XColor *).  Valid
                                         * only if optionPtr->specPtr->objOffset
                                         * is < 0.  The space must be large
                                         * enough to accommodate a double, a
                                         * long, or a pointer; right now it
                                         * looks like a double is big
                                         * enough.  Also, using a double
                                         * guarantees that the field is
                                         * properly aligned for storing large
                                         * values. */
} Tk_SavedOption;

#ifdef TCL_MEM_DEBUG
#   define TK_NUM_SAVED_OPTIONS 2
#else
#   define TK_NUM_SAVED_OPTIONS 20
#endif

typedef struct Tk_SavedOptions {
    char *recordPtr;                    /* The data structure in which to
                                         * restore configuration options. */
    Tk_Window tkwin;                    /* Window associated with recordPtr;
                                         * needed to restore certain options. */
    int numItems;                       /* The number of valid items in 
                                         * items field. */
    Tk_SavedOption items[TK_NUM_SAVED_OPTIONS];
                                        /* Items used to hold old values. */
    struct Tk_SavedOptions *nextPtr;    /* Points to next structure in list;    
                                         * needed if too many options changed
                                         * to hold all the old values in a
                                         * single structure.  NULL means no
                                         * more structures. */
} Tk_SavedOptions;

/*
 * Structure used to describe application-specific configuration
 * options:  indicates procedures to call to parse an option and
 * to return a text string describing an option. THESE ARE
 * DEPRECATED; PLEASE USE THE NEW STRUCTURES LISTED ABOVE.
 */

/*
 * This is a temporary flag used while tkObjConfig and new widgets
 * are in development.
 */

#ifndef __NO_OLD_CONFIG

typedef int (Tk_OptionParseProc) _ANSI_ARGS_((ClientData clientData,
        Tcl_Interp *interp, Tk_Window tkwin, CONST84 char *value, char *widgRec,
        int offset));
typedef char *(Tk_OptionPrintProc) _ANSI_ARGS_((ClientData clientData,
        Tk_Window tkwin, char *widgRec, int offset,
        Tcl_FreeProc **freeProcPtr));

typedef struct Tk_CustomOption {
    Tk_OptionParseProc *parseProc;      /* Procedure to call to parse an
                                         * option and store it in converted
                                         * form. */
    Tk_OptionPrintProc *printProc;      /* Procedure to return a printable
                                         * string describing an existing
                                         * option. */
    ClientData clientData;              /* Arbitrary one-word value used by
                                         * option parser:  passed to
                                         * parseProc and printProc. */
} Tk_CustomOption;

/*
 * Structure used to specify information for Tk_ConfigureWidget.  Each
 * structure gives complete information for one option, including
 * how the option is specified on the command line, where it appears
 * in the option database, etc.
 */

typedef struct Tk_ConfigSpec {
    int type;                   /* Type of option, such as TK_CONFIG_COLOR;
                                 * see definitions below.  Last option in
                                 * table must have type TK_CONFIG_END. */
    char *argvName;             /* Switch used to specify option in argv.
                                 * NULL means this spec is part of a group. */
    Tk_Uid dbName;              /* Name for option in option database. */
    Tk_Uid dbClass;             /* Class for option in database. */
    Tk_Uid defValue;            /* Default value for option if not
                                 * specified in command line or database. */
    int offset;                 /* Where in widget record to store value;
                                 * use Tk_Offset macro to generate values
                                 * for this. */
    int specFlags;              /* Any combination of the values defined
                                 * below;  other bits are used internally
                                 * by tkConfig.c. */
    Tk_CustomOption *customPtr; /* If type is TK_CONFIG_CUSTOM then this is
                                 * a pointer to info about how to parse and
                                 * print the option.  Otherwise it is
                                 * irrelevant. */
} Tk_ConfigSpec;

/*
 * Type values for Tk_ConfigSpec structures.  See the user
 * documentation for details.
 */

typedef enum {
    TK_CONFIG_BOOLEAN, TK_CONFIG_INT, TK_CONFIG_DOUBLE, TK_CONFIG_STRING,
    TK_CONFIG_UID, TK_CONFIG_COLOR, TK_CONFIG_FONT, TK_CONFIG_BITMAP,
    TK_CONFIG_BORDER, TK_CONFIG_RELIEF, TK_CONFIG_CURSOR, 
    TK_CONFIG_ACTIVE_CURSOR, TK_CONFIG_JUSTIFY, TK_CONFIG_ANCHOR, 
    TK_CONFIG_SYNONYM, TK_CONFIG_CAP_STYLE, TK_CONFIG_JOIN_STYLE,
    TK_CONFIG_PIXELS, TK_CONFIG_MM, TK_CONFIG_WINDOW, TK_CONFIG_CUSTOM, 
    TK_CONFIG_END
} Tk_ConfigTypes;

/*
 * Possible values for flags argument to Tk_ConfigureWidget:
 */

#define TK_CONFIG_ARGV_ONLY     1
#define TK_CONFIG_OBJS          0x80

/*
 * Possible flag values for Tk_ConfigSpec structures.  Any bits at
 * or above TK_CONFIG_USER_BIT may be used by clients for selecting
 * certain entries.  Before changing any values here, coordinate with
 * tkOldConfig.c (internal-use-only flags are defined there).
 */

#define TK_CONFIG_NULL_OK               (1 << 0)
#define TK_CONFIG_COLOR_ONLY            (1 << 1)
#define TK_CONFIG_MONO_ONLY             (1 << 2)
#define TK_CONFIG_DONT_SET_DEFAULT      (1 << 3)
#define TK_CONFIG_OPTION_SPECIFIED      (1 << 4)
#define TK_CONFIG_USER_BIT              0x100
#endif /* __NO_OLD_CONFIG */

/*
 * Structure used to specify how to handle argv options.
 */

typedef struct {
    char *key;          /* The key string that flags the option in the
                         * argv array. */
    int type;           /* Indicates option type;  see below. */
    char *src;          /* Value to be used in setting dst;  usage
                         * depends on type. */
    char *dst;          /* Address of value to be modified;  usage
                         * depends on type. */
    char *help;         /* Documentation message describing this option. */
} Tk_ArgvInfo;

/*
 * Legal values for the type field of a Tk_ArgvInfo: see the user
 * documentation for details.
 */

#define TK_ARGV_CONSTANT                15
#define TK_ARGV_INT                     16
#define TK_ARGV_STRING                  17
#define TK_ARGV_UID                     18
#define TK_ARGV_REST                    19
#define TK_ARGV_FLOAT                   20
#define TK_ARGV_FUNC                    21
#define TK_ARGV_GENFUNC                 22
#define TK_ARGV_HELP                    23
#define TK_ARGV_CONST_OPTION            24
#define TK_ARGV_OPTION_VALUE            25
#define TK_ARGV_OPTION_NAME_VALUE       26
#define TK_ARGV_END                     27

/*
 * Flag bits for passing to Tk_ParseArgv:
 */

#define TK_ARGV_NO_DEFAULTS             0x1
#define TK_ARGV_NO_LEFTOVERS            0x2
#define TK_ARGV_NO_ABBREV               0x4
#define TK_ARGV_DONT_SKIP_FIRST_ARG     0x8

/*
 * Enumerated type for describing actions to be taken in response
 * to a restrictProc established by Tk_RestrictEvents.
 */

typedef enum {
    TK_DEFER_EVENT, TK_PROCESS_EVENT, TK_DISCARD_EVENT
} Tk_RestrictAction;

/*
 * Priority levels to pass to Tk_AddOption:
 */

#define TK_WIDGET_DEFAULT_PRIO  20
#define TK_STARTUP_FILE_PRIO    40
#define TK_USER_DEFAULT_PRIO    60
#define TK_INTERACTIVE_PRIO     80
#define TK_MAX_PRIO             100

/*
 * Relief values returned by Tk_GetRelief:
 */

#define TK_RELIEF_NULL          -1
#define TK_RELIEF_FLAT          0
#define TK_RELIEF_GROOVE        1
#define TK_RELIEF_RAISED        2
#define TK_RELIEF_RIDGE         3
#define TK_RELIEF_SOLID         4
#define TK_RELIEF_SUNKEN        5

/*
 * "Which" argument values for Tk_3DBorderGC:
 */

#define TK_3D_FLAT_GC           1
#define TK_3D_LIGHT_GC          2
#define TK_3D_DARK_GC           3

/*
 * Special EnterNotify/LeaveNotify "mode" for use in events
 * generated by tkShare.c.  Pick a high enough value that it's
 * unlikely to conflict with existing values (like NotifyNormal)
 * or any new values defined in the future.
 */

#define TK_NOTIFY_SHARE         20

/*
 * Enumerated type for describing a point by which to anchor something:
 */

typedef enum {
    TK_ANCHOR_N, TK_ANCHOR_NE, TK_ANCHOR_E, TK_ANCHOR_SE,
    TK_ANCHOR_S, TK_ANCHOR_SW, TK_ANCHOR_W, TK_ANCHOR_NW,
    TK_ANCHOR_CENTER
} Tk_Anchor;

/*
 * Enumerated type for describing a style of justification:
 */

typedef enum {
    TK_JUSTIFY_LEFT, TK_JUSTIFY_RIGHT, TK_JUSTIFY_CENTER
} Tk_Justify;

/*
 * The following structure is used by Tk_GetFontMetrics() to return
 * information about the properties of a Tk_Font.  
 */

typedef struct Tk_FontMetrics {
    int ascent;                 /* The amount in pixels that the tallest
                                 * letter sticks up above the baseline, plus
                                 * any extra blank space added by the designer
                                 * of the font. */
    int descent;                /* The largest amount in pixels that any
                                 * letter sticks below the baseline, plus any
                                 * extra blank space added by the designer of
                                 * the font. */
    int linespace;              /* The sum of the ascent and descent.  How
                                 * far apart two lines of text in the same
                                 * font should be placed so that none of the
                                 * characters in one line overlap any of the
                                 * characters in the other line. */
} Tk_FontMetrics;

/*
 * Flags passed to Tk_MeasureChars:
 */

#define TK_WHOLE_WORDS          1
#define TK_AT_LEAST_ONE         2
#define TK_PARTIAL_OK           4

/*
 * Flags passed to Tk_ComputeTextLayout:
 */

#define TK_IGNORE_TABS          8
#define TK_IGNORE_NEWLINES      16

/*
 * Widget class procedures used to implement platform specific widget
 * behavior.
 */

typedef Window (Tk_ClassCreateProc) _ANSI_ARGS_((Tk_Window tkwin,
        Window parent, ClientData instanceData));
typedef void (Tk_ClassWorldChangedProc) _ANSI_ARGS_((ClientData instanceData));
typedef void (Tk_ClassModalProc) _ANSI_ARGS_((Tk_Window tkwin,
        XEvent *eventPtr));

typedef struct Tk_ClassProcs {
    unsigned int size;
    Tk_ClassWorldChangedProc *worldChangedProc;
                                /* Procedure to invoke when the widget needs to
                                 * respond in some way to a change in the
                                 * world (font changes, etc.) */
    Tk_ClassCreateProc *createProc;
                                /* Procedure to invoke when the
                                 * platform-dependent window needs to be
                                 * created. */
    Tk_ClassModalProc *modalProc;
                                /* Procedure to invoke after all bindings on a
                                 * widget have been triggered in order to
                                 * handle a modal loop. */
} Tk_ClassProcs;

/*
 * Simple accessor for Tk_ClassProcs structure.  Checks that the structure
 * is not NULL, then checks the size field and returns either the requested
 * field, if present, or NULL if the structure is too small to have the field
 * (or NULL if the structure is NULL).
 *
 * A more general version of this function may be useful if other
 * size-versioned structure pop up in the future:
 *
 *      #define Tk_GetField(name, who, which) \
 *          (((who) == NULL) ? NULL :
 *          (((who)->size <= Tk_Offset(name, which)) ? NULL :(name)->which))
 */

#define Tk_GetClassProc(procs, which) \
    (((procs) == NULL) ? NULL : \
    (((procs)->size <= Tk_Offset(Tk_ClassProcs, which)) ? NULL:(procs)->which))

/*
 * Each geometry manager (the packer, the placer, etc.) is represented
 * by a structure of the following form, which indicates procedures
 * to invoke in the geometry manager to carry out certain functions.
 */

typedef void (Tk_GeomRequestProc) _ANSI_ARGS_((ClientData clientData,
        Tk_Window tkwin));
typedef void (Tk_GeomLostSlaveProc) _ANSI_ARGS_((ClientData clientData,
        Tk_Window tkwin));

typedef struct Tk_GeomMgr {
    char *name;                 /* Name of the geometry manager (command
                                 * used to invoke it, or name of widget
                                 * class that allows embedded widgets). */
    Tk_GeomRequestProc *requestProc;
                                /* Procedure to invoke when a slave's
                                 * requested geometry changes. */
    Tk_GeomLostSlaveProc *lostSlaveProc;
                                /* Procedure to invoke when a slave is
                                 * taken away from one geometry manager
                                 * by another.  NULL means geometry manager
                                 * doesn't care when slaves are lost. */
} Tk_GeomMgr;

/*
 * Result values returned by Tk_GetScrollInfo:
 */

#define TK_SCROLL_MOVETO        1
#define TK_SCROLL_PAGES         2
#define TK_SCROLL_UNITS         3
#define TK_SCROLL_ERROR         4

/*
 *---------------------------------------------------------------------------
 *
 * Extensions to the X event set
 *
 *---------------------------------------------------------------------------
 */
#define VirtualEvent        (LASTEvent)
#define ActivateNotify      (LASTEvent + 1)
#define DeactivateNotify    (LASTEvent + 2)
#define MouseWheelEvent     (LASTEvent + 3)
#define TK_LASTEVENT        (LASTEvent + 4)

#define MouseWheelMask      (1L << 28)

#define ActivateMask        (1L << 29)
#define VirtualEventMask    (1L << 30)
#define TK_LASTEVENT        (LASTEvent + 4)


/*
 * A virtual event shares most of its fields with the XKeyEvent and
 * XButtonEvent structures.  99% of the time a virtual event will be
 * an abstraction of a key or button event, so this structure provides
 * the most information to the user.  The only difference is the changing
 * of the detail field for a virtual event so that it holds the name of the
 * virtual event being triggered.
 */

typedef struct {
    int type;
    unsigned long serial;   /* # of last request processed by server */
    Bool send_event;        /* True if this came from a SendEvent request */
    Display *display;       /* Display the event was read from */
    Window event;           /* Window on which event was requested. */
    Window root;            /* root window that the event occured on */
    Window subwindow;       /* child window */
    Time time;              /* milliseconds */
    int x, y;               /* pointer x, y coordinates in event window */
    int x_root, y_root;     /* coordinates relative to root */
    unsigned int state;     /* key or button mask */
    Tk_Uid name;            /* Name of virtual event. */
    Bool same_screen;       /* same screen flag */
} XVirtualEvent;

typedef struct {
    int type;
    unsigned long serial;   /* # of last request processed by server */
    Bool send_event;        /* True if this came from a SendEvent request */
    Display *display;       /* Display the event was read from */
    Window window;          /* Window in which event occurred. */
} XActivateDeactivateEvent;
typedef XActivateDeactivateEvent XActivateEvent;
typedef XActivateDeactivateEvent XDeactivateEvent;

/*
 *--------------------------------------------------------------
 *
 * Macros for querying Tk_Window structures.  See the
 * manual entries for documentation.
 *
 *--------------------------------------------------------------
 */

#define Tk_Display(tkwin)               (((Tk_FakeWin *) (tkwin))->display)
#define Tk_ScreenNumber(tkwin)          (((Tk_FakeWin *) (tkwin))->screenNum)
#define Tk_Screen(tkwin)                (ScreenOfDisplay(Tk_Display(tkwin), \
        Tk_ScreenNumber(tkwin)))
#define Tk_Depth(tkwin)                 (((Tk_FakeWin *) (tkwin))->depth)
#define Tk_Visual(tkwin)                (((Tk_FakeWin *) (tkwin))->visual)
#define Tk_WindowId(tkwin)              (((Tk_FakeWin *) (tkwin))->window)
#define Tk_PathName(tkwin)              (((Tk_FakeWin *) (tkwin))->pathName)
#define Tk_Name(tkwin)                  (((Tk_FakeWin *) (tkwin))->nameUid)
#define Tk_Class(tkwin)                 (((Tk_FakeWin *) (tkwin))->classUid)
#define Tk_X(tkwin)                     (((Tk_FakeWin *) (tkwin))->changes.x)
#define Tk_Y(tkwin)                     (((Tk_FakeWin *) (tkwin))->changes.y)
#define Tk_Width(tkwin)                 (((Tk_FakeWin *) (tkwin))->changes.width)
#define Tk_Height(tkwin) \
    (((Tk_FakeWin *) (tkwin))->changes.height)
#define Tk_Changes(tkwin)               (&((Tk_FakeWin *) (tkwin))->changes)
#define Tk_Attributes(tkwin)            (&((Tk_FakeWin *) (tkwin))->atts)
#define Tk_IsEmbedded(tkwin) \
    (((Tk_FakeWin *) (tkwin))->flags & TK_EMBEDDED)
#define Tk_IsContainer(tkwin) \
    (((Tk_FakeWin *) (tkwin))->flags & TK_CONTAINER)
#define Tk_IsMapped(tkwin) \
    (((Tk_FakeWin *) (tkwin))->flags & TK_MAPPED)
#define Tk_IsTopLevel(tkwin) \
    (((Tk_FakeWin *) (tkwin))->flags & TK_TOP_LEVEL)
#define Tk_HasWrapper(tkwin) \
    (((Tk_FakeWin *) (tkwin))->flags & TK_HAS_WRAPPER)
#define Tk_WinManaged(tkwin) \
    (((Tk_FakeWin *) (tkwin))->flags & TK_WIN_MANAGED)
#define Tk_TopWinHierarchy(tkwin) \
    (((Tk_FakeWin *) (tkwin))->flags & TK_TOP_HIERARCHY)
#define Tk_ReqWidth(tkwin)              (((Tk_FakeWin *) (tkwin))->reqWidth)
#define Tk_ReqHeight(tkwin)             (((Tk_FakeWin *) (tkwin))->reqHeight)
/* Tk_InternalBorderWidth is deprecated */
#define Tk_InternalBorderWidth(tkwin) \
    (((Tk_FakeWin *) (tkwin))->internalBorderLeft)
#define Tk_InternalBorderLeft(tkwin) \
    (((Tk_FakeWin *) (tkwin))->internalBorderLeft)
#define Tk_InternalBorderRight(tkwin) \
    (((Tk_FakeWin *) (tkwin))->internalBorderRight)
#define Tk_InternalBorderTop(tkwin) \
    (((Tk_FakeWin *) (tkwin))->internalBorderTop)
#define Tk_InternalBorderBottom(tkwin) \
    (((Tk_FakeWin *) (tkwin))->internalBorderBottom)
#define Tk_MinReqWidth(tkwin)           (((Tk_FakeWin *) (tkwin))->minReqWidth)
#define Tk_MinReqHeight(tkwin)          (((Tk_FakeWin *) (tkwin))->minReqHeight)
#define Tk_Parent(tkwin)                (((Tk_FakeWin *) (tkwin))->parentPtr)
#define Tk_Colormap(tkwin)              (((Tk_FakeWin *) (tkwin))->atts.colormap)

/*
 * The structure below is needed by the macros above so that they can
 * access the fields of a Tk_Window.  The fields not needed by the macros
 * are declared as "dummyX".  The structure has its own type in order to
 * prevent applications from accessing Tk_Window fields except using
 * official macros.  WARNING!! The structure definition must be kept
 * consistent with the TkWindow structure in tkInt.h.  If you change one,
 * then change the other.  See the declaration in tkInt.h for
 * documentation on what the fields are used for internally.
 */

typedef struct Tk_FakeWin {
    Display *display;
    char *dummy1;               /* dispPtr */
    int screenNum;
    Visual *visual;
    int depth;
    Window window;
    char *dummy2;               /* childList */
    char *dummy3;               /* lastChildPtr */
    Tk_Window parentPtr;        /* parentPtr */
    char *dummy4;               /* nextPtr */
    char *dummy5;               /* mainPtr */
    char *pathName;
    Tk_Uid nameUid;
    Tk_Uid classUid;
    XWindowChanges changes;
    unsigned int dummy6;        /* dirtyChanges */
    XSetWindowAttributes atts;
    unsigned long dummy7;       /* dirtyAtts */
    unsigned int flags;
    char *dummy8;               /* handlerList */
#ifdef TK_USE_INPUT_METHODS
    XIC dummy9;                 /* inputContext */
#endif /* TK_USE_INPUT_METHODS */
    ClientData *dummy10;        /* tagPtr */
    int dummy11;                /* numTags */
    int dummy12;                /* optionLevel */
    char *dummy13;              /* selHandlerList */
    char *dummy14;              /* geomMgrPtr */
    ClientData dummy15;         /* geomData */
    int reqWidth, reqHeight;
    int internalBorderLeft;
    char *dummy16;              /* wmInfoPtr */
    char *dummy17;              /* classProcPtr */
    ClientData dummy18;         /* instanceData */
    char *dummy19;              /* privatePtr */
    int internalBorderRight;
    int internalBorderTop;
    int internalBorderBottom;
    int minReqWidth;
    int minReqHeight;
} Tk_FakeWin;

/*
 * Flag values for TkWindow (and Tk_FakeWin) structures are:
 *
 * TK_MAPPED:                   1 means window is currently mapped,
 *                              0 means unmapped.
 * TK_TOP_LEVEL:                1 means this is a top-level widget.
 * TK_ALREADY_DEAD:             1 means the window is in the process of
 *                              being destroyed already.
 * TK_NEED_CONFIG_NOTIFY:       1 means that the window has been reconfigured
 *                              before it was made to exist.  At the time of
 *                              making it exist a ConfigureNotify event needs
 *                              to be generated.
 * TK_GRAB_FLAG:                Used to manage grabs.  See tkGrab.c for
 *                              details.
 * TK_CHECKED_IC:               1 means we've already tried to get an input
 *                              context for this window;  if the ic field
 *                              is NULL it means that there isn't a context
 *                              for the field.
 * TK_DONT_DESTROY_WINDOW:      1 means that Tk_DestroyWindow should not
 *                              invoke XDestroyWindow to destroy this widget's
 *                              X window.  The flag is set when the window
 *                              has already been destroyed elsewhere (e.g.
 *                              by another application) or when it will be
 *                              destroyed later (e.g. by destroying its
 *                              parent).
 * TK_WM_COLORMAP_WINDOW:       1 means that this window has at some time
 *                              appeared in the WM_COLORMAP_WINDOWS property
 *                              for its toplevel, so we have to remove it
 *                              from that property if the window is
 *                              deleted and the toplevel isn't.
 * TK_EMBEDDED:                 1 means that this window (which must be a
 *                              toplevel) is not a free-standing window but
 *                              rather is embedded in some other application.
 * TK_CONTAINER:                1 means that this window is a container, and
 *                              that some other application (either in
 *                              this process or elsewhere) may be
 *                              embedding itself inside the window.
 * TK_BOTH_HALVES:              1 means that this window is used for
 *                              application embedding (either as
 *                              container or embedded application), and
 *                              both the containing and embedded halves
 *                              are associated with windows in this
 *                              particular process.
 * TK_DEFER_MODAL:              1 means that this window has deferred a modal
 *                              loop until all of the bindings for the current
 *                              event have been invoked.
 * TK_WRAPPER:                  1 means that this window is the extra
 *                              wrapper window created around a toplevel
 *                              to hold the menubar under Unix.  See
 *                              tkUnixWm.c for more information.
 * TK_REPARENTED:               1 means that this window has been reparented
 *                              so that as far as the window system is
 *                              concerned it isn't a child of its Tk
 *                              parent.  Initially this is used only for
 *                              special Unix menubar windows.
 * TK_ANONYMOUS_WINDOW:         1 means that this window has no name, and is
 *                              thus not accessible from Tk.
 * TK_HAS_WRAPPER               1 means that this window has a wrapper window
 * TK_WIN_MANAGED               1 means that this window is a child of the
 *                              root window, and is managed by the window
 *                              manager.
 * TK_TOP_HIERARCHY             1 means this window is at the top of a
 *                              physical window hierarchy within this
 *                              process, i.e. the window's parent
 *                              either doesn't exist or is not owned by
 *                              this Tk application.
 * TK_PROP_PROPCHANGE           1 means that PropertyNotify events in
 *                              this window's children should propagate
 *                              up to this window.
 */


#define TK_MAPPED               1
#define TK_TOP_LEVEL            2
#define TK_ALREADY_DEAD         4
#define TK_NEED_CONFIG_NOTIFY   8
#define TK_GRAB_FLAG            0x10
#define TK_CHECKED_IC           0x20
#define TK_DONT_DESTROY_WINDOW  0x40
#define TK_WM_COLORMAP_WINDOW   0x80
#define TK_EMBEDDED             0x100
#define TK_CONTAINER            0x200
#define TK_BOTH_HALVES          0x400
#define TK_DEFER_MODAL          0x800
#define TK_WRAPPER              0x1000
#define TK_REPARENTED           0x2000
#define TK_ANONYMOUS_WINDOW     0x4000
#define TK_HAS_WRAPPER          0x8000
#define TK_WIN_MANAGED          0x10000
#define TK_TOP_HIERARCHY        0x20000
#define TK_PROP_PROPCHANGE      0x40000

/*
 *--------------------------------------------------------------
 *
 * Procedure prototypes and structures used for defining new canvas
 * items:
 *
 *--------------------------------------------------------------
 */

typedef enum {
    TK_STATE_NULL = -1, TK_STATE_ACTIVE, TK_STATE_DISABLED,
    TK_STATE_NORMAL, TK_STATE_HIDDEN
} Tk_State;

typedef struct Tk_SmoothMethod {
    char *name;
    int (*coordProc) _ANSI_ARGS_((Tk_Canvas canvas,
                double *pointPtr, int numPoints, int numSteps,
                XPoint xPoints[], double dblPoints[]));
    void (*postscriptProc) _ANSI_ARGS_((Tcl_Interp *interp,
                Tk_Canvas canvas, double *coordPtr,
                int numPoints, int numSteps));
} Tk_SmoothMethod;

/*
 * For each item in a canvas widget there exists one record with
 * the following structure.  Each actual item is represented by
 * a record with the following stuff at its beginning, plus additional
 * type-specific stuff after that.
 */

#define TK_TAG_SPACE 3

typedef struct Tk_Item  {
    int id;                             /* Unique identifier for this item
                                         * (also serves as first tag for
                                         * item). */
    struct Tk_Item *nextPtr;            /* Next in display list of all
                                         * items in this canvas.  Later items
                                         * in list are drawn on top of earlier
                                         * ones. */
    Tk_Uid staticTagSpace[TK_TAG_SPACE];/* Built-in space for limited # of
                                         * tags. */
    Tk_Uid *tagPtr;                     /* Pointer to array of tags.  Usually
                                         * points to staticTagSpace, but
                                         * may point to malloc-ed space if
                                         * there are lots of tags. */
    int tagSpace;                       /* Total amount of tag space available
                                         * at tagPtr. */
    int numTags;                        /* Number of tag slots actually used
                                         * at *tagPtr. */
    struct Tk_ItemType *typePtr;        /* Table of procedures that implement
                                         * this type of item. */
    int x1, y1, x2, y2;                 /* Bounding box for item, in integer
                                         * canvas units. Set by item-specific
                                         * code and guaranteed to contain every
                                         * pixel drawn in item.  Item area
                                         * includes x1 and y1 but not x2
                                         * and y2. */
    struct Tk_Item *prevPtr;            /* Previous in display list of all
                                         * items in this canvas. Later items
                                         * in list are drawn just below earlier
                                         * ones. */
    Tk_State state;                     /* state of item */
    char *reserved1;                    /* reserved for future use */
    int redraw_flags;                   /* some flags used in the canvas */

    /*
     *------------------------------------------------------------------
     * Starting here is additional type-specific stuff;  see the
     * declarations for individual types to see what is part of
     * each type.  The actual space below is determined by the
     * "itemInfoSize" of the type's Tk_ItemType record.
     *------------------------------------------------------------------
     */
} Tk_Item;

/*
 * Flag bits for canvases (redraw_flags):
 *
 * TK_ITEM_STATE_DEPENDANT -    1 means that object needs to be
 *                              redrawn if the canvas state changes.
 * TK_ITEM_DONT_REDRAW -        1 means that the object redraw is already
 *                              been prepared, so the general canvas code
 *                              doesn't need to do that any more.
 */

#define TK_ITEM_STATE_DEPENDANT         1
#define TK_ITEM_DONT_REDRAW             2

/*
 * Records of the following type are used to describe a type of
 * item (e.g.  lines, circles, etc.) that can form part of a
 * canvas widget.
 */

#ifdef USE_OLD_CANVAS
typedef int     Tk_ItemCreateProc _ANSI_ARGS_((Tcl_Interp *interp,
                    Tk_Canvas canvas, Tk_Item *itemPtr, int argc,
                    char **argv));
typedef int     Tk_ItemConfigureProc _ANSI_ARGS_((Tcl_Interp *interp,
                    Tk_Canvas canvas, Tk_Item *itemPtr, int argc,
                    char **argv, int flags));
typedef int     Tk_ItemCoordProc _ANSI_ARGS_((Tcl_Interp *interp,
                    Tk_Canvas canvas, Tk_Item *itemPtr, int argc,
                    char **argv));
#else
typedef int     Tk_ItemCreateProc _ANSI_ARGS_((Tcl_Interp *interp,
                    Tk_Canvas canvas, Tk_Item *itemPtr, int argc,
                    Tcl_Obj *CONST objv[]));
typedef int     Tk_ItemConfigureProc _ANSI_ARGS_((Tcl_Interp *interp,
                    Tk_Canvas canvas, Tk_Item *itemPtr, int argc,
                    Tcl_Obj *CONST objv[], int flags));
typedef int     Tk_ItemCoordProc _ANSI_ARGS_((Tcl_Interp *interp,
                    Tk_Canvas canvas, Tk_Item *itemPtr, int argc,
                    Tcl_Obj *CONST argv[]));
#endif
typedef void    Tk_ItemDeleteProc _ANSI_ARGS_((Tk_Canvas canvas,
                    Tk_Item *itemPtr, Display *display));
typedef void    Tk_ItemDisplayProc _ANSI_ARGS_((Tk_Canvas canvas,
                    Tk_Item *itemPtr, Display *display, Drawable dst,
                    int x, int y, int width, int height));
typedef double  Tk_ItemPointProc _ANSI_ARGS_((Tk_Canvas canvas,
                    Tk_Item *itemPtr, double *pointPtr));
typedef int     Tk_ItemAreaProc _ANSI_ARGS_((Tk_Canvas canvas,
                    Tk_Item *itemPtr, double *rectPtr));
typedef int     Tk_ItemPostscriptProc _ANSI_ARGS_((Tcl_Interp *interp,
                    Tk_Canvas canvas, Tk_Item *itemPtr, int prepass));
typedef void    Tk_ItemScaleProc _ANSI_ARGS_((Tk_Canvas canvas,
                    Tk_Item *itemPtr, double originX, double originY,
                    double scaleX, double scaleY));
typedef void    Tk_ItemTranslateProc _ANSI_ARGS_((Tk_Canvas canvas,
                    Tk_Item *itemPtr, double deltaX, double deltaY));
typedef int     Tk_ItemIndexProc _ANSI_ARGS_((Tcl_Interp *interp,
                    Tk_Canvas canvas, Tk_Item *itemPtr, char *indexString,
                    int *indexPtr));
typedef void    Tk_ItemCursorProc _ANSI_ARGS_((Tk_Canvas canvas,
                    Tk_Item *itemPtr, int index));
typedef int     Tk_ItemSelectionProc _ANSI_ARGS_((Tk_Canvas canvas,
                    Tk_Item *itemPtr, int offset, char *buffer,
                    int maxBytes));
typedef void    Tk_ItemInsertProc _ANSI_ARGS_((Tk_Canvas canvas,
                    Tk_Item *itemPtr, int beforeThis, char *string));
typedef void    Tk_ItemDCharsProc _ANSI_ARGS_((Tk_Canvas canvas,
                    Tk_Item *itemPtr, int first, int last));

#ifndef __NO_OLD_CONFIG

typedef struct Tk_ItemType {
    char *name;                         /* The name of this type of item, such
                                         * as "line". */
    int itemSize;                       /* Total amount of space needed for
                                         * item's record. */
    Tk_ItemCreateProc *createProc;      /* Procedure to create a new item of
                                         * this type. */
    Tk_ConfigSpec *configSpecs;         /* Pointer to array of configuration
                                         * specs for this type.  Used for
                                         * returning configuration info. */
    Tk_ItemConfigureProc *configProc;   /* Procedure to call to change
                                         * configuration options. */
    Tk_ItemCoordProc *coordProc;        /* Procedure to call to get and set
                                         * the item's coordinates. */
    Tk_ItemDeleteProc *deleteProc;      /* Procedure to delete existing item of
                                         * this type. */
    Tk_ItemDisplayProc *displayProc;    /* Procedure to display items of
                                         * this type. */
    int alwaysRedraw;                   /* Non-zero means displayProc should
                                         * be called even when the item has
                                         * been moved off-screen. */
    Tk_ItemPointProc *pointProc;        /* Computes distance from item to
                                         * a given point. */
    Tk_ItemAreaProc *areaProc;          /* Computes whether item is inside,
                                         * outside, or overlapping an area. */
    Tk_ItemPostscriptProc *postscriptProc;
                                        /* Procedure to write a Postscript
                                         * description for items of this
                                         * type. */
    Tk_ItemScaleProc *scaleProc;        /* Procedure to rescale items of
                                         * this type. */
    Tk_ItemTranslateProc *translateProc;/* Procedure to translate items of
                                         * this type. */
    Tk_ItemIndexProc *indexProc;        /* Procedure to determine index of
                                         * indicated character.  NULL if
                                         * item doesn't support indexing. */
    Tk_ItemCursorProc *icursorProc;     /* Procedure to set insert cursor pos.
                                         * to just before a given position. */
    Tk_ItemSelectionProc *selectionProc;/* Procedure to return selection (in
                                         * STRING format) when it is in this
                                         * item. */
    Tk_ItemInsertProc *insertProc;      /* Procedure to insert something into
                                         * an item. */
    Tk_ItemDCharsProc *dCharsProc;      /* Procedure to delete characters
                                         * from an item. */
    struct Tk_ItemType *nextPtr;        /* Used to link types together into
                                         * a list. */
    char *reserved1;                    /* Reserved for future extension. */
    int   reserved2;                    /* Carefully compatible with */
    char *reserved3;                    /* Jan Nijtmans dash patch */
    char *reserved4;
} Tk_ItemType;

#endif

/*
 * The following structure provides information about the selection and
 * the insertion cursor.  It is needed by only a few items, such as
 * those that display text.  It is shared by the generic canvas code
 * and the item-specific code, but most of the fields should be written
 * only by the canvas generic code.
 */

typedef struct Tk_CanvasTextInfo {
    Tk_3DBorder selBorder;      /* Border and background for selected
                                 * characters.  Read-only to items.*/
    int selBorderWidth;         /* Width of border around selection. 
                                 * Read-only to items. */
    XColor *selFgColorPtr;      /* Foreground color for selected text.
                                 * Read-only to items. */
    Tk_Item *selItemPtr;        /* Pointer to selected item.  NULL means
                                 * selection isn't in this canvas.
                                 * Writable by items. */
    int selectFirst;            /* Character index of first selected
                                 * character.  Writable by items. */
    int selectLast;             /* Character index of last selected
                                 * character.  Writable by items. */
    Tk_Item *anchorItemPtr;     /* Item corresponding to "selectAnchor":
                                 * not necessarily selItemPtr.   Read-only
                                 * to items. */
    int selectAnchor;           /* Character index of fixed end of
                                 * selection (i.e. "select to" operation will
                                 * use this as one end of the selection).
                                 * Writable by items. */
    Tk_3DBorder insertBorder;   /* Used to draw vertical bar for insertion
                                 * cursor.  Read-only to items. */
    int insertWidth;            /* Total width of insertion cursor.  Read-only
                                 * to items. */
    int insertBorderWidth;      /* Width of 3-D border around insert cursor.
                                 * Read-only to items. */
    Tk_Item *focusItemPtr;      /* Item that currently has the input focus,
                                 * or NULL if no such item.  Read-only to
                                 * items.  */
    int gotFocus;               /* Non-zero means that the canvas widget has
                                 * the input focus.  Read-only to items.*/
    int cursorOn;               /* Non-zero means that an insertion cursor
                                 * should be displayed in focusItemPtr.
                                 * Read-only to items.*/
} Tk_CanvasTextInfo;

/*
 * Structures used for Dashing and Outline.
 */

typedef struct Tk_Dash {
    int number;
    union {
        char *pt;
        char array[sizeof(char *)];
    } pattern;
} Tk_Dash;

typedef struct Tk_TSOffset {
    int flags;                  /* flags; see below for possible values */
    int xoffset;                /* x offset */
    int yoffset;                /* y offset */
} Tk_TSOffset;

/*
 * Bit fields in Tk_Offset->flags:
 */

#define TK_OFFSET_INDEX         1
#define TK_OFFSET_RELATIVE      2
#define TK_OFFSET_LEFT          4
#define TK_OFFSET_CENTER        8
#define TK_OFFSET_RIGHT         16
#define TK_OFFSET_TOP           32
#define TK_OFFSET_MIDDLE        64
#define TK_OFFSET_BOTTOM        128

typedef struct Tk_Outline {
    GC gc;                      /* Graphics context. */
    double width;               /* Width of outline. */
    double activeWidth;         /* Width of outline. */
    double disabledWidth;       /* Width of outline. */
    int offset;                 /* Dash offset */
    Tk_Dash dash;               /* Dash pattern */
    Tk_Dash activeDash;         /* Dash pattern if state is active*/
    Tk_Dash disabledDash;       /* Dash pattern if state is disabled*/
    VOID *reserved1;            /* reserved for future expansion */
    VOID *reserved2;
    VOID *reserved3;
    Tk_TSOffset tsoffset;       /* stipple offset for outline*/
    XColor *color;              /* Outline color. */
    XColor *activeColor;        /* Outline color if state is active. */
    XColor *disabledColor;      /* Outline color if state is disabled. */
    Pixmap stipple;             /* Outline Stipple pattern. */
    Pixmap activeStipple;       /* Outline Stipple pattern if state is active. */
    Pixmap disabledStipple;     /* Outline Stipple pattern if state is disabled. */
} Tk_Outline;


/*
 *--------------------------------------------------------------
 *
 * Procedure prototypes and structures used for managing images:
 *
 *--------------------------------------------------------------
 */

typedef struct Tk_ImageType Tk_ImageType;
#ifdef USE_OLD_IMAGE
typedef int (Tk_ImageCreateProc) _ANSI_ARGS_((Tcl_Interp *interp,
        char *name, int argc, char **argv, Tk_ImageType *typePtr,
        Tk_ImageMaster master, ClientData *masterDataPtr));
#else
typedef int (Tk_ImageCreateProc) _ANSI_ARGS_((Tcl_Interp *interp,
        char *name, int objc, Tcl_Obj *CONST objv[], Tk_ImageType *typePtr,
        Tk_ImageMaster master, ClientData *masterDataPtr));
#endif
typedef ClientData (Tk_ImageGetProc) _ANSI_ARGS_((Tk_Window tkwin,
        ClientData masterData));
typedef void (Tk_ImageDisplayProc) _ANSI_ARGS_((ClientData instanceData,
        Display *display, Drawable drawable, int imageX, int imageY,
        int width, int height, int drawableX, int drawableY));
typedef void (Tk_ImageFreeProc) _ANSI_ARGS_((ClientData instanceData,
        Display *display));
typedef void (Tk_ImageDeleteProc) _ANSI_ARGS_((ClientData masterData));
typedef void (Tk_ImageChangedProc) _ANSI_ARGS_((ClientData clientData,
        int x, int y, int width, int height, int imageWidth,
        int imageHeight));
typedef int (Tk_ImagePostscriptProc) _ANSI_ARGS_((ClientData clientData,
        Tcl_Interp *interp, Tk_Window tkwin, Tk_PostscriptInfo psinfo,
        int x, int y, int width, int height, int prepass));

/*
 * The following structure represents a particular type of image
 * (bitmap, xpm image, etc.).  It provides information common to
 * all images of that type, such as the type name and a collection
 * of procedures in the image manager that respond to various
 * events.  Each image manager is represented by one of these
 * structures.
 */

struct Tk_ImageType {
    char *name;                 /* Name of image type. */
    Tk_ImageCreateProc *createProc;
                                /* Procedure to call to create a new image
                                 * of this type. */
    Tk_ImageGetProc *getProc;   /* Procedure to call the first time
                                 * Tk_GetImage is called in a new way
                                 * (new visual or screen). */
    Tk_ImageDisplayProc *displayProc;
                                /* Call to draw image, in response to
                                 * Tk_RedrawImage calls. */
    Tk_ImageFreeProc *freeProc; /* Procedure to call whenever Tk_FreeImage
                                 * is called to release an instance of an
                                 * image. */
    Tk_ImageDeleteProc *deleteProc;
                                /* Procedure to call to delete image.  It
                                 * will not be called until after freeProc
                                 * has been called for each instance of the
                                 * image. */
    Tk_ImagePostscriptProc *postscriptProc;
                                /* Procedure to call to produce postscript
                                 * output for the image. */
    struct Tk_ImageType *nextPtr;
                                /* Next in list of all image types currently
                                 * known.  Filled in by Tk, not by image
                                 * manager. */
    char *reserved;             /* reserved for future expansion */
};

/*
 *--------------------------------------------------------------
 *
 * Additional definitions used to manage images of type "photo".
 *
 *--------------------------------------------------------------
 */

/*
 * The following type is used to identify a particular photo image
 * to be manipulated:
 */

typedef void *Tk_PhotoHandle;

/*
 * The following structure describes a block of pixels in memory:
 */

typedef struct Tk_PhotoImageBlock {
    unsigned char *pixelPtr;    /* Pointer to the first pixel. */
    int         width;          /* Width of block, in pixels. */
    int         height;         /* Height of block, in pixels. */
    int         pitch;          /* Address difference between corresponding
                                 * pixels in successive lines. */
    int         pixelSize;      /* Address difference between successive
                                 * pixels in the same line. */
    int         offset[4];      /* Address differences between the red, green,
                                 * blue and alpha components of the pixel and
                                 * the pixel as a whole. */
} Tk_PhotoImageBlock;

/*
 * The following values control how blocks are combined into photo
 * images when the alpha component of a pixel is not 255, a.k.a. the
 * compositing rule.
 */

#define TK_PHOTO_COMPOSITE_OVERLAY      0
#define TK_PHOTO_COMPOSITE_SET          1

/*
 * Procedure prototypes and structures used in reading and
 * writing photo images:
 */

typedef struct Tk_PhotoImageFormat Tk_PhotoImageFormat;
#ifdef USE_OLD_IMAGE
typedef int (Tk_ImageFileMatchProc) _ANSI_ARGS_((Tcl_Channel chan,
        char *fileName, char *formatString, int *widthPtr, int *heightPtr));
typedef int (Tk_ImageStringMatchProc) _ANSI_ARGS_((char *string,
        char *formatString, int *widthPtr, int *heightPtr));
typedef int (Tk_ImageFileReadProc) _ANSI_ARGS_((Tcl_Interp *interp,
        Tcl_Channel chan, char *fileName, char *formatString,
        Tk_PhotoHandle imageHandle, int destX, int destY,
        int width, int height, int srcX, int srcY));
typedef int (Tk_ImageStringReadProc) _ANSI_ARGS_((Tcl_Interp *interp,
        char *string, char *formatString, Tk_PhotoHandle imageHandle,
        int destX, int destY, int width, int height, int srcX, int srcY));
typedef int (Tk_ImageFileWriteProc) _ANSI_ARGS_((Tcl_Interp *interp,
        char *fileName, char *formatString, Tk_PhotoImageBlock *blockPtr));
typedef int (Tk_ImageStringWriteProc) _ANSI_ARGS_((Tcl_Interp *interp,
        Tcl_DString *dataPtr, char *formatString,
        Tk_PhotoImageBlock *blockPtr));
#else
typedef int (Tk_ImageFileMatchProc) _ANSI_ARGS_((Tcl_Channel chan,
        CONST char *fileName, Tcl_Obj *format, int *widthPtr,
        int *heightPtr, Tcl_Interp *interp));
typedef int (Tk_ImageStringMatchProc) _ANSI_ARGS_((Tcl_Obj *dataObj,
        Tcl_Obj *format, int *widthPtr, int *heightPtr,
        Tcl_Interp *interp));
typedef int (Tk_ImageFileReadProc) _ANSI_ARGS_((Tcl_Interp *interp,
        Tcl_Channel chan, CONST char *fileName, Tcl_Obj *format,
        Tk_PhotoHandle imageHandle, int destX, int destY,
        int width, int height, int srcX, int srcY));
typedef int (Tk_ImageStringReadProc) _ANSI_ARGS_((Tcl_Interp *interp,
        Tcl_Obj *dataObj, Tcl_Obj *format, Tk_PhotoHandle imageHandle,
        int destX, int destY, int width, int height, int srcX, int srcY));
typedef int (Tk_ImageFileWriteProc) _ANSI_ARGS_((Tcl_Interp *interp,
        CONST char *fileName, Tcl_Obj *format, Tk_PhotoImageBlock *blockPtr));
typedef int (Tk_ImageStringWriteProc) _ANSI_ARGS_((Tcl_Interp *interp,
        Tcl_Obj *format, Tk_PhotoImageBlock *blockPtr));
#endif

/*
 * The following structure represents a particular file format for
 * storing images (e.g., PPM, GIF, JPEG, etc.).  It provides information
 * to allow image files of that format to be recognized and read into
 * a photo image.
 */

struct Tk_PhotoImageFormat {
    char *name;                 /* Name of image file format */
    Tk_ImageFileMatchProc *fileMatchProc;
                                /* Procedure to call to determine whether
                                 * an image file matches this format. */
    Tk_ImageStringMatchProc *stringMatchProc;
                                /* Procedure to call to determine whether
                                 * the data in a string matches this format. */
    Tk_ImageFileReadProc *fileReadProc;
                                /* Procedure to call to read data from
                                 * an image file into a photo image. */
    Tk_ImageStringReadProc *stringReadProc;
                                /* Procedure to call to read data from
                                 * a string into a photo image. */
    Tk_ImageFileWriteProc *fileWriteProc;
                                /* Procedure to call to write data from
                                 * a photo image to a file. */
    Tk_ImageStringWriteProc *stringWriteProc;
                                /* Procedure to call to obtain a string
                                 * representation of the data in a photo
                                 * image.*/
    struct Tk_PhotoImageFormat *nextPtr;
                                /* Next in list of all photo image formats
                                 * currently known.  Filled in by Tk, not
                                 * by image format handler. */
};

EXTERN void             Tk_CreateOldImageType _ANSI_ARGS_((
                                Tk_ImageType *typePtr));
EXTERN void             Tk_CreateOldPhotoImageFormat _ANSI_ARGS_((
                                Tk_PhotoImageFormat *formatPtr));

#if !defined(USE_TK_STUBS) && defined(USE_OLD_IMAGE)
#define Tk_CreateImageType Tk_CreateOldImageType
#define Tk_CreatePhotoImageFormat Tk_CreateOldPhotoImageFormat
#endif


/*
 *--------------------------------------------------------------
 *
 * Procedure prototypes and structures used for managing styles:
 *
 *--------------------------------------------------------------
 */

/*
 * Style support version tag.
 */
#define TK_STYLE_VERSION_1      0x1
#define TK_STYLE_VERSION        TK_STYLE_VERSION_1

/*
 * The following structures and prototypes are used as static templates to
 * declare widget elements.
 */

typedef void (Tk_GetElementSizeProc) _ANSI_ARGS_((ClientData clientData,
        char *recordPtr, CONST Tk_OptionSpec **optionsPtr, Tk_Window tkwin,
        int width, int height, int inner, int *widthPtr, int *heightPtr));
typedef void (Tk_GetElementBoxProc) _ANSI_ARGS_((ClientData clientData,
        char *recordPtr, CONST Tk_OptionSpec **optionsPtr, Tk_Window tkwin,
        int x, int y, int width, int height, int inner, int *xPtr, int *yPtr,
        int *widthPtr, int *heightPtr));
typedef int (Tk_GetElementBorderWidthProc) _ANSI_ARGS_((ClientData clientData,
        char *recordPtr, CONST Tk_OptionSpec **optionsPtr, Tk_Window tkwin));
typedef void (Tk_DrawElementProc) _ANSI_ARGS_((ClientData clientData,
        char *recordPtr, CONST Tk_OptionSpec **optionsPtr, Tk_Window tkwin,
        Drawable d, int x, int y, int width, int height, int state));

typedef struct Tk_ElementOptionSpec {
    char *name;                 /* Name of the required option. */
    Tk_OptionType type;         /* Accepted option type. TK_OPTION_END means
                                 * any. */
} Tk_ElementOptionSpec;

typedef struct Tk_ElementSpec {
    int version;                /* Version of the style support. */
    char *name;                 /* Name of element. */
    Tk_ElementOptionSpec *options;
                                /* List of required options. Last one's name
                                 * must be NULL. */

    /*
     * Hooks
     */

    Tk_GetElementSizeProc *getSize;
                                /* Compute the external (resp. internal) size of
                                 * the element from its desired internal (resp.
                                 * external) size. */
    Tk_GetElementBoxProc *getBox;
                                /* Compute the inscribed or bounding boxes
                                 * within a given area. */
    Tk_GetElementBorderWidthProc *getBorderWidth;
                                /* Return the element's internal border width.
                                 * Mostly useful for widgets. */
    Tk_DrawElementProc *draw;   /* Draw the element in the given bounding box.*/
} Tk_ElementSpec;

/*
 * Element state flags. Can be OR'ed.
 */

#define TK_ELEMENT_STATE_ACTIVE         1<<0
#define TK_ELEMENT_STATE_DISABLED       1<<1
#define TK_ELEMENT_STATE_FOCUS          1<<2
#define TK_ELEMENT_STATE_PRESSED        1<<3

/*
 *--------------------------------------------------------------
 *
 * The definitions below provide backward compatibility for
 * functions and types related to event handling that used to
 * be in Tk but have moved to Tcl.
 *
 *--------------------------------------------------------------
 */

#define TK_READABLE             TCL_READABLE
#define TK_WRITABLE             TCL_WRITABLE
#define TK_EXCEPTION            TCL_EXCEPTION

#define TK_DONT_WAIT            TCL_DONT_WAIT
#define TK_X_EVENTS             TCL_WINDOW_EVENTS
#define TK_WINDOW_EVENTS        TCL_WINDOW_EVENTS
#define TK_FILE_EVENTS          TCL_FILE_EVENTS
#define TK_TIMER_EVENTS         TCL_TIMER_EVENTS
#define TK_IDLE_EVENTS          TCL_IDLE_EVENTS
#define TK_ALL_EVENTS           TCL_ALL_EVENTS

#define Tk_IdleProc             Tcl_IdleProc
#define Tk_FileProc             Tcl_FileProc
#define Tk_TimerProc            Tcl_TimerProc
#define Tk_TimerToken           Tcl_TimerToken

#define Tk_BackgroundError      Tcl_BackgroundError
#define Tk_CancelIdleCall       Tcl_CancelIdleCall
#define Tk_CreateFileHandler    Tcl_CreateFileHandler
#define Tk_CreateTimerHandler   Tcl_CreateTimerHandler
#define Tk_DeleteFileHandler    Tcl_DeleteFileHandler
#define Tk_DeleteTimerHandler   Tcl_DeleteTimerHandler
#define Tk_DoOneEvent           Tcl_DoOneEvent
#define Tk_DoWhenIdle           Tcl_DoWhenIdle
#define Tk_Sleep                Tcl_Sleep

/* Additional stuff that has moved to Tcl: */

#define Tk_EventuallyFree       Tcl_EventuallyFree
#define Tk_FreeProc             Tcl_FreeProc
#define Tk_Preserve             Tcl_Preserve
#define Tk_Release              Tcl_Release

/* Removed Tk_Main, use macro instead */
#define Tk_Main(argc, argv, proc) \
    Tk_MainEx(argc, argv, proc, Tcl_CreateInterp())

CONST char *Tk_InitStubs _ANSI_ARGS_((Tcl_Interp *interp, char *version, int exact));

#ifndef USE_TK_STUBS

#define Tk_InitStubs(interp, version, exact) \
    Tcl_PkgRequire(interp, "Tk", version, exact)

#endif

void Tk_InitImageArgs _ANSI_ARGS_((Tcl_Interp *interp, int argc, char ***argv));

#if !defined(USE_TK_STUBS) || !defined(USE_OLD_IMAGE)

#define Tk_InitImageArgs(interp, argc, argv) /**/

#endif


/*
 *--------------------------------------------------------------
 *
 * Additional procedure types defined by Tk.
 *
 *--------------------------------------------------------------
 */

typedef int (Tk_ErrorProc) _ANSI_ARGS_((ClientData clientData,
        XErrorEvent *errEventPtr));
typedef void (Tk_EventProc) _ANSI_ARGS_((ClientData clientData,
        XEvent *eventPtr));
typedef int (Tk_GenericProc) _ANSI_ARGS_((ClientData clientData,
        XEvent *eventPtr));
typedef int (Tk_ClientMessageProc) _ANSI_ARGS_((Tk_Window tkwin,
        XEvent *eventPtr));
typedef int (Tk_GetSelProc) _ANSI_ARGS_((ClientData clientData,
        Tcl_Interp *interp, char *portion));
typedef void (Tk_LostSelProc) _ANSI_ARGS_((ClientData clientData));
typedef Tk_RestrictAction (Tk_RestrictProc) _ANSI_ARGS_((
        ClientData clientData, XEvent *eventPtr));
typedef int (Tk_SelectionProc) _ANSI_ARGS_((ClientData clientData,
        int offset, char *buffer, int maxBytes));


/*
 *--------------------------------------------------------------
 *
 * Platform independant exported procedures and variables.
 *
 *--------------------------------------------------------------
 */

#include "tkDecls.h"

/*
 * Allow users to say that they don't want to alter their source to
 * add the extra argument to Tk_PhotoPutBlock(); DO NOT DEFINE THIS
 * WHEN BUILDING TK.
 *
 * This goes after the inclusion of the stubbed-decls so that the
 * declarations of what is actually there can be correct.
 */

#ifdef USE_COMPOSITELESS_PHOTO_PUT_BLOCK
#   ifdef Tk_PhotoPutBlock
#       undef Tk_PhotoPutBlock
#   endif
#   define Tk_PhotoPutBlock             Tk_PhotoPutBlock_NoComposite
#   ifdef Tk_PhotoPutZoomedBlock
#       undef Tk_PhotoPutZoomedBlock
#   endif
#   define Tk_PhotoPutZoomedBlock       Tk_PhotoPutZoomedBlock_NoComposite
#endif /* USE_COMPOSITELESS_PHOTO_PUT_BLOCK */

/*
 * Tcl commands exported by Tk:
 */


#undef TCL_STORAGE_CLASS
#define TCL_STORAGE_CLASS DLLIMPORT

#endif /* RC_INVOKED */

/*
 * end block for C++
 */
    
#ifdef __cplusplus
}
#endif
    
#endif /* _TK */

/*
 * Local Variables:
 * mode: C
 * tab-width: 8
 * c-basic-offset: 4
 * indent-tabs-mode: t
 * End:
 * ex: shiftwidth=4 tabstop=8
 */

---