HC_PShow_Net_Clip_Region

int HC_PShow_Net_Clip_Region(int count, Key const keys[], int *loopCount, int loopSizeArray[], Point points[], char *spec)
int HC_PShow_Net_Clip_Region(int count, Key const keys, int loopCount, int loopSizeArray, Point points, char spec)

Returns all the clip regions found on the key path passed to the function.

By default, HOOPS will determine the Net attribute from the last specified key all the way to the root. If you add -1 at the end of the array, the PShow_Net routines will not proceed beyond the end of the last specified key.

A negative integer in the out_lengths array indicates that the loop represented by that integer is part of the clip region represented by the previous integer. In an array with the values [4, -5, 7, -6], the loop represented by the second element (-5) is part of the clip region that also includes the first element (4). When sequential values in the array change from negative to positive, the positive integer represents a new clip region, so in this case, the third element (7) represents a new clip region. Because the value of the fourth element is negative (-6), then that loop is part of the same clip region as the third element (7).

The out_spec parameter includes a comma-separated list of attribute pairs for each clip region, e.g.: *(window,type=mask),(world,type=clip)*. This indicates that there are two clip regions, with the first clip region set in window space using a mask attribute (hiding objects within the clip region that are in or below the current segment), and the second in world space with a clip attribute (hiding objects outside the clip region that are in or below the current segment).

A return value of 0 indicates no clip region was found. A value of 1 indicates a single-precision clip region was found. A value of 2 indicates a double-precision clip region was found.

HC_Show_Clip_Region()

Parameters

in_count: Number of keys in the keys array.

in_keys: The list of keys starting with the owning segment and following all the way back to the root segment or other desired segment.

out_loops: Number of loops defined in the points array. This will be the size of the array out_lengths. Returned to caller. Passed by reference always

out_lengths: An array of integers defining the number of points in each loop. The sum of the absolute values of these integers will be the size of the out_points array. Please refer to the Details section for an explanation of the positive/negative values.

out_points: The array of points used to define the clip region. Returned to caller. Passed by reference always.

out_spec: Options that were used to define that clip region. Returned to caller. Passed by reference always.