insmbkrds(3alc)

1INSMBKRDS(3)                RDS PHYSICAL FUNCTIONS                INSMBKRDS(3)
2
3
4

NAME

6       insmbkrds - converts MBK figure to RDS figure
7

SYNOPSIS

9       #include "rfmnnn.h"
10       rdsins_list ∗insmbkrds( FigureRds, InstanceMbk, Mode, Lynx )
11          rdsfig_list ∗FigureRds;
12          phins_list  ∗InstanceMbk;
13          char         Mode;
14          char         Lynx;
15

PARAMETER

17       FigureRds           The  Rds  figure  which  has  to  receive  the  RDS
18                           instance issue to the MBK instance conversion.
19
20       InstanceMbk         MBK instance which has to be converted and added to
21                           the RDS figure.
22
23       Mode                This field can take three values :
24
25                           ´A´ : All the cell is loaded in ram.
26
27                           ´P´  : Only information concerning the model inter‐
28                           face is present, that means  connector  s  and  the
29                           abutment box.
30
31                           ´C´  : Finishes to fill an already loaded figure in
32                           ´P´ mode, in order to have it all in memory.  After
33                           this, the conversion is applied.
34
35                           Note : The loading mode here is the MBK mode.
36
37       Lynx                Flag used for the segment conversion. If the param‐
38                           eter Lynx is set to 0 then thi s is the normal con‐
39                           version  mode.  If  the  parameter Lynx is set to 1
40                           then the rds structure generated permits to extract
41                           equipotentials rectangles.
42

DESCRIPTION

44       The insmbkrds function creates in the RDS figure the RDS instance issue
45       to the conversion of the MBK instance to RDS format. If  the  parameter
46       ´Mode´ is set to ´A´ then all the instance is loaded, else if parameter
47       ´Mode´ is set to ´P´ then  connectors  and  abutment  box  and  through
48       routes are loaded (for more information, see getphfig and loadphfig MBK
49       functions).
50

RETURN VALUE

52       A pointer to the newly created instance is returned.
53

ERRORS

55       "Rds202: rdsalloc error, can't continue !"
56              it's impossible to allocate the memory size desired
57

EXAMPLE

59               #include "mphnnn.h"
60               #include "mutnnn.h"
61               #include "rdsnnn.h"
62               #include "rfmnnn.h"
63               #include "rtlnnn.h"
64               typedef struct UserStruct
65                {
66                  char ∗STRING;
67                  void ∗USER1;
68                } UserStruct;
69               main()
70                 {
71                   phfig_list  ∗MbkFigure;
72                   phins_list  ∗MbkInstance;
73                   rdsfig_list ∗RdsFigure;
74                   rdsins_list ∗RdsInstance;
75                   mbkenv();
76                   rdsenv();
77                   loadrdsparam();
78                   /∗ create MbkFigure Named "core" ∗/
79                   MbkFigure    = addphfig("core");
80                   /∗ add Mbk instance "n1_y" to MbkFigure named "core" ∗/
81                   MbkInstance  = addphins(MbkFigure,"n1_y","inv_1",NOSYM,4,9);
82                   /∗ create RdsFigure named "core_2" ∗/
83                   RdsFigure    = addrdsfig("core_2",sizeof(UserStruct));
84                   /∗ create RdsInstance with MbkInstance ∗/
85                   RdsInstance  = insmbkrds ( RdsFigure, MbkInstance, 'A', 0 );
86                   viewrdsins ( RdsInstance );
87                   . . .
88                 }
89