GENLIB_PLACE_LEFT.3alc man page

GENLIB_PLACE_LEFT — place a physical instance in the current figure at the left of the "reference instance"

Synopsis

#include <genlib.h>
void GENLIB_PLACE_LEFT(modelname, insname, symetry)
char ∗modelname, ∗insname;
char symetry;

Parameters

modelname

Name of the layout figure to be instantiated

insname

Name to be given to the instance on the model

symetry

Geometrical operation to be performed on the instance before being placed

Description

PLACE_LEFT add an instance of model modelname in the current layout cell. The bottom right corner of the abutment box of the instance is placed, after being symetrized and/or rotated, toward the bottom left corner of the abutment box of the "reference instance". The newly placed instance becomes the "reference instance".
The insname is the name given to the instance and must be unique at a given hierarchy level.
The symetry argument can take eight legal values :

NOSYM

no geometrical operation is performed

SYM_Y

Y becomes -Y, that means toward X axe symetry

SYM_X

X becomes -X, that means toward Y axe symetry

SYMXY

X becomes -X, Y becomes -Y

ROT_P

a positive 90 degrees rotation take place

ROT_M

a negative 90 degrees rotation take place

SY_RP

Y becomes -Y, and then a positive 90 degrees rotation take place

SY_RM

Y becomes -Y, and then a negative 90 degrees rotation take place

The model of the figure to be placed must be available, on disk or in memory. The path to the library is specified in the MBK_CATA_LIB (1) and MBK_WORK_LIB (1) environment variables, and its format is given by the MBK_IN_PH (1) environment variable.

Errors

"GENLIB_PLACE_LEFT impossible : missing GENLIB_DEF_PHFIG"

No figure has been yet specified by a call to DEF_PHFIG. So it isn't possible to place an instance inside it. you must call DEF_PHFIG before any other layout action.

"GENLIB_PLACE_LEFT impossible : No previous instance"

There are no instances placed in the current layout cell, so it's impossible to know where to place from. Use a PLACE call before.

"illegal addphins : transformation is x in insname"

The symetry parameter is not one of the define given, but has the integer value x.

Example

#include <genlib.h>
main()
{
	/∗ Create a figure to work on  ∗/
	GENLIB_DEF_PHFIG("cell");
	/∗ Place two instances ∗/
	GENLIB_PLACE("grbdo_3","ins1", NOSYM, 0L, 0L);
	/∗ negative placement values are allowed ∗/
	GENLIB_PLACE_LEFT("grxwh_k","ins2", SYMXY);
	/∗ Save all that on disk ∗/
	GENLIB_SAVE_PHFIG();
}

See Also

genlib(1), GENLIB_DEF_PHFIG(3), GENLIB_SAVE_PHFIG(3), GENLIB_PLACE(3), GENLIB_PLACE_TOP(3), GENLIB_PLACE_BOTTOM(3), GENLIB_PLACE_RIGHT(3), MBK_CATA_LIB(1), MBK_WORK_LIB(1), MBK_IN_PH(1).

Referenced By

genlib.1alc(1), GENLIB_DEF_PHINS.3alc(3), GENLIB_FLATTEN_ALL_PHINS.3alc(3), GENLIB_PLACE.3alc(3), GENLIB_PLACE_BOTTOM.3alc(3), GENLIB_PLACE_ON.3alc(3), GENLIB_PLACE_RIGHT.3alc(3), GENLIB_PLACE_TOP.3alc(3).

ASIM/LIP6 PROCEDURAL GENERATION LANGUAGE