insrefmbkrds(3alc)

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

NAME

6       insrefmbkrds - adds in RDS instance all the references of MBK instance.
7

SYNOPSIS

9       #include "rfmnnn.h"
10       rdsrec_list ∗insrefmbkrds( InstanceMbk, ModelMbk, InstanceRds )
11          phins_list  ∗InstanceMbk;
12          phfig_list  ∗ModelMbk;
13          rdsins_list ∗InstanceRds;
14

PARAMETER

16       InstanceMbk         MBK instance which contains references to treat.
17
18       ModelMbk            Pointer to the model of the MBK instance.
19
20       InstanceRds         RDS  Instance which has to receive converted refer‐
21                           ences from MBK to RDS format.
22

DESCRIPTION

24       The insrefmbkrds function adds in the RDS instance  all  references  of
25       the  MBK instance converted to RDS format. All newly created references
26       are chained each other (circulary list) using the  USER  field  of  the
27       rdsrec_list structure.
28

RETURN VALUE

30       Pointer  to  the  head  of  list  of  the  added  rectangles to the RDS
31       instance.
32

ERRORS

34       "Rds202: rdsalloc error, can't continue !"
35              it's impossible to allocate the memory size desired
36

EXAMPLE

38               #include "mphnnn.h"
39               #include "mutnnn.h"
40               #include "rdsnnn.h"
41               #include "rfmnnn.h"
42               #include "rtlnnn.h"
43               typedef struct UserStruct
44                {
45                  char ∗STRING;
46                  void ∗USER1;
47                } UserStruct;
48               main()
49                 {
50                   phfig_list  ∗MbkFigure;
51                   phins_list  ∗MbkInstance;
52                   phfig_list  ∗MbkModelInstance;
53                   rdsfig_list ∗RdsFigure;
54                   rdsins_list ∗RdsInstance;
55                   rdsrec_list ∗RdsReferenceList;
56                   mbkenv();
57                   rdsenv();
58                   loadrdsparam();
59                   /∗ creates MbkFigure Named "core" ∗/
60                   MbkFigure        = addphfig("core");
61                   /∗ creates RdsFigure named "core_2" ∗/
62                   RdsFigure        = addrdsfig("core_2",sizeof(UserStruct));
63                   /∗ adds Mbk instance "n1_y" to MbkFigure named "core" ∗/
64                   MbkInstance      = addphins(MbkFigure,"n1_y","inv_1",NOSYM,4,9);
65                   /∗ Gets Model of instance n1_y ∗/
66                   MbkModelInstance = getphfig("n1_y",'A');
67                   /∗ creates Rds instance named "block_1" added to RdsFigure ∗/
68                   RdsInstance =
69                       addrdsins(RdsFigure,"block","block_1",RDS_NOSYM,8,6);
70                   /∗
71                       adds reference of "inv_1" instance Mbk in Rds instance
72                       named "block_1"
73                   ∗/
74                   RdsReferenceList = insrefmbkrds ( MbkInstance,
75                                                     MbkModelInstance,
76                                                     RdsInstance );
77                   viewrfmrec ( RdsReferenceList );
78                 }
79