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

# loadrdsfig(3)

give back a pointer to a figure

## NAME

loadrdsfig - give back a pointer to a figure

## SYNOPSYS

```
#include "rtlnnn.h"
 void loadrdsfig( Figure, Name, Mode )
    rdsfig_list ∗Figure;
    char        ∗Name;
    char         Mode;
```

## PARAMETER

- *Figure*

  Pointer to the RDS Figure created.

- *Name*

  Name of the model of the figure.

- *MODE* :

  Caracter indicating the status of the figure in memory.

This field can take three values :

- *´A´*

  All the cell is loaded in ram (The figure, its rectangles and its instances empty).

- *´P´*

  Only information concerning the model interface is present, that means : connectors, the abutment box and through routes of the figure.

- *´V´*

  Visualization mode : all is loaded in RAM : The figure, its rectangles, its instances and the rectangles of its instances.

## DESCRIPTION

The *loadrdsfig* function loads in memory a cell model from disk. The loadrdsfig function in fact performs a call to a  parser ,chosen by the RDS\_IN environment variable.

## RETURN VALUE

The pointer to the created figure. (it's the parameter ´Figure´ of the loadrdsfig function).

## ERRORS

**"Rtl103.h: Unknown rds input format"**

The input format defined by the unix environment variable RDS\_IN is not supported by the driver (supported formats are "cif" and "gds").

Other errors can appear because the loadrdsfig function calls cif and gds parsers.

## EXAMPLE

        \#include "mutnnn.h"\
         \#include "rdsnnn.h"\
         \#include "rtlnnn.h"\
         main()\
          {\
            rdsfig\_list ∗RdsFigure;\
            mbkenv();\
            rdsenv();\
            loadrdsparam();\
            /∗ ∗/ **loadrdsfig** (RdsFigure, "core", 'A');\
            viewrdsfig( Figure );\
          }

## SEE ALSO

**librtl,** **getrdsfig,** **rdsenv,** **RDS\_IN**