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

ASIM/LIP6                                        October 1, 1997                                    VIAMBKRDS(3)