magic/commands/CmdLQ.c

/*
 * CmdLQ.c --
 *
 * Commands with names beginning with the letters L through Q.
 *
 *     *********************************************************************
 *     * Copyright (C) 1985, 1990 Regents of the University of California. *
 *     * Permission to use, copy, modify, and distribute this              *
 *     * software and its documentation for any purpose and without        *
 *     * fee is hereby granted, provided that the above copyright          *
 *     * notice appear in all copies.  The University of California        *
 *     * makes no representations about the suitability of this            *
 *     * software for any purpose.  It is provided "as is" without         *
 *     * express or implied warranty.  Export of this software outside     *
 *     * of the United States of America may require an export license.    *
 *     *********************************************************************
 */

#ifndef lint
static const char rcsid[] __attribute__ ((unused)) = "$Header: /usr/cvsroot/magic-8.0/commands/CmdLQ.c,v 1.9 2010/06/24 12:37:15 tim Exp $";
#endif  /* not lint */

#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <ctype.h>

#include "tcltk/tclmagic.h"
#include "utils/magic.h"
#include "utils/malloc.h"
#include "utils/geometry.h"
#include "utils/utils.h"
#include "tiles/tile.h"
#include "utils/hash.h"
#include "database/database.h"
#include "database/fonts.h"
#include "windows/windows.h"
#include "dbwind/dbwind.h"
#include "utils/main.h"
#include "commands/commands.h"
#include "textio/textio.h"
#include "graphics/graphics.h"
#include "drc/drc.h"
#include "textio/txcommands.h"
#include "utils/undo.h"
#include "select/select.h"
#include "netmenu/netmenu.h"

/* C99 compat */
#include "cif/cif.h"

/* Forward declarations */

void CmdPaintEraseButton(MagWindow *w, Point *refPoint, bool isPaint, bool isScreen);

/* See the SetLabel command */

extern Label *DefaultLabel;

#ifdef FILE_LOCKS
/* See the "locking" command */
extern bool FileLocking;
#endif

/*
 * ----------------------------------------------------------------------------
 *
 * CmdLabelProc --
 *
 * 	This procedure does all the work of putting a label except for
 *	parsing argments.  It is separated from CmdLabel so it can be
 *	used by the net-list menu system.
 *
 * Results:
 *	None.
 *
 * Side effects:
 *	A label is added to the edit cell at the box location, with
 *	the given text position, on the given layer.  If type is -1,
 *	then there must be only one layer underneath the box, and the
 *	label is added to that layer.
 *
 * ----------------------------------------------------------------------------
 */

void
CmdLabelProc(
    char *text,			/* Text for label. */
    int font,			/* Known font to use, or -1 for X11 fonts */
    int size,			/* Fixed size of font (invalid with X11 fonts) */
    int rotate,			/* Rotation (invalid with X11 fonts) */
    int offx,			/* Position offset X (invalid with X11 fonts) */
    int offy,			/* Position offset Y (invalid with X11 fonts) */
    int pos,			/* Justification of text relative to text. -1
				 * means "pick a nice one for me."
				 */
    bool sticky,		/* 1 if label should not be moved off chosen layer */
    TileType type)		/* Type of material label is to be attached
				 * to.  -1 means "pick a reasonable layer".
				 */
{
    Rect editBox, tmpArea;
    Point offset;
    Label *lab;

    /* Make sure the box exists */
    if (!ToolGetEditBox(&editBox)) return;

    if (EditCellUse == NULL)
    {
        TxError("The current cell is not editable.\n");
        return;
    }

    /* Make sure there's a valid string of text. */

    if ((text == NULL) || (*text == 0))
    {
	TxError("Can't have null label name.\n");
	return;
    }
    if (CmdIllegalChars(text, " /", "Label name"))
	return;

    if (type < 0) type = TT_SPACE;

    /* Eliminate any duplicate labels at the same position, regardless
     * of type.
     */

    DBEraseLabelsByContent(EditCellUse->cu_def, &editBox, -1, text);

    offset.p_x = offx;
    offset.p_y = offy;
    lab = DBPutFontLabel(EditCellUse->cu_def, &editBox, font, size,
		rotate, &offset, pos, text, type,
		((sticky) ? LABEL_STICKY : 0), 0);
    DBAdjustLabels(EditCellUse->cu_def, &editBox);
    DBReComputeBbox(EditCellUse->cu_def);
    tmpArea = lab->lab_rect;
    lab->lab_rect = editBox;
    DBWLabelChanged(EditCellUse->cu_def, lab, DBW_ALLWINDOWS);
    lab->lab_rect = tmpArea;
}


/*
 * ----------------------------------------------------------------------------
 *
 * CmdLabel --
 *
 * Implement the "label" command.
 * Place a label at a specific point on a specific type in EditCell
 *
 * Usage:
 *	label <text> [<direction> [<layer>]]
 *	label <text> <font> [<size> [<rotation>
 *			[<offsetx> <offsety> [<direction> [<layer>]]]]]
 *
 * Direction may be one of:
 *	right left top bottom
 *	east west north south
 *	ne nw se sw
 * or any unique abbreviation.  If not specified, it defaults to a value
 * chosen to keep the label text inside the cell.
 *
 * Layer defaults to the type of material beneath the degenerate box.
 * If the box is a rectangle, then use the lower left corner to determine
 * the material.
 *
 * If more than more than one tiletype other than space touches the box,
 * then the "layer" must be specified in the command.
 *
 * Results:
 *	None.
 *
 * Side effects:
 *	Modified EditCellUse->cu_def.
 *
 * ----------------------------------------------------------------------------
 */


void
CmdLabel(
    MagWindow *w,
    TxCommand *cmd)
{
    TileType type = (TileType)(-1);
    int pos = -1, font = -1, size = 0, rotate = 0, offx = 0, offy = 0;
    bool sticky = FALSE;
    int option;
    char *p;

    if (cmd->tx_argc < 2 || cmd->tx_argc > 9)
    {
	TxError("Usage: %s text [direction [layer]]\n", cmd->tx_argv[0]);
	TxError("or:    %s text font [size [rotation [offsetx offsety "
		"[direction [layer]]]]]\n", cmd->tx_argv[0]);
	return;
    }

    p = cmd->tx_argv[1];

    /*
     * If the "setlabel" command has been used to set defaults, pick up
     * the default values from DefaultLabel.
     */
    if (DefaultLabel != NULL)
    {
	pos = DefaultLabel->lab_just;
	font = DefaultLabel->lab_font;
	size = DefaultLabel->lab_size;
	rotate = DefaultLabel->lab_rotate;
	offx = DefaultLabel->lab_offset.p_x;
	offy = DefaultLabel->lab_offset.p_y;
	sticky = (DefaultLabel->lab_flags & LABEL_STICKY) ? 1 : 0;
	type = DefaultLabel->lab_type;
    }

    /*
     * Find and check validity of position.
     */

    if (cmd->tx_argc > 2)
    {
	pos = GeoNameToPos(cmd->tx_argv[2], FALSE, FALSE);
	if (pos < 0)
	{
	    if (StrIsInt(cmd->tx_argv[2]))
	    {
		font = atoi(cmd->tx_argv[2]);
		if (font < 0 || font >= DBNumFonts)
		{
		    if (DBNumFonts == 0)
			TxError("No vector outline fonts are loaded!\n");
		    else
			TxError("Font value out of range (0 to %d)\n", DBNumFonts - 1);
		}
	    }
	    else
	    {
		/* Assume that this is a font name */

		font = DBNameToFont(cmd->tx_argv[2]);
		if (font < -1)
		{
		    TxError("Unknown vector outline font \"%s\"\n", cmd->tx_argv[2]);
		    return;
		}
	    }
	}
	else
	    pos = GeoTransPos(&RootToEditTransform, pos);
    }

    if (font >= 0)
    {
	char *yp = NULL;

    	if (DefaultLabel == NULL)
	    size = DBLambda[1];

	if (cmd->tx_argc > 3)
	    if (StrIsNumeric(cmd->tx_argv[3]))
		size = cmdScaleCoord(w, cmd->tx_argv[3], TRUE, TRUE, 8);

	if (cmd->tx_argc > 4)
	    if (StrIsInt(cmd->tx_argv[4]))
		rotate = atoi(cmd->tx_argv[4]);

	if (cmd->tx_argc > 6)
	{
	    if ((yp = strchr(cmd->tx_argv[5], ' ')) != NULL)
	    {
		*yp = '\0';
		yp++;
		if (StrIsNumeric(cmd->tx_argv[5]) && StrIsNumeric(yp))
		{
		    offx = cmdScaleCoord(w, cmd->tx_argv[5], TRUE, TRUE, 8);
		    offy = cmdScaleCoord(w, yp, TRUE, FALSE, 8);
		    *yp = ' ';
		}
		else
		{
		    TxError("Uninterpretable offset value \"%s %s\"\n",
				cmd->tx_argv[5], yp);
		    *yp = ' ';
		    return;
		}
	    }
	    else if (StrIsNumeric(cmd->tx_argv[5]) && StrIsNumeric(cmd->tx_argv[6]))
	    {
		/* offx and offy are entered in lambda units and	*/
		/* re-interpreted as eighth-internal units.		*/

		offx = cmdScaleCoord(w, cmd->tx_argv[5], TRUE, TRUE, 8);
		offy = cmdScaleCoord(w, cmd->tx_argv[6], TRUE, FALSE, 8);
	    }
	    else
	    {
		TxError("Uninterpretable offset value \"%s %s\"\n", cmd->tx_argv[5],
			cmd->tx_argv[6]);
		return;
	    }
	}

	if (((yp != NULL) && (cmd->tx_argc > 6))  || (cmd->tx_argc > 7))
	{
	    int pidx = (yp != NULL) ? 6 : 7;
	    pos = GeoNameToPos(cmd->tx_argv[pidx], FALSE, TRUE);
	    if (pos < 0)
		return;
	    else
		pos = GeoTransPos(&RootToEditTransform, pos);
	}
    }

    /*
     * Find and check validity of type parameter.  Accept prefix "-" on
     * layer as an indication of a "sticky" label (label is fixed to
     * indicated type and does not change).
     */

    if ((font < 0 && cmd->tx_argc > 3) || (font >= 0 && cmd->tx_argc >= 8))
    {
	char *typename;

	typename = cmd->tx_argv[cmd->tx_argc - 1];
	if (*typename == '-')
	{
	    sticky = TRUE;
	    typename++;
	}
	type = DBTechNameType(typename);
	if (type < 0)
	{
	    TxError("Unknown layer: %s\n", cmd->tx_argv[cmd->tx_argc - 1]);
	    return;
	}
    }

    CmdLabelProc(p, font, size, rotate, offx, offy, pos, sticky, type);
}

