NAME
icetAddTile -- add a tile to the logical display.
Synopsis
#include <GL/ice-t.h>
int icetAddTile( GLint x,
GLint y,
GLsizei width,
GLsizei 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 tiles viewport in the
logical global display much in the same way glViewport declares a
region in a physical display. 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.
Errors
ICET_INVALID_VALUE
Raised if display_rank is not a valid process rank or
display_rank is already assigned to another tile. If this error
is raised, nothing is done and -1 is returned.
Warnings
None.
Bugs
icetAddTile will let you add tiles of different sizes, but the use of
different sized tiles is not yet supported. The user should try to make
sure that all tiles are of the same size.
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, there is a non-exclusive
license for use of this work by or on behalf of the U.S. Government.
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that this Notice and any statement
of authorship are reproduced on all copies.
See Also
icetResetTiles(3)
IceT Reference December 1, 2006 icetAddTile(3)