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

ASIM/LIP6                                        October 1, 1997                                   LOADRDSFIG(3)