/[dtapublic]/projs/dtats/trunk/shared_source/c_tk_base_7_5_w_mods/tk.h

Diff of /projs/dtats/trunk/shared_source/c_tk_base_7_5_w_mods/tk.h

Parent Directory | Revision Log | View Patch Patch

-revision 69 by dashley,
Sat Nov  5 10:54:17 2016 UTC
+revision 71 by dashley,
Sat Nov  5 11:07:06 2016 UTC
 Line 1
  /* $Header$ */
  /*
   * 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 Scriptics Corporation.
   *
   * 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 1.1.1.1 2001/06/13 04:53:16 dtashley Exp $
   */
  #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)
   * win/README           (not patchlevel)
   * unix/README          (not patchlevel)
   * unix/tk.spec         (3 LOC Major/Minor, 2 LOC patch)
   * win/aclocal.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   3
  #define TK_RELEASE_LEVEL   TCL_FINAL_RELEASE
  #define TK_RELEASE_SERIAL  1
  #define TK_VERSION      "8.3"
  #define TK_PATCH_LEVEL  "8.3.1"
  /*
   * The following definitions set up the proper options for Macintosh
   * compilers.  We use this method because there is no autoconf equivalent.
   */
  #ifdef MAC_TCL
  #   ifndef REDO_KEYSYM_LOOKUP
  #       define REDO_KEYSYM_LOOKUP
  #   endif
  #endif
  #ifndef _TCL
  #   include <tcl.h>
  #endif
  /*
   * A special definition used to allow this header file to be included
   * in resource files.
   */
  #ifndef RESOURCE_INCLUDED
  #ifndef _XLIB_H
  #   ifdef MAC_TCL
  #       include <Xlib.h>
  #       include <X.h>
  #   else
  #       include "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;
  /*
   * Additional types exported to clients.
   */
  typedef 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_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
  #define TK_OPTION_DONT_SET_DEFAULT      8
  /*
   * 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, 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. */
      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 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
  #define TK_CONFIG_COLOR_ONLY            2
  #define TK_CONFIG_MONO_ONLY             4
  #define TK_CONFIG_DONT_SET_DEFAULT      8
  #define TK_CONFIG_OPTION_SPECIFIED      0x10
  #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_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
  /*
   * 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_ReqWidth(tkwin)              (((Tk_FakeWin *) (tkwin))->reqWidth)
  #define Tk_ReqHeight(tkwin)             (((Tk_FakeWin *) (tkwin))->reqHeight)
  #define Tk_InternalBorderWidth(tkwin) \
      (((Tk_FakeWin *) (tkwin))->internalBorderWidth)
  #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;
      int screenNum;
      Visual *visual;
      int depth;
      Window window;
      char *dummy2;
      char *dummy3;
      Tk_Window parentPtr;
      char *dummy4;
      char *dummy5;
      char *pathName;
      Tk_Uid nameUid;
      Tk_Uid classUid;
      XWindowChanges changes;
      unsigned int dummy6;
      XSetWindowAttributes atts;
      unsigned long dummy7;
      unsigned int flags;
      char *dummy8;
  #ifdef TK_USE_INPUT_METHODS
      XIC dummy9;
  #endif /* TK_USE_INPUT_METHODS */
      ClientData *dummy10;
      int dummy11;
      int dummy12;
      char *dummy13;
      char *dummy14;
      ClientData dummy15;
      int reqWidth, reqHeight;
      int internalBorderWidth;
      char *dummy16;
      char *dummy17;
      ClientData dummy18;
      char *dummy19;
  } 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 window (it
   *                              was or will be created as a child of
   *                              a root window).
   * 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.
   */
  #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
  /*
   *--------------------------------------------------------------
   *
   * 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;
  /*
   * 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
  /*
   *--------------------------------------------------------------
   *
   * 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_AfterCmd             Tcl_AfterCmd
  #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())
  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_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));
  /*
   *--------------------------------------------------------------
   *
   * Exported procedures and variables.
   *
   *--------------------------------------------------------------
   */
  #include "tkDecls.h"
  /*
   * Tcl commands exported by Tk:
   */
  #endif /* RESOURCE_INCLUDED */
  #undef TCL_STORAGE_CLASS
  #define TCL_STORAGE_CLASS DLLIMPORT
  /*
   * end block for C++
   */
  #ifdef __cplusplus
  }
  #endif
  #endif /* _TK */
  /* End of tk.h */

 Legend:



Removed from v.69
 


changed lines


 
Added in v.71
 Legend:



Removed from v.69
 


changed lines


 
Added in v.71
-Removed from v.69
+Added in v.71

dashley@gmail.com	ViewVC Help
Powered by ViewVC 1.1.25