Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
ADDRDSINS(3)		    RDS	PHYSICAL FUNCTIONS		  ADDRDSINS(3)

NAME
	addrdsins - adds an instance to	a figure

SYNOPSIS
       #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 be-
			   longs.

       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 hori-
					       zontal and vertical axis.

			   RDS_ROT_M	       90 degrees rotation clockwise.

			   RDS_SYM_X	       symmetry	 with regard to	a ver-
					       tical axis.

			   RDS_SY_RM	       symmetry	with regard to a  ver-
					       tical   axis   and  90  degrees
					       clockwise.

			   RDS_SYM_Y	       symmetry	with regard to a hori-
					       zontal axis.

			   RDS_SY_RP	       symmetry	with regard to a hori-
					       zontal axis and 90 degrees  ro-
					       tation 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

ASIM/LIP6			October	1, 1997			  ADDRDSINS(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=addrdsins&sektion=3&manpath=FreeBSD+Ports+15.0>

home | help