insmbkrds.3alc man page

insmbkrds — converts MBK figure to RDS figure

Synopsis

#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 conversion 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

Info

October 1, 1997 ASIM/LIP6 RDS PHYSICAL FUNCTIONS