icetAddTile(3)							  IceT Reference						    icetAddTile(3)

NAME

       icetAddTile -- add a tile to the logical display.

Synopsis
       #include <IceT.h>

       int icetAddTile(   IceTInt	 x,
			  IceTInt	 y,
			  IceTSizeType	 width,
			  IceTSizeType	 height,
			  int		 display_rank  );

Description
       Adds a tile to the tiled display. Every process, whether actually displaying a tile or not, must declare the tiles in the display and which
       processes drive them with icetResetTiles and icetAddTile.  Thus, each process calls icetAddTile once for each tile in the display, and  all
       processes must declare them in the same order.

       The  parameters x, y, width, and height define the tile's viewport in the logical global display much in the same way glViewport declares a
       region in a physical display in OpenGL .IceT places no limits on the extents of the logical global display. That is, there are no limits on
       the values of x and y.  They can extend as far as they want in both the positive and negative directions.

       IceT  will  project its images onto the region of the logical global display that just covers all of the tiles. Therefore, shifting all the
       tiles in the logical global display by the same amount will have no real overall effect.

       The display_rank parameter identifies the rank of the process that will be displaying the given tile. It is assumed that the output of  the
       rendering window of the given process is projected onto the space in a tiled display given by x, y, width, and height.  Each tile must have
       a valid rank (between 0 and $ICET_NUM_PROCESSES - 1$). Furthermore, no process may be displaying more than one tile.

Return Value
       Returns the index of the tile created or -1 if the tile could not be created.

Errors
       ICET_INVALID_VALUE
	       Raised if display_rank is not a valid process rank, if display_rank is already assigned to another tile, or if width or	height	is
	      smaller than 1. If this error is raised, nothing is done and -1 is returned.

Warnings
       None.

Bugs
       All processes must specify the same tiles in the same order. IceT will assume this even though it is not explicitly detected or enforced.

Copyright
       Copyright (C)2003 Sandia Corporation

       Under the terms of Contract DE-AC04-94AL85000 with Sandia Corporation, the U.S. Government retains certain rights in this software.

       This source code is released under the New BSD License.

See Also
       icetResetTiles(3), icetPhysicalRenderSize(3)

IceT Reference							   June  7, 2011						    icetAddTile(3)