🎨 Fritzing-Parts: MT6701 Magnetic Encoder Guide

A precision workflow for creating high-quality custom components in Fritzing. This guide documents the exact XML edits and Inkscape settings required to bypass common SVG rendering bugs.

Pro-Tip: A .fzpz file is just a renamed .zip archive. Rename it to access the raw .fzp metadata and SVG source files directly for manual editing.

Downloads

Open-Source MT6701 Part & Full Documentation at GitHub

Quick-Fix Troubleshooting

If your custom part looks "broken" upon import, refer to these common XML/SVG fixes:

Symptom	Likely Cause	Fix Action
Giant/Tiny Text	Inkscape `px` units	Delete "px" from `font-size` in XML Editor
Black Text Only	Hardcoded `fill` value	Remove specific `fill` line in XML tree
Single-Sided PCB	Incorrect Layering	Nest `copper1` group inside `copper0`
Invisible Part	Missing Layer ID	Match top-level group ID to `.fzp` definition

Advanced Technical Workflow

Creating professional parts requires a 4-stage technical cycle to ensure manufacturing accuracy:

1. XML Metadata (.fzp)

Define pin mappings and internal Buses. If your part has multiple GND pins, linking them in the .fzp file ensures they share the same net in Fritzing.

2. PCB Layer Nesting

For dual-side connectivity, the SVG structure must follow a specific hierarchy: <g id="copper1"> (Top Layer) containing <g id="copper0"> (Bottom Layer). This allows Fritzing to recognize through-hole pads correctly for manufacturing.

Solving the Inkscape Rendering Engine Bugs

Modern Inkscape versions output data that Fritzing's older rendering engine often misinterprets. Use the following logic to sanitize your files:

The Font-Size Bug: Open the XML Editor (Edit -> XML Editor). Fritzing requires unit-less values for scaling. font-size: 12px must become font-size: 12.
Vector Optimization: Always export as "Optimized SVG". This strips unnecessary metadata that can cause part "ghosting" or invisible components.
Transparency: For complex shapes, use the PNG-to-Bitmap tracing workflow to maintain transparency without adding heavy path data.

Recommended Tools: Use FritzingCheckApp to validate your SVGs before import. It automatically detects missing layer IDs and non-standard XML tags.