viambkrds(3alc)

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

NAME

6       viambkrds - adds to RDS figure a contact from a MBK figure
7

SYNOPSIS

9       #include "rfmnnn.h"
10        rdsrec_list ∗viambkrds( Figure, Via, Lynx )
11           rdsfig_list ∗Figure;
12           phvia_list  ∗Via;
13           char         Lynx;
14

PARAMETER

16       Figure              The  RDS  figure which has to receive the converted
17                           contact.
18
19       Via                 MBK contact to convert to RDS rectangles.
20
21       Lynx                Flag used for the via conversion. If the  parameter
22                           Lynx is set to 0 then this is the normal conversion
23                           mode. If the parameter Lynx is set to  1  then  the
24                           rds  structure generated permits to extract equipo‐
25                           tentials rectangles.
26

DESCRIPTION

28       The viambkrds function converts and creates a RDS contact  from  a  MBK
29       contact.  The contact is attached to the RDS figure in parameter of the
30       viambkrds function. See the rdsfig_list structure of librds.
31
32       Note : This function generates many rectangles to create a RDS contact.
33              These rectangle are chained each other (circulary list) with the
34              field USER of the rdsrec_list structure.
35

RETURN VALUE

37       Pointer to one of the RDS rectangles created.
38

ERRORS

40       "Rds202: rdsalloc error, can't continue !"
41              it's impossible to allocate the memory size desired
42

EXAMPLE

44               #include "mphnnn.h"
45               #include "mutnnn.h"
46               #include "rdsnnn.h"
47               #include "rfmnnn.h"
48               #include "rtlnnn.h"
49               typedef struct UserStruct
50                {
51                  char ∗STRING;
52                  void ∗USER1;
53                } UserStruct;
54               main()
55                 {
56                   phfig_list  ∗MbkFigure;
57                   rdsfig_list ∗RdsFigure;
58                   rdsrec_list ∗Via;
59                   mbkenv();
60                   rdsenv();
61                   loadrdsparam();
62                   RdsFigure = addrdsfig ("core",sizeof ( UserStruct ) );
63                   MbkFigure->PHVIA = addphvia ( MbkFigure, CONT_VIA, 4, 7);
64                   Via = viambkrds (RdsFigure, MbkFigure->PHVIA);
65                   viewrfmvia ( MbkFigure->PHVIA, Via );
66                 }
67