From 2500828c587e0ad05e9fc69116d4f8a5aa2393d7 Mon Sep 17 00:00:00 2001 From: sentientstardust Date: Thu, 21 May 2026 07:03:20 +0100 Subject: [PATCH] Update README.md --- README.md | 56 +++++++++++++++++++++++++++++++------------------------ 1 file changed, 32 insertions(+), 24 deletions(-) diff --git a/README.md b/README.md index 79dffbeb785..4c7613167d8 100644 --- a/README.md +++ b/README.md @@ -58,41 +58,49 @@ Zoomed-out G-code preview: ![Slicer Screenshot](https://gradients.garden/gitlab_images/sliced3.jpeg) -### OBJ Image Texture Loading +### 3D Model Image Texture Import -- **Load OBJ files with image textures or vertex colors** - slice in full image resolution, no need to subdivide your model or bake vertex colors first - -### Print with only one tool change per layer -- When printing image textures with this technique, only a single filament color is used per layer (not dependent on texture color). You can print many different models at once without increasing the number of tool changes. - -![More Test Prints](https://gradients.garden/gitlab_images/test_prints.jpeg) - -([3D model](https://sketchfab.com/3d-models/snakchameleon-f0e3c872f1984cf7a467645d9e0d3abd) by Pedram Ashoori, CC BY 4.0) -(Himalayan Monal photo from https://en.wikipedia.org/wiki/Himalayan_monal#/media/File:Himalayan_Monal_at_Sagarmatha_National_Park,_Nepal.jpg - CC BY-SA 4.0) - -### Print images on your prime towers -- Turn your prime towers into ornaments (requires no extra tool changes, and typically <1g additional filament) - -![Prime Tower Image Printing (The Great Wave off Kanagawa)](https://gradients.garden/gitlab_images/the_great_wave_prime_tower.jpeg) +- **Load OBJ, glTF and GLB files with image textures or vertex colors** - slice in full image resolution, no need to subdivide your model or bake vertex colors first ### Image Projection +- Import images and project them onto your 3D model. Or use text mode and select a font to project writing ![Image Projection Panel](https://gradients.garden/gitlab_images/image_projection_sphere_1.jpeg) ![Image Projection Result](https://gradients.garden/gitlab_images/image_projection_sphere_2.jpeg) -### 2D Gradient Generation -- **Create 2D Gradients** on your object by changing a texture mapping zone's pattern to "2D Gradient" - -![2D Gradients](https://gradients.garden/gitlab_images/slicergradients.jpeg) - -### Works with Filament Painting -- Texture mapping and gradients integrate with OrcaSlicer filament region painting, so you can have texture mapping on one part of the model, and a solid filament color or gradient somewhere else. - ### Simplify/Repair/Cut Textured Models - When using these model utilities, image textures are remapped to the resulting mesh, allowing you to keep your textures. ![Color Cut Tool 1](https://gradients.garden/gitlab_images/color_cut_tool_1.jpeg) ![Color Cut Tool 1](https://gradients.garden/gitlab_images/color_cut_tool_2.jpeg) +([Lizard 3D Scan](https://sketchfab.com/3d-models/lizard-e60fb42493fa47389195350fcf216ee7) by Rene-L211979, CC BY 4.0) + +### Print images on your prime towers +- Turn your prime towers into ornaments (requires no extra tool changes, and typically <1g additional filament) + +![Prime Tower Image Printing (The Great Wave off Kanagawa)](https://gradients.garden/gitlab_images/the_great_wave_prime_tower.jpeg) + +### Print with only one tool change per layer +- When printing image textures with this technique, only a single filament color is used per layer (not dependent on texture color). You can print many different models at once without increasing the number of tool changes or prime tower size. This can print faster than other multicolor techniques at the same layer height. + +![More Test Prints](https://gradients.garden/gitlab_images/test_prints.jpeg) + +([3D model](https://sketchfab.com/3d-models/snakchameleon-f0e3c872f1984cf7a467645d9e0d3abd) by Pedram Ashoori, CC BY 4.0) +(Himalayan Monal photo from https://en.wikipedia.org/wiki/Himalayan_monal#/media/File:Himalayan_Monal_at_Sagarmatha_National_Park,_Nepal.jpg - CC BY-SA 4.0) + +### 2D Gradient Generation +- **Create 2D Gradients** on your object by changing a texture mapping zone's pattern to "2D Gradient" + +![2D Gradients](https://gradients.garden/gitlab_images/slicergradients.jpeg) + +### Other features/improvements implemented in OrcaSlicer-ImageMap: +- Paint filament regions by slope +- Convert between all supported color data types (image texture, vertex colors, 3mf filament painting regions, RGBA data) + - For example you could import a 3mf with region painting and convert it to a texture (with autogenerated UV map) +- Triangulate 3D models on import (before only OBJs with triangles or quads could be imported) +- Halftone image dithering (for stylized effect) +- Integrates with Filament Painting + - Texture mapping and 2D gradients work with OrcaSlicer filament region painting, so you can have texture mapping on one part of the model, and a solid filament color or gradient somewhere else. # Download @@ -154,7 +162,7 @@ Currently builds are not available for linux, you must build this yourself # Tips and advice for printing with image textures: ### Filament - In my test prints shown above I used PLA with transmission distances of around 2-4 - - Avoid using filament with higher TD values, such as filaments labelled 'translucent' or 'transparent', as they are likely to lead to washed out/pale colors (this technique works by overhanging filament sagging and blocking the layer below, so if you use filament that is too translucent the color below will still be visible). + - Avoid using filament with higher TD values with line width modulation mode, such as filaments labelled 'translucent' or 'transparent', as they are likely to lead to washed out/pale colors (this technique works by overhanging filament sagging and blocking the layer below, so if you use filament that is too translucent the color below will still be visible). - On the other hand, filament that is very opaque can cause horizontal lines to be too visible, so I recommend filaments with middle ground TD values - If you don’t have a TD measurement device you can look up community sourced filament TD values on filamentcolors.xyz or 3dfilamentprofiles.com ### Overhang amount