label operation

Syntax

• label (label)

Parameters

1. label—string
   A non-empty label.

Description

The label operation creates a labeled shape. This shape can be referenced to in various labeled context related queries, for example occlusion queries on selected occluder shapes.

Related

• Context and occlusion queries
• contextCompare function
• contextCount function
• inside / overlaps / touches function
• minimumDistance function
• comp operation
• offset operation

Examples: Occlusion queries

The label operation makes the current shape available for intra and inter occlusion queries.

Labeled occlusion queries

Labeled occlusion queries are performed on occluder shapes with that label only.

Unlabeled occlusion queries

Unlabeled occlusion queries are performed on occluder shapes with any label.

Additionally, for leaf shapes and shapes where a component split or offset has been applied, (unlabeled) occluder shapes are automatically generated. In most cases this is sufficient, and there is no need to use the label operation.