NAME

addphins - create a physical instance

See the file man1/alc_origin.1.

SYNOPSIS

#include "mph.h"
phins_list ∗addphins(ptfig, figname, insname, sym, x, y)
phfig_list ∗ptfig;
char ∗figname;
char ∗insname;
char sym;
long x, y;

PARAMETERS

ptfig

Pointer to the figure in which the instance should be added

figname

Instance model name

insname

Instance name

sym

Geometrical operation performed on the instance

x, y

Coordinates of the lower left corner of the instance

DESCRIPTION

addphins creates a new instance whose lower left corner is at the given coordinates, and adds it to the list of instances pointed to by ptfig->PHINS. The new instance is added in front of the list, and becomes itself the list head.
The parameters figname, insname, sym, x and y fill respectivly the FIGNAME, INSNAME, TRANSF, XINS and YINS fields of the phins structure.
The addphins function does not check in memory or on disk to see if the instantiated model exists, since no information on it are needed.
The coordinates are not transformation dependent. It means that the transformation is performed before placing the instance at the given point. For details on the structure, see phins(3).

RETURN VALUE

addphins returns a pointer to the newly created instance.

ERRORS

"∗∗∗ mbk error ∗∗∗ addphins figure figname cannot be part of itself"

"∗∗∗ mbk error ∗∗∗ illegal addphins transformation sym in : insname"

"∗∗∗ mbk error ∗∗∗ illegal addphins duplicate instance name : insname"

EXAMPLE

#include "mph.h"
phins_list ∗ins_dup(pfd, pfs) /∗ duplicate instances ∗/
phfig_list ∗pfd, ∗pfs;
{
phins_list ∗pi;
	for (pi = pfs->phins; pi != NULL; pi = pi->NEXT)
		addphins(pfd, pi->FIGNAME, pi->INSNAME, pi->TRANSF,


                         pi->XINS, pi->YINS);
	return pfd->PHINS;
}

SEE ALSO

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

See the file man1/alc_bug_report.1.