---
name: "viambkrds"
section: "3"
platform: "linux"
package: "alliance"
version: "5.1.1-3"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://new.carta.tech/viambkrds"
---

# viambkrds(3)

adds to RDS figure a contact from a MBK figure

## NAME

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

## SYNOPSYS

```
#include "rfmnnn.h"
 rdsrec_list ∗viambkrds( Figure, Via, Lynx )
    rdsfig_list ∗Figure;
    phvia_list  ∗Via;
    char         Lynx;
```

## PARAMETER

- *Figure*

  The RDS figure which has to receive the converted contact.

- *Via*

  MBK contact to convert to RDS rectangles.

- *Lynx*

  Flag used for the via conversion. If the parameter Lynx is set to 0 then this 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 *viambkrds* function converts and creates a RDS contact from a MBK contact. The contact is attached to the RDS figure in parameter of the viambkrds function. See the *rdsfig\_list* structure of librds.

- *Note* :

  This function generates many rectangles to create a RDS contact. These rectangle are chained each other (circulary list) with the field USER of the rdsrec\_list structure.

## RETURN VALUE

Pointer to one of the RDS rectangles created.

## 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;
            rdsfig_list ∗RdsFigure;
            rdsrec_list ∗Via;
            mbkenv();
            rdsenv();
            loadrdsparam();
            RdsFigure = addrdsfig ("core",sizeof ( UserStruct ) );
            MbkFigure->PHVIA = addphvia ( MbkFigure, CONT_VIA, 4, 7);
            Via = viambkrds (RdsFigure, MbkFigure->PHVIA);
            viewrfmvia ( MbkFigure->PHVIA, Via );
          }
```

## SEE ALSO

**librds,** **librfm,** **viewrfmvia,** **loadrdsparam**