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

# segmbkrds(3)

adds to RDS figure a segment from a MBK figure

## NAME

segmbkrds - adds to RDS figure a segment from a MBK figure

## SYNOPSYS

```
#include "rfmnnn.h"
 rdsrec_list ∗segmbkrds( Figure, Segment, Lynx )
    rdsfig_list ∗Figure;
    phseg_list  ∗Segment;
    char         Lynx;
```

## PARAMETER

- *Figure*

  The RDS figure which has to receive the converted segment.

- *Segment*

  MBK segment to convert to RDS rectangle.

- *Lynx*

  Flag used for the segment 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 *segmbkrds* function converts and creates a RDS segment from a MBK segment. The segment is attached to the RDS figure in parameter of the segmbkrds function. See the *rdsfig\_list* structure in librds.

## RETURN VALUE

Pointer to the newly created RDS segment.

## 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 ∗Segment;
            mbkenv();
            rdsenv();
            loadrdsparam();
            RdsFigure =
               addrdsfig ("core",sizeof ( UserStruct ) );
            MbkFigure->PHSEG =
               addphseg ( MbkFigure, ALU1, 1, 1, 1, 2, 12, "seg_alu1");
            Segment = segmbkrds (RdsFigure, MbkFigure->PHSEG, 0);
            viewrdsrec ( Segment );
          }
```

## SEE ALSO

**librds,** **librfm,** **viewrfmseg,** **loadrdsparam**