home *** CD-ROM | disk | FTP | other *** search
/ Ultra Pack / UltraComputing Partner Applications.iso / SunLabs / tclTK / src / tk4.0 / tkCursor.c < prev    next >
Encoding:
C/C++ Source or Header  |  1995-03-18  |  19.5 KB  |  663 lines
  1. /* 
  2.  * tkCursor.c --
  3.  *
  4.  *    This file maintains a database of read-only cursors for the Tk
  5.  *    toolkit.  This allows cursors to be shared between widgets and
  6.  *    also avoids round-trips to the X server.
  7.  *
  8.  * Copyright (c) 1990-1994 The Regents of the University of California.
  9.  * Copyright (c) 1994-1995 Sun Microsystems, Inc.
  10.  *
  11.  * See the file "license.terms" for information on usage and redistribution
  12.  * of this file, and for a DISCLAIMER OF ALL WARRANTIES.
  13.  */
  14.  
  15. static char sccsid[] = "@(#) tkCursor.c 1.24 95/03/18 15:43:39";
  16.  
  17. #include "tkPort.h"
  18. #include "tkInt.h"
  19.  
  20. /*
  21.  * One of the following data structures exists for each cursor that is
  22.  * currently active.  Each structure is indexed with two hash tables
  23.  * defined below.  One of the tables is idTable, and the other is either
  24.  * nameTable or dataTable, also defined below.
  25.  * .
  26.  */
  27.  
  28. typedef struct {
  29.     Cursor cursor;        /* X identifier for cursor. */
  30.     Display *display;        /* Display for which cursor is valid. */
  31.     int refCount;        /* Number of active uses of cursor. */
  32.     Tcl_HashTable *otherTable;    /* Second table (other than idTable) used
  33.                  * to index this entry. */
  34.     Tcl_HashEntry *hashPtr;    /* Entry in otherTable for this structure
  35.                  * (needed when deleting). */
  36. } TkCursor;
  37.  
  38. /*
  39.  * Hash table to map from a textual description of a cursor to the
  40.  * TkCursor record for the cursor, and key structure used in that
  41.  * hash table:
  42.  */
  43.  
  44. static Tcl_HashTable nameTable;
  45. typedef struct {
  46.     Tk_Uid name;        /* Textual name for desired cursor. */
  47.     Display *display;        /* Display for which cursor will be used. */
  48. } NameKey;
  49.  
  50. /*
  51.  * Hash table to map from a collection of in-core data about a
  52.  * cursor (bitmap contents, etc.) to a TkCursor structure:
  53.  */
  54.  
  55. static Tcl_HashTable dataTable;
  56. typedef struct {
  57.     char *source;        /* Cursor bits. */
  58.     char *mask;            /* Mask bits. */
  59.     int width, height;        /* Dimensions of cursor (and data
  60.                  * and mask). */
  61.     int xHot, yHot;        /* Location of cursor hot-spot. */
  62.     Tk_Uid fg, bg;        /* Colors for cursor. */
  63.     Display *display;        /* Display on which cursor will be used. */
  64. } DataKey;
  65.  
  66. /*
  67.  * Hash table that maps from <display + cursor id> to the TkCursor structure
  68.  * for the cursor.  This table is used by Tk_FreeCursor.
  69.  */
  70.  
  71. static Tcl_HashTable idTable;
  72. typedef struct {
  73.     Display *display;        /* Display for which cursor was allocated. */
  74.     Cursor cursor;        /* Cursor identifier. */
  75. } IdKey;
  76.  
  77. static int initialized = 0;    /* 0 means static structures haven't been
  78.                  * initialized yet. */
  79.  
  80. /*
  81.  * The table below is used to map from the name of a cursor to its
  82.  * index in the official cursor font:
  83.  */
  84.  
  85. static struct CursorName {
  86.     char        *name;
  87.     unsigned int    shape;
  88. } cursorNames[] = {
  89.     {"X_cursor",        XC_X_cursor},
  90.     {"arrow",            XC_arrow},
  91.     {"based_arrow_down",    XC_based_arrow_down},
  92.     {"based_arrow_up",        XC_based_arrow_up},
  93.     {"boat",            XC_boat},
  94.     {"bogosity",        XC_bogosity},
  95.     {"bottom_left_corner",    XC_bottom_left_corner},
  96.     {"bottom_right_corner",    XC_bottom_right_corner},
  97.     {"bottom_side",        XC_bottom_side},
  98.     {"bottom_tee",        XC_bottom_tee},
  99.     {"box_spiral",        XC_box_spiral},
  100.     {"center_ptr",        XC_center_ptr},
  101.     {"circle",            XC_circle},
  102.     {"clock",            XC_clock},
  103.     {"coffee_mug",        XC_coffee_mug},
  104.     {"cross",            XC_cross},
  105.     {"cross_reverse",        XC_cross_reverse},
  106.     {"crosshair",        XC_crosshair},
  107.     {"diamond_cross",        XC_diamond_cross},
  108.     {"dot",            XC_dot},
  109.     {"dotbox",            XC_dotbox},
  110.     {"double_arrow",        XC_double_arrow},
  111.     {"draft_large",        XC_draft_large},
  112.     {"draft_small",        XC_draft_small},
  113.     {"draped_box",        XC_draped_box},
  114.     {"exchange",        XC_exchange},
  115.     {"fleur",            XC_fleur},
  116.     {"gobbler",            XC_gobbler},
  117.     {"gumby",            XC_gumby},
  118.     {"hand1",            XC_hand1},
  119.     {"hand2",            XC_hand2},
  120.     {"heart",            XC_heart},
  121.     {"icon",            XC_icon},
  122.     {"iron_cross",        XC_iron_cross},
  123.     {"left_ptr",        XC_left_ptr},
  124.     {"left_side",        XC_left_side},
  125.     {"left_tee",        XC_left_tee},
  126.     {"leftbutton",        XC_leftbutton},
  127.     {"ll_angle",        XC_ll_angle},
  128.     {"lr_angle",        XC_lr_angle},
  129.     {"man",            XC_man},
  130.     {"middlebutton",        XC_middlebutton},
  131.     {"mouse",            XC_mouse},
  132.     {"pencil",            XC_pencil},
  133.     {"pirate",            XC_pirate},
  134.     {"plus",            XC_plus},
  135.     {"question_arrow",        XC_question_arrow},
  136.     {"right_ptr",        XC_right_ptr},
  137.     {"right_side",        XC_right_side},
  138.     {"right_tee",        XC_right_tee},
  139.     {"rightbutton",        XC_rightbutton},
  140.     {"rtl_logo",        XC_rtl_logo},
  141.     {"sailboat",        XC_sailboat},
  142.     {"sb_down_arrow",        XC_sb_down_arrow},
  143.     {"sb_h_double_arrow",    XC_sb_h_double_arrow},
  144.     {"sb_left_arrow",        XC_sb_left_arrow},
  145.     {"sb_right_arrow",        XC_sb_right_arrow},
  146.     {"sb_up_arrow",        XC_sb_up_arrow},
  147.     {"sb_v_double_arrow",    XC_sb_v_double_arrow},
  148.     {"shuttle",            XC_shuttle},
  149.     {"sizing",            XC_sizing},
  150.     {"spider",            XC_spider},
  151.     {"spraycan",        XC_spraycan},
  152.     {"star",            XC_star},
  153.     {"target",            XC_target},
  154.     {"tcross",            XC_tcross},
  155.     {"top_left_arrow",        XC_top_left_arrow},
  156.     {"top_left_corner",        XC_top_left_corner},
  157.     {"top_right_corner",    XC_top_right_corner},
  158.     {"top_side",        XC_top_side},
  159.     {"top_tee",            XC_top_tee},
  160.     {"trek",            XC_trek},
  161.     {"ul_angle",        XC_ul_angle},
  162.     {"umbrella",        XC_umbrella},
  163.     {"ur_angle",        XC_ur_angle},
  164.     {"watch",            XC_watch},
  165.     {"xterm",            XC_xterm},
  166.     {NULL,            0}
  167. };
  168.  
  169. /*
  170.  * Font to use for cursors:
  171.  */
  172.  
  173. #ifndef CURSORFONT
  174. #define CURSORFONT "cursor"
  175. #endif
  176.  
  177. /*
  178.  * Forward declarations for procedures defined in this file:
  179.  */
  180.  
  181. static void        CursorInit _ANSI_ARGS_((void));
  182.  
  183. /*
  184.  *----------------------------------------------------------------------
  185.  *
  186.  * Tk_GetCursor --
  187.  *
  188.  *    Given a string describing a cursor, locate (or create if necessary)
  189.  *    a cursor that fits the description.
  190.  *
  191.  * Results:
  192.  *    The return value is the X identifer for the desired cursor,
  193.  *    unless string couldn't be parsed correctly.  In this case,
  194.  *    None is returned and an error message is left in interp->result.
  195.  *    The caller should never modify the cursor that is returned, and
  196.  *    should eventually call Tk_FreeCursor when the cursor is no longer
  197.  *    needed.
  198.  *
  199.  * Side effects:
  200.  *    The cursor is added to an internal database with a reference count.
  201.  *    For each call to this procedure, there should eventually be a call
  202.  *    to Tk_FreeCursor, so that the database can be cleaned up when cursors
  203.  *    aren't needed anymore.
  204.  *
  205.  *----------------------------------------------------------------------
  206.  */
  207.  
  208. Cursor
  209. Tk_GetCursor(interp, tkwin, string)
  210.     Tcl_Interp *interp;        /* Interpreter to use for error reporting. */
  211.     Tk_Window tkwin;        /* Window in which cursor will be used. */
  212.     Tk_Uid string;        /* Description of cursor.  See manual entry
  213.                  * for details on legal syntax. */
  214. {
  215.     NameKey nameKey;
  216.     IdKey idKey;
  217.     Tcl_HashEntry *nameHashPtr, *idHashPtr;
  218.     register TkCursor *cursorPtr;
  219.     int new;
  220.     Cursor cursor;
  221.     int argc;
  222.     char **argv = NULL;
  223.     Pixmap source = None;
  224.     Pixmap mask = None;
  225.  
  226.     if (!initialized) {
  227.     CursorInit();
  228.     }
  229.  
  230.     nameKey.name = string;
  231.     nameKey.display = Tk_Display(tkwin);
  232.     nameHashPtr = Tcl_CreateHashEntry(&nameTable, (char *) &nameKey, &new);
  233.     if (!new) {
  234.     cursorPtr = (TkCursor *) Tcl_GetHashValue(nameHashPtr);
  235.     cursorPtr->refCount++;
  236.     return cursorPtr->cursor;
  237.     }
  238.  
  239.     /*
  240.      * No suitable cursor exists.  Parse the cursor name into fields
  241.      * and create a cursor, either from the standard cursor font or
  242.      * from bitmap files.
  243.      */
  244.  
  245.     if (Tcl_SplitList(interp, string, &argc, &argv) != TCL_OK) {
  246.     goto error;
  247.     }
  248.     if (argc == 0) {
  249.     badString:
  250.     Tcl_AppendResult(interp, "bad cursor spec \"", string, "\"",
  251.         (char *) NULL);
  252.     goto error;
  253.     }
  254.     if (argv[0][0] != '@') {
  255.     XColor fg, bg;
  256.     unsigned int maskIndex;
  257.     register struct CursorName *namePtr;
  258.     TkDisplay *dispPtr;
  259.  
  260.     /*
  261.      * The cursor is to come from the standard cursor font.  If one
  262.      * arg, it is cursor name (use black and white for fg and bg).
  263.      * If two args, they are name and fg color (ignore mask).  If
  264.      * three args, they are name, fg, bg.  Some of the code below
  265.      * is stolen from the XCreateFontCursor Xlib procedure.
  266.      */
  267.  
  268.     if (argc > 3) {
  269.         goto badString;
  270.     }
  271.     for (namePtr = cursorNames; ; namePtr++) {
  272.         if (namePtr->name == NULL) {
  273.         goto badString;
  274.         }
  275.         if ((namePtr->name[0] == argv[0][0])
  276.             && (strcmp(namePtr->name, argv[0]) == 0)) {
  277.         break;
  278.         }
  279.     }
  280.     maskIndex = namePtr->shape + 1;
  281.     if (argc == 1) {
  282.         fg.red = fg.green = fg.blue = 0;
  283.         bg.red = bg.green = bg.blue = 65535;
  284.     } else {
  285.         if (XParseColor(nameKey.display, Tk_Colormap(tkwin), argv[1],
  286.             &fg) == 0) {
  287.         Tcl_AppendResult(interp, "invalid color name \"", argv[1],
  288.             "\"", (char *) NULL);
  289.         goto error;
  290.         }
  291.         if (argc == 2) {
  292.         bg.red = bg.green = bg.blue = 0;
  293.         maskIndex = namePtr->shape;
  294.         } else {
  295.         if (XParseColor(nameKey.display, Tk_Colormap(tkwin), argv[2],
  296.             &bg) == 0) {
  297.             Tcl_AppendResult(interp, "invalid color name \"", argv[2],
  298.                 "\"", (char *) NULL);
  299.             goto error;
  300.         }
  301.         }
  302.     }
  303.     dispPtr = ((TkWindow *) tkwin)->dispPtr;
  304.     if (dispPtr->cursorFont == None) {
  305.         dispPtr->cursorFont = XLoadFont(nameKey.display, CURSORFONT);
  306.         if (dispPtr->cursorFont == None) {
  307.         interp->result = "couldn't load cursor font";
  308.         goto error;
  309.         }
  310.     }
  311.     cursor = XCreateGlyphCursor(nameKey.display, dispPtr->cursorFont,
  312.         dispPtr->cursorFont, namePtr->shape, maskIndex,
  313.         &fg, &bg);
  314.     } else {
  315.     int width, height, maskWidth, maskHeight;
  316.     int xHot, yHot, dummy1, dummy2;
  317.     XColor fg, bg;
  318.  
  319.     /*
  320.      * The cursor is to be created by reading bitmap files.  There
  321.      * should be either two elements in the list (source, color) or
  322.      * four (source mask fg bg).
  323.      */
  324.  
  325.     if ((argc != 2) && (argc != 4)) {
  326.         goto badString;
  327.     }
  328.     if (XReadBitmapFile(nameKey.display,
  329.         RootWindowOfScreen(Tk_Screen(tkwin)), &argv[0][1],
  330.         (unsigned int *) &width, (unsigned int *) &height,
  331.         &source, &xHot, &yHot) != BitmapSuccess) {
  332.         Tcl_AppendResult(interp, "error reading bitmap file \"",
  333.             &argv[0][1], "\"", (char *) NULL);
  334.         goto error;
  335.     }
  336.     if ((xHot < 0) || (yHot < 0) || (xHot >= width) || (yHot >= height)) {
  337.         Tcl_AppendResult(interp, "bad hot spot in bitmap file \"",
  338.             &argv[0][1], "\"", (char *) NULL);
  339.         goto error;
  340.     }
  341.     if (argc == 2) {
  342.         if (XParseColor(nameKey.display, Tk_Colormap(tkwin), argv[1],
  343.             &fg) == 0) {
  344.         Tcl_AppendResult(interp, "invalid color name \"",
  345.             argv[1], "\"", (char *) NULL);
  346.         goto error;
  347.         }
  348.         cursor = XCreatePixmapCursor(nameKey.display, source, source,
  349.             &fg, &fg, (unsigned) xHot, (unsigned) yHot);
  350.     } else {
  351.         if (XReadBitmapFile(nameKey.display,
  352.             RootWindowOfScreen(Tk_Screen(tkwin)), argv[1],
  353.             (unsigned int *) &maskWidth, (unsigned int *) &maskHeight,
  354.             &mask, &dummy1, &dummy2) != BitmapSuccess) {
  355.         Tcl_AppendResult(interp, "error reading bitmap file \"",
  356.             argv[1], "\"", (char *) NULL);
  357.         goto error;
  358.         }
  359.         if ((maskWidth != width) && (maskHeight != height)) {
  360.         interp->result =
  361.             "source and mask bitmaps have different sizes";
  362.         goto error;
  363.         }
  364.         if (XParseColor(nameKey.display, Tk_Colormap(tkwin), argv[2],
  365.             &fg) == 0) {
  366.         Tcl_AppendResult(interp, "invalid color name \"", argv[2],
  367.             "\"", (char *) NULL);
  368.         goto error;
  369.         }
  370.         if (XParseColor(nameKey.display, Tk_Colormap(tkwin), argv[3],
  371.             &bg) == 0) {
  372.         Tcl_AppendResult(interp, "invalid color name \"", argv[3],
  373.             "\"", (char *) NULL);
  374.         goto error;
  375.         }
  376.         cursor = XCreatePixmapCursor(nameKey.display, source, mask,
  377.             &fg, &bg, (unsigned) xHot, (unsigned) yHot);
  378.     }
  379.     }
  380.  
  381.     /*
  382.      * Add information about this cursor to our database.
  383.      */
  384.  
  385.     cursorPtr = (TkCursor *) ckalloc(sizeof(TkCursor));
  386.     cursorPtr->cursor = cursor;
  387.     cursorPtr->display = nameKey.display;
  388.     cursorPtr->refCount = 1;
  389.     cursorPtr->otherTable = &nameTable;
  390.     cursorPtr->hashPtr = nameHashPtr;
  391.     idKey.display = nameKey.display;
  392.     idKey.cursor = cursor;
  393.     idHashPtr = Tcl_CreateHashEntry(&idTable, (char *) &idKey, &new);
  394.     if (!new) {
  395.     panic("cursor already registered in Tk_GetCursor");
  396.     }
  397.     Tcl_SetHashValue(nameHashPtr, cursorPtr);
  398.     Tcl_SetHashValue(idHashPtr, cursorPtr);
  399.  
  400.     done:
  401.     if (argv != NULL) {
  402.     ckfree((char *) argv);
  403.     }
  404.     if (source != None) {
  405.     XFreePixmap(nameKey.display, source);
  406.     Tk_FreeXId(nameKey.display, (XID) source);
  407.     }
  408.     if (mask != None) {
  409.     XFreePixmap(nameKey.display, mask);
  410.     Tk_FreeXId(nameKey.display, (XID) mask);
  411.     }
  412.     return cursor;
  413.  
  414.     error:
  415.     Tcl_DeleteHashEntry(nameHashPtr);
  416.     cursor = None;
  417.     goto done;
  418. }
  419.  
  420. /*
  421.  *----------------------------------------------------------------------
  422.  *
  423.  * Tk_GetCursorFromData --
  424.  *
  425.  *    Given a description of the bits and colors for a cursor,
  426.  *    make a cursor that has the given properties.
  427.  *
  428.  * Results:
  429.  *    The return value is the X identifer for the desired cursor,
  430.  *    unless it couldn't be created properly.  In this case, None is
  431.  *    returned and an error message is left in interp->result.  The
  432.  *    caller should never modify the cursor that is returned, and
  433.  *    should eventually call Tk_FreeCursor when the cursor is no
  434.  *    longer needed.
  435.  *
  436.  * Side effects:
  437.  *    The cursor is added to an internal database with a reference count.
  438.  *    For each call to this procedure, there should eventually be a call
  439.  *    to Tk_FreeCursor, so that the database can be cleaned up when cursors
  440.  *    aren't needed anymore.
  441.  *
  442.  *----------------------------------------------------------------------
  443.  */
  444.  
  445. Cursor
  446. Tk_GetCursorFromData(interp, tkwin, source, mask, width, height,
  447.     xHot, yHot, fg, bg)
  448.     Tcl_Interp *interp;        /* Interpreter to use for error reporting. */
  449.     Tk_Window tkwin;        /* Window in which cursor will be used. */
  450.     char *source;        /* Bitmap data for cursor shape. */
  451.     char *mask;            /* Bitmap data for cursor mask. */
  452.     int width, height;        /* Dimensions of cursor. */
  453.     int xHot, yHot;        /* Location of hot-spot in cursor. */
  454.     Tk_Uid fg;            /* Foreground color for cursor. */
  455.     Tk_Uid bg;            /* Background color for cursor. */
  456. {
  457.     DataKey dataKey;
  458.     IdKey idKey;
  459.     Tcl_HashEntry *dataHashPtr, *idHashPtr;
  460.     register TkCursor *cursorPtr;
  461.     int new;
  462.     XColor fgColor, bgColor;
  463.     Pixmap sourcePixmap, maskPixmap;
  464.  
  465.     if (!initialized) {
  466.     CursorInit();
  467.     }
  468.  
  469.     dataKey.source = source;
  470.     dataKey.mask = mask;
  471.     dataKey.width = width;
  472.     dataKey.height = height;
  473.     dataKey.xHot = xHot;
  474.     dataKey.yHot = yHot;
  475.     dataKey.fg = fg;
  476.     dataKey.bg = bg;
  477.     dataKey.display = Tk_Display(tkwin);
  478.     dataHashPtr = Tcl_CreateHashEntry(&dataTable, (char *) &dataKey, &new);
  479.     if (!new) {
  480.     cursorPtr = (TkCursor *) Tcl_GetHashValue(dataHashPtr);
  481.     cursorPtr->refCount++;
  482.     return cursorPtr->cursor;
  483.     }
  484.  
  485.     /*
  486.      * No suitable cursor exists yet.  Make one using the data
  487.      * available and add it to the database.
  488.      */
  489.  
  490.     if (XParseColor(dataKey.display, Tk_Colormap(tkwin), fg, &fgColor) == 0) {
  491.     Tcl_AppendResult(interp, "invalid color name \"", fg, "\"",
  492.         (char *) NULL);
  493.     goto error;
  494.     }
  495.     if (XParseColor(dataKey.display, Tk_Colormap(tkwin), bg, &bgColor) == 0) {
  496.     Tcl_AppendResult(interp, "invalid color name \"", bg, "\"",
  497.         (char *) NULL);
  498.     goto error;
  499.     }
  500.  
  501.     cursorPtr = (TkCursor *) ckalloc(sizeof(TkCursor));
  502.     sourcePixmap = XCreateBitmapFromData(dataKey.display,
  503.         RootWindowOfScreen(Tk_Screen(tkwin)), source, (unsigned) width,
  504.         (unsigned) height);
  505.     maskPixmap = XCreateBitmapFromData(dataKey.display, 
  506.         RootWindowOfScreen(Tk_Screen(tkwin)), mask, (unsigned) width,
  507.         (unsigned) height);
  508.     cursorPtr->cursor = XCreatePixmapCursor(dataKey.display, sourcePixmap,
  509.         maskPixmap, &fgColor, &bgColor, (unsigned) xHot, (unsigned) yHot);
  510.     XFreePixmap(dataKey.display, sourcePixmap);
  511.     Tk_FreeXId(dataKey.display, (XID) sourcePixmap);
  512.     XFreePixmap(dataKey.display, maskPixmap);
  513.     Tk_FreeXId(dataKey.display, (XID) maskPixmap);
  514.     cursorPtr->display = dataKey.display;
  515.     cursorPtr->refCount = 1;
  516.     cursorPtr->otherTable = &dataTable;
  517.     cursorPtr->hashPtr = dataHashPtr;
  518.     idKey.display = dataKey.display;
  519.     idKey.cursor = cursorPtr->cursor;
  520.     idHashPtr = Tcl_CreateHashEntry(&idTable, (char *) &idKey, &new);
  521.     if (!new) {
  522.     panic("cursor already registered in Tk_GetCursorFromData");
  523.     }
  524.     Tcl_SetHashValue(dataHashPtr, cursorPtr);
  525.     Tcl_SetHashValue(idHashPtr, cursorPtr);
  526.     return cursorPtr->cursor;
  527.  
  528.     error:
  529.     Tcl_DeleteHashEntry(dataHashPtr);
  530.     return None;
  531. }
  532.  
  533. /*
  534.  *--------------------------------------------------------------
  535.  *
  536.  * Tk_NameOfCursor --
  537.  *
  538.  *    Given a cursor, return a textual string identifying it.
  539.  *
  540.  * Results:
  541.  *    If cursor was created by Tk_GetCursor, then the return
  542.  *    value is the "string" that was used to create it.
  543.  *    Otherwise the return value is a string giving the X
  544.  *    identifier for the cursor.  The storage for the returned
  545.  *    string is only guaranteed to persist up until the next
  546.  *    call to this procedure.
  547.  *
  548.  * Side effects:
  549.  *    None.
  550.  *
  551.  *--------------------------------------------------------------
  552.  */
  553.  
  554. char *
  555. Tk_NameOfCursor(display, cursor)
  556.     Display *display;        /* Display for which cursor was allocated. */
  557.     Cursor cursor;        /* Identifier for cursor whose name is
  558.                  * wanted. */
  559. {
  560.     IdKey idKey;
  561.     Tcl_HashEntry *idHashPtr;
  562.     TkCursor *cursorPtr;
  563.     static char string[20];
  564.  
  565.     if (!initialized) {
  566.     printid:
  567.     sprintf(string, "cursor id 0x%x", (unsigned int) cursor);
  568.     return string;
  569.     }
  570.     idKey.display = display;
  571.     idKey.cursor = cursor;
  572.     idHashPtr = Tcl_FindHashEntry(&idTable, (char *) &idKey);
  573.     if (idHashPtr == NULL) {
  574.     goto printid;
  575.     }
  576.     cursorPtr = (TkCursor *) Tcl_GetHashValue(idHashPtr);
  577.     if (cursorPtr->otherTable != &nameTable) {
  578.     goto printid;
  579.     }
  580.     return ((NameKey *) cursorPtr->hashPtr->key.words)->name;
  581. }
  582.  
  583. /*
  584.  *----------------------------------------------------------------------
  585.  *
  586.  * Tk_FreeCursor --
  587.  *
  588.  *    This procedure is called to release a cursor allocated by
  589.  *    Tk_GetCursor or TkGetCursorFromData.
  590.  *
  591.  * Results:
  592.  *    None.
  593.  *
  594.  * Side effects:
  595.  *    The reference count associated with cursor is decremented, and
  596.  *    it is officially deallocated if no-one is using it anymore.
  597.  *
  598.  *----------------------------------------------------------------------
  599.  */
  600.  
  601. void
  602. Tk_FreeCursor(display, cursor)
  603.     Display *display;        /* Display for which cursor was allocated. */
  604.     Cursor cursor;        /* Identifier for cursor to be released. */
  605. {
  606.     IdKey idKey;
  607.     Tcl_HashEntry *idHashPtr;
  608.     register TkCursor *cursorPtr;
  609.  
  610.     if (!initialized) {
  611.     panic("Tk_FreeCursor called before Tk_GetCursor");
  612.     }
  613.  
  614.     idKey.display = display;
  615.     idKey.cursor = cursor;
  616.     idHashPtr = Tcl_FindHashEntry(&idTable, (char *) &idKey);
  617.     if (idHashPtr == NULL) {
  618.     panic("Tk_FreeCursor received unknown cursor argument");
  619.     }
  620.     cursorPtr = (TkCursor *) Tcl_GetHashValue(idHashPtr);
  621.     cursorPtr->refCount--;
  622.     if (cursorPtr->refCount == 0) {
  623.     XFreeCursor(cursorPtr->display, cursorPtr->cursor);
  624.     Tk_FreeXId(cursorPtr->display, (XID) cursorPtr->cursor);
  625.     Tcl_DeleteHashEntry(cursorPtr->hashPtr);
  626.     Tcl_DeleteHashEntry(idHashPtr);
  627.     ckfree((char *) cursorPtr);
  628.     }
  629. }
  630.  
  631. /*
  632.  *----------------------------------------------------------------------
  633.  *
  634.  * CursorInit --
  635.  *
  636.  *    Initialize the structures used for cursor management.
  637.  *
  638.  * Results:
  639.  *    None.
  640.  *
  641.  * Side effects:
  642.  *    Read the code.
  643.  *
  644.  *----------------------------------------------------------------------
  645.  */
  646.  
  647. static void
  648. CursorInit()
  649. {
  650.     initialized = 1;
  651.     Tcl_InitHashTable(&nameTable, sizeof(NameKey)/sizeof(int));
  652.     Tcl_InitHashTable(&dataTable, sizeof(DataKey)/sizeof(int));
  653.  
  654.     /*
  655.      * The call below is tricky:  can't use sizeof(IdKey) because it
  656.      * gets padded with extra unpredictable bytes on some 64-bit
  657.      * machines.
  658.      */
  659.  
  660.     Tcl_InitHashTable(&idTable, (sizeof(Display *) + sizeof(Cursor))
  661.         /sizeof(int));
  662. }
  663.