icetDataReplicationGroupColor(3)

NAME

icetDataReplicationGroupColor -- define data replication.

Synopsis

#include <IceT.h>

void icetDataReplicationGroupColor( | IceTInt | color );

Description

IceT has the ability to take advantage of geometric data that is replicated among processes. If a group of processes share the same geometry data, then IceT will split the region of the display that the data projects onto among the processes, thereby reducing the total amount of image composition work that needs to be done.

Despite the name of the function, icetDataReplicationGroupColor has nothing to do the color of the data being replicated. Instead, color is used to mark the local process as part of a given group. When icetDataReplicationGroupColor is called, it finds all other processes that have the same color and builds a group based on this information.

icetDataReplicationGroupColor must be called on every processes before the function will return.

Errors

None.

Warnings

None.

Bugs

IceT assumes that icetDataReplicationGroup is called with the exact same parameters on all processes belonging to a given group. Likewise, IceT also assumes that all processes have called icetBoundingVertices or icetBoundingBox with the exact same parameters on all processes belonging to a given group. These requirements are not strictly enforced, but failing to do so may cause some of the geometry to not be rendered.

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

icetDataReplicationGroup(3), icetBoundingVertices(3), icetBoundingBox(3)