​
Accessors

​
filteringState

get filteringState(): FilteringState

Returns the current FilteringState.

Returns: FilteringState

​
Methods

​
hideObjects

hideObjects(
    objectIds: string[],
    stateKey: string = null,
    includeDescendants = false,
    ghost = false
  ): FilteringState

Hides the specified object ids.

Parameters

  • objectIds: The ids of the objects to hide
  • optional stateKey: A way of splitting up commands coming from different controls (model explorer, filters, selection) so the viewer filtering api can know whether to reset its internal state or not
  • optional includeDescendants: Whether to include the descendants of the provided object ids
  • optional ghost Whether to ghost the rest of the objects

Returns: FilteringState

​
isolateObjects

isolateObjects(
    objectIds: string[],
    stateKey: string = null,
    includeDescendants = true,
    ghost = true
  ): FilteringState

Hides the specified object ids.

Parameters

  • objectIds: The ids of the objects to hide
  • optional stateKey: A way of splitting up commands coming from different controls (model explorer, filters, selection) so the viewer filtering api can know whether to reset its internal state or not
  • optional includeDescendants: Whether to include the descendants of the provided object ids
  • optional ghost Whether to ghost the rest of the objects

Returns: FilteringState

​
isolateObjects

removeColorFilter(): FilteringState

Removes any current color filters.

Returns: FilteringState

​
removeUserObjectColors

removeUserObjectColors(): FilteringState

Removes any current user color filters.

Returns: FilteringState

​
resetFilters

resetFilters(): FilteringState

Removes al the current filters.

Returns: FilteringState

​
setColorFilter

setColorFilter(prop: PropertyInfo, ghost = true): FilteringState

Applies a color filter.

Parameters

  • prop: PropertyInfo
  • optional ghost” Whether to ghost the rest of the objects

Returns: FilteringState

​
setUserObjectColors

setUserObjectColors(
    groups: { objectIds: string[]; color: string }[]
): FilteringState

Applies a user color filter.

If used appropriately user color filters can typically be much more performant than applying multiple materials per color.

Parameters

  • groups: Groups of objects organized by color

Returns: FilteringState

​
showObjects

showObjects(
    objectIds: string[],
    stateKey: string = null,
    includeDescendants = false
  ): FilteringState

Shows the specified object ids.

Parameters

  • objectIds: The ids of the objects to hide
  • optional stateKey: A way of splitting up commands coming from different controls (model explorer, filters, selection) so the viewer filtering api can know whether to reset its internal state or not
  • optional includeDescendants: Whether to include the descendants of the provided object ids

Returns: FilteringState

​
unIsolateObjects

unIsolateObjects(
    objectIds: string[],
    stateKey: string = null,
    includeDescendants = true,
    ghost = true
  ): FilteringState

Shows the specified object ids.

Parameters

  • objectIds: The ids of the objects to hide
  • optional stateKey: A way of splitting up commands coming from different controls (model explorer, filters, selection) so the viewer filtering api can know whether to reset its internal state or not
  • optional includeDescendants: Whether to include the descendants of the provided object ids
  • optional ghost Whether to ghost the rest of the objects

Returns: FilteringState

​
Typedefs

​
FilteringState

type FilteringState = {
  selectedObjects?: string[];
  hiddenObjects?: string[];
  isolatedObjects?: string[];
  colorGroups?: Record<string, string>[];
  userColorGroups?: { ids: string[]; color: string }[];
  activePropFilterKey?: string;
  passMin?: number | null;
  passMax?: number | null;
};
  • selectedObjects: The current selected object ids
  • hidenObjects: The current hidden object ids
  • isolatedObjects: The current isolated object ids
  • colorGroups: The current color groups
  • userColorGroups: The current user color groups
  • activePropFilterKey: The active property filtering key
  • passMin: The minimal value of the property filtering value if numeric
  • passMax: The maximum value of the property filtering value if numeric

​
PropertyInfo

interface PropertyInfo {
  key: string;
  objectCount: number;
  type: 'number' | 'string';
}

Outline of a filterable property.

  • key: The property key
  • objectCount: The object count where the key is present
  • type: Property type