Commit d62b3138 authored by Kenneth Moreland's avatar Kenneth Moreland
Browse files

Merge branch 'Document21Changes' into release

parents 3279f167 d9ad69dc
Describe radix-k algorithm.
ietAddTile raises ICET_INVALID_VALUE if you try to create a tile with no
pixels.
icetFindRankInGroup, icetFindMyRankInGroup
The following state variables are not set with sequential strategy:
ICET_ALL_CONTAINED_TILES_MASKS, ICET_TILE_CONTRIB_COUNTS, and
ICET_TOTAL_IMAGE_COUNT.
Suggest using sequential strategy for single tile (because it skips some
allgathers).
icetCommBarrier
icetImageAssignBuffer, icetSingleImageAssignBuffer
icetWaitany returns index to finished request - different than MPI.
icetCommGather, icetCommGatherV
ICET_IN_PLACE_COLLECT
ICET_SIZE_TYPE (list of types in implement new strategy -> Communications).
const array for compose_group in single image strategy functions.
icetSingleImageCompose interface change.
icetSingleImageCollect.
General change to single image strategy functions.
ICET_MAGIC_K state variable, CMake variable, and environment variable.
icetCompressedCompressedComposite
icetSparseImageCopyPixels
icetSparseImageSplit
icetSparseImageSplitPartitionNumPixels
icetImageEqual, icetSparseImageEqual
icetDecompressSubImage
icetRenderTransferSparseImages
icetSparseImageNull, icetSparseImageIsNull
icetUnsafeStateGet* now return const
todo: correct background before gather
ICET_INTERLACE_IMAGES
icetSparseImageInterlace
ICET_MAGIC_K environment variable, cmake variable, state variable
ICET_COLLECT_TIME: The fraction of ICET_COMPOSITE_TIME spent in collecting
image fragments to display process.
ICET_COLLECT_IMAGES: When this option is on (the default) images partitions
are always collected to display processes (the current behavior). When
turned off, the strategy has the option of leaving images partitioned
amongst processes. Each process containing part of a tile's image will
return the entire buffer from icetDrawFrame in an IceTImage object.
However, only certain pixels will be valid. The state variables
ICET_VALID_PIXELS_TILE, ICET_VALID_PIXELS_OFFSET, and ICET_VALID_PIXELS_NUM
give which tile the pixels belong to and what range of pixels are valid.
ICET_VALID_PIXELS_TILE: Gives the tile for which the last image returned
from icetDrawFrame contains pixels. Each process has its own value. If
the last call to icetDrawFrame did not return pixels for the local process,
this variable is set to -1. This state variable is only useful when
ICET_COLLECT_IMAGES is off. If on, it can be assumed that all display
processes have valid pixels for their respective display tiles, and all
other processes have no pixel data. Strategies taking advantage of turning
off ICET_COLLECT_IMAGES should set this.
ICET_VALID_PIXELS_OFFSET, ICET_VALID_PIXELS_NUM: Gives the range of valid
pixels for the last image returned from icetDrawFrame. Given the arrays of
pixels returned with the icetImageGetColor and icetImageGetDepth functions,
the valid pixels start at the pixel indexed by ICET_VALID_PIXELS_OFFSET and
continue for ICET_VALID_PIXELS_NUM. The tile to which these pixels belong
are captured in the ICET_VALID_PIXELS_TILE state variable. If the last
call to icetDrawFrame did not return pixels for the local process,
ICET_VALID_PIXELS_NUM is set to 0. This state variable is only useful when
ICET_COLLECT_IMAGES is off. If on, it can be assumed that all display
processes contain all pixels in the image (ICET_VALID_PIXELS_OFFSET is 0
and ICET_VALID_PIXELS_NUM is the number of pixels in the image), and all
other processes have no pixel data. Strategies taking advantage of turning
off ICET_COLLECT_IMAGES should set this.
ICET_MAX_IMAGE_SPLIT environment variable, cmake variable, state variable
All the matrix math helpers icetMatrix* in IceTDevMatrix.h
Const versions of icetImageGetColor* and icetImageGetDepth* functions.
Added Alltoall to communicator. (Search for Allgather for places to add in
documentation.)
icetSendRecvLargeMessages takes const array for messageDestinations.
ICET_CORRECT_COLORED_BACKGROUND is now the responsibility of the strategy,
not done automatically. icetSingleImageCollect does it for you, though.
Added internal state variables ICET_NEED_BACKGROUND_CORRECTION,
ICET_TRUE_BACKGROUND_COLOR, and ICET_TRUE_BACKGROUND_COLOR_WORD.
icetImageCorrectBackground, icetClearImageTrueBackground,
icetDecompressImageCorrectBackground, and
icetDecompressSubImageCorrectBackground functions.
'\" t
.\" Manual page created with latex2man on Thu Sep 23 08:15:12 MDT 2010
.\" Manual page created with latex2man on Tue Jul 19 13:11:53 MDT 2011
.\" NOTE: This file is generated, DO NOT EDIT.
.de Vb
.ft CW
......@@ -10,7 +10,7 @@
.fi
..
.TH "icetAddTile" "3" "August 10, 2010" "\fBIceT \fPReference" "\fBIceT \fPReference"
.TH "icetAddTile" "3" "June 7, 2011" "\fBIceT \fPReference" "\fBIceT \fPReference"
.SH NAME
\fBicetAddTile \-\- add a tile to the logical display.\fP
......@@ -86,10 +86,13 @@ created.
.TP
\fBICET_INVALID_VALUE\fP
Raised if \fIdisplay_rank\fP
is not a valid process rank or
\fIdisplay_rank\fP
is already assigned to another tile. If this
error is raised, nothing is done and \-1 is returned.
is not a valid process rank, if \fIdisplay_rank\fP
is already
assigned to another tile, or if \fIwidth\fP
or \fIheight\fP
is
smaller than 1. If this error is raised, nothing is done and \-1 is
returned.
.PP
.SH Warnings
......
'\" t
.\" Manual page created with latex2man on Thu Sep 23 08:15:12 MDT 2010
.\" Manual page created with latex2man on Tue Jul 19 13:11:53 MDT 2011
.\" NOTE: This file is generated, DO NOT EDIT.
.de Vb
.ft CW
......
'\" t
.\" Manual page created with latex2man on Thu Sep 23 08:15:12 MDT 2010
.\" Manual page created with latex2man on Tue Jul 19 13:11:53 MDT 2011
.\" NOTE: This file is generated, DO NOT EDIT.
.de Vb
.ft CW
......
'\" t
.\" Manual page created with latex2man on Thu Sep 23 08:15:12 MDT 2010
.\" Manual page created with latex2man on Tue Jul 19 13:11:53 MDT 2011
.\" NOTE: This file is generated, DO NOT EDIT.
.de Vb
.ft CW
......
'\" t
.\" Manual page created with latex2man on Thu Sep 23 08:15:12 MDT 2010
.\" Manual page created with latex2man on Tue Jul 19 13:11:54 MDT 2011
.\" NOTE: This file is generated, DO NOT EDIT.
.de Vb
.ft CW
......
'\" t
.\" Manual page created with latex2man on Thu Sep 23 08:15:12 MDT 2010
.\" Manual page created with latex2man on Tue Jul 19 13:11:54 MDT 2011
.\" NOTE: This file is generated, DO NOT EDIT.
.de Vb
.ft CW
......
'\" t
.\" Manual page created with latex2man on Thu Sep 23 08:15:12 MDT 2010
.\" Manual page created with latex2man on Tue Jul 19 13:11:54 MDT 2011
.\" NOTE: This file is generated, DO NOT EDIT.
.de Vb
.ft CW
......
'\" t
.\" Manual page created with latex2man on Thu Sep 23 08:15:12 MDT 2010
.\" Manual page created with latex2man on Tue Jul 19 13:11:54 MDT 2011
.\" NOTE: This file is generated, DO NOT EDIT.
.de Vb
.ft CW
......
'\" t
.\" Manual page created with latex2man on Thu Sep 23 08:15:12 MDT 2010
.\" Manual page created with latex2man on Tue Jul 19 13:11:54 MDT 2011
.\" NOTE: This file is generated, DO NOT EDIT.
.de Vb
.ft CW
......
'\" t
.\" Manual page created with latex2man on Thu Sep 23 08:15:12 MDT 2010
.\" Manual page created with latex2man on Tue Jul 19 13:11:54 MDT 2011
.\" NOTE: This file is generated, DO NOT EDIT.
.de Vb
.ft CW
......
'\" t
.\" Manual page created with latex2man on Thu Sep 23 08:15:12 MDT 2010
.\" Manual page created with latex2man on Tue Jul 19 13:11:54 MDT 2011
.\" NOTE: This file is generated, DO NOT EDIT.
.de Vb
.ft CW
......
'\" t
.\" Manual page created with latex2man on Thu Sep 23 08:15:12 MDT 2010
.\" Manual page created with latex2man on Tue Jul 19 13:11:54 MDT 2011
.\" NOTE: This file is generated, DO NOT EDIT.
.de Vb
.ft CW
......
'\" t
.\" Manual page created with latex2man on Thu Sep 23 08:15:13 MDT 2010
.\" Manual page created with latex2man on Tue Jul 19 13:11:54 MDT 2011
.\" NOTE: This file is generated, DO NOT EDIT.
.de Vb
.ft CW
......
'\" t
.\" Manual page created with latex2man on Thu Sep 23 08:15:13 MDT 2010
.\" Manual page created with latex2man on Tue Jul 19 13:11:54 MDT 2011
.\" NOTE: This file is generated, DO NOT EDIT.
.de Vb
.ft CW
......
'\" t
.\" Manual page created with latex2man on Thu Sep 23 08:15:13 MDT 2010
.\" Manual page created with latex2man on Tue Jul 19 13:11:54 MDT 2011
.\" NOTE: This file is generated, DO NOT EDIT.
.de Vb
.ft CW
......
'\" t
.\" Manual page created with latex2man on Thu Sep 23 08:15:13 MDT 2010
.\" Manual page created with latex2man on Tue Jul 19 13:11:54 MDT 2011
.\" NOTE: This file is generated, DO NOT EDIT.
.de Vb
.ft CW
......@@ -10,7 +10,7 @@
.fi
..
.TH "icetEnable" "3" "September 20, 2010" "\fBIceT \fPReference" "\fBIceT \fPReference"
.TH "icetEnable" "3" "July 11, 2011" "\fBIceT \fPReference" "\fBIceT \fPReference"
.SH NAME
\fBicetEnable\fP,\fBicetDisable\fP\-\- enable/disable an \fBIceT \fPfeature.
......@@ -39,6 +39,23 @@ be turned on or off. Valid values for \fIpname\fP
are:
.PP
.TP
\fBICET_COLLECT_IMAGES\fP
When this option is on (the default)
images partitions are always collected to display processes. When this
option is turned off, the strategy has the option of leaving images
partitioned among processes. Each process containing part of a tile\&'s
image will return the entire buffer from \fBicetDrawFrame\fP
or
\fBicetGLDrawFrame\fP
in an \fBIceTImage\fP
object. However, only
certain pixels will be valid. The state variables
\fBICET_VALID_PIXELS_TILE\fP,
\fBICET_VALID_PIXELS_OFFSET\fP,
and \fBICET_VALID_PIXELS_NUM\fP
give which tile the pixels belong
to and what range of pixels are valid.
.TP
\fBICET_COMPOSITE_ONE_BUFFER\fP
Turn this option on when
performing z\-buffer compositing of a color image and the only result
......@@ -60,6 +77,11 @@ be shifted such that the geometry will be rendered in one shot whenever
possible, even if the geometry straddles up to four tiles. This flag
is enabled by default.
.TP
\fBICET_INTERLACE_IMAGES\fP
If enabled, pixels in images
(might be) shuffled to better load balance the compositing work. This
flag is enabled by default.
.TP
\fBICET_ORDERED_COMPOSITE\fP
If enabled, the image composition
will be performed in the order specified by the last call to
......
'\" t
.\" Manual page created with latex2man on Thu Sep 23 08:15:13 MDT 2010
.\" Manual page created with latex2man on Tue Jul 19 13:11:54 MDT 2011
.\" NOTE: This file is generated, DO NOT EDIT.
.de Vb
.ft CW
......
'\" t
.\" Manual page created with latex2man on Thu Sep 23 08:15:13 MDT 2010
.\" Manual page created with latex2man on Tue Jul 19 13:11:54 MDT 2011
.\" NOTE: This file is generated, DO NOT EDIT.
.de Vb
.ft CW
......
'\" t
.\" Manual page created with latex2man on Thu Sep 23 08:15:13 MDT 2010
.\" Manual page created with latex2man on Tue Jul 19 13:11:54 MDT 2011
.\" NOTE: This file is generated, DO NOT EDIT.
.de Vb
.ft CW
......@@ -10,7 +10,7 @@
.fi
..
.TH "icetEnable" "3" "September 20, 2010" "\fBIceT \fPReference" "\fBIceT \fPReference"
.TH "icetEnable" "3" "July 11, 2011" "\fBIceT \fPReference" "\fBIceT \fPReference"
.SH NAME
\fBicetEnable\fP,\fBicetDisable\fP\-\- enable/disable an \fBIceT \fPfeature.
......@@ -39,6 +39,23 @@ be turned on or off. Valid values for \fIpname\fP
are:
.PP
.TP
\fBICET_COLLECT_IMAGES\fP
When this option is on (the default)
images partitions are always collected to display processes. When this
option is turned off, the strategy has the option of leaving images
partitioned among processes. Each process containing part of a tile\&'s
image will return the entire buffer from \fBicetDrawFrame\fP
or
\fBicetGLDrawFrame\fP
in an \fBIceTImage\fP
object. However, only
certain pixels will be valid. The state variables
\fBICET_VALID_PIXELS_TILE\fP,
\fBICET_VALID_PIXELS_OFFSET\fP,
and \fBICET_VALID_PIXELS_NUM\fP
give which tile the pixels belong
to and what range of pixels are valid.
.TP
\fBICET_COMPOSITE_ONE_BUFFER\fP
Turn this option on when
performing z\-buffer compositing of a color image and the only result
......@@ -60,6 +77,11 @@ be shifted such that the geometry will be rendered in one shot whenever
possible, even if the geometry straddles up to four tiles. This flag
is enabled by default.
.TP
\fBICET_INTERLACE_IMAGES\fP
If enabled, pixels in images
(might be) shuffled to better load balance the compositing work. This
flag is enabled by default.
.TP
\fBICET_ORDERED_COMPOSITE\fP
If enabled, the image composition
will be performed in the order specified by the last call to
......
Supports Markdown
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment