addrdsins

ADDRDSINS(3)                RDS PHYSICAL FUNCTIONS                ADDRDSINS(3)



NAME
        addrdsins - adds an instance to a figure


ORIGIN
       This software belongs to the  ALLIANCE CAD SYSTEM developed by the ASIM
       team at LIP6 laboratory of Université Pierre et Marie CURIE, in Paris,
       France.

       Web : http://asim.lip6.fr/recherche/alliance/
       E-mail : alliance-users@asim.lip6.fr


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




BUG REPORT
       This tool is under development at the ASIM department of the LIP6
       laboratory.
       We need your feedback to improve documentation and tools.






ASIM/LIP6                       October 1, 1997                   ADDRDSINS(3)