CopyTo¶

![CopyTo Hero Image - TODO: Add image showing multiple objects with copies at their origins]

What is it?¶

CopyTo duplicates the active object to the origin point of all other selected objects, maintaining the active object's orientation and scale. Perfect for quickly placing identical objects (screws, details, decorations) at multiple predetermined locations.

Access and Shortcuts¶

Pie Menu: Arrangement section → "CopyTo"
Operator: damtools.copy_to
Icon: Duplicate icon in DAMTools pie menu

Workflow¶

Select target objects where you want copies placed (these mark the destination points)
Select the source object last (this becomes the active object to be copied)
Activate CopyTo from the pie menu
Result: Copies of the active object appear at the origin of each previously selected object

TODO: Add GIF showing the selection process and resulting copies

Parameters¶

CopyTo has no adjustable parameters - it performs a direct copy operation based on object selection.

Tips¶

Selection order matters: Select destination objects first, source object last
Origin points: Copies are placed at the exact origin (center point) of target objects
Multiple copies: Works with any number of target objects selected
Non-destructive: Original objects remain unchanged
Collection management: Copies are automatically added to the same collection as the source object

Validation and Error Handling¶

Minimum selection: Requires at least 2 objects selected (1 source + 1+ targets)
Active object check: Ensures an active object exists for copying
Clear feedback: Displays helpful messages if selection requirements aren't met

Use Cases¶

Hardware placement: Copy screws, bolts, or fasteners to multiple mounting points
Decoration distribution: Place identical decorative elements across a model
Component arrays: Position identical parts at predetermined locations
Detail work: Add small details to multiple locations quickly

Known Limitations¶

Copies use the exact orientation of the source object (no automatic rotation to match targets)
Target objects remain in the scene (they are not replaced, only used as position references)