viambkrds(3) 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 ); 
          }