#define LOAD_NOWINDOW	  0
#define LOAD_DEREFERENCE  1
#define LOAD_FORCE	  2
#define LOAD_QUIET	  3
#define LOAD_SILENT	  4
#define LOAD_FAIL	  5

/*
 * ----------------------------------------------------------------------------
 *
 * CmdLoad --
 *
 * Implement the "load" command.
 *
 * Usage:
 *	load [name [scaled n [d]]] [-force] [-nowindow] [-dereference] [-quiet] [-fail]
 *
 * If name is supplied, then the window containing the point tool is
 * remapped so as to edit the cell with the given name.
 *
 * If no name is supplied, then a new cell with the name "(UNNAMED)"
 * is created in the selected window.  If there is already a cell by
 * that name in existence (eg, in another window), that cell gets loaded
 * rather than a new cell being created.
 *
 * An input file can be scaled by specifying the "scaled" option, for
 * which the geometry of the input file is multiplied by n/d.
 *
 * Magic saves the path to instances to ensure correct versioning.  But
 * this interferes with attempts to re-link instances from a different
 * location (such as an abstract view instead of a full view, or vice
 * versa).  So the "-dereference" option strips the instance paths from
 * the input file and relies only on the search locations set up by the
 * "path" command to find the location of instances.
 *
 * Results:
 *	None.
 *
 * Side effects:
 *	Sets EditCellUse.
 *
 * ----------------------------------------------------------------------------
 */

void
CmdLoad(
    MagWindow *w,
    TxCommand *cmd)
{
    int n = 1;
    int d = 1;
    int option;
    int locargc = cmd->tx_argc;
    bool ignoreTech = FALSE;
    bool noWindow = FALSE;
    bool dereference = FALSE;
    char verbose = DB_VERBOSE_ALL;
    bool failNotFound = FALSE;
    unsigned char saveVerbose;
    unsigned char flags;
    int keepGoing(CellUse *use, ClientData clientdata);			/* forward declaration */
    extern unsigned char DBVerbose;	/* from DBio.c */

    saveVerbose = DBVerbose;

    static const char * const cmdLoadOption[] =
    {
	"-nowindow	load file but do not display in the layout window",
	"-dereference	use search paths and ignore embedded cell paths in file",
	"-force 	load file even if tech in header does not match",
	"-quiet		only errors printed",
	"-silent	no alert if file does not exist",
	"-fail		if file does not exist, do not create a new cell",
	NULL
    };

    while (cmd->tx_argv[locargc - 1][0] == '-')
    {
    	option = Lookup(cmd->tx_argv[locargc - 1], cmdLoadOption);
	switch (option)
	{
	    case LOAD_NOWINDOW:
	    	noWindow = TRUE;
		break;
	    case LOAD_DEREFERENCE:
	    	dereference = TRUE;
		break;
	    case LOAD_FORCE:
	    	ignoreTech = TRUE;
		break;
	    case LOAD_QUIET:
	    	verbose = DB_VERBOSE_ERR;
		break;
	    case LOAD_SILENT:
	    	verbose = DB_VERBOSE_NONE;
		break;
	    case LOAD_FAIL:
	    	failNotFound = TRUE;
		break;
	    default:
		TxError("No such option \"%s\".\n", cmd->tx_argv[locargc - 1]);
	}
	locargc--;
    }

    if (locargc > 2)
    {
	if ((locargc >= 4) && !strncmp(cmd->tx_argv[2], "scale", 5) &&
		StrIsInt(cmd->tx_argv[3]))
	{
	    n = atoi(cmd->tx_argv[3]);
 	    if ((locargc == 5) && StrIsInt(cmd->tx_argv[4]))
	        d = atoi(cmd->tx_argv[4]);
	    else if (locargc != 4)
	    {
		TxError("Usage: %s name scaled n [d] [-force] "
			    "[-nowindow] [-dereference]\n",
			    cmd->tx_argv[0]);
		return;
	    }
	    DBLambda[0] *= d;
	    DBLambda[1] *= n;
	    ReduceFraction(&DBLambda[0], &DBLambda[1]);
	}
	else if (!ignoreTech && !noWindow && !dereference)
	{
	    TxError("Usage: %s name [scaled n [d]] [-force] "
			    "[-nowindow] [-dereference] [-quiet] [-fail]\n",
			    cmd->tx_argv[0]);
	    return;
	}
    }

    windCheckOnlyWindow(&w, DBWclientID);
    if ((w == (MagWindow *) NULL) && (noWindow == FALSE))
    {
	TxError("Point to a window first.\n");
	return;
    }

    if (locargc > 1)
    {
	if (CmdIllegalChars(cmd->tx_argv[1], "[],", "Cell name"))
	    return;
#ifdef MAGIC_WRAPPER
	/* Names that have been list-braced in Tcl need to be modified */
	if (cmd->tx_argv[1][0] == '{')
	{
	    cmd->tx_argv[1]++;
	    *(cmd->tx_argv[1] + strlen(cmd->tx_argv[1]) - 1) = '\0';
	}
#endif
	DBVerbose = verbose;
	flags = 0;
	if (ignoreTech) flags |= DBW_LOAD_IGNORE_TECH;
	if (dereference) flags |= DBW_LOAD_DEREFERENCE;
	if (failNotFound) flags |= DBW_LOAD_FAIL;
	if (verbose < DB_VERBOSE_WARN) flags |= DBW_LOAD_QUIET;

	DBWloadWindow((noWindow == TRUE) ? NULL : w, cmd->tx_argv[1], flags);
	DBVerbose = saveVerbose;

	if ((n > 1) || (d > 1))
	{
            CellUse *topuse = (CellUse *)w->w_surfaceID;

	    /* To ensure that all subcells are also scaled, we need to	*/
	    /* expand the entire cell hierarchy to force a load of the	*/
	    /* cell.  After this, we return all the expansion flags	*/
	    /* back to the way they were originally.			*/

	    TxPrintf("Recursively reading all cells at new scale.\n");

	    DBExpandAll(topuse, &(topuse->cu_bbox),
			((DBWclientRec *)w->w_clientData)->dbw_bitmask,
			TRUE, keepGoing, NULL);

	    DBExpandAll(topuse, &(topuse->cu_bbox),
			((DBWclientRec *)w->w_clientData)->dbw_bitmask,
			FALSE, keepGoing, NULL);
	    DBExpand(topuse,
			((DBWclientRec *)w->w_clientData)->dbw_bitmask,
			TRUE);

	    /* We don't want to save and restore DBLambda, because      */
	    /* loading the file may change their values.  Instead, we   */
	    /* invert the scaling factor and reapply.                   */

	    DBLambda[0] *= n;
	    DBLambda[1] *= d;
	    ReduceFraction(&DBLambda[0], &DBLambda[1]);
	}
    }
    else
    {
	DBVerbose = verbose;
	DBWloadWindow(w, (char *) NULL, DBW_LOAD_IGNORE_TECH);
	DBVerbose = saveVerbose;
    }
}

/*
 * Function callback which continues the search through all cells for
 * expansion/unexpansion, used by CmdLoad() above.
 */

int
keepGoing(
    CellUse *use,
    ClientData clientdata)
{
    return 0;	/* keep the search going */
}

/*
 * ----------------------------------------------------------------------------
 *
 * CmdLocking --
 *
 * Implement the "locking" command.
 *
 * Usage:
 *	locking [enable|disable]
 *
 * This command controls the behavior of file locking.  If enabled, then
 * every layout read from a .mag file will generate a file descriptor in
 * the operating system, and the file will be held open for the duration
 * of use.  This is a fairly simple way of preventing two different
 * processes of magic from attempting to write to the same .mag file.
 * Generally speaking, the file locking should remain on at all times,
 * and read/write behavior of any specific cell can be controlled with
 * the "cellname writeable" command option.  However, in some cases,
 * layouts with many components may exceed the operating system's
 * allotted number of open file descriptors, in which case the only real
 * option is to disable file locking altogether using "locking disable".
 *
 * Results:
 *	None.
 *
 * Side effects:
 *	Sets global boolean variable FileLocking.
 *
 * Note:
 *	When magic is configured with --disable-locking, then this command
 *	is implemented such that "locking enable" does nothing, and
 *	"locking disable" generates an error.
 *
 * ----------------------------------------------------------------------------
 */

void
CmdLocking(
    MagWindow *w,
    TxCommand *cmd)
{
    int option;

    static const char * const cmdLockingYesNo[] = { "disable", "no", "false", "off", "0",
	    "enable", "yes", "true", "on", "1", 0 };

    if (cmd->tx_argc <= 1)
    {
#ifdef FILE_LOCKS
#ifdef MAGIC_WRAPPER
	/* Interpreter return value is the state of locking */
	Tcl_SetResult(magicinterp, (FileLocking) ? "enabled" : "disabled",
		TCL_VOLATILE);
#else
	/* Print the status of file locking to the console */
	TxPrintf("%s\n", (FileLocking) ? "enabled" : "disabled");
#endif
    }
    else
    {
	option = Lookup(cmd->tx_argv[1], cmdLockingYesNo);
	if (option < 0)
	{
	    TxError("Unknown locking option \"%s\"\n", cmd->tx_argv[1]);
	    return;
	}
	FileLocking = (option <= 4) ? FALSE : TRUE;
    }
#else	/* !FILE_LOCKS */
#ifdef MAGIC_WRAPPER
	Tcl_SetResult(magicinterp,
		"File locking disabled as a compile-time option",
		TCL_VOLATILE);
#else
	/* Print the status of file locking to the console */
	TxPrintf("File locking disabled as a compile-time option\n");
#endif
    }
    else
    {
	option = Lookup(cmd->tx_argv[1], cmdLockingYesNo);
	if (option < 0)
	    TxError("Unknown locking option \"%s\"\n", cmd->tx_argv[1]);
	else if (option > 4)		/* "true", "enable", "on", etc. */
	    TxError("Cannot enable locking because it has been disabled"
			" as a compile-time option.\n");
    }
