Commands  ›  Annotation  ›  Annotation Split Dimension String At Point

Annotation Split Dimension String At Point

Annotation writes to model Public API · not yet exposed

Coming soon

Before you run this

Active document open; dimension id resolves to a Dimension with a linear curve; split point projects cleanly onto it and produces two sides each with ≥ 2 references.

After it runs

Original dimension deleted; two new dimensions exist. One committed Transaction.

When to use this

Don't use this when

Non-linear dimension curves.

Decision flow

1) Resolvers: dimension id, split(X,Y,Z) in feet. 2) Resolve dimension; verify curve is a Line; project split point onto line. 3) Transaction 'Split dimension string'. 4) Partition References by bbox-centroid X vs. projected X into leftRefs / rightRefs; each side must have ≥ 2 references. 5) NewDimension(left) + NewDimension(right); delete original. 6) Commit. 7) Bot JSON / User toast. 8) Exception → tracker.Fail + WireFault.

What you'll see in the chat

on start
Splitting dimension string at point…
thinking
Projecting split point onto dimension line…
Partitioning references…
on success
Dimension split — left {left_dimension_id}, right {right_dimension_id}.
on failure
Could not split dimension: {error}.

REST API

Not yet exposed

This command does not carry a [RestApi] attribute today. Once tagged, this section will auto-populate with:

  • POST /api/v1/commands/annotation_split_dimension_string_at_point
  • Request body schema (from [RestApiParam])
  • Response schema (from [RestApiResponse])
  • curl / JS / Python code examples

Keywords & intent patterns

split dimension · break dimension at point · split running dimension · drawing presentation · tidy dimensions

PillarAnnotation