VIAMBKRDS(3)						      RDS PHYSICAL FUNCTIONS						      VIAMBKRDS(3)

NAME

       viambkrds - adds to RDS figure a contact from a MBK figure

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 "rfmnnn.h"
	rdsrec_list *viambkrds( Figure, Via, Lynx )
	   rdsfig_list *Figure;
	   phvia_list  *Via;
	   char 	Lynx;

PARAMETER

       Figure		   The RDS figure which has to receive the converted contact.

       Via		   MBK contact to convert to RDS rectangles.

       Lynx		   Flag used for the via conversion. If the parameter Lynx is set to 0 then this 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 viambkrds function converts and creates a RDS contact from a MBK contact. The contact is attached to the RDS figure in parameter of the
       viambkrds function. See the rdsfig_list structure of librds.

       Note : This function generates many rectangles to create a RDS contact. These rectangle are chained each other (circulary  list)  with  the
	      field USER of the rdsrec_list structure.

RETURN VALUE

       Pointer to one of the RDS rectangles created.

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;
		   rdsfig_list *RdsFigure;
		   rdsrec_list *Via;
		   mbkenv();
		   rdsenv();
		   loadrdsparam();
		   RdsFigure = addrdsfig ("core",sizeof ( UserStruct ) );
		   MbkFigure->PHVIA = addphvia ( MbkFigure, CONT_VIA, 4, 7);
		   Via = viambkrds (RdsFigure, MbkFigure->PHVIA);
		   viewrfmvia ( MbkFigure->PHVIA, Via );
		 }

SEE ALSO

       librds, librfm, viewrfmvia, 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						      VIAMBKRDS(3)