ADDPHINS(3) MBK PHYSICAL FUNCTIONS ADDPHINS(3) NAME addphins - create a physical instance 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 co- ordinates, 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 in- stantiated model exists, since no information on it are needed. The coordinates are not transformation dependent. It means that the trans- formation 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" The instance has for model name of the figure on the which it is to be added. It's illegal and dangerous. This check is made at the ac- tual hierarchy level only, not recursivly on the structure, so it still may happened. "*** mbk error *** illegal addphins transformation sym in : insname" The geometrical operation is not in the legal range. See phins(3) for a complete list of values. "*** mbk error *** illegal addphins duplicate instance name : insname" The instance name is an identifier, so it can't appear twice in the same figure. 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). ASIM/LIP6 October 1, 1997 ADDPHINS(3)
NAME | SYNOPSIS | PARAMETERS | DESCRIPTION | RETURN VALUE | ERRORS | EXAMPLE | SEE ALSO
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=addphins&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>