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.