#endif	/* !FILE_LOCKS */
}

/*
 * ----------------------------------------------------------------------------
 *
 * CmdMove --
 *
 * Implement the "move" command.
 *
 * Usage:
 *	move [origin] [direction [amount]]
 *	move [origin] to x y
 *
 * Results:
 *	None.
 *
 * Side effects:
 *	Moves everything that's currently selected.
 *
 * ----------------------------------------------------------------------------
 */

void
CmdMove(
    MagWindow *w,
    TxCommand *cmd)
{
    Transform t;
    Rect rootBox, newBox;
    Point rootPoint, editPoint;
    CellDef *rootDef;
    int argpos;
    bool doOrigin = FALSE;

    if (cmd->tx_argc > 4)
    {
	badUsage:
	TxError("Usage: %s [origin] [direction [amount]]\n", cmd->tx_argv[0]);
	TxError("   or: %s [origin] to x y\n", cmd->tx_argv[0]);
	return;
    }

    if (cmd->tx_argc > 1)
    {
	int indx, amountx, amounty;
	int xdelta, ydelta;

	if (!ToolGetEditBox((Rect *)NULL)) return;

	argpos = 1;

	if (strcmp(cmd->tx_argv[1], "origin") == 0)
	{
	    doOrigin = TRUE;
	    argpos++;
	}

	if (strcmp(cmd->tx_argv[argpos], "to") == 0)
	{
	    if (cmd->tx_argc != 4)
		goto badUsage;
	    editPoint.p_x = cmdParseCoord(w, cmd->tx_argv[argpos + 1], FALSE, TRUE);
	    editPoint.p_y = cmdParseCoord(w, cmd->tx_argv[argpos + 2], FALSE, FALSE);
	    GeoTransPoint(&EditToRootTransform, &editPoint, &rootPoint);
	    goto moveToPoint;
	}

	indx = GeoNameToPos(cmd->tx_argv[argpos], FALSE, FALSE);
	if (indx >= 0) argpos++;

	if (cmd->tx_argc >= 3)
	{
	    switch (indx)
	    {
		case GEO_EAST: case GEO_WEST:
		    amountx = cmdParseCoord(w, cmd->tx_argv[argpos], TRUE, TRUE);
		    amounty = 0;
		    break;
		case GEO_NORTH: case GEO_SOUTH:
		    amountx = 0;
		    amounty = cmdParseCoord(w, cmd->tx_argv[argpos], TRUE, FALSE);
		    break;
		default:
		    amountx = cmdParseCoord(w, cmd->tx_argv[argpos], TRUE, TRUE);
		    amounty = cmdParseCoord(w, cmd->tx_argv[cmd->tx_argc - 1],
				TRUE, FALSE);
		    break;
	    }
	}
	else
	{
	    amountx = cmdParseCoord(w, "1l", TRUE, TRUE);
	    amounty = cmdParseCoord(w, "1l", TRUE, FALSE);
	}

	switch (indx)
	{
	    case GEO_NORTH:
		xdelta = 0;
		ydelta = amounty;
		break;
	    case GEO_SOUTH:
		xdelta = 0;
		ydelta = -amounty;
		break;
	    case GEO_EAST:
		xdelta = amountx;
		ydelta = 0;
		break;
	    case GEO_WEST:
		xdelta = -amountx;
		ydelta = 0;
		break;
	    case GEO_NORTHEAST:
	    case -2:
		xdelta = amountx;
		ydelta = amounty;
		break;
	    case GEO_NORTHWEST:
		xdelta = -amountx;
		ydelta = amounty;
		break;
	    case GEO_SOUTHEAST:
		xdelta = amountx;
		ydelta = -amounty;
		break;
	    case GEO_SOUTHWEST:
		xdelta = -amountx;
		ydelta = -amounty;
		break;
	    default:
		ASSERT(FALSE, "Bad direction in CmdMove");
		return;
	}
	GeoTransTranslate(xdelta, ydelta, &GeoIdentityTransform, &t);

	/* Move the box by the same amount as the selection, if the
	 * box exists.
         * If no selection exists, but the box does, then move the box
         * anyway (hace 10/8/97)
	 * The above method is superseded by "box move <dir> <dist>"
	 * but is retained for backward compatibility.
	 */

	if (ToolGetBox(&rootDef, &rootBox) &&
		((rootDef == SelectRootDef) || (SelectRootDef == NULL))
		&& (doOrigin == FALSE))
	{
	    GeoTransRect(&t, &rootBox, &newBox);
	    DBWSetBox(rootDef, &newBox);
	}
    }
    else
    {
	/* Use the displacement between the box lower-left corner and
	 * the point as the transform.
	 */

	MagWindow *window;

	window = ToolGetPoint(&rootPoint, (Rect *) NULL);
	if ((window == NULL) ||
	    (EditRootDef != ((CellUse *) window->w_surfaceID)->cu_def))
	{
	    TxError("\"Move\" uses the point as the place to put down a\n");
	    TxError("    the selection, but the point doesn't point to the\n");
	    TxError("    edit cell.\n");
	    return;
	}

	/* Recast the command as "move to x y" so that it no longer
	 * depends on the pointer position, for command logging.
	 */
	GeoTransPoint(&RootToEditTransform, &rootPoint, &editPoint);
        sprintf(cmd->tx_argstring, "move to %di %di\n", editPoint.p_x,
                        editPoint.p_y);
        TxRebuildCommand(cmd);

moveToPoint:
	if (!ToolGetBox(&rootDef, &rootBox) || (rootDef != SelectRootDef))
	{
	    TxError("\"Move\" uses the box lower-left corner as a place\n");
	    TxError("    to pick up the selection for moving, but the box\n");
	    TxError("    isn't in a window containing the selection.\n");
	    return;
	}
	GeoTransTranslate(rootPoint.p_x - rootBox.r_xbot,
	    rootPoint.p_y - rootBox.r_ybot, &GeoIdentityTransform, &t);
	if (doOrigin == FALSE)
	{
	    GeoTransRect(&t, &rootBox, &newBox);
	    DBWSetBox(rootDef, &newBox);
	}
    }

    if (doOrigin)
    {
	DBMoveCell(rootDef, t.t_c, t.t_f);

	/* Adjust box to maintain relative position */

	if (ToolGetBox(&rootDef, &rootBox) &&
		((rootDef == SelectRootDef) || (SelectRootDef == NULL)))
	{
	    t.t_c = -t.t_c;
	    t.t_f = -t.t_f;
	    GeoTransRect(&t, &rootBox, &newBox);
	    DBWSetBox(rootDef, &newBox);
	    t.t_c = -t.t_c;
	    t.t_f = -t.t_f;
	}

        /* Adjust all window viewing positions and redraw */

        WindTranslate(t.t_c, t.t_f);

        /* This is harsh.  Might work to change all distance measures	*/
        /* in the undo record, but this is simple and direct.           */

        UndoFlush();
    }
    else
	SelectTransform(&t);
}

/*
 * ----------------------------------------------------------------------------
 *
 * CmdPaint --
 *
 * Implement the "paint" command.
 * Paint the specified layers underneath the box in EditCellUse->cu_def.
 *
 * Usage:
 *	paint <layers> | cursor | pick x y
 *
 * Results:
 *	None.
 *
 * Side effects:
 *	Modified EditCellUse->cu_def.
 *
 * ----------------------------------------------------------------------------
 */

void
CmdPaint(
    MagWindow *w,
    TxCommand *cmd)
{
    Rect editRect;
    TileTypeBitMask mask;

    windCheckOnlyWindow(&w, DBWclientID);
    if ((w == (MagWindow *) NULL) || (w->w_client != DBWclientID))
    {
	TxError("Put the cursor in a layout window\n");
	return;
    }

    if ((cmd->tx_argc == 4) && !strcmp(cmd->tx_argv[1], "pick"))
    {
	Point editPoint, rootPoint;
	editPoint.p_x = cmdParseCoord(w, cmd->tx_argv[2], FALSE, TRUE);
	editPoint.p_y = cmdParseCoord(w, cmd->tx_argv[3], FALSE, FALSE);
	GeoTransPoint(&EditToRootTransform, &editPoint, &rootPoint);
	CmdPaintEraseButton(w, &rootPoint, TRUE, FALSE);
	return;
    }

    if (cmd->tx_argc != 2)
    {
	TxError("Usage: %s <layers> | cursor | pick x y\n", cmd->tx_argv[0]);
	return;
    }

    if (!strncmp(cmd->tx_argv[1], "cursor", 6))
    {
	Point editPoint, rootPoint;

	CmdPaintEraseButton(w, &cmd->tx_p, TRUE, TRUE);

	/* Recast the command as "paint pick x y" for logging purposes */
	CmdGetRootPoint(&rootPoint, (Rect *)NULL);
	GeoTransPoint(&RootToEditTransform, &rootPoint, &editPoint);
	sprintf(cmd->tx_argstring, "paint pick %di %di", editPoint.p_x,
			editPoint.p_y);
	TxRebuildCommand(cmd);
	return;
    }
    else if (!CmdParseLayers(cmd->tx_argv[1], &mask))
	return;

    if (!ToolGetEditBox(&editRect)) return;
    if (EditCellUse == (CellUse *)NULL)
    {
	TxError("The cell is not editable.\n");
	return;
    }

    if (TTMaskHasType(&mask, L_LABEL))
    {
	TxError("Label layer cannot be painted.  Use the \"label\" command\n");
	return;
    }
    if (TTMaskHasType(&mask, L_CELL))
    {
	TxError("Subcell layer cannot be painted.  Use \"getcell\".\n");
	return;
    }

    TTMaskClearType(&mask, TT_SPACE);
    DBPaintValid(EditCellUse->cu_def, &editRect, &mask, 0);
    DBAdjustLabels(EditCellUse->cu_def, &editRect);
    SelectClear();
    DBWAreaChanged(EditCellUse->cu_def, &editRect, DBW_ALLWINDOWS, &mask);
    DBReComputeBbox(EditCellUse->cu_def);
    if (DRCBackGround)
	DRCCheckThis (EditCellUse->cu_def, TT_CHECKPAINT, &editRect);
}

