Repository navigation
Troubleshooting and Defect Resolution
Because filament paintings consist of dozens of solid micro-layers (
This guide provides diagnostic root causes, step-by-step remedies, and preventative settings for the most common print issues.
| Symptom / Defect | Root Cause | Solution |
|---|---|---|
| Muddy / Dirty Highlights (White looks gray or tinted) | Incomplete nozzle purge after black/dark color. | Increase flush volume multiplier to |
| Washed Out / Low Contrast | Infill density is |
Re-slice with Aligned Rectilinear infill; recalibrate filament |
| Cross-Hatch Shadow Pattern | Slicer used Grid, Gyroid, or Cubic infill. |
Change infill pattern strictly to Aligned Rectilinear or Monotonic. |
| Plate Warping / Corner Lifting | High thermal contraction stress from dense solid plastic. | Wash plate with dish soap; lower bed temp to |
| Nozzle Drag Marks / Rough Surface | Cumulative over-extrusion across 20+ solid layers. | Reduce extrusion multiplier / flow rate by |
| Visible Horizontal Color Stepping | Insufficient layer budget or coarse z-resolution. | Reduce layer height from |
| Stringing / Spiderweb Wisps | Wet filament or excessive nozzle temperature. | Dry spool at |
| Layer Shift Mid-Print | Nozzle collided with curled corner or over-extruded ridge. | Lower flow rate, enable Z-hop ( |
Problem: After swapping from Black or Red to White or Yellow, the first 5β10 layers of light filament appear muddy, dirty, or greenish-gray.
Root Cause: Modern hotends have internal melt zones holding 20β40 mmΒ³ of molten polymer. Highly concentrated carbon black or phthalocyanine pigments cling to the interior barrel walls and dissolve gradually into the incoming plastic.
Resolution:
- Calibrate Flush Volumes: In Bambu Studio/OrcaSlicer, open the Flushing Volumes dialog.
- For transitions from Dark
$\to$ Light:- Set flush volume to 500 β 700 mmΒ³.
- For transitions from Light
$\to$ Dark:- Set flush volume to 150 β 200 mmΒ³ (light colors are easily masked by dark pigment).
-
Prime Tower: Always enable a prime tower with at least
$35\text{ mm}^3$ prime volume so pressure equalizes before laying down the canvas.
Problem: The bottom layers look great, but as the print reaches layer 20β30, the nozzle begins scraping across the plastic, leaving rough ridges, bumps, or scraping noises.
Root Cause: In standard hollow prints with 15% infill, minor over-extrusion (
Resolution:
- Calibrate your filament's Extrusion Multiplier (Flow Rate):
- For standard PLA, set flow to
0.96β0.98(never1.02+).
- For standard PLA, set flow to
- Set Top Surface Flow to
0.95. - In Slicer Quality settings, enable Z-hop on retract (
$0.2\text{ mm} - 0.4\text{ mm}$ , Spiral or Auto).
Problem: The edges of large flat lithophanes or paintings curl upward off the build plate mid-print, causing deformed corners or nozzle strikes.
Root Cause: Large solid sheets of polymer experience high tensile contraction as they cool from
Resolution:
- Chemical Bed Clean: Wash the PEI plate thoroughly with dish soap (Dawn) and warm water to strip all fingerprint grease. Follow with 99% isopropyl alcohol.
-
Bed Temperature Profile:
- First layer:
$60^\circ\text{C} - 65^\circ\text{C}$ for initial bite. - Subsequent layers: Drop to
$50^\circ\text{C} - 55^\circ\text{C}$ to prevent thermal softening under contraction stress.
- First layer:
- Turn Off Auxiliary Chamber Fans: High-velocity cross-drafts from side chamber fans cool one edge of the print faster than the rest, inducing curl. Set chamber/aux fan to 0%.
-
Mouse Ears / Brim: Add a
$5\text{ mm}$ outer brim with$0.1\text{ mm}$ brim-object gap for easy peeling.
Problem: Skin tones or sky gradients look like sharp, discrete stair-steps instead of smooth photographic blending.
Root Cause: Too few optical layers allocated to that specific tonal range, or the chosen filaments have
Resolution:
- In TailWag Studio, examine the Color Timeline.
- If a color only prints for 1 or 2 layers, light cannot blend effectively.
- Replace the transition filament with a higher-$TD$ alternative (e.g. swap an opaque Red
$TD=1.0$ for a translucent Coral$TD=3.5$ ). - Increase total project layers by reducing layer height to
$0.04\text{ mm}$ or bumping the model depth from$2.0\text{ mm}$ to$2.8\text{ mm}$ .
- Slicer Setup & Print Settings: Recommended layer heights and infill configuration.
- TD Calibration Guide: Accurate measurement to eliminate color drift.
- Filament Painting Science: Understanding transmission physics and pigment saturation.
TailWag Studio Documentation Β· Open-Source 3D Filament Painting & TD Lithophane Engine Β· GitHub