HP SVA V2.1 Parallel Compositing Reference Guide

Table 2-7 Summary of Context Properties (continued)
DescriptionCan
Change
After
Context
Create
Can Set
On
Context
Create
TypePropertyValue
1
Each host has a hostId and hostName. These
are specified when the context is created on the
master by calling pcContextCreateMaster.
The hostname:hosted for each host is an
element of this array.
nonointeger
PC_HOSTID
host-specific
nonostring
PC_HOSTNAME
This property is the index for the current host.
Each host has an index between 0 and
(PC_NUM_HOSTS - 1). The index assigned to
a host is its position in the array passed by the
master to pcContextCreateMaster. When
requesting a host specific property, you do so by
providing the index that corresponds to the host.
nonointeger
PC_HOSTINDEX
Different hosts can request different outputs from
the frame. These properties control the area of
the frame that can be retrieved as a result on a
particular host.
The values of these properties must specify a
rectangular area within the frame described by
PC_FRAME_WIDTH and PC_FRAME_HEIGHT.
When set to 0, PC_OUTPUT_WIDTH or
PC_OUTPUT_HEIGHT indicate no output is
needed by the host.
Default values are 0 for x and y offset, 256 for
width and height.
yesnointeger
PC_OUTPUT_HEIGHT
yesnointeger
PC_OUTPUT_WIDTH
yesnointeger
PC_OUTPUT_X_OFFSET
yesnointeger
PC_OUTPUT_Y_OFFSET
This property returns the number of bytes read
by the local host from all other hosts since the last
retrieval of this property. Retrieving the property
resets the property to 0. Although the property
is local and applies to a host, the property can
only be retrieved for the local host.
nonointeger
PC_READ_COUNT_EXT
(Supported by
more than one
vendor.)
By default, the output of a frame is only available
between pcFrameEnd and the following
pcFrameBegin. This property relaxes this
constraint and lets the caller access the output for
the number of frames designated by this property.
The value of this property cannot exceed the
value of the system property,
PC_RETAIN_OUTPUT_LIMIT. (Default value is
2 for the HP Library to support double buffering
of the output.)
See Section for the details.
noyesinteger
PC_RETAIN_OUTPUT
By default, framelets are copied by the Library
when passed as a parameter to a function call.
This property relaxes this constraint, which
potentially allows the library to be more efficient.
The property is an integer stating how many
frames in the future the application will reuse the
buffer. The value of this property cannot exceed
the value of the system property,
PC_VOLATILE_FRAMELET_LIMIT. In the case
of the HP Library, this is the default value of 0.
See Section for details.
noyesinteger
PC_VOLATILE_FRAMELET
Context Properties 31