NAME

       insmbkrds - converts MBK figure to RDS figure

SYNOPSYS

       #include "rfmnnn.h"
       rdsins_list ∗insmbkrds( FigureRds, InstanceMbk, Mode, Lynx )
          rdsfig_list ∗FigureRds;
          phins_list  ∗InstanceMbk;
          char         Mode;
          char         Lynx;

PARAMETER

       FigureRds           The  Rds  figure  which  has  to  receive  the RDS instance issue to the MBK instance
                           conversion.

       InstanceMbk         MBK instance which has to be converted and added to the RDS figure.

       Mode                This field can take three values :

                           ´A´ : All the cell is loaded in ram.

                           ´P´ : Only  information  concerning  the  model  interface  is  present,  that  means
                           connector s and the abutment box.

                           ´C´  : Finishes to fill an already loaded figure in ´P´ mode, in order to have it all
                           in memory. After this, the conversion is applied.

                           Note : The loading mode here is the MBK mode.

       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 insmbkrds function creates in the RDS figure the RDS instance issue to  the  convertion  of  the  MBK
       instance  to  RDS  format. If the parameter ´Mode´ is set to ´A´ then all the instance is loaded, else if
       parameter ´Mode´ is set to ´P´ then connectors and abutment box and through routes are loaded  (for  more
       information, see getphfig and loadphfig MBK functions).

RETURN VALUE

       A pointer to the newly created instance is returned.

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;
                   rdsfig_list ∗RdsFigure;
                   rdsins_list ∗RdsInstance;
                   mbkenv();
                   rdsenv();
                   loadrdsparam();
                   /∗ create MbkFigure Named "core" ∗/
                   MbkFigure    = addphfig("core");
                   /∗ add Mbk instance "n1_y" to MbkFigure named "core" ∗/
                   MbkInstance  = addphins(MbkFigure,"n1_y","inv_1",NOSYM,4,9);
                   /∗ create RdsFigure named "core_2" ∗/
                   RdsFigure    = addrdsfig("core_2",sizeof(UserStruct));
                   /∗ create RdsInstance with MbkInstance ∗/
                   RdsInstance  = insmbkrds ( RdsFigure, MbkInstance, 'A', 0 );
                   viewrdsins ( RdsInstance );
                   . . .
                 }

SEE ALSO

       librfm, librds, viewrfmins, loadrdsparam