NAME

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

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