HC_QShow_Existence
-
int
HC_QShow_Existence(char const *segment, char const *filter) - int HC_QShow_Existence(char const segment, char const filter)
Similar to Show_Existence(), but operates on a given segment rather than the currently open one.
The segment parameter can take a number of valid segment name specifications including aliases, wildcards, and paths, as explained in the HOOPS/3dGS programming guide section 1.2.6 “Segment-Name Syntax”. The following examples are valid usages:
- “.” Shows objects on the currently open segment.
- “..” Shows objects on the parent of the currently open segment.
- “…” Shows objects on the currently open segment and its child segments.
- “….” Shows objects on the currently open segment, its children, and any include segments below the current segment.
- “?picture/model” Shows objects on the segment “model”.
- “?picture/model/..” Shows objects on “?picture”.
- “?picture/model/…” searches the segment named ‘model’ and all of its subsegments.
- “?picture/model/….” Shows objects on the segment named ‘model’, all of its children, and any include segments below ‘model’.
- “/…/model*” Shows objects on all segments in the entire tree starting with ‘model’, but not their subsegments.
- “/…/model/….” Shows objects on all segments in the entire tree named ‘model’, their children, and any include segments below them.
Parameters
segment: Name of the segment(s) in which to search. Can include wildcards, multiple segments, etc.
filter: List of the types of objects to be queried.
Returns
count Number of objects found that match the requested type.