/*
 * ----------------------------------------------------------------------------
 *
 * CmdPaintEraseButton --
 *
 * Paint the specified layers underneath the box in EditCellUse->cu_def.
 * Implements the traditional "box tool" Button2 function as a command.
 *
 * Results:
 *	None.
 *
 * Side effects:
 *	Modified EditCellUse->cu_def.
 *
 * ----------------------------------------------------------------------------
 */

void
CmdPaintEraseButton(
    MagWindow *w,
    Point *refPoint,	/* Screen location at which button was raised */
    bool isPaint,	/* True for paint, False for erase.	*/
    bool isScreen)	/* True for screen coordinates, False for root */
{
    Rect rootRect, editRect, areaReturn;
    TileTypeBitMask mask;
    DBWclientRec *crec;

    windCheckOnlyWindow(&w, DBWclientID);
    if ((w == (MagWindow *) NULL) || (w->w_client != DBWclientID))
    {
	TxError("Put the cursor in a layout window\n");
	return;
    }
    crec = (DBWclientRec *) w->w_clientData;

    if (isScreen)
	WindPointToSurface(w, refPoint, (Point *) NULL, &rootRect);
    else
    {
	rootRect.r_ll.p_x = refPoint->p_x;
	rootRect.r_ll.p_y = refPoint->p_y;
	rootRect.r_ur.p_x = refPoint->p_x + 1;
	rootRect.r_ur.p_y = refPoint->p_y + 1;
    }

    DBSeeTypesAll(((CellUse *)w->w_surfaceID), &rootRect,
	    crec->dbw_bitmask, &mask);
    TTMaskAndMask(&mask, &DBActiveLayerBits);
    TTMaskAndMask(&mask, &crec->dbw_visibleLayers);
    TTMaskClearType(&mask, TT_SPACE);

    if (!ToolGetEditBox(&editRect)) return;
    if (EditRootDef == (CellDef *)NULL) return;

    areaReturn = editRect;
    if (TTMaskEqual(&mask, &DBZeroTypeBits))
    {
	TileTypeBitMask eraseMask;

	TTMaskAndMask3(&mask, &CmdYMAllButSpace, &crec->dbw_visibleLayers);

	/* A little extra bit of cleverness:  if the box is zero size
	 * then delete all labels (this must be what the user intended
	 * since a zero size box won't delete any paint).  Otherwise,
	 * only delete labels whose paint has completely vanished.
	 */

	if (GEO_RECTNULL(&editRect))
	    TTMaskSetType(&mask, L_LABEL);

	TTMaskAndMask3(&eraseMask, &crec->dbw_visibleLayers, &DBActiveLayerBits);
	DBEraseValid(EditCellUse->cu_def, &editRect, &eraseMask, 0);
	DBEraseLabel(EditCellUse->cu_def, &editRect, &mask, &areaReturn);
    }
    else if (isPaint)
	DBPaintValid(EditCellUse->cu_def, &editRect, &mask, 0);
    else
    {
	DBEraseValid(EditCellUse->cu_def, &editRect, &mask, 0);
	DBEraseLabel(EditCellUse->cu_def, &editRect, &mask, NULL);
    }
    SelectClear();
    DBAdjustLabels(EditCellUse->cu_def, &editRect);

    DRCCheckThis (EditCellUse->cu_def, TT_CHECKPAINT, &editRect);
    DBWAreaChanged(EditCellUse->cu_def, &areaReturn, DBW_ALLWINDOWS, &mask);
    DBReComputeBbox(EditCellUse->cu_def);
    UndoNext();
}

/*
 * ----------------------------------------------------------------------------
 *
 * CmdPath --
 *
 * Implement the "path" command:  set a global cell search path.
 *
 * Usage:
 *	path [search|cell|sys] [path]
 *
 * Results:
 *	None.
 *
 * Side effects:
 *	The indicated path is set to the first command line argument.
 *	A "+" in front of the path indicates append to the current path.
 *	If the middle argument is missing, the search path is assumed.
 *	If no argument is given, then the current paths are printed.
 *
 * ----------------------------------------------------------------------------
 */

#define PATHSEARCH	0
#define PATHCELL	1
#define PATHSYSTEM	2
#define PATHHELP	3

void
CmdPath(
    MagWindow *w,
    TxCommand *cmd)
{
    char **pathptr;
    char *srcptr;
    int option;
    static const char * const cmdPathOption[] =
    {
	"search	[[+]path]	set [append to] search path",
	"cell	[[+]path]	set [append to] cell path",
	"sys    [[+]path]	set [append to] system path",
	"help			print this help information",
	NULL
    };

    if (cmd->tx_argc > 3)
	goto usage;

    else if (cmd->tx_argc == 1)
    {
	TxPrintf("Search path for cells is \"%s\"\n", Path);
	TxPrintf("Cell library search path is \"%s\"\n", CellLibPath);
	TxPrintf("System search path is \"%s\"\n", SysLibPath);
	return;
    }
    option = Lookup(cmd->tx_argv[1], cmdPathOption);
    if (option == -1)
    {
	TxError("Ambiguous path option: \"%s\"\n", cmd->tx_argv[1]);
	goto usage;
    }

    switch (option) {
	case PATHHELP:
	    goto usage;
	    break;
	case PATHSEARCH:
	    pathptr = &Path;
	    if (cmd->tx_argc == 2)
	    {
#ifdef MAGIC_WRAPPER
		Tcl_SetResult(magicinterp, Path, NULL);
#else
		TxPrintf("Search path for cells is \"%s\"\n", Path);
#endif
		return;
	    }
	    else
	        srcptr = cmd->tx_argv[2];
	    break;
	case PATHCELL:
	    pathptr = &CellLibPath;
	    if (cmd->tx_argc == 2)
	    {
#ifdef MAGIC_WRAPPER
		Tcl_SetResult(magicinterp, CellLibPath, NULL);
#else
		TxPrintf("Cell library search path is \"%s\"\n", CellLibPath);
#endif
		return;
	    }
	    else
	        srcptr = cmd->tx_argv[2];
	    break;
	case PATHSYSTEM:
	    pathptr = &SysLibPath;
	    if (cmd->tx_argc == 2)
	    {
#ifdef MAGIC_WRAPPER
		Tcl_SetResult(magicinterp, SysLibPath, NULL);
#else
		TxPrintf("System search path is \"%s\"\n", SysLibPath);
#endif
		return;
	    }
	    else
	        srcptr = cmd->tx_argv[2];
	    break;
	default:
	    if (cmd->tx_argc == 2)
	    {
	        pathptr = &Path;
		srcptr = cmd->tx_argv[1];
	    }
	    else
		goto usage;
    }

    if (*srcptr == '+')
    {
	srcptr++;
	PaAppend(pathptr, srcptr);
    }
    else
    {
	(void) StrDup(pathptr, srcptr);
    }
    return;

usage:
    TxError("Usage: %s [search|cell|sys] [[+]path]\n", cmd->tx_argv[0]);
}

/*
 * ----------------------------------------------------------------------------
 *
 * CmdPolygon --
 *
 * Implement the "polygon" command.  Draws a polygon based on the
 * point pairs supplied.
 *
 * Usage:
 *	polygon tiletype x1 y1 x2 y2 [x3 y3 ...] xn yn
 *
 * Results:
 *	None.
 *
 * Side Effects:
 *	Paints into the database.
 *
 * ----------------------------------------------------------------------------
 */

void
CmdPolygon(
    MagWindow *w,
    TxCommand *cmd)
{
    TileType type;
    int points, i, j, pNum;
    Point *plist;
    Rect r;
    CellDef *def = (CellDef *)NULL;
    PaintUndoInfo ui;

    if (EditCellUse != NULL)
	def = EditCellUse->cu_def;

    if (def == NULL)
    {
	TxError("No cell being edited\n");
	return;
    }

    if (cmd->tx_argc < 8)
    {
	TxError("Usage:  polygon tiletype x1 y1 x2 y2 [x3 y3 ...] xn yn\n");
	return;
    }

    type = DBTechNoisyNameType(cmd->tx_argv[1]);
    if (type < 0)
	return;

    if (cmd->tx_argc & 1)
    {
	TxError("Unpaired coordinate value\n");
	return;
    }
    points = (cmd->tx_argc - 2) >> 1;
    plist = (Point *)mallocMagic(points * sizeof(Point));
    for (i = 0, j = 2; i < points; i++)
    {
	plist[i].p_x = cmdParseCoord(w, cmd->tx_argv[j++], FALSE, TRUE);
	plist[i].p_y = cmdParseCoord(w, cmd->tx_argv[j++], FALSE, FALSE);
    }

    def->cd_flags |= CDMODIFIED | CDGETNEWSTAMP;
    ui.pu_def = def;
    for (pNum = PL_PAINTBASE; pNum < DBNumPlanes; pNum++)
    {
	if (DBPaintOnPlane(type, pNum))
	{
	    ui.pu_pNum = pNum;
	    PaintPolygon(plist, points, def->cd_planes[pNum],
			DBStdPaintTbl(type, pNum), &ui, FALSE);
	}
    }

    /* Get the bounding box of the polygon and update the cell bbox */

    r.r_xbot = r.r_xtop = plist[0].p_x;
    r.r_ybot = r.r_ytop = plist[0].p_y;
    for (i = 1; i < points; i++)
	GeoIncludePoint(plist + i, &r);

    DBWAreaChanged(def, &r, DBW_ALLWINDOWS, &DBAllButSpaceBits);
    DBReComputeBbox(def);
    DRCCheckThis(def, TT_CHECKPAINT, &r);
    freeMagic(plist);
}

/*----------------------------------------------------------------------*/
/* cmdPortLabelFunc() ---						*/
/*----------------------------------------------------------------------*/

int
cmdPortLabelFunc1(
    SearchContext *scx,
    Label *label,
    TerminalPath *tpath,
    ClientData cdata)
{
    Label **rlab = (Label **)cdata;

    if (GEO_SURROUND(&scx->scx_area, &label->lab_rect))
    {
	if (*rlab != NULL)
	{
	    // More than one label in the area;  ambiguous.
	    *rlab = NULL;
	    return 1;
	}
	*rlab = label;
    }
    return 0;
}

int
cmdPortLabelFunc2(
    SearchContext *scx,
    Label *label,
    TerminalPath *tpath,
    ClientData cdata)
{
    Label **rlab = (Label **)cdata;

    if (GEO_OVERLAP(&scx->scx_area, &label->lab_rect))
    {
	if (*rlab != NULL)
	{
	    // More than one label in the area;  ambiguous.
	    *rlab = NULL;
	    return 1;
	}
	*rlab = label;
    }
    return 0;
}

