Provided by: alliance_5.1.1-1.1build1_amd64 
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