Model Replace

Description

Model Replace is an interactive tool that allows you to replace selected objects with objects from a collection. The tool provides a modal interface for selecting a collection of replacement objects and then selecting objects to be replaced, with options to randomize which objects from the collection are used as replacements.

Features

• Interactive collection selection with real-time preview
• Multi-object replacement support
• Original objects are preserved in a hidden collection
• Replacement objects are duplicated from the source collection
• Randomization of replacement objects using mouse wheel
• Alignment based on object origins for precise placement

How to Use

1. Activate the Model Replace tool from the DAMTools menu (Edit/Drawing section)
2. Select a collection to use for replacements (use mouse wheel to navigate through collections)
3. Press Enter/Space to confirm the collection selection
4. Click on objects in the scene to select them for replacement
5. Use the mouse wheel to randomize which objects from the collection will replace the selected objects
6. Press Enter/Space to confirm and perform the replacement
7. Press Esc or right-click to cancel at any time

Process

1. When you confirm the replacement, the original objects are moved to a hidden collection named "Replaced"
2. Objects from the selected collection are duplicated and positioned at the locations of the original objects
3. The placement is based on the origin points of the objects for accurate positioning
4. Original objects remain in the scene but are hidden, allowing you to revert changes if needed

Tips

• Prepare your replacement objects in a collection before using this tool
• Make sure the origins of your objects are properly set for accurate replacement
• You can use this tool for quickly populating scenes with variations of similar objects
• The randomization feature helps create visual variety in your scene
• Original objects are preserved, so you can always recover them if needed