archie/tk3.6/tkCanvBmap.c
2024-05-27 16:13:40 +02:00

731 lines
21 KiB
C
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

/*
* tkCanvBmap.c --
*
* This file implements bitmap items for canvas widgets.
*
* Copyright (c) 1992-1993 The Regents of the University of California.
* All rights reserved.
*
* Permission is hereby granted, without written agreement and without
* license or royalty fees, to use, copy, modify, and distribute this
* software and its documentation for any purpose, provided that the
* above copyright notice and the following two paragraphs appear in
* all copies of this software.
*
* IN NO EVENT SHALL THE UNIVERSITY OF CALIFORNIA BE LIABLE TO ANY PARTY FOR
* DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES ARISING OUT
* OF THE USE OF THIS SOFTWARE AND ITS DOCUMENTATION, EVEN IF THE UNIVERSITY OF
* CALIFORNIA HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*
* THE UNIVERSITY OF CALIFORNIA SPECIFICALLY DISCLAIMS ANY WARRANTIES,
* INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
* AND FITNESS FOR A PARTICULAR PURPOSE. THE SOFTWARE PROVIDED HEREUNDER IS
* ON AN "AS IS" BASIS, AND THE UNIVERSITY OF CALIFORNIA HAS NO OBLIGATION TO
* PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.
*/
#ifndef lint
static char rcsid[] = "$Header: /user6/ouster/wish/RCS/tkCanvBmap.c,v 1.12 93/09/15 08:19:47 ouster Exp $ SPRITE (Berkeley)";
#endif
#include <stdio.h>
#include "tkInt.h"
#include "tkConfig.h"
#include "tkCanvas.h"
/*
* The structure below defines the record for each rectangle/oval item.
*/
typedef struct BitmapItem {
Tk_Item header; /* Generic stuff that's the same for all
* types. MUST BE FIRST IN STRUCTURE. */
double x, y; /* Coordinates of positioning point for
* bitmap. */
Tk_Anchor anchor; /* Where to anchor bitmap relative to
* (x,y). */
Pixmap bitmap; /* Bitmap to display in window. */
XColor *fgColor; /* Foreground color to use for bitmap. */
XColor *bgColor; /* Background color to use for bitmap. */
GC gc; /* Graphics context to use for drawing
* bitmap on screen. */
} BitmapItem;
/*
* Information used for parsing configuration specs:
*/
static Tk_ConfigSpec configSpecs[] = {
{TK_CONFIG_ANCHOR, "-anchor", (char *) NULL, (char *) NULL,
"center", Tk_Offset(BitmapItem, anchor), TK_CONFIG_DONT_SET_DEFAULT},
{TK_CONFIG_COLOR, "-background", (char *) NULL, (char *) NULL,
(char *) NULL, Tk_Offset(BitmapItem, bgColor), TK_CONFIG_NULL_OK},
{TK_CONFIG_BITMAP, "-bitmap", (char *) NULL, (char *) NULL,
(char *) NULL, Tk_Offset(BitmapItem, bitmap), TK_CONFIG_NULL_OK},
{TK_CONFIG_COLOR, "-foreground", (char *) NULL, (char *) NULL,
"black", Tk_Offset(BitmapItem, fgColor), 0},
{TK_CONFIG_CUSTOM, "-tags", (char *) NULL, (char *) NULL,
(char *) NULL, 0, TK_CONFIG_NULL_OK, &tkCanvasTagsOption},
{TK_CONFIG_END, (char *) NULL, (char *) NULL, (char *) NULL,
(char *) NULL, 0, 0}
};
/*
* Prototypes for procedures defined in this file:
*/
static int BitmapCoords _ANSI_ARGS_((Tk_Canvas *canvasPtr,
Tk_Item *itemPtr, int argc, char **argv));
static int BitmapToArea _ANSI_ARGS_((Tk_Canvas *canvasPtr,
Tk_Item *itemPtr, double *rectPtr));
static double BitmapToPoint _ANSI_ARGS_((Tk_Canvas *canvasPtr,
Tk_Item *itemPtr, double *coordPtr));
static int BitmapToPostscript _ANSI_ARGS_((Tk_Canvas *canvasPtr,
Tk_Item *itemPtr, Tk_PostscriptInfo *psInfoPtr));
static void ComputeBitmapBbox _ANSI_ARGS_((Tk_Canvas *canvasPtr,
BitmapItem *bmapPtr));
static int ConfigureBitmap _ANSI_ARGS_((
Tk_Canvas *canvasPtr, Tk_Item *itemPtr, int argc,
char **argv, int flags));
static int CreateBitmap _ANSI_ARGS_((Tk_Canvas *canvasPtr,
struct Tk_Item *itemPtr, int argc, char **argv));
static void DeleteBitmap _ANSI_ARGS_((Tk_Canvas *canvasPtr,
Tk_Item *itemPtr));
static void DisplayBitmap _ANSI_ARGS_((Tk_Canvas *canvasPtr,
Tk_Item *itemPtr, Drawable dst));
static void ScaleBitmap _ANSI_ARGS_((Tk_Canvas *canvasPtr,
Tk_Item *itemPtr, double originX, double originY,
double scaleX, double scaleY));
static void TranslateBitmap _ANSI_ARGS_((Tk_Canvas *canvasPtr,
Tk_Item *itemPtr, double deltaX, double deltaY));
/*
* The structures below defines the rectangle and oval item types
* by means of procedures that can be invoked by generic item code.
*/
Tk_ItemType TkBitmapType = {
"bitmap", /* name */
sizeof(BitmapItem), /* itemSize */
CreateBitmap, /* createProc */
configSpecs, /* configSpecs */
ConfigureBitmap, /* configureProc */
BitmapCoords, /* coordProc */
DeleteBitmap, /* deleteProc */
DisplayBitmap, /* displayProc */
0, /* alwaysRedraw */
BitmapToPoint, /* pointProc */
BitmapToArea, /* areaProc */
BitmapToPostscript, /* postscriptProc */
ScaleBitmap, /* scaleProc */
TranslateBitmap, /* translateProc */
(Tk_ItemIndexProc *) NULL, /* indexProc */
(Tk_ItemCursorProc *) NULL, /* icursorProc */
(Tk_ItemSelectionProc *) NULL, /* selectionProc */
(Tk_ItemInsertProc *) NULL, /* insertProc */
(Tk_ItemDCharsProc *) NULL, /* dTextProc */
(Tk_ItemType *) NULL /* nextPtr */
};
/*
*--------------------------------------------------------------
*
* CreateBitmap --
*
* This procedure is invoked to create a new bitmap
* item in a canvas.
*
* Results:
* A standard Tcl return value. If an error occurred in
* creating the item, then an error message is left in
* canvasPtr->interp->result; in this case itemPtr is
* left uninitialized, so it can be safely freed by the
* caller.
*
* Side effects:
* A new bitmap item is created.
*
*--------------------------------------------------------------
*/
static int
CreateBitmap(canvasPtr, itemPtr, argc, argv)
register Tk_Canvas *canvasPtr; /* Canvas to hold new item. */
Tk_Item *itemPtr; /* Record to hold new item; header
* has been initialized by caller. */
int argc; /* Number of arguments in argv. */
char **argv; /* Arguments describing rectangle. */
{
register BitmapItem *bmapPtr = (BitmapItem *) itemPtr;
if (argc < 2) {
Tcl_AppendResult(canvasPtr->interp, "wrong # args: should be \"",
Tk_PathName(canvasPtr->tkwin), "\" create ",
itemPtr->typePtr->name, " x y ?options?",
(char *) NULL);
return TCL_ERROR;
}
/*
* Initialize item's record.
*/
bmapPtr->anchor = TK_ANCHOR_CENTER;
bmapPtr->bitmap = None;
bmapPtr->fgColor = NULL;
bmapPtr->bgColor = NULL;
bmapPtr->gc = None;
/*
* Process the arguments to fill in the item record.
*/
if ((TkGetCanvasCoord(canvasPtr, argv[0], &bmapPtr->x) != TCL_OK)
|| (TkGetCanvasCoord(canvasPtr, argv[1],
&bmapPtr->y) != TCL_OK)) {
return TCL_ERROR;
}
if (ConfigureBitmap(canvasPtr, itemPtr, argc-2, argv+2, 0) != TCL_OK) {
DeleteBitmap(canvasPtr, itemPtr);
return TCL_ERROR;
}
return TCL_OK;
}
/*
*--------------------------------------------------------------
*
* BitmapCoords --
*
* This procedure is invoked to process the "coords" widget
* command on bitmap items. See the user documentation for
* details on what it does.
*
* Results:
* Returns TCL_OK or TCL_ERROR, and sets canvasPtr->interp->result.
*
* Side effects:
* The coordinates for the given item may be changed.
*
*--------------------------------------------------------------
*/
static int
BitmapCoords(canvasPtr, itemPtr, argc, argv)
register Tk_Canvas *canvasPtr; /* Canvas containing item. */
Tk_Item *itemPtr; /* Item whose coordinates are to be
* read or modified. */
int argc; /* Number of coordinates supplied in
* argv. */
char **argv; /* Array of coordinates: x1, y1,
* x2, y2, ... */
{
register BitmapItem *bmapPtr = (BitmapItem *) itemPtr;
char x[TCL_DOUBLE_SPACE], y[TCL_DOUBLE_SPACE];
if (argc == 0) {
Tcl_PrintDouble(canvasPtr->interp, bmapPtr->x, x);
Tcl_PrintDouble(canvasPtr->interp, bmapPtr->y, y);
Tcl_AppendResult(canvasPtr->interp, x, " ", y, (char *) NULL);
} else if (argc == 2) {
if ((TkGetCanvasCoord(canvasPtr, argv[0], &bmapPtr->x) != TCL_OK)
|| (TkGetCanvasCoord(canvasPtr, argv[1],
&bmapPtr->y) != TCL_OK)) {
return TCL_ERROR;
}
ComputeBitmapBbox(canvasPtr, bmapPtr);
} else {
sprintf(canvasPtr->interp->result,
"wrong # coordinates: expected 0 or 2, got %d",
argc);
return TCL_ERROR;
}
return TCL_OK;
}
/*
*--------------------------------------------------------------
*
* ConfigureBitmap --
*
* This procedure is invoked to configure various aspects
* of a bitmap item, such as its anchor position.
*
* Results:
* A standard Tcl result code. If an error occurs, then
* an error message is left in canvasPtr->interp->result.
*
* Side effects:
* Configuration information may be set for itemPtr.
*
*--------------------------------------------------------------
*/
static int
ConfigureBitmap(canvasPtr, itemPtr, argc, argv, flags)
Tk_Canvas *canvasPtr; /* Canvas containing itemPtr. */
Tk_Item *itemPtr; /* Bitmap item to reconfigure. */
int argc; /* Number of elements in argv. */
char **argv; /* Arguments describing things to configure. */
int flags; /* Flags to pass to Tk_ConfigureWidget. */
{
register BitmapItem *bmapPtr = (BitmapItem *) itemPtr;
XGCValues gcValues;
GC newGC;
if (Tk_ConfigureWidget(canvasPtr->interp, canvasPtr->tkwin,
configSpecs, argc, argv, (char *) bmapPtr, flags) != TCL_OK) {
return TCL_ERROR;
}
/*
* A few of the options require additional processing, such as those
* that determine the graphics context.
*/
gcValues.foreground = bmapPtr->fgColor->pixel;
if (bmapPtr->bgColor != NULL) {
gcValues.background = bmapPtr->bgColor->pixel;
} else {
gcValues.background = Tk_3DBorderColor(canvasPtr->bgBorder)->pixel;
}
newGC = Tk_GetGC(canvasPtr->tkwin, GCForeground|GCBackground, &gcValues);
if (bmapPtr->gc != None) {
Tk_FreeGC(canvasPtr->display, bmapPtr->gc);
}
bmapPtr->gc = newGC;
ComputeBitmapBbox(canvasPtr, bmapPtr);
return TCL_OK;
}
/*
*--------------------------------------------------------------
*
* DeleteBitmap --
*
* This procedure is called to clean up the data structure
* associated with a bitmap item.
*
* Results:
* None.
*
* Side effects:
* Resources associated with itemPtr are released.
*
*--------------------------------------------------------------
*/
static void
DeleteBitmap(canvasPtr, itemPtr)
Tk_Canvas *canvasPtr; /* Info about overall canvas widget. */
Tk_Item *itemPtr; /* Item that is being deleted. */
{
register BitmapItem *bmapPtr = (BitmapItem *) itemPtr;
if (bmapPtr->bitmap != None) {
Tk_FreeBitmap(canvasPtr->display, bmapPtr->bitmap);
}
if (bmapPtr->fgColor != NULL) {
Tk_FreeColor(bmapPtr->fgColor);
}
if (bmapPtr->bgColor != NULL) {
Tk_FreeColor(bmapPtr->bgColor);
}
if (bmapPtr->gc != NULL) {
Tk_FreeGC(canvasPtr->display, bmapPtr->gc);
}
}
/*
*--------------------------------------------------------------
*
* ComputeBitmapBbox --
*
* This procedure is invoked to compute the bounding box of
* all the pixels that may be drawn as part of a bitmap item.
* This procedure is where the child bitmap's placement is
* computed.
*
* Results:
* None.
*
* Side effects:
* The fields x1, y1, x2, and y2 are updated in the header
* for itemPtr.
*
*--------------------------------------------------------------
*/
/* ARGSUSED */
static void
ComputeBitmapBbox(canvasPtr, bmapPtr)
Tk_Canvas *canvasPtr; /* Canvas that contains item. */
register BitmapItem *bmapPtr; /* Item whose bbox is to be
* recomputed. */
{
unsigned int width, height;
int x, y;
x = bmapPtr->x + 0.5;
y = bmapPtr->y + 0.5;
if (bmapPtr->bitmap == None) {
bmapPtr->header.x1 = bmapPtr->header.x2 = x;
bmapPtr->header.y1 = bmapPtr->header.y2 = y;
return;
}
/*
* Compute location and size of bitmap, using anchor information.
*/
Tk_SizeOfBitmap(canvasPtr->display, bmapPtr->bitmap, &width, &height);
switch (bmapPtr->anchor) {
case TK_ANCHOR_N:
x -= width/2;
break;
case TK_ANCHOR_NE:
x -= width;
break;
case TK_ANCHOR_E:
x -= width;
y -= height/2;
break;
case TK_ANCHOR_SE:
x -= width;
y -= height;
break;
case TK_ANCHOR_S:
x -= width/2;
y -= height;
break;
case TK_ANCHOR_SW:
y -= height;
break;
case TK_ANCHOR_W:
y -= height/2;
break;
case TK_ANCHOR_NW:
break;
case TK_ANCHOR_CENTER:
x -= width/2;
y -= height/2;
break;
}
/*
* Store the information in the item header.
*/
bmapPtr->header.x1 = x;
bmapPtr->header.y1 = y;
bmapPtr->header.x2 = x + width;
bmapPtr->header.y2 = y + height;
}
/*
*--------------------------------------------------------------
*
* DisplayBitmap --
*
* This procedure is invoked to draw a bitmap item in a given
* drawable.
*
* Results:
* None.
*
* Side effects:
* ItemPtr is drawn in drawable using the transformation
* information in canvasPtr.
*
*--------------------------------------------------------------
*/
static void
DisplayBitmap(canvasPtr, itemPtr, drawable)
register Tk_Canvas *canvasPtr; /* Canvas that contains item. */
Tk_Item *itemPtr; /* Item to be displayed. */
Drawable drawable; /* Pixmap or window in which to draw
* item. */
{
register BitmapItem *bmapPtr = (BitmapItem *) itemPtr;
if (bmapPtr->bitmap != None) {
XCopyPlane(Tk_Display(canvasPtr->tkwin), bmapPtr->bitmap, drawable,
bmapPtr->gc, 0, 0,
(unsigned int) bmapPtr->header.x2 - bmapPtr->header.x1,
(unsigned int) bmapPtr->header.y2 - bmapPtr->header.y1,
bmapPtr->header.x1 - canvasPtr->drawableXOrigin,
bmapPtr->header.y1 - canvasPtr->drawableYOrigin, 1);
}
}
/*
*--------------------------------------------------------------
*
* BitmapToPoint --
*
* Computes the distance from a given point to a given
* rectangle, in canvas units.
*
* Results:
* The return value is 0 if the point whose x and y coordinates
* are coordPtr[0] and coordPtr[1] is inside the bitmap. If the
* point isn't inside the bitmap then the return value is the
* distance from the point to the bitmap.
*
* Side effects:
* None.
*
*--------------------------------------------------------------
*/
/* ARGSUSED */
static double
BitmapToPoint(canvasPtr, itemPtr, coordPtr)
Tk_Canvas *canvasPtr; /* Canvas containing item. */
Tk_Item *itemPtr; /* Item to check against point. */
double *coordPtr; /* Pointer to x and y coordinates. */
{
register BitmapItem *bmapPtr = (BitmapItem *) itemPtr;
double x1, x2, y1, y2, xDiff, yDiff;
x1 = bmapPtr->header.x1;
y1 = bmapPtr->header.y1;
x2 = bmapPtr->header.x2;
y2 = bmapPtr->header.y2;
/*
* Point is outside rectangle.
*/
if (coordPtr[0] < x1) {
xDiff = x1 - coordPtr[0];
} else if (coordPtr[0] > x2) {
xDiff = coordPtr[0] - x2;
} else {
xDiff = 0;
}
if (coordPtr[1] < y1) {
yDiff = y1 - coordPtr[1];
} else if (coordPtr[1] > y2) {
yDiff = coordPtr[1] - y2;
} else {
yDiff = 0;
}
return hypot(xDiff, yDiff);
}
/*
*--------------------------------------------------------------
*
* BitmapToArea --
*
* This procedure is called to determine whether an item
* lies entirely inside, entirely outside, or overlapping
* a given rectangle.
*
* Results:
* -1 is returned if the item is entirely outside the area
* given by rectPtr, 0 if it overlaps, and 1 if it is entirely
* inside the given area.
*
* Side effects:
* None.
*
*--------------------------------------------------------------
*/
/* ARGSUSED */
static int
BitmapToArea(canvasPtr, itemPtr, rectPtr)
Tk_Canvas *canvasPtr; /* Canvas containing item. */
Tk_Item *itemPtr; /* Item to check against rectangle. */
double *rectPtr; /* Pointer to array of four coordinates
* (x1, y1, x2, y2) describing rectangular
* area. */
{
register BitmapItem *bmapPtr = (BitmapItem *) itemPtr;
if ((rectPtr[2] <= bmapPtr->header.x1)
|| (rectPtr[0] >= bmapPtr->header.x2)
|| (rectPtr[3] <= bmapPtr->header.y1)
|| (rectPtr[1] >= bmapPtr->header.y2)) {
return -1;
}
if ((rectPtr[0] <= bmapPtr->header.x1)
&& (rectPtr[1] <= bmapPtr->header.y1)
&& (rectPtr[2] >= bmapPtr->header.x2)
&& (rectPtr[3] >= bmapPtr->header.y2)) {
return 1;
}
return 0;
}
/*
*--------------------------------------------------------------
*
* ScaleBitmap --
*
* This procedure is invoked to rescale a rectangle or oval
* item.
*
* Results:
* None.
*
* Side effects:
* The rectangle or oval referred to by itemPtr is rescaled
* so that the following transformation is applied to all
* point coordinates:
* x' = originX + scaleX*(x-originX)
* y' = originY + scaleY*(y-originY)
*
*--------------------------------------------------------------
*/
static void
ScaleBitmap(canvasPtr, itemPtr, originX, originY, scaleX, scaleY)
Tk_Canvas *canvasPtr; /* Canvas containing rectangle. */
Tk_Item *itemPtr; /* Rectangle to be scaled. */
double originX, originY; /* Origin about which to scale rect. */
double scaleX; /* Amount to scale in X direction. */
double scaleY; /* Amount to scale in Y direction. */
{
register BitmapItem *bmapPtr = (BitmapItem *) itemPtr;
bmapPtr->x = originX + scaleX*(bmapPtr->x - originX);
bmapPtr->y = originY + scaleY*(bmapPtr->y - originY);
ComputeBitmapBbox(canvasPtr, bmapPtr);
}
/*
*--------------------------------------------------------------
*
* TranslateBitmap --
*
* This procedure is called to move a rectangle or oval by a
* given amount.
*
* Results:
* None.
*
* Side effects:
* The position of the rectangle or oval is offset by
* (xDelta, yDelta), and the bounding box is updated in the
* generic part of the item structure.
*
*--------------------------------------------------------------
*/
static void
TranslateBitmap(canvasPtr, itemPtr, deltaX, deltaY)
Tk_Canvas *canvasPtr; /* Canvas containing item. */
Tk_Item *itemPtr; /* Item that is being moved. */
double deltaX, deltaY; /* Amount by which item is to be
* moved. */
{
register BitmapItem *bmapPtr = (BitmapItem *) itemPtr;
bmapPtr->x += deltaX;
bmapPtr->y += deltaY;
ComputeBitmapBbox(canvasPtr, bmapPtr);
}
/*
*--------------------------------------------------------------
*
* BitmapToPostscript --
*
* This procedure is called to generate Postscript for
* bitmap items.
*
* Results:
* The return value is a standard Tcl result. If an error
* occurs in generating Postscript then an error message is
* left in canvasPtr->interp->result, replacing whatever used
* to be there. If no error occurs, then Postscript for the
* item is appended to the result.
*
* Side effects:
* None.
*
*--------------------------------------------------------------
*/
static int
BitmapToPostscript(canvasPtr, itemPtr, psInfoPtr)
Tk_Canvas *canvasPtr; /* Information about overall canvas. */
Tk_Item *itemPtr; /* Item for which Postscript is
* wanted. */
Tk_PostscriptInfo *psInfoPtr; /* Information about the Postscript;
* must be passed back to Postscript
* utility procedures. */
{
register BitmapItem *bmapPtr = (BitmapItem *) itemPtr;
double x, y;
unsigned int width, height;
char buffer[200];
if (bmapPtr->bitmap == None) {
return TCL_OK;
}
/*
* Compute the coordinates of the lower-left corner of the bitmap,
* taking into account the anchor position for the bitmp.
*/
x = bmapPtr->x;
y = TkCanvPsY(psInfoPtr, bmapPtr->y);
Tk_SizeOfBitmap(canvasPtr->display, bmapPtr->bitmap, &width, &height);
switch (bmapPtr->anchor) {
case TK_ANCHOR_NW: y -= height; break;
case TK_ANCHOR_N: x -= width/2.0; y -= height; break;
case TK_ANCHOR_NE: x -= width; y -= height; break;
case TK_ANCHOR_E: x -= width; y -= height/2.0; break;
case TK_ANCHOR_SE: x -= width; break;
case TK_ANCHOR_S: x -= width/2.0; break;
case TK_ANCHOR_SW: break;
case TK_ANCHOR_W: y -= height/2.0; break;
case TK_ANCHOR_CENTER: x -= width/2.0; y -= height/2.0; break;
}
/*
* Color the background, if there is one.
*/
if (bmapPtr->bgColor != NULL) {
sprintf(buffer,
"%.15g %.15g moveto %d 0 rlineto 0 %d rlineto %d %s\n",
x, y, width, height, -width,"0 rlineto closepath");
Tcl_AppendResult(canvasPtr->interp, buffer, (char *) NULL);
if (TkCanvPsColor(canvasPtr, psInfoPtr, bmapPtr->bgColor) != TCL_OK) {
return TCL_ERROR;
}
Tcl_AppendResult(canvasPtr->interp, "fill\n", (char *) NULL);
}
/*
* Draw the bitmap, if there is a foreground color.
*/
if (bmapPtr->fgColor != NULL) {
if (TkCanvPsColor(canvasPtr, psInfoPtr, bmapPtr->fgColor) != TCL_OK) {
return TCL_ERROR;
}
sprintf(buffer, "%.15g %.15g translate\n %d %d true matrix {\n",
x, y, width, height);
Tcl_AppendResult(canvasPtr->interp, buffer, (char *) NULL);
if (TkCanvPsBitmap(canvasPtr, psInfoPtr, bmapPtr->bitmap) != TCL_OK) {
return TCL_ERROR;
}
Tcl_AppendResult(canvasPtr->interp, "\n} imagemask\n", (char *) NULL);
}
return TCL_OK;
}