#64 Material Selector Plugin

[3D Logic Class]

Material Selector Plugin

The Material Selector Plugin is a powerful tool for Sweet Home 3D that allows users to batch-replace furniture materials quickly and easily.

With this plugin, you can:

Replace materials on multiple furniture items at once.

Apply textures from image files (JPG, PNG) with real-world size settings, rotation, and optional random offsets.

• Apply solid colors to selected materials.
• Make materials transparent where needed.
• Adjust or preserve shininess for realistic finishes.
• Use drag & drop to quickly select image files.
• Undo or redo changes using Sweet Home 3D’s Undo/Redo system.

The plugin features a user-friendly interface with a material tree that automatically groups materials by name for easy navigation and selection.

[3D Logic Class]

📺 Video Demonstration

Watch how the Material Selector Plugin automates your workflow in Sweet Home 3D.

[3D Logic Class]

Material Selector Plugin – Version 1.0.1 Release Notes

The Material Selector Plugin v1.0.1 introduces a sophisticated image processing engine and advanced texture customization options to provide even greater control over your project's materials.

🚀 What’s New in 1.0.1

• Advanced Image Processing Engine: Integration of the new TextureEffectProcessor module, enabling on-the-fly modification of texture files before they are applied to the 3D model.
• Per-Texture Transparency Control: Unlike simple toggles, you can now adjust the transparency of applied image textures on a scale of 0-100%. This uses alpha compositing to blend textures while maintaining visual details.
• Dynamic Grout Generation: A new feature for tiling and masonry. You can programmatically add grout lines to any texture with full control over the grout's color and thickness (in pixels).
• Improved Resource Management: The plugin now automatically manages processed texture variations using a secure temporary file system (sh3d_processed_) to keep your project environment clean.
• Optimized Performance: Image processing logic is decoupled from the main UI thread, ensuring a smoother user experience during complex batch operations.
• Enhanced Undo/Redo Support: Improved tracking for wall and room material states to ensure complex multi-material changes remain perfectly reversible.

---

🛠 Core Features (Carried over from v1.0.0)

• Batch Replacement: Replace materials on multiple furniture items, walls, or rooms at once.
• Material Tree: Automatically groups materials by name for easy navigation and selection.
• Drag & Drop: Quickly import image files (JPG, PNG) with real-world size settings and rotation.
• Full Integration: Works seamlessly with Sweet Home 3D’s native Undo/Redo system.

---

📦 Installation

1. Download the MaterialSelectorPlugin-1.0.1.sh3p file.
2. Double-click the file or copy it to the plugins folder of Sweet Home 3D.
3. Restart Sweet Home 3D (if necessary) to see the plugin under the Tools menu.

[3D Logic Class]

📺 Video Demonstration

Watch how the Batch Material Replacer v1.0.1 automates your workflow for walls, floors, and furniture in Sweet Home 3D.

[3D Logic Class]

Material Selector Plugin - Version 1.0.2 Release Notes

We are pleased to announce the update of the Material Selector Plugin to Version 1.0.2 (April 2026). This is the fully complete and final version, implementing advanced UI ergonomics and feature requests for a professional workflow.

🆕 What’s New in 1.0.2

👁️ Advanced Preview & Selection

• Side-by-Side Preview: New "Current vs. New" comparison view allows you to see material changes before applying them.
• Dynamic Material Updates: Selecting any material in the tree now automatically updates the "Current" preview for instant feedback.
• Integrated Catalog: A fully functional Catalog button with an integrated browser for selecting materials directly from the Sweet Home 3D library.
• Browse Dialog Enhancement: Image previews are now displayed directly inside the file browse dialog when selecting custom textures.

🎨 Color & Texture Management

• SH3D Preferences Sync: Recent colors are now loaded directly from the Sweet Home 3D Preferences.xml file and are always visible.
• Dual Recent Textures Panels: * Integrated the standard Sweet Home 3D Recent Textures panel.
  • Added a custom Plugin Recent Textures panel that saves full material properties (transparency, grout, etc.), not just the image.
• Professional Swatches: All color swatches (Recent Colors, color preview, and grout buttons) have been redesigned as square, fully-filled buttons for a consistent, modern look.

💻 UI & Technical Improvements

• Ergonomic Tabbed Design: Recent Colors and Texture panels have been moved into a JTabbedPane, significantly reducing the window's vertical height.
• Scrollable Control Panel: The right panel is now scrollable, ensuring all controls and recent items are accessible regardless of window size.
• Smart Directory Memory: The plugin now remembers the last used directory for texture imports.
• Logical Layout: Control groups are now organized inside TitledBorder boxes for better visual distribution and ease of use.

---

📥 Installation Instructions

To update to the latest version:

1. Download the new version from the Files section.
2. Replace the existing plugin file in your Sweet Home 3D plugins directory.
3. Restart Sweet Home 3D to apply the changes.