Add SVG combination tool and plate dimension options

Created combine_svg_vertical.py to vertically stack SVG files with centering
and configurable spacing. Enhanced svg_logo_to_stl.py with plate dimensions
and margin options for better nameplate creation.

combine_svg_vertical.py features:
- Vertically combines two SVG files (icon above text)
- Automatically centers smaller element
- Configurable spacing between elements (default: 20px)
- Configurable margin around composition (default: 10px)
- Preserves individual SVG structure in groups

svg_logo_to_stl.py enhancements:
- Added --plate-width and --plate-height options
- Logo scales to fit within plate dimensions (maintaining aspect ratio)
- Added --margin option for spacing around logo on plate
- Automatic centering of logo on plate
- Reports actual dimensions: plate, logo, margin, and offset

Example usage:
  # Combine icon and text
  python combine_svg_vertical.py um_grey.svg um_black.svg combined.svg --spacing 114

  # Center on 256x256mm plate with 10mm margin
  python svg_logo_to_stl.py combined.svg output \
    --plate-width 256 --plate-height 256 --margin 10 \
    --base-thickness 1.5 --feature-height 2.5

Files:
- combine_svg_vertical.py: Vertical SVG stacking tool
- README_combine_svg.md: Documentation for combine tool
- underground-magnetics-combined.svg: Example combined logo
- svg_logo_to_stl.py: Enhanced with plate dimensions
- command.txt: Updated with new parameters

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
2026-05-31 12:23:24 -05:00
parent 2719ec244d
commit 859ce050a3
5 changed files with 519 additions and 92 deletions

112
README_combine_svg.md Normal file
View File

@@ -0,0 +1,112 @@
# Combine SVG Vertical
A script to combine two SVG files vertically with automatic centering and configurable spacing.
## Purpose
This tool is designed for preparing multi-part logos for 3D printing by:
- Placing an icon/logo above text
- Automatically centering the smaller element
- Adding configurable spacing between elements
- Maintaining proper dimensions for STL conversion
## Usage
```bash
python combine_svg_vertical.py <top_svg> <bottom_svg> <output_svg> [options]
```
### Arguments
- `top` - Top SVG file (e.g., icon or logo)
- `bottom` - Bottom SVG file (e.g., text)
- `output` - Output combined SVG file
### Options
- `--spacing, -s` - Vertical spacing between elements in pixels (default: 20)
- `--margin, -m` - Margin around entire composition in pixels (default: 10)
## Examples
### Basic Usage (Underground Magnetics Logo)
```bash
python combine_svg_vertical.py um_grey.svg um_black.svg underground-magnetics-combined.svg
```
**Result:**
- Grey "UM" icon (413×390) centered above black text (3070×233)
- 20px spacing between icon and text
- 10px margin around composition
- Final canvas: 3090×663px
### Custom Spacing
```bash
# Larger spacing between elements
python combine_svg_vertical.py icon.svg text.svg combined.svg --spacing 50
# Larger margin around composition
python combine_svg_vertical.py icon.svg text.svg combined.svg --margin 30
# Both custom
python combine_svg_vertical.py icon.svg text.svg combined.svg -s 40 -m 20
```
## How It Works
1. **Load SVGs** - Reads dimensions from viewBox or width/height attributes
2. **Calculate Layout** - Determines positioning based on:
- Maximum width of both elements
- Combined height + spacing
- Centering offsets for smaller element
3. **Create Groups** - Wraps each SVG in a `<g>` group with transform
4. **Combine** - Creates new SVG canvas with both elements positioned
## Output Structure
```xml
<svg width="..." height="..." viewBox="...">
<!-- Combined: top.svg (top) + bottom.svg (bottom) -->
<g id="top" transform="translate(x_offset, y_offset)">
<!-- All elements from top SVG -->
</g>
<g id="bottom" transform="translate(x_offset, y_offset)">
<!-- All elements from bottom SVG -->
</g>
</svg>
```
## Integration with 3D Workflow
After combining SVGs, you can convert to STL:
```bash
# Convert combined logo to 3D model
python svg_logo_to_stl.py underground-magnetics-combined.svg um_logo \
--width-mm 100 \
--base-thickness 1.5 \
--feature-height 2.5
```
This will create a single 3D model with both the icon and text at the same height (not stacked vertically in 3D, just in the 2D layout).
## Tips
- **Spacing**: Use `--spacing` to adjust the gap between icon and text
- Small spacing (10-20): Compact look
- Medium spacing (20-40): Balanced (default)
- Large spacing (50+): Separated elements
- **Margin**: Use `--margin` to add breathing room around the entire composition
- Useful when the combined SVG will be cropped or bounded
- **Order Matters**: The first argument is always placed on top
- Icon above text: `combine_svg_vertical.py icon.svg text.svg ...`
- Text above icon: `combine_svg_vertical.py text.svg icon.svg ...`
## File Size
The combined SVG file size is approximately the sum of the input files:
- um_grey.svg: 728B
- um_black.svg: 6.1KB
- **Combined**: 7.0KB