debian man page for inssegmbkrds

INSSEGMBKRDS(3) 					      RDS PHYSICAL FUNCTIONS						   INSSEGMBKRDS(3)

NAME
       inssegmbkrds - adds in RDS instance all the segments of MBK instance

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 "rdsnnn.h"
	rdsrec_list *inssegmbkrds( InstanceMbk, ModelMbk, InstanceRds, Lynx )
	   phins_list  *InstanceMbk;
	   phfig_list  *ModelMbk;
	   rdsins_list *InstanceRds;
	   char 	Lynx;

PARAMETER
       InstanceMbk	   The MBK instance which contains the segments to convert.

       ModelMbk 	   Pointer to the model of the MBK instance.

       InstanceRds	   The instance which has to receive converted segments from MBK to RDS format.

       Lynx		   Flag used for the segment conversion. If the parameter Lynx is set to 0 then thi s is the normal  conversion  mode.	If
			   the parameter Lynx is set to 1 then the rds structure generated permits to extract equipotentials rectangles.

DESCRIPTION
       The inssegmbkrds function adds in the RDS instance all segments of the MBK instance converted to RDS format. All newly created segments are
       chained each other (circulary list) using the USER field of the rdsrec_list structure.

RETURN VALUE
       Pointer to the head of list of the added rectangles to the RDS instance.

ERRORS
       "Rds202: rdsalloc error, can't continue !"
	      it's impossible to allocate the memory size desired

EXAMPLE
	       #include "mphnnn.h"
	       #include "mutnnn.h"
	       #include "rdsnnn.h"
	       #include "rfmnnn.h"
	       #include "rtlnnn.h"
	       typedef struct UserStruct
		{
		  char *STRING;
		  void *USER1;
		} UserStruct;
	       main()
		 {
		   phfig_list  *MbkFigure;
		   phins_list  *MbkInstance;
		   phfig_list  *MbkModelInstance;
		   rdsfig_list *RdsFigure;
		   rdsins_list *RdsInstance;
		   rdsrec_list *RdsSegmentList;
		   rdsrec_list *ScanSegment;
		   mbkenv();
		   rdsenv();
		   loadrdsparam();
		   /* creates MbkFigure Named "core" */
		   MbkFigure	    = addphfig("core");
		   /* creates RdsFigure named "core_2" */
		   RdsFigure	    = addrdsfig("core_2",sizeof(UserStruct));
		   /* adds Mbk instance "n1_y" to MbkFigure named "core" */
		   MbkInstance	    = addphins(MbkFigure,"n1_y","inv_1",NOSYM,4,9);
		   /* Gets Model of instance n1_y */
		   MbkModelInstance = getphfig("n1_y",'A');
		   /* creates Rds instance named "block_1" added to RdsFigure */
		   RdsInstance =
		      addrdsins(RdsFigure,"block","block_1",RDS_NOSYM,8,6);
		   /*
			 adds segments of "inv_1" instance Mbk in Rds instance
			 named "block_1"
		   */
		   RdsSegmentList   = inssegmbkrds ( MbkInstance,
						     MbkModelInstance,
						     RdsInstance,0 );
		   viewrdsrec ( RdsSegmentList );
		   for ( ScanSegment  = RdsSegmentList->USER ;
			 ScanSegment != RdsSegmentList ;
			 ScanSegment  = ScanSegment->USER )
		    {
		      viewrdsrec ( (rdsrec_list *) ScanSegment );
		    }
		 }

SEE ALSO
       librfm, librds, loadrdsparam

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						   INSSEGMBKRDS(3)