/*----------------------------------------------------------------------*/
/* portFindLabel ---							*/
/*									*/
/* Find a label in the cell editDef.					*/
/*									*/
/* If "port" is true, then search only for labels that are ports.	*/
/*    If false, then search only for labels that are not ports.		*/
/* If "unique" is true, then return a label only if exactly one label	*/
/* is found in the edit box.						*/
/*----------------------------------------------------------------------*/

Label *
portFindLabel(
    CellDef *editDef,
    bool port,		// If TRUE, only look for labels that are ports
    bool unique,
    bool *nonEdit)	// TRUE if label is not in the edit cell
{
    int found, wrongkind;
    Label *lab, *sl;
    Rect editBox;

    /*
     * Check for unique label in box area.  Note that GEO_OVERLAP
     * requires non-zero overlap area, so also check GEO_SURROUND to
     * catch zero-area label rectangles.
     */

    ToolGetEditBox(&editBox);
    found = 0;
    wrongkind = FALSE;
    if (nonEdit) *nonEdit = FALSE;
    lab = NULL;
    for (sl = editDef->cd_labels; sl != NULL; sl = sl->lab_next)
    {
	/* Ignore labels based on whether label is or is not a port */
	if (((port == TRUE) && !(sl->lab_flags & PORT_DIR_MASK)) ||
		    ((port == FALSE) && (sl->lab_flags & PORT_DIR_MASK)))
	{
	    wrongkind = TRUE;	/* Found at least one label of the wrong kind */
	    continue;
	}

	if (GEO_OVERLAP(&editBox, &sl->lab_rect) ||
			GEO_SURROUND(&editBox, &sl->lab_rect))
	{
	    if (found > 0)
	    {
		/* Let's do this again with the GEO_SURROUND function	*/
		/* and see if we come up with only one label.		*/

		found = 0;
		for (sl = editDef->cd_labels; sl != NULL; sl = sl->lab_next)
		{
		    if (GEO_SURROUND(&editBox, &sl->lab_rect))
		    {
			if (found > 0 && unique == TRUE) return NULL;
			lab = sl;
			found++;
		    }
		}
		break;
	    }
	    lab = sl;
	    found++;
	    if (nonEdit) *nonEdit = FALSE;
	}
    }
    if ((found == 0) && (wrongkind == TRUE)) return NULL;

    /* If no label was found, then search the hierarchy under the box.	*/
    /* The calling routine may determine whether a label that is not in	*/
    /* the edit cell may be valid for the command (e.g., if querying	*/
    /* but not changing values).  NOTE:  Currently this does not apply	*/
    /* the "port" option.						*/

    if (found == 0)
    {
	SearchContext scx;
	scx.scx_area = editBox;
	scx.scx_use = EditCellUse;
	scx.scx_trans = GeoIdentityTransform;

	/* First check for exactly one label surrounded by the cursor box.  */
	/* If that fails, check for exactly one label overlapping the	    */
	/* cursor box.							    */

        DBTreeSrLabels(&scx, &DBAllButSpaceBits, 0, NULL, TF_LABEL_ATTACH,
		cmdPortLabelFunc1, (ClientData) &lab);
	if (lab == NULL)
	    DBTreeSrLabels(&scx, &DBAllButSpaceBits, 0, NULL, TF_LABEL_ATTACH,
		    cmdPortLabelFunc2, (ClientData) &lab);

	if (lab != NULL)
	    if (nonEdit) *nonEdit = TRUE;
    }

    return lab;
}

/*
 * ----------------------------------------------------------------------------
 *
 * complabel() --
 *
 * qsort() callback routine used by CmdPort when renumbering ports.
 * Simply do a string comparison on the two labels.  There is no special
 * meaning to the lexigraphic ordering;  it is meant only to enforce a
 * consistent and repeatable port order.  However, note that since SPICE
 * is case-insensitive, case-insensitive string comparison is used.
 *
 * ----------------------------------------------------------------------------
 */

int
complabel(
    const void *one,
    const void *two)
{
    /* Natural sort order routine from DBcellname.c
     * replaces strcasecmp().
     */
    int strcmpbynum(const char *s1, const char *s2);

    Label *l1 = *((Label **)one);
    Label *l2 = *((Label **)two);
    return strcmpbynum(l1->lab_text, l2->lab_text);
}

/*
 * ----------------------------------------------------------------------------
 *
 * CmdPort --
 *
 * Implement the "port" command.  Finds a label inside the cursor box.
 * If this label is unique (only one label found), then its flags are
 * set according to "num" and one or more "connect_directions" (see
 * usage, below).
 *
 * Usage:
 *	port make [num] [connect_direction(s)]
 * or
 *	port makeall|renumber [connect_direction(s)]
 * or
 *	port [name|num] class|use|shape|index|name [value] [-quiet]
 *
 * num is the index of the port, usually beginning with 1.  This indicates
 *	the order in which ports should be written to a subcircuit record
 *	in extracted output.  The edit cell is searched for ports to make
 *	sure that "num" is unique.  If not specified, "num" will use the
 *	first available index starting at 1.
 *
 * connect_directions is one or more of the manhattan (n, s, e, w)
 *	directions.  This indicates to place and route tools where
 *	networks may connect to the subcircuit.  To extresis, the
 *	direction indicates the direction of current flow into the
 *	subcircuit.  If not specified, connect_directions will use
 *	the direction of the label text as the direction of connection.
 *
 * "value" is a value string representing one of the valid port classes
 *	or uses.
 *
 * The "-quiet" option causes magic to fail quietly and return (in Tcl)
 *	an empty string if the value requested does not exist.
 *
 * Results:
 *	None.
 *
 * Side effects:
 *	Modified label record.
 *
 * ----------------------------------------------------------------------------
 */

#define PORT_CLASS	0
#define PORT_USE	1
#define PORT_SHAPE	2
#define PORT_INDEX	3
#define PORT_EQUIV	4
#define PORT_EXISTS	5
#define PORT_CONNECT	6
#define PORT_FIRST	7
#define PORT_NEXT	8
#define PORT_LAST	9
#define PORT_MAKE	10
#define PORT_MAKEALL	11
#define PORT_NAME	12
#define PORT_REMOVE	13
#define PORT_RENUMBER	14
#define PORT_HELP	15

