Description

Combines enabled spatial checks and their settings for a clash detection routine.

Object selections A and B are supplied separately to the routine. Multiple checks may be enabled simultaneously; each uses its own settings and classifies results independently. By default only intersection detection is enabled. Disabled checks retain their settings for later use. When all checks are disabled, the routine should return no results. calculateClashes() uses independent geometry passes and merges successful classifications by object pair. Coincidence accepts open surfaces; inclusion validates only the potential container and tests inner vertices. Contact honors its geometry output and style settings. Object creation requires every pass to complete; failures in another pass retain numeric contact results and suppress contact object creation. Responses echo this complete map in used_options and report errors with object IDs and the failing check.

contactEnabled controls the explicit contact check and its treatment. The intersection check's touchingCountsAsClash flag remains independent and uses intersection.distanceTolerance to additionally identify near-contact pairs even when explicit contact reporting is disabled. Distances are in metres, volumes in cubic metres, angles in degrees and ratios in [0, 1]; the more specific constraints of the individual option classes also apply.

Maps contain intersection_enabled, clearance_enabled, coincidence_enabled, inclusion_enabled and contact_enabled flags, plus the nested intersection, clearance, coincidence, inclusion and contact settings. setFromMap() preserves omitted flags and nested fields. Supplying settings for a disabled check does not enable it. Numeric validation is the caller's responsibility.

gom::ClashOptions options;
options.clearanceEnabled = true;
options.clearance.requiredClearance = 0.1; // 100 mm
options.coincidenceEnabled = true;
options.contactEnabled = true;
options.contact.treatment = gom::ContactOptions::Treatment::SeparateResult;
const QVariantMap map = options.toMap();

Since: 1.1, 09/2026