xyflat(3) [debian man page]

XYFLAT(3)						      MBK PHYSICAL FUNCTIONS							 XYFLAT(3)

NAME

       xyflat - compute hierarchical coordinates

ORIGIN

       This  software  belongs	to  the  ALLIANCE CAD SYSTEM developed by the ASIM team at LIP6 laboratory of Universite Pierre et Marie CURIE, in
       Paris, France.

       Web : http://asim.lip6.fr/recherche/alliance/
       E-mail : alliance-users@asim.lip6.fr

SYNOPSYS

       #include "mph.h"
       void xyflat(xout, yout, x, y, xins, yins, x1, y1, x2, y2, trsf)
       long *xout, *yout;
       long x, y;
       long xins, yins;
       long x1, y1, x2, y2;
       char trsf;

PARAMETERS

       xout, yout	   Values filled by the function call, return values, that represent coordinates of the point in the figure

       x, y		   Coordinates of a point in the instance

       xins, yins	   Coordinates of the lower left corner of the instance

       x1, y1, x2, y2	   Coordinates of the abutment box of the model of the instance

       trsf		   Geometrical operation applied to the instance

DESCRIPTION

       xyflat computes coordinates relative to a model of instance in order to give them in figure coordinates, taking care of the  transformation
       performed on the instance.
       This function is very useful when flattening, or getting coordinates of an object belonging to an istance at figure level.
       Care  must be taken that the x1, y1, x2, y2 parameters are not the current figure abutment box coordinates, but the instance model abutment
       box coordinates.

EXAMPLE

       #include "mph.h"
       long GET_CON_X(insname, conname, index)
       char *insname, *conname;
       long index;
       {
       phfig_list *ptfig; /* pointer on model of instance called insname */
       phins_list *ptins; /* pointer on instance called insname */
       phcon_list *ptcon; /* pointer on the conname called con inside ptins */
       long x_con, y_con; /* return values, y_con here for beauty */
	  ptins = getphins(WORK_PHFIG, insname);
	  ptfig = getphfig(ptins->FIGNAME, 'P');
	  ptcon = getphcon(ptfig, conname, index);
	  xyflat(&x_con, &y_con, ptcon->XCON, ptcon->YCON,
	     ptins->XINS, ptins->YIINS,
	     ptfig->XAB1, ptfig->YAB1, ptfig->XAB2, ptfig->YAB2,
	     ptins->TRANSF);
	  return x_con;
       }

SEE ALSO

       mbk(1), phfig(3), phins(3).

BUG REPORT

       This tool is under development at the ASIM department of the LIP6 laboratory.
       We need your feedback to improve documentation and tools.

ASIM
/LIP6							  October 1, 1997							 XYFLAT(3)

ADDPHCON(3)						      MBK PHYSICAL FUNCTIONS						       ADDPHCON(3)

NAME

       addphcon - create a physical connector

ORIGIN

       This  software  belongs	to  the  ALLIANCE CAD SYSTEM developed by the ASIM team at LIP6 laboratory of Universite Pierre et Marie CURIE, in
       Paris, France.

       Web : http://asim.lip6.fr/recherche/alliance/
       E-mail : alliance-users@asim.lip6.fr

SYNOPSYS

       #include "mph.h"
       phcon_list *addphcon(ptfig, orient, conname, x, y, layer, width)
       phfig_list *ptfig;
       char orient;
       char *conname;
       long x, y;
       char layer;
       long width;

PARAMETERS

       ptfig		   Pointer to the figure in which the connector should be added

       orient		   Face of the connector

       conname		   Name of the connector

       x, y		   Absolute connector coordinates

       layer		   Connector symbolic layer

       width		   Connector symbolic width

DESCRIPTION

       addphcon creates a new connector called conname and adds it to the list of connectors pointed to by  ptfig->PHCON.  The	new  connector	is
       added in front of the list, and becomes itself the list head.
       The  parameters	conname, orient, x, y, layer, width fill respectivly the NAME, ORIENT, XCON, YCON, LAYER, WIDTH fields of the phcon struc-
       ture.  See phcon(3) for details.
       The INDEX field is computed by the addphcon function in order to warranty index unicity. A topological sort is performed, checking x,  then
       y, then the layer. So for a given figure, each connector will have a constant INDEX.
       The x, y coordinates must be placed inside the butment box of the figure.
       The width is a layer extension that takes place in parallel to the connector face.
       For a list of valid orient and layers, see locon(3).

RETURN VALUE

       addphcon returns a pointer to the newly created connector.

ERRORS

       "*** mbk error *** illegal addphcon unknow layer layer in conname"
	      The layer parameter is out of range, and does not represent a legal symbolic layer. See locon(3) for a complete list of layers.
       "*** mbk error *** illegal addphcon connector conname not in abutment box"
	      The  connector  coordinates  are not included in the rectangle of the figure abutment box. This means that the abutment box field of
	      the phfig must be filled befor any call to addphcon.
       "*** mbk error *** illegal addphcon orientation is orient in conname"
	      The orient parameter is not in the set of legal values. See locon(3) for the complete list of orientations.

EXAMPLE

       #include "mph.h"
       phcon_list *du_con(ptfig, ptcon) /* duplicate connector */
       phfig_list *ptfig;
       phcon_list *ptcon;
       {
	  /* the index depends from what's in ptfig->PHCON, not from me */
	  return addphcon(ptfig, ptcon->ORIENT, ptcon->NAME,
			  ptcon->XCON, ptcon->YCON,
			  ptcon->LAYER, ptcon->WIDTH);
       }

SEE ALSO

       mbk(1), phfig(3), phcon(3), getphcon(3), delphcon(3), locon(3).

BUG REPORT

       This tool is under development at the ASIM department of the LIP6 laboratory.
       We need your feedback to improve documentation and tools.

ASIM
/LIP6							  October 1, 1997						       ADDPHCON(3)