void
CmdPort(
    MagWindow *w,
    TxCommand *cmd)
{
    const char * const *msg;
    int argstart;
    int i, refidx, idx, pos, type, option, argc;
    unsigned int dirmask;
    bool found;
    bool nonEdit = FALSE, doQuiet = FALSE;
    Label *lab, *sl;
    Rect editBox, tmpArea;
    CellDef *editDef;

    static const char * const cmdPortOption[] =
    {
	"class	[type]		get [set] port class type",
	"use	[type]		get [set] port use type",
	"shape	[type]		get [set] port shape type",
	"index	[number]	get [set] port number",
	"equivalent [number]	make port equivalent to another port",
	"exists			report if a label is a port or not",
	"connections [dir...]	get [set] port connection directions",
	"first			report the lowest port number used",
	"next [number]		report the next port number used",
	"last			report the highest port number used",
	"make [index] [dir...]	turn a label into a port",
	"makeall [index] [dir]	turn all labels into ports",
	"name			report the port name",
	"remove			turn a port back into a label",
	"renumber		renumber all ports",
	"help			print this help information",
	NULL
    };

    static const char * const cmdPortClassTypes[] =
    {
	"default",
	"input",
	"output",
	"tristate",
	"bidirectional",
	"inout",
	"feedthrough",
	"feedthru",
	NULL
    };

    static const int cmdClassToBitmask[] =
    {
	PORT_CLASS_DEFAULT,
	PORT_CLASS_INPUT,
	PORT_CLASS_OUTPUT,
	PORT_CLASS_TRISTATE,
	PORT_CLASS_BIDIRECTIONAL,
	PORT_CLASS_BIDIRECTIONAL,
	PORT_CLASS_FEEDTHROUGH,
	PORT_CLASS_FEEDTHROUGH
    };

    static const char * const cmdPortUseTypes[] =
    {
	"default",
	"analog",
	"signal",
	"digital",
	"power",
	"ground",
	"clock",
	NULL
    };

    static const int cmdUseToBitmask[] =
    {
	PORT_USE_DEFAULT,
	PORT_USE_ANALOG,
	PORT_USE_SIGNAL,
	PORT_USE_SIGNAL,
	PORT_USE_POWER,
	PORT_USE_GROUND,
	PORT_USE_CLOCK
    };

    static const char * const cmdPortShapeTypes[] =
    {
	"default",
	"abutment",
	"ring",
	"feedthrough",
	"feedthru",
	NULL
    };

    static const int cmdShapeToBitmask[] =
    {
	PORT_SHAPE_DEFAULT,
	PORT_SHAPE_ABUT,
	PORT_SHAPE_RING,
	PORT_SHAPE_THRU,
	PORT_SHAPE_THRU
    };

    windCheckOnlyWindow(&w, DBWclientID);
    if (w == (MagWindow *) NULL)
        editDef = EditCellUse->cu_def;
    else
        editDef = ((CellUse *) w->w_surfaceID)->cu_def;

    argstart = 1;
    argc = cmd->tx_argc;

    if (argc > 1)
    {
	if (!strcmp(cmd->tx_argv[argc - 1], "-quiet"))
	{
	    doQuiet = TRUE;
	    argc--;
	}
    }

    if (argc > 6 || argc == 1)
        goto portWrongNumArgs;
    else
    {
	/* Make sure edit box exists */
	if (!ToolGetEditBox(&editBox)) return;

	/* Handle syntax "port <name>|<index> [option ...]"	*/
	/* Does not require a selection.			*/

	lab = NULL;
	if (argc > 2) {
	    option = Lookup(cmd->tx_argv[2], cmdPortOption);
	    if (option >= 0 && option != PORT_HELP)
	    {
		char *portname;

		if (StrIsInt(cmd->tx_argv[1]))
		{
		    int portidx = atoi(cmd->tx_argv[1]);
		    for (sl = editDef->cd_labels; sl != NULL; sl = sl->lab_next)
			if (sl && ((sl->lab_flags & PORT_DIR_MASK) != 0))
			    if ((int)sl->lab_port == portidx)
			    {
			    	lab = sl;
				break;
			    }
		}
		else
		{

 		    portname = cmd->tx_argv[1];
		    for (sl = editDef->cd_labels; sl != NULL; sl = sl->lab_next)
			if (!strcmp(portname, sl->lab_text))
			{
			    lab = sl;
			    if (sl && ((sl->lab_flags & PORT_DIR_MASK) != 0))
			    	break;
			}
		}
		if (lab == NULL)
		{
		    if (!doQuiet)
		    {
			if (StrIsInt(cmd->tx_argv[1]))
			    TxError("No label found with index %s.\n", cmd->tx_argv[1]);
			else
			    TxError("No port found with name %s.\n", cmd->tx_argv[1]);
		    }
		    return;
		}
		argstart = 2;
		argc--;
	    }
	    else
		option = Lookup(cmd->tx_argv[1], cmdPortOption);
	}
	else
	    option = Lookup(cmd->tx_argv[1], cmdPortOption);
	if (option < 0 || option == PORT_HELP) goto portWrongNumArgs;
    }

    if (option >= 0)
    {
	/* Check for options that require only one selected port */

	if (option != PORT_LAST && option != PORT_FIRST)
	{
	    if (lab == NULL)
	    {
		if (option == PORT_MAKE)
		    lab = portFindLabel(editDef, FALSE, TRUE, &nonEdit);
		else
		    lab = portFindLabel(editDef, TRUE, TRUE, &nonEdit);
	    }

	    if (option == PORT_EXISTS)
	    {
		if (lab && ((lab->lab_flags & PORT_DIR_MASK) != 0))
#ifdef MAGIC_WRAPPER
		    Tcl_SetObjResult(magicinterp, Tcl_NewBooleanObj(1));
#else
		    TxPrintf("true\n");
#endif
		else
#ifdef MAGIC_WRAPPER
		    Tcl_SetObjResult(magicinterp, Tcl_NewBooleanObj(0));
#else
		    TxPrintf("false\n");
#endif
		return;
	    }
	}
	if ((option != PORT_LAST) && (option != PORT_FIRST) &&
		(option != PORT_MAKEALL) && (option != PORT_RENUMBER)
		&& (lab == NULL))
	{
	    /* Let "port remove" fail without complaining. */
	    if (option != PORT_REMOVE)
	    {
		TxError("Exactly one label may be present under the cursor box.\n");
		TxError("Use \"port <name> ...\" to specify a unique port.\n");
	    }

	    return;
	}

	/* Check for options that require label to be a port */

	if ((option != PORT_MAKE) && (option != PORT_MAKEALL)
		&& (option != PORT_EXISTS) && (option != PORT_RENUMBER)
		&& (option != PORT_LAST) && (option != PORT_FIRST))
	{
	    /* label "lab" must already be a port */
	    if (!(lab->lab_flags & PORT_DIR_MASK))
	    {
		if ((option != PORT_REMOVE) && (!doQuiet))
		    TxError("The selected label is not a port.\n");
		return;
	    }
	}

	/* Check for options that cannot operate on a non-edit cell label */
	if (nonEdit)
	{
	    if ((option == PORT_MAKE) || (option == PORT_MAKEALL)
		    || (option == PORT_REMOVE) || (option == PORT_RENUMBER)
		    || (argc == 3))
	    {
		TxError("Cannot modify a port in an non-edit cell.\n");
		return;
	    }
	}

	/* Handle all command options */
	switch (option)
	{
	    case PORT_LAST:
		i = -1;
		for (sl = editDef->cd_labels; sl != NULL; sl = sl->lab_next)
		{
		    idx = (int)sl->lab_port;
		    if (idx > i) i = idx;
		}
#ifdef MAGIC_WRAPPER
		Tcl_SetObjResult(magicinterp, Tcl_NewIntObj(i));
#else
		TxPrintf("%d\n", i);
#endif
		break;

	    case PORT_FIRST:
		i = -1;
		for (sl = editDef->cd_labels; sl != NULL; sl = sl->lab_next)
		{
		    if (sl->lab_flags & PORT_DIR_MASK)
		    {
		    	idx = (int)sl->lab_port;
		    	if (idx < i || i == -1) i = idx;
		    }
		}
#ifdef MAGIC_WRAPPER
		Tcl_SetObjResult(magicinterp, Tcl_NewIntObj(i));
#else
		TxPrintf("%d\n", i);
#endif
		break;

	    case PORT_NEXT:
		refidx = (int)lab->lab_port;
		i = -1;
		for (sl = editDef->cd_labels; sl != NULL; sl = sl->lab_next)
		{
		    if (sl->lab_flags & PORT_DIR_MASK)
		    {
		    	idx = (int)sl->lab_port;
		    	if (idx > refidx)
		            if (idx < i || i == -1) i = idx;
		    }
		}
#ifdef MAGIC_WRAPPER
		Tcl_SetObjResult(magicinterp, Tcl_NewIntObj(i));
#else
		TxPrintf("Index = %d\n", i);
#endif
		break;

	    case PORT_EXISTS:
		if (!(lab->lab_flags & PORT_DIR_MASK))
		{
#ifdef MAGIC_WRAPPER
		    Tcl_SetObjResult(magicinterp, Tcl_NewBooleanObj(0));
#else
		    TxPrintf("false\n");
#endif
		}
		else
		{
#ifdef MAGIC_WRAPPER
		    Tcl_SetObjResult(magicinterp, Tcl_NewBooleanObj(1));
#else
		    TxPrintf("true\n");
#endif
		}
		break;

	    case PORT_NAME:
		if (argc == 2)
		{
#ifdef MAGIC_WRAPPER
		    Tcl_SetObjResult(magicinterp, Tcl_NewStringObj(lab->lab_text, -1));
#else
		    TxPrintf("Name = %s\n", lab->lab_text);
#endif
		}
		else if (argc == 3)
		{
		    /* This is just a duplication of "setlabel text" */
		    sl = DBPutFontLabel(editDef, &lab->lab_rect, lab->lab_font,
				lab->lab_size, lab->lab_rotate,
				&lab->lab_offset, lab->lab_just,
				cmd->tx_argv[argstart + 1],
				lab->lab_type, lab->lab_flags, lab->lab_port);
		    DBEraseLabelsByContent(editDef, &lab->lab_rect, -1,
				lab->lab_text);
		    DBWLabelChanged(editDef, sl, DBW_ALLWINDOWS);
		}
		break;
	    case PORT_CLASS:
		if (argc == 2)
		{
		    type = lab->lab_flags & PORT_CLASS_MASK;
		    for (idx = 0; cmdPortClassTypes[idx] != NULL; idx++)
			if (cmdClassToBitmask[idx] == type)
			{
#ifdef MAGIC_WRAPPER
			    Tcl_AppendResult(magicinterp, cmdPortClassTypes[idx],
					(char *)NULL);
#else
			    TxPrintf("Class = %s\n", cmdPortClassTypes[idx]);
#endif
			    break;
			}
		}
		else if (argc == 3)
		{
		    type = Lookup(cmd->tx_argv[argstart + 1], cmdPortClassTypes);
		    if (type < 0)
		    {
		        TxError("Usage:  port class <type>, where <type> is one of:\n");
			for (msg = &(cmdPortClassTypes[0]); *msg != NULL; msg++)
			{
                	    TxError("    %s\n", *msg);
			}
		    }
		    else
		    {
			for (sl = lab; sl; sl = sl->lab_next)
			{
			    if (((sl->lab_flags & PORT_DIR_MASK) != 0) &&
					!strcmp(sl->lab_text, lab->lab_text))
			    {
				sl->lab_flags &= (~PORT_CLASS_MASK);
				sl->lab_flags |= (PORT_CLASS_MASK &
					    cmdClassToBitmask[type]);
			    }
			}
			editDef->cd_flags |= (CDMODIFIED | CDGETNEWSTAMP);
		    }
		}
		else
		    goto portWrongNumArgs;
		break;
	    case PORT_USE:
		if (argc == 2)
		{
		    type = lab->lab_flags & PORT_USE_MASK;
		    for (idx = 0; cmdPortUseTypes[idx] != NULL; idx++)
			if (cmdUseToBitmask[idx] == type)
			{
#ifdef MAGIC_WRAPPER
			    Tcl_AppendResult(magicinterp, cmdPortUseTypes[idx],
					(char *)NULL);
#else
			    TxPrintf("Use = %s\n", cmdPortUseTypes[idx]);
#endif
			    break;
			}
		}
		else if (argc == 3)
		{
		    type = Lookup(cmd->tx_argv[argstart + 1], cmdPortUseTypes);
		    if (type < 0)
		    {
		        TxError("Usage:  port use <type>, where <type> is one of:\n");
			for (msg = &(cmdPortUseTypes[0]); *msg != NULL; msg++)
			{
                	    TxError("    %s\n", *msg);
			}
		    }
		    else
		    {
			for (sl = lab; sl; sl = sl->lab_next)
			{
			    if (((sl->lab_flags & PORT_DIR_MASK) != 0) &&
					!strcmp(sl->lab_text, lab->lab_text))
			    {
				sl->lab_flags &= (~PORT_USE_MASK);
				sl->lab_flags |= (PORT_USE_MASK & cmdUseToBitmask[type]);
			    }
			}
			editDef->cd_flags |= (CDMODIFIED | CDGETNEWSTAMP);
		    }
		}
		else
		    goto portWrongNumArgs;
		break;

	    case PORT_SHAPE:
		if (argc == 2)
		{
		    type = lab->lab_flags & PORT_SHAPE_MASK;
		    for (idx = 0; cmdPortShapeTypes[idx] != NULL; idx++)
			if (cmdShapeToBitmask[idx] == type)
			{
#ifdef MAGIC_WRAPPER
			    Tcl_AppendResult(magicinterp, cmdPortShapeTypes[idx],
					(char *)NULL);
#else
			    TxPrintf("Shape = %s\n", cmdPortShapeTypes[idx]);
#endif
			    break;
			}
		}
		else if (argc == 3)
		{
		    type = Lookup(cmd->tx_argv[argstart + 1], cmdPortShapeTypes);
		    if (type < 0)
		    {
		        TxError("Usage:  port shape <type>, where <type> is one of:\n");
			for (msg = &(cmdPortShapeTypes[0]); *msg != NULL; msg++)
			{
                	    TxError("    %s\n", *msg);
			}
		    }
		    else
		    {
			for (sl = lab; sl; sl = sl->lab_next)
			{
			    if (((sl->lab_flags & PORT_DIR_MASK) != 0) &&
					!strcmp(sl->lab_text, lab->lab_text))
			    {
				sl->lab_flags &= (~PORT_SHAPE_MASK);
				sl->lab_flags |= (PORT_SHAPE_MASK & cmdShapeToBitmask[type]);
			    }
			}
			editDef->cd_flags |= (CDMODIFIED | CDGETNEWSTAMP);
		    }
		}
		else
		    goto portWrongNumArgs;
		break;

	    case PORT_INDEX:
		if (argc == 2)
		{
		    idx = (int)lab->lab_port;
#ifdef MAGIC_WRAPPER
		    Tcl_SetObjResult(magicinterp, Tcl_NewIntObj(idx));
#else
		    TxPrintf("Index = %d\n", idx);
#endif
		}
		else if (argc == 3)
		{
		    if (!StrIsInt(cmd->tx_argv[argstart + 1]))
		        TxError("Usage:  port index <integer>\n");
		    else
		    {
			for (sl = lab; sl; sl = sl->lab_next)
			{
			    if (((sl->lab_flags & PORT_DIR_MASK) != 0) &&
					!strcmp(sl->lab_text, lab->lab_text))
			    {
				sl->lab_port = (unsigned int)atoi(cmd->tx_argv[argstart + 1]);
			    }
			}
			editDef->cd_flags |= (CDMODIFIED | CDGETNEWSTAMP);
		    }
		}
		else
		    goto portWrongNumArgs;
		break;

	    case PORT_CONNECT:
		if (argc == 2)
		{
		    char cdir[5];

		    cdir[0] = '\0';
		    pos = lab->lab_flags & PORT_DIR_MASK;
		    if (pos & PORT_DIR_NORTH) strcat(cdir, "n");
		    if (pos & PORT_DIR_EAST) strcat(cdir, "e");
		    if (pos & PORT_DIR_SOUTH) strcat(cdir, "s");
		    if (pos & PORT_DIR_WEST) strcat(cdir, "w");
#ifdef MAGIC_WRAPPER
		    Tcl_AppendResult(magicinterp, cdir, (char *)NULL);
#else
		    TxPrintf("Directions = %s\n", cdir);
#endif
		}
		else
		{
		    argstart++;
		    goto parsepositions;
		}
		break;

	    case PORT_REMOVE:
	        lab->lab_flags = 0;
		tmpArea = lab->lab_rect;
		lab->lab_rect = editBox;
		DBWLabelChanged(editDef, lab, DBW_ALLWINDOWS);
		lab->lab_rect = tmpArea;
		editDef->cd_flags |= (CDMODIFIED | CDGETNEWSTAMP);
		break;

	    case PORT_RENUMBER:
		/* Renumber ports in canonical order (by alphabetical
		 * order of the label text).  NOTE:  Because SPICE is
		 * case-insensitive, case-insensitive alphabetical order
		 * is used.
		 * Update (2/26/2023):  Use *natural sort* order so that
		 * indexes get sorted in numerical, not alphabetical, order.
		 */
		{
		    int numlabels, n, p;
		    Label **slablist, *tlab, *lastlab;
		    extern int complabel(const void *one, const void *two);

		    /* Create a sortable list of labels */
		    numlabels = 0;
		    for (lab = editDef->cd_labels; lab; lab = lab->lab_next)
			numlabels++;

		    slablist = (Label **)mallocMagic(numlabels * sizeof(Label *));
		    numlabels = 0;
		    for (lab = editDef->cd_labels; lab; lab = lab->lab_next)
		    {
			*(slablist + numlabels) = lab;
			numlabels++;
		    }

		    /* Sort the list */
		    qsort(slablist, numlabels, sizeof(Label *), complabel);

		    /* Number the ports by sorted order */
		    p = 0;
		    lastlab = NULL;
		    for (n = 0; n < numlabels; n++)
		    {
			tlab = *(slablist + n);
			if (tlab->lab_flags & PORT_DIR_MASK)
			{
			    if (lastlab)
				if (!strcmp(lastlab->lab_text, tlab->lab_text))
				    p--;

			    tlab->lab_port = (unsigned int)p;
			    lastlab = tlab;
			    p++;
			}
		    }

		    /* Clean up */
		    freeMagic((char *)slablist);
		}
		break;

	    case PORT_MAKEALL:
		lab = editDef->cd_labels;
		// Fall through. . .

	    case PORT_MAKE:
		argstart++;
		goto parseindex;
		break;

	    case PORT_HELP:
portWrongNumArgs:
		TxError("Usage:  port [option], where [option] is one of:\n");
		for (msg = &(cmdPortOption[0]); *msg != NULL; msg++)
		{
                    TxError("    %s\n", *msg);
		}
		TxError("    <index> <directions>\n");
		break;
	}
	return;
    }

parseindex:

    if ((option != PORT_MAKEALL) && (lab->lab_flags & PORT_DIR_MASK))
    {
	/* For this syntax, the label must not already be a port */
	if (!doQuiet)
	{
	    TxError("The selected label is already a port.\n");
	    TxError("Do \"port help\" to get a list of options.\n");
	}
	return;
    }

    while (lab != NULL) {

	if (option == PORT_MAKEALL)
	{
	    /* Get the next valid label, skipping any that are not	*/
	    /* inside the edit box or are already marked as ports.	*/

	    while ((lab != NULL) && (!GEO_OVERLAP(&editBox, &lab->lab_rect)
			|| (lab->lab_flags & PORT_DIR_MASK)))
		lab = lab->lab_next;
	    if (lab == NULL) break;
	}
	else if (lab->lab_flags & PORT_DIR_MASK) break;

	if ((argc > argstart) && StrIsInt(cmd->tx_argv[argstart]))
	{
	    idx = atoi(cmd->tx_argv[argstart]);
	    for (sl = editDef->cd_labels; sl != NULL; sl = sl->lab_next)
	    {
		if (sl == lab) continue;	/* don't consider self */
		if (sl->lab_flags & PORT_DIR_MASK)
		{
		    if ((int)sl->lab_port == idx)
		    {
			/* This is only an error if port name doesn't match */
			if (strcmp(sl->lab_text, lab->lab_text))
			{
			    TxError("Port index %d is already used by port %s.\n"
					"Use command \"port index %d\" to force "
					"equivalence after defining the port.\n",
					idx, sl->lab_text, idx);
			    return;
			}
		    }
		}
	    }
	    argstart++;
	}
	else
	{
	    idx = 0;
	    for (sl = editDef->cd_labels; sl != NULL; sl = sl->lab_next)
	    {
		if (sl == lab) continue;	/* don't consider self */
		if (sl->lab_flags & PORT_DIR_MASK)
		{
		    // If there is another, identical label that is already
		    // declared a port, then use its index.
		    if (!strcmp(sl->lab_text, lab->lab_text))
		    {
			idx = (int)sl->lab_port - 1;
			break;
		    }
		    else if (sl->lab_port > idx)
			idx = sl->lab_port;
		}
	    }
	    idx++;
	}

	lab->lab_port = idx;

	/*
	 * Find positions.
	 */

parsepositions:

	dirmask = 0;
	if (argc == argstart)
	{
	    /* Get position from label */

	    pos = lab->lab_just;
            switch (pos)
	    {
		case GEO_NORTH:
		    dirmask = PORT_DIR_NORTH;
		    break;
		case GEO_SOUTH:
		    dirmask = PORT_DIR_SOUTH;
		    break;
		case GEO_EAST:
		    dirmask = PORT_DIR_EAST;
		    break;
		case GEO_WEST:
		    dirmask = PORT_DIR_WEST;
		    break;
		case GEO_NORTHEAST:
		    dirmask = PORT_DIR_NORTH | PORT_DIR_EAST;
		    break;
		case GEO_NORTHWEST:
		    dirmask = PORT_DIR_NORTH | PORT_DIR_WEST;
		    break;
		case GEO_SOUTHEAST:
		    dirmask = PORT_DIR_SOUTH | PORT_DIR_EAST;
		    break;
		case GEO_SOUTHWEST:
		    dirmask = PORT_DIR_SOUTH | PORT_DIR_WEST;
		    break;
		case GEO_CENTER:
		    dirmask = PORT_DIR_MASK;
		    break;
	    }
	}
	else
	{
	    /* Parse one or more positions */

	    for (i = argstart; i < argc; i++)
	    {
		pos = GeoNameToPos(cmd->tx_argv[i], TRUE, TRUE);
		if (pos < 0)
		    return;
        	pos = GeoTransPos(&RootToEditTransform, pos);
		switch (pos)
		{
		    case GEO_NORTH:
			dirmask |= PORT_DIR_NORTH;
			break;
		    case GEO_SOUTH:
			dirmask |= PORT_DIR_SOUTH;
			break;
		    case GEO_EAST:
			dirmask |= PORT_DIR_EAST;
			break;
		    case GEO_WEST:
			dirmask |= PORT_DIR_WEST;
			break;
		}
	    }
	}

	lab->lab_flags &= ~PORT_DIR_MASK;
	lab->lab_flags |= dirmask;

	tmpArea = lab->lab_rect;
	lab->lab_rect = editBox;
	DBWLabelChanged(editDef, lab, DBW_ALLWINDOWS);
	lab->lab_rect = tmpArea;
    }
    editDef->cd_flags |= (CDMODIFIED | CDGETNEWSTAMP);
}

/*
 * ----------------------------------------------------------------------------
 *
 * CmdDoProperty ---
 *
 * This is the core of the CmdProperty function, separated out so that
 * the function can operate on a specified CellDef in addition to operating
 * on the currently selected EditDef.  This allows us to add the option
 * "property" to the "cellname" command, to grab a property from a cell
 * without having to be actively editing it.
 *
 * Results:
 *	None.
 *
 * Side effects:
 *	Modified cd_prop record in the current edit cell's def.
 *
 * ----------------------------------------------------------------------------
 */

void
CmdDoProperty(
    CellDef *def,
    TxCommand *cmd,
    int argstart)
{
    int printPropertiesFunc();
    char *value;
    bool propfound;
    int locargc = cmd->tx_argc - argstart + 1;

    if (locargc == 1)
    {
	/* print all properties and their values */
	DBPropEnum(def, printPropertiesFunc, NULL);
    }

    else if (locargc == 2)
    {
	/* print the value of the indicated property */
	value = (char *)DBPropGet(def, cmd->tx_argv[argstart], &propfound);
	if (propfound)
#ifdef MAGIC_WRAPPER
	    Tcl_SetResult(magicinterp, value, NULL);
#else
	    TxPrintf("%s", value);
#endif
	else {
#ifdef MAGIC_WRAPPER
	    /* If the command was "cellname list property ...", then	*/
	    /* just return NULL if the property was not found.		*/
	    if (strcmp(cmd->tx_argv[1], "list"))
#endif
		TxError("Property name \"%s\" is not defined\n", cmd->tx_argv[1]);
	}
    }
    else if (locargc == 3)
    {
	if (strlen(cmd->tx_argv[argstart + 1]) == 0)
	    DBPropPut(def, cmd->tx_argv[argstart], NULL);
	else
	{
	    value = StrDup((char **)NULL, cmd->tx_argv[argstart + 1]);
	    DBPropPut(def, cmd->tx_argv[argstart], value);
	}
	def->cd_flags |= (CDMODIFIED | CDGETNEWSTAMP);
    }
    else
    {
	TxError("Usage: property [name] [value]\n");
	TxError("If value is more than one word, enclose in quotes\n");
    }
}

/*
 * ----------------------------------------------------------------------------
 *
 * CmdProperty --
 *
 * Implement the "property" command.  Adds a property string to the
 * current edit cell, using the cd_props hash table and functions
 * defined in database/DBprop.c.
 *
 * Usage:
 *	property [name] [value]
 *
 * "name" is a unique string tag for the property, and "value" is its
 * string value.
 *
 * Results:
 *	None.
 *
 * Side effects:
 *	Modified cd_prop record in the current edit cell's def.
 *
 * ----------------------------------------------------------------------------
 */

void
CmdProperty(
    MagWindow *w,
    TxCommand *cmd)
{
    CellDef *def;

    /* Get the root definition of the window	*/
    /* If window is NULL, pick up the edit def	*/

    windCheckOnlyWindow(&w, DBWclientID);
    if (w == (MagWindow *) NULL)
	def = EditCellUse->cu_def;
    else
	def = ((CellUse *) w->w_surfaceID)->cu_def;

    CmdDoProperty(def, cmd, 1);
}

/*
 * ----------------------------------------------------------------------------
 * Callback function for printing a single property key:value pair
 * ----------------------------------------------------------------------------
 */

int
printPropertiesFunc(
    const char *name,
    ClientData value,
    ClientData cdata) /* not used */
{
#ifdef MAGIC_WRAPPER
    char *keyvalue;

    if (value == NULL)
    {
	keyvalue = (char *)mallocMagic(strlen(name) + 4);
	sprintf(keyvalue, "%s {}", name);
    }
    else
    {
	keyvalue = (char *)mallocMagic(strlen(name) + strlen((const char *)value) + 2);
	sprintf(keyvalue, "%s %s", name, (const char *)value);
    }
    Tcl_AppendElement(magicinterp, keyvalue);
    freeMagic(keyvalue);

#else
    TxPrintf("%s = %s\n", name, (const char *)value);
#endif

    return 0;	/* keep the search alive */
}

/*
 * ----------------------------------------------------------------------------
 *
 * CmdNetlist --
 *
 * Usage:
 *	netlist option
 *
 * Results:
 *	None.
 *
 * Side effects:
 *	Performs the functions previously handled by the button
 *	handler mechanism, which has been replaced with a command-line
 *	command plus macro method.
 *
 * ----------------------------------------------------------------------------
 */

#define NLIST_HELP	0
#define NLIST_SELECT	1
#define NLIST_JOIN	2
#define NLIST_TERMINAL	3

void
CmdNetlist(
    MagWindow *w,
    TxCommand *cmd)
{
    int option;
    const char * const *msg;
    char *lastargv;
    Point cursor;
    static const char * const cmdNetlistOption[] =
    {
	"help           print this help information",
	"select		select the net nearest the cursor",
	"join           join current net and net containing terminal nearest the cursor",
	"terminal	toggle the terminal nearest the cursor into/out of current net",
	NULL
    };

    if (cmd->tx_argc < 2)
    {
	option = NLIST_HELP;
    }
    else
    {
	option = Lookup(cmd->tx_argv[1], cmdNetlistOption);
	if (option < 0)
	{
	    TxError("\"%s\" isn't a valid netlist option.\n", cmd->tx_argv[1]);
	    option = NLIST_HELP;
	}
    }

    switch (option)
    {
	case NLIST_HELP:
	    TxPrintf("Netlist commands have the form \":netlist option\",");
	    TxPrintf(" where option is one of:\n");
	    for (msg = &(cmdNetlistOption[0]); *msg != NULL; msg++)
	    {
		TxPrintf("    %s\n", *msg);
	    }
	    break;

	case NLIST_SELECT:
	    NMButtonLeft(w, cmd);
	    break;

	case NLIST_JOIN:
	    NMButtonMiddle(w, cmd);
	    break;

	case NLIST_TERMINAL:
	    NMButtonRight(w, cmd);
	    break;
    }
}

/*
 * ----------------------------------------------------------------------------
 *
 * CmdOrient --
 *
 * Implement the "orient" command.  Set the orientation of the selection and
 * according to the orientation string, which can be in Magic's format
 * (using number of degrees, and "h" for horizontal flip or "v" for vertical
 * flip) or DEF format ("N", "S", "FN", etc.).  The cursor box is rotated to
 * match.
 *
 * Usage:
 *	orient [orientation] [-origin]
 *
 * Results:
 *	None.
 *
 * Side effects:
 *	Modifies the edit cell.
 *
 * Notes:
 *	The "-origin" option sets the orientation relative to the origin,
 *	instead of the lower-left corner.
 *
 * ----------------------------------------------------------------------------
 */

void
CmdOrient(
    MagWindow *w,
    TxCommand *cmd)
{
    Transform trans, t2;
    int orientidx, locargc;
    char *orientstr;
    Rect rootBox,  bbox;
    CellDef *rootDef;
    bool noAdjust = FALSE;

    static const char * const orientNames[] = {      "0", "90", "180", "270",
                                        "v", "0v", "90v", "180v", "270v",
                                        "h", "0h", "90h", "180h", "270h",
                                        "N", "E", "S", "W",
                                        "FN", "FE", "FS", "FW",
                                        0 };

    typedef enum { IDX_ORIENT_0, IDX_ORIENT_90, IDX_ORIENT_180, IDX_ORIENT_270,
            IDX_ORIENT_V, IDX_ORIENT_0V, IDX_ORIENT_90V, IDX_ORIENT_180V,
            IDX_ORIENT_270V, IDX_ORIENT_H, IDX_ORIENT_0H, IDX_ORIENT_90H,
            IDX_ORIENT_180H, IDX_ORIENT_270H, IDX_ORIENT_N, IDX_ORIENT_E,
            IDX_ORIENT_S, IDX_ORIENT_W, IDX_ORIENT_FN, IDX_ORIENT_FE,
            IDX_ORIENT_FS, IDX_ORIENT_FW } orientType;

    locargc = cmd->tx_argc;
    if (!strncmp(cmd->tx_argv[locargc - 1], "-orig", 5))
    {
	noAdjust = TRUE;
	locargc--;
    }

    if (!ToolGetEditBox((Rect *)NULL)) return;

    if (locargc == 2)
	orientstr = cmd->tx_argv[1];
    else
	goto badusage;

    orientidx = Lookup(orientstr, orientNames);

    switch (orientidx)
    {
        case IDX_ORIENT_0:
        case IDX_ORIENT_N:
            /* ORIENT_NORTH */
            t2 = GeoIdentityTransform;
            break;
        case IDX_ORIENT_S:
        case IDX_ORIENT_180:
            /* ORIENT_SOUTH */
            t2 = Geo180Transform;
            break;
        case IDX_ORIENT_E:
        case IDX_ORIENT_90:
            /* ORIENT_EAST */
            t2 = Geo90Transform;
            break;
        case IDX_ORIENT_W:
        case IDX_ORIENT_270:
            /* ORIENT_WEST */
            t2 = Geo270Transform;
            break;
        case IDX_ORIENT_FN:
        case IDX_ORIENT_H:
        case IDX_ORIENT_0H:
            /* ORIENT_FLIPPED_NORTH */
            t2 = GeoSidewaysTransform;
            break;
        case IDX_ORIENT_FS:
        case IDX_ORIENT_180H:
        case IDX_ORIENT_V:
        case IDX_ORIENT_0V:
            /* ORIENT_FLIPPED_SOUTH */
            t2 = GeoUpsideDownTransform;
            break;
        case IDX_ORIENT_FE:
        case IDX_ORIENT_90H:
        case IDX_ORIENT_270V:
            /* ORIENT_FLIPPED_EAST */
            t2 = GeoRef135Transform;
            break;
        case IDX_ORIENT_FW:
        case IDX_ORIENT_270H:
        case IDX_ORIENT_90V:
            /* ORIENT_FLIPPED_WEST */
            t2 = GeoRef45Transform;
            break;
	default:
	    goto badusage;
    }

    /* To orient the selection, first orient it relative to the origin
     * then move it so its lower-left corner is at the same place
     * that it used to be.  If the "-origin" option was selected, then
     * only orient relative to the origin.
     */

    GeoTransRect(&t2, &SelectDef->cd_bbox, &bbox);
    if (noAdjust)
	trans = t2;
    else
    {
	GeoTranslateTrans(&t2, SelectDef->cd_bbox.r_xbot - bbox.r_xbot,
		SelectDef->cd_bbox.r_ybot - bbox.r_ybot, &trans);
    }

    SelectTransform(&trans);

    /* Rotate the box, if it exists and is in the same window as the
     * selection.
     */

    if (ToolGetBox(&rootDef, &rootBox) && (rootDef == SelectRootDef))
    {
	Rect newBox;

	GeoTransRect(&trans, &rootBox, &newBox);
	DBWSetBox(rootDef, &newBox);
    }

    return;

    badusage:
    TxError("Usage: %s [orientation]\n", cmd->tx_argv[0]);
}