Skip to main content

Objects and editing

Satin Studio edits embroidery objects when it can. A machine stitch stream is not the same thing as an editable object.

Object means sewing intent​

An object is more than visible geometry.

Examples:

  • fill region: shape, density, angle, underlay, compensation, thread, entry, exit;
  • satin column: spine/rails, width, splits, direction, underlay, thread;
  • running path: points, stitch length, repeats, thread;
  • text: content, font asset, layout, stitch style, size warnings;
  • appliqué step: placement, tackdown, stop, trim, cover stitch;
  • imported block: preserved machine commands and any reconstruction evidence.

If a project has the object, edit the object. If the file only has stitches, edit the stitch stream or reconstruct cautiously.

Inspector​

The inspector should show only controls that apply to the selected thing.

A fill needs density and angle. A text object needs content and font facts. An imported manual block needs command-range tools and warnings about what cannot be inferred.

Mixed selections should state what is mixed. Hidden assumptions cause bad machine files.

Editing levels​

Use the least destructive level that solves the problem:

  1. View/proof: inspect, comment, approve, follow notes.
  2. Safe quick edit: change prepared values, such as a thread choice or template text.
  3. Object edit: change sewing intent, then recompile.
  4. Stitch repair: edit machine commands directly.

Stitch repair is necessary for some imports. It should not be the default editing model for native objects.

Guided repairs​

A warning should identify the object or stitch range, state the risk, and offer an undoable fix.

Good warning:

This satin is 11.8 mm wide. Long floats may snag. Split the satin or convert it to fill.

Bad warning:

Invalid geometry.

Repairs should update the project source. Preview, timeline, proof, worksheet, and export should then agree.

Resizing​

Resizing stitches is not the same as resizing editable objects.

  • Preserving stitches scales existing needle points. It keeps the stitch count and changes density.
  • Recalculating stitches uses editable objects to generate a new stitch plan.

Small fitting changes may be safe as preserved stitches. Large size changes usually need object-level recalculation and review.