NAME

        addrdsins - adds an instance to a figure

SYNOPSYS

       #include "rdsnnn.h"
       rdsins_list ∗addrdsins( Figure, Model, Name, Sym, X, Y )
            rdsfig_list ∗Figure;
            char        ∗Model;
            char        ∗Name;
            char         Sym;
            long         X;
            long         Y;

PARAMETER

       Figure              figure which contains the instance.

       Model               Name of the model of the instance.

       Name                Name of the instance in the figure at which it belongs.

       Sym                 Symmetry applied to the instance.

                           possible values :

                           RDS_NOSYM           no symmetry.

                           RDS_ROT_P           90 degrees rotation counter clockwise.

                           RDS_SYMXY           symmetry  with regard to a horizontal and vertical
                                               axis.

                           RDS_ROT_M           90 degrees rotation clockwise.

                           RDS_SYM_X           symmetry with regard to a vertical axis.

                           RDS_SY_RM           symmetry with regard to a  vertical  axis  and  90
                                               degrees clockwise.

                           RDS_SYM_Y           symmetry with regard to a horizontal axis.

                           RDS_SY_RP           symmetry  with  regard to a horizontal axis and 90
                                               degrees rotation counter clockwise.

       X,Y                 position of the lower left corner of the instance in the figure  after
                           symmetry.

DESCRIPTION

       The  addrdsins  function  adds  an  instance to the head of instances's list in the figure
       described in function parameter. Some fields of  rdsins_list  structure  are  modified  as
       follows :
       The field FIGNAME is set to Model
       The field INSNAME is set to Name
       The field X is set to X
       The field Y is set to Y
       The field TRANSF is set to Sym
       The field SIZE is set to Figure->SIZE

RETURN VALUE

       addrdsins  returns  a  pointer  to the newly created instance which is head of instances's
       list of the figure.

ERRORS

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

EXAMPLE

       #include "mutnnn.h"
       #include "rdsnnn.h"
       #include "rtlnnn.h"
               typedef struct UserStruct
                {
                  char ∗STRING;
                  void ∗USER1;
                } UserStruct;
                main()
                 {
                   rdsfig_list ∗RdsFigure;
                   rdsins_list ∗Instance;
                   mbkenv();
                   rdsenv();
                   loadrdsparam();
                   RdsFigure = addrdsfig ("core",sizeof ( UserStruct ) );
                   Instance = addrdsins (RdsFigure,"na2_y","and2",RDS_NOSYM,8,6);
                   printf("(RdsFigure->INSTANCE)->NAME = %s\n",
                           (RdsFigure->INSTANCE)->NAME);
                   /∗ Instance is head of instance list of the figure ∗/
                   printf("Instance->NAME = %s\n", Instance->NAME);
                 }

SEE ALSO

       librds, delrdsins, viewrdsins