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 shows 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.

For a mixed selection, the inspector identifies which values agree and which are mixed. It never guesses a shared setting.

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.

For live text, letter curve edits stay on the text object as structured overrides. Use them before converting text to paths or editing raw stitches, and reset or repair stale curve edits when the text/font changes.

Grouping and object order

Select two or more source objects and run Objects: group selection from M-x. Grouping creates one undoable hierarchy edit and selects the new group. Objects: ungroup selected group removes that wrapper while preserving and selecting its children.

Objects inside a group have an explicit order. Use the Objects: move selected… commands to move one child earlier, later, to either edge, or out of its group. These commands change project source and use the same project undo history as direct canvas edits.

Editing inside groups

Select a group and run Scope: edit selected group contents from M-x to work with its children. The object tree and selection then stay inside that group. Nested groups form a breadcrumb, so you can move inward one group at a time.

Run Scope: exit group contents to move up one level. Satin Studio selects the group you just left, which makes it clear where you returned. Entering or leaving a group changes editing context only; it does not alter project geometry or add a project undo step.

Stitch repair is useful for imported command streams and deliberate manual blocks. Native objects are safer to change through their sewing settings.

Guided repairs

Each warning identifies the object or stitch range, states the production risk, and offers an undoable fix when Satin Studio can make one safely.

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.

A repair updates project source. The next compile brings the preview, timeline, proof, worksheet, and export back into agreement.

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. Machine handoff flags visible imported stitch blocks that were resized so you remember to test sew or reconstruct before production.