HueForge Wiki - User contributions [en]

Main Page

2026-06-24T19:31:58Z

HueForge:

[[File:Main_image001.png|500px|thumb|center|HueForge Example]]

===[[Common Terms]]===

===[[How To Pages]]===

===[[TD-1]]===

===[[FAQ]]===

===[[Printer Profiles]]===

===[[Troubleshooting]]===
===[[HueForge v8.1 UI Break Down]]===

===[[HueForge Hotkeys]]===

===[[HueForge Controls]]===

===[[Video Summaries]]===

What does the Mesh Core Do?

2025-06-03T01:17:20Z

HueForge: /* TD (Thickness Depth) */

== Briefing Document: HueForge Color Match Deep Dive ==

=== Introduction ===
This document summarizes key concepts, features, and workflows for using the Color Match feature within HueForge, based on two tutorial excerpts. The focus is on understanding how the '''Mesh Core''' functions to map colors and how to utilize various tools and techniques for effective color matching. These tutorials delve into both the practical, hands-on application of the tools and the more theoretical underpinnings of the color matching algorithms.

<youtube>OMB5-Iw_WRo</youtube>

== Key Themes & Concepts ==

=== Mesh Core as a Custom Luminance Function ===
* The '''Mesh Core''' is not just a visual representation; it acts as a customizable luminance function that defines how colors in an image are mapped to the Z-height of a 3D print.
* The vertical ordering and layering of colors within the Mesh Core directly influence the print's appearance.
* "We're basically making a custom function to define where the heights of what colors are in the image."

=== Layering and Blending ===
* Color matching is approached as a '''layering problem''', where colors are blended rather than simply matched directly.
* Blending '''up''' (from light to dark) has seen significant improvements in recent versions.
* "Blending up means instead of thinking about blending down to a color... I'm planning on getting a darker and darker color above me..."

=== Color Matching Algorithms ===
* HueForge utilizes different color matching algorithms, with '''CIELAB''' currently being the most accurate.
* Testing different algorithms is crucial for achieving the best results.
* "...The CIELAB one is now by far the best. It's not always the one you're going to want to use, but it's by far the best."

=== TD (Transmission Distance) ===
* '''TD values''' control the thickness and blending of each color layer.
* They determine how smoothly one color fades into another.
* The '''T shortcut''' and mouse wheel can be used for quick TD adjustments.

=== Importance of Min Depth ===
* '''Min Depth''' is the bottom layer—'''all layers must be above this level'''.
* "...The bottom here is either the lowest slider or it is the layer below Min Depth."

=== Saturated Color Matching ===
* HueForge always matches to the '''lowest saturated layer''', which can sometimes yield unexpected results when matching dark colors.
* '''Disabling layers''' is an effective technique to manage this.
* "...Color match is always just going to match to the lowest value of that."

=== Filament Selection for Mesh Core ===
* The '''Mesh Core''' can be adjusted independently of filament selection.
* However, '''choosing the filament first''' and then copying to the Color Core makes matching easier.

=== Color Core as a Representation of Filament Colors ===
* Once the '''Mesh Core''' is set, it must be matched to the '''Color Core'''.
* The '''Color Core''' represents the actual filament colors and settings for the print.
* "...Now that we've actually set our Mesh Core, we need to match it to our Color Core."

=== Practical Workflow ===
A typical workflow for Color Match involves:
# Loading an image and switching to '''Color Match''' mode.
# Adjusting the '''Mesh Core''' to map colors to layers.
# Matching the '''Mesh Core''' colors to the '''Color Core''' (filament colors).
# Tweaking colors and placements for optimal blending and visual results.

=== Dynamic vs. Static Mode ===
* '''Static and dynamic modes''' are mostly inactive in Color Match mode.
* The '''top slider''' represents the '''highest Z-height''' in the 3D print.

=== Anti-Aliasing Issues ===
* Anti-aliasing in source images can create unwanted edges in Color Match.
* Using images '''without anti-aliasing''' can help reduce these problems.

=== Experimentation and Iteration ===
* '''Color Matching requires experimentation and iteration'''.
* Every action in Color Match involves trade-offs.
* "It's a trade-off game where you're trying to figure out what the best matches are that don’t take over where you don’t want them."

== Key Features and Functionality (from Tutorials) ==

=== Shortcuts ===
* '''Control/Command + Click + Drag''': Sample color from an image and drag onto a slider. Release '''Control/Command''' before dropping to match correctly.
* '''Z''': Set selected slider to zero.
* '''T + Mouse Wheel''': Adjust '''TD (Thickness Depth)''' of a slider.
* '''D (or Right Click)''': Disable a layer in Color Match.

=== Layout Customization ===
* Move and dock various controls (e.g., General Options, Lighting, Sliders) for an efficient workflow.

=== Layer Disabling ===
* Skipping layers in the matching algorithm allows for full saturation control.

=== Mesh View Flipping ===
* Flip between the model and mesh view using '''double-click, arrows, or buttons'''.

=== Browsing Projects ===
* HueForge allows browsing saved project files for easy access.

== Important Changes in v0.8.0-beta-2 ==

* '''TD Retention''': Dragging a color to a filament slider now retains the original filament's TD instead of defaulting to 1.
* '''Improved Blending Math''': Blending "up" calculations are now more accurate.

== Practical Tips from the Tutorials ==

* Start with '''real colors''' whenever possible to simplify adjustments later.
* Be mindful of '''color saturation''', particularly for dark colors and low layer heights.
* Consider the '''image context''' when stacking layers.
* Prioritize '''important edges'''—it may not be possible to perfect every detail.
* Test different '''Color Match algorithms''' to achieve the best results.
* Watch out for the '''anti-aliasing issue''' and how it affects prints.
* The '''CIELAB method''' is the best for Color Match, but '''Dot Product''' may be necessary when dealing with similar colors.

== Conclusion ==

These tutorials provide a strong foundation for understanding and utilizing the '''HueForge Color Match''' feature.

Key takeaways:
* The '''Mesh Core''' functions as a '''custom luminance function'''.
* '''Strategic layering''' of colors is essential for optimal blending.
* A range of tools and adjustments are available for fine-tuning.
* '''Success with Color Match requires understanding the principles, experimenting with different techniques, and iterative adjustments'''.

HueForge Hotkeys

2025-04-24T15:15:52Z

HueForge: /* Filter Options */

=Hotkeys By Category=
==File Menu==
{| class="wikitable"
! Action !! Windows/Linux !! macOS
|-
| Open Project || Ctrl+O || Command+O
|-
| Open Image || Ctrl+I || Command+I
|-
| Reload Image || Ctrl+Alt+I || Command+Option+I
|-
| Reload Project || Ctrl+Alt+O || Command+Option+O
|-
| Browse Projects (with thumbnails) || Ctrl+B || Command+B
|-
| Browse Example Projects || Ctrl+Shift+B || Command+Shift+B
|-
| Save Project || Ctrl+S || Command+S
|-
| Save Project As || Ctrl+Shift+S || Command+Shift+S
|-
| Export STL || Ctrl+E || Command+E
|-
| New Project and reset to defaults || Ctrl+N || Command+N
|-
| Quit HueForge || Ctrl+Q || Command+Q
|-
| Undo || Ctrl+Z || Command+Z
|-
| Step-by-Step Undo || Ctrl+Shift+Z || Command+Shift+Z
|-
| Redo || Ctrl+Y || Command+Shift+Z
|-
| Step-by-Step Redo || Ctrl+Shift+Y || Command+Shift+Z
|}

==General HueForge==
{| class="wikitable"
! Action !! Windows/Linux !! macOS
|-
| Launch a new instance || Ctrl+Shift+I || Command+Shift+I (the only way to run 2 HueForge instances on MacOS)
|-
| Select Filament Filter box || Alt+F || Option+F
|-
| Sort Sliders || Alt+S || Option+S
|-
| Invert Sliders || Alt+I || Option+I
|-
| Clear Slider History || Alt+H || Option+H
|-
| Reset View (v0.8.1) || r || r
|-
| Filament Set Menu || f || f
|-
| Core Fragment Menu || s || s
|}
==Filter Options==
{| class="wikitable"
! Action !! Windows/Linux !! macOS
|-
| Search by Hex || Start search with # || Start search with #
|-
| Search works with Tags || ||
|}

==Color Sliders==
{| class="wikitable"
! Action !! Windows/Linux !! macOS
|-
| Disable Slider (when hovering over) || Space || Space
|-
| Move Current Slider up/down || Up/Down Arrows || Up/Down Arrows
|-
| Select Slider to Left/Right in the Slider Dock || Left/Right Arrows || Left/Right Arrows
|}

==Color/Mesh Core==
{| class="wikitable"
! Action !! Windows/Linux !! macOS
|-
| Make Color Core Active (v0.8.1) || , or < || , or <
|-
| Make Mesh Core Active (v0.8.1) || . or > || . or >
|-
|-
| Convert Filament to Image Color (Cannot Undo) || i || i
|-
| Enable/Disable Slider || Space || Space
|-
| Lock Slider in place (will only move when dragged) || l || l
|-
| Toggle Slider Handle to display TD/layer value || t || t
|-
| Zero the slider under the mouse || z || z
|-
| Remove Slider under the mouse || del || del
|-
| Move slider up/down || Up/Down Arrows || Up/Down Arrows
|-
| Move slider and all unlocked sliders above it up and down || Ctrl+Up/Down Arrows || Command+Up/Down Arrows
|-
| Move slider and all unlocked sliders below it up and down || Alt+Up/Down Arrows || Option+Up/Down Arrows
|-
| Disable a layer on the Mesh Core to make it unavailable for matching || d || d
|-
|Show all TDs
| Alt + t
| Option + t
|-
|Show Layer Heights
| Alt + m
| Option + m
|-
| Copy Selected Sliders || Ctrl+C || Command+C
|-
| Cut Selected Sliders || Ctrl+X || Command+X
|-
| Reverse Selected Sliders || Ctrl+R || Command+R
|-
| Paste Copied Sliders (insert) || Ctrl+V || Command+V
|-
| Paste Copied Sliders (overwrite) || Ctrl+Shift+V || Command+Shift+V
|}

HueForge Hotkeys

2025-04-24T15:15:38Z

HueForge:

=Hotkeys By Category=
==File Menu==
{| class="wikitable"
! Action !! Windows/Linux !! macOS
|-
| Open Project || Ctrl+O || Command+O
|-
| Open Image || Ctrl+I || Command+I
|-
| Reload Image || Ctrl+Alt+I || Command+Option+I
|-
| Reload Project || Ctrl+Alt+O || Command+Option+O
|-
| Browse Projects (with thumbnails) || Ctrl+B || Command+B
|-
| Browse Example Projects || Ctrl+Shift+B || Command+Shift+B
|-
| Save Project || Ctrl+S || Command+S
|-
| Save Project As || Ctrl+Shift+S || Command+Shift+S
|-
| Export STL || Ctrl+E || Command+E
|-
| New Project and reset to defaults || Ctrl+N || Command+N
|-
| Quit HueForge || Ctrl+Q || Command+Q
|-
| Undo || Ctrl+Z || Command+Z
|-
| Step-by-Step Undo || Ctrl+Shift+Z || Command+Shift+Z
|-
| Redo || Ctrl+Y || Command+Shift+Z
|-
| Step-by-Step Redo || Ctrl+Shift+Y || Command+Shift+Z
|}

==General HueForge==
{| class="wikitable"
! Action !! Windows/Linux !! macOS
|-
| Launch a new instance || Ctrl+Shift+I || Command+Shift+I (the only way to run 2 HueForge instances on MacOS)
|-
| Select Filament Filter box || Alt+F || Option+F
|-
| Sort Sliders || Alt+S || Option+S
|-
| Invert Sliders || Alt+I || Option+I
|-
| Clear Slider History || Alt+H || Option+H
|-
| Reset View (v0.8.1) || r || r
|-
| Filament Set Menu || f || f
|-
| Core Fragment Menu || s || s
|}
==Filter Options==
{| class="wikitable"
! Action !! Windows/Linux !! macOS
|-
| Search by Hex || Start search with # || Start search with #
| Search works with Tags || ||
|}
==Color Sliders==
{| class="wikitable"
! Action !! Windows/Linux !! macOS
|-
| Disable Slider (when hovering over) || Space || Space
|-
| Move Current Slider up/down || Up/Down Arrows || Up/Down Arrows
|-
| Select Slider to Left/Right in the Slider Dock || Left/Right Arrows || Left/Right Arrows
|}

==Color/Mesh Core==
{| class="wikitable"
! Action !! Windows/Linux !! macOS
|-
| Make Color Core Active (v0.8.1) || , or < || , or <
|-
| Make Mesh Core Active (v0.8.1) || . or > || . or >
|-
|-
| Convert Filament to Image Color (Cannot Undo) || i || i
|-
| Enable/Disable Slider || Space || Space
|-
| Lock Slider in place (will only move when dragged) || l || l
|-
| Toggle Slider Handle to display TD/layer value || t || t
|-
| Zero the slider under the mouse || z || z
|-
| Remove Slider under the mouse || del || del
|-
| Move slider up/down || Up/Down Arrows || Up/Down Arrows
|-
| Move slider and all unlocked sliders above it up and down || Ctrl+Up/Down Arrows || Command+Up/Down Arrows
|-
| Move slider and all unlocked sliders below it up and down || Alt+Up/Down Arrows || Option+Up/Down Arrows
|-
| Disable a layer on the Mesh Core to make it unavailable for matching || d || d
|-
|Show all TDs
| Alt + t
| Option + t
|-
|Show Layer Heights
| Alt + m
| Option + m
|-
| Copy Selected Sliders || Ctrl+C || Command+C
|-
| Cut Selected Sliders || Ctrl+X || Command+X
|-
| Reverse Selected Sliders || Ctrl+R || Command+R
|-
| Paste Copied Sliders (insert) || Ctrl+V || Command+V
|-
| Paste Copied Sliders (overwrite) || Ctrl+Shift+V || Command+Shift+V
|}

HueForge Hotkeys

2025-04-24T15:10:31Z

HueForge:

=Hotkeys By Category=
==File Menu==
{| class="wikitable"
! Action !! Windows/Linux !! macOS
|-
| Open Project || Ctrl+O || Command+O
|-
| Open Image || Ctrl+I || Command+I
|-
| Reload Image || Ctrl+Alt+I || Command+Option+I
|-
| Reload Project || Ctrl+Alt+O || Command+Option+O
|-
| Browse Projects (with thumbnails) || Ctrl+B || Command+B
|-
| Browse Example Projects || Ctrl+Shift+B || Command+Shift+B
|-
| Save Project || Ctrl+S || Command+S
|-
| Save Project As || Ctrl+Shift+S || Command+Shift+S
|-
| Export STL || Ctrl+E || Command+E
|-
| New Project and reset to defaults || Ctrl+N || Command+N
|-
| Quit HueForge || Ctrl+Q || Command+Q
|-
| Undo || Ctrl+Z || Command+Z
|-
| Step-by-Step Undo || Ctrl+Shift+Z || Command+Shift+Z
|-
| Redo || Ctrl+Y || Command+Shift+Z
|-
| Step-by-Step Redo || Ctrl+Shift+Y || Command+Shift+Z
|}

==General HueForge==
{| class="wikitable"
! Action !! Windows/Linux !! macOS
|-
| Launch a new instance || Ctrl+Shift+I || Command+Shift+I (the only way to run 2 HueForge instances on MacOS)
|-
| Select Filament Filter box || Alt+F || Option+F
|-
| Sort Sliders || Alt+S || Option+S
|-
| Invert Sliders || Alt+I || Option+I
|-
| Clear Slider History || Alt+H || Option+H
|-
| Reset View (v0.8.1) || r || r
|-
| Filament Set Menu || f || f
|-
| Core Fragment Menu || s || s
|}

==Color Sliders==
{| class="wikitable"
! Action !! Windows/Linux !! macOS
|-
| Disable Slider (when hovering over) || Space || Space
|-
| Move Current Slider up/down || Up/Down Arrows || Up/Down Arrows
|-
| Select Slider to Left/Right in the Slider Dock || Left/Right Arrows || Left/Right Arrows
|}

==Color/Mesh Core==
{| class="wikitable"
! Action !! Windows/Linux !! macOS
|-
| Make Color Core Active (v0.8.1) || , or < || , or <
|-
| Make Mesh Core Active (v0.8.1) || . or > || . or >
|-
|-
| Convert Filament to Image Color (Cannot Undo) || i || i
|-
| Enable/Disable Slider || Space || Space
|-
| Lock Slider in place (will only move when dragged) || l || l
|-
| Toggle Slider Handle to display TD/layer value || t || t
|-
| Zero the slider under the mouse || z || z
|-
| Remove Slider under the mouse || del || del
|-
| Move slider up/down || Up/Down Arrows || Up/Down Arrows
|-
| Move slider and all unlocked sliders above it up and down || Ctrl+Up/Down Arrows || Command+Up/Down Arrows
|-
| Move slider and all unlocked sliders below it up and down || Alt+Up/Down Arrows || Option+Up/Down Arrows
|-
| Disable a layer on the Mesh Core to make it unavailable for matching || d || d
|-
|Show all TDs
| Alt + t
| Option + t
|-
|Show Layer Heights
| Alt + m
| Option + m
|-
| Copy Selected Sliders || Ctrl+C || Command+C
|-
| Cut Selected Sliders || Ctrl+X || Command+X
|-
| Reverse Selected Sliders || Ctrl+R || Command+R
|-
| Paste Copied Sliders (insert) || Ctrl+V || Command+V
|-
| Paste Copied Sliders (overwrite) || Ctrl+Shift+V || Command+Shift+V
|}

Office Hours v0.9.0 UI Changes

2025-03-06T15:54:22Z

HueForge:

== Briefing Document: HueForge Office Hours UI Changes for v0.9.0 ==
The start of this Office Hours was spent going over UI Changes in the upcoming version of HueForge. This document goes over the highlights. As always, more details are in the video.
<youtube>e5CLDQlEd7k</youtube>
== Key Highlights ==
* The default layout has been updated to use toolbars instead of dock widgets. The old dock widgets were prone to crashing and difficult to recover if something went wrong. They also took up a lot of space.

* Filament and model geometry remain in a dock due but don't take up much room.
* The slider dock is optional and can be enabled in the Windows menu. The core now includes all the functions of the sliders that are needed.

* A very useable 1366x768 default layout is how HueForge will load the first time.

* The cores replace the slider functions. Transmission Distance of sliders (TDs) can be adjusted, and the millimeter height of each slider can be displayed for setting layer swaps in the slicer if you don't use the Describe file (which I don't).

* The filament library is no longer editable directly. To edit a filament, right-click on it and choose edit.

* You can now increase/decrease font size of the UI. This settings is per-computer and is reapplied at startup.

* The filament dialogue has added the ability to add tags to filaments.
* These tags are searchable and filterable.
* Gray filaments have a secret tag for both "gray" and "grey" spellings, ensuring they are searchable under either spelling.

* The filaments menu has a types menu that allows merging PLA and PLA+ into one tab.
* Unwanted tabs for filament types and brands can be turned off, with an option to show owned spools of hidden brands.
* You can hide filaments by type, brand, or type and brand.

* There is now a UI page that breaks down all the UI elements on the HueForge.wiki for v0.8.1 a version for v0.9.0 will come out at release.

* The previous Luminance option (where you switch between modes) is now called Mesh Mode.

* A lit rendering system has been added, allowing users to see how the image will look with lighting.
* The color and intensity of the light can be adjusted.
* The shininess of the filament will also affect the rendering.
* Filaments with names containing "Metallic", "Pearl", "Silk", "Starlight", or "Elixir" will automatically be rendered with appropriate shine.
* Filaments with Matte or Terra in their name will be rendered with less shine.
* Color Shifting effects for filaments like Starlights can be added.
* Lit Rendering should be considered experimental.

* Mesh height information has been moved to the Preview pane.

* Base thickness and blend depth have been added.
* Base thickness replaces minimum depth but functions differently by moving all layers up while keeping blend depth.
* Blend Depth replaces Max Depth and "floats" on top of Base Thickness. No more moving a bunch of sliders when changing Min Depth.

* Hovering over a layer will create a pulsing highlight the corresponding parts of the image on the mesh.

* There are now options for predicting glow-in-the-dark, fluorescent, and color-shifting filaments. These options should be considered experimental.
* The current system only supports one secondary effect per filament.
* The current prediction system only supports one kind of secondary effect for prediction unless they are widely spaced
* You may have multiple colors of glow, or fluorescence, etc, but not glow going into fluoro etc.

* There are now two CIELAB color matching algorithms:
* **CIELAB** (the original with bug fixes) which puts some extra weight on the brightness of the colors.
* **CIELAB 2**, which puts more weight on perceptual color. The differences are generally small, but can be impactful in some images.

* Holding down control and using the mouse wheel will move all sliders. This has been in but it bears repeating.

* Sliders can now be:
* Selected
* Copied
* Cut
* Pasted (insert or replace)
* Inverted
* All operations can be synchronized between cores so that changes in slider orders etc are shared. (Especially useful for experimenting with different color orders)

* A new feature allows saving Core Fragments, which are sets of sliders that can be saved and reused.
* Core Fragments are accessed using the S key
* You can paste fragments in with Overwrite (replace), Insert, or Merge mode. The footprint of the fragment is displayed on the affected core.

* A blend assistant has been added to help with CMYK color space blending. It does not use the HueForge filament blending algorithm, but can still assist in selecting filaments to achieve new colors.
* You set your source color by color picker (MacOS must use the native picker in the Color Dialog), or drag and drop then set the target color the same way and it will show both intermediate blends and colors you can use to achieve the target color.
* Right clicking on a swatch will give a sorted list (by Delta-E 2000) of the closest colors of filaments you own AND unowned filaments that might be a good match.

* There is now a pixel scaling option for pixel art images. This turns off any interpolation of the image when resizing.

* The configuration can now be managed, allowing users to:
* Move to whatever folder you want
* Use an existing configuration from another location like a shared cloud drive to use between multiple computers.
* Not all configuration is stored in the folder, some is saved in User settings on the system.

* Borders have been improved and bugs have been fixed.
* You may now choose from External Borders or Regular borders.
* External borders will not resize the image.
* Regular Borders will resize the major axis of the model to avoid cropping or distortion of the image.
* If you want to set the major axis to a specific size, use External borders and set the size to desired size - 2 times the border width
* Border sizes on all sides will be uniform.
* Borders now use less triangles.
* Height and Width labels now show a size in () that is the ACTUAL size of the model adjusted by any borders.

* Color Cores have controls between them to allow a set of new functions
* Replace all sliders on a core with the ones on the other core (Arrow buttons allow this to go either way)
* Reset all colors/disables on the sliders to defaults without removing the image (not a new project, just a color reset to defaults)
* Remove all Layer Disables from the Mesh Core
* Turn on/off TD mode for all sliders
* Turn on/off millimeter labels for all active sliders.

Office Hours v0.9.0 UI Changes

2025-03-06T15:54:03Z

HueForge:

== Briefing Document: HueForge Office Hours UI Changes for v0.9.0 ==
The start of this Office Hours was spent going over UI Changes in the upcoming version of HueForge. This document goes over the highlights. As always, more details are in the video.
<youtube>e5CLDQlEd7k</youtube>
== Key Themes & Concepts ==
* The default layout has been updated to use toolbars instead of dock widgets. The old dock widgets were prone to crashing and difficult to recover if something went wrong. They also took up a lot of space.

* Filament and model geometry remain in a dock due but don't take up much room.
* The slider dock is optional and can be enabled in the Windows menu. The core now includes all the functions of the sliders that are needed.

* A very useable 1366x768 default layout is how HueForge will load the first time.

* The cores replace the slider functions. Transmission Distance of sliders (TDs) can be adjusted, and the millimeter height of each slider can be displayed for setting layer swaps in the slicer if you don't use the Describe file (which I don't).

* The filament library is no longer editable directly. To edit a filament, right-click on it and choose edit.

* You can now increase/decrease font size of the UI. This settings is per-computer and is reapplied at startup.

* The filament dialogue has added the ability to add tags to filaments.
* These tags are searchable and filterable.
* Gray filaments have a secret tag for both "gray" and "grey" spellings, ensuring they are searchable under either spelling.

* The filaments menu has a types menu that allows merging PLA and PLA+ into one tab.
* Unwanted tabs for filament types and brands can be turned off, with an option to show owned spools of hidden brands.
* You can hide filaments by type, brand, or type and brand.

* There is now a UI page that breaks down all the UI elements on the HueForge.wiki for v0.8.1 a version for v0.9.0 will come out at release.

* The previous Luminance option (where you switch between modes) is now called Mesh Mode.

* A lit rendering system has been added, allowing users to see how the image will look with lighting.
* The color and intensity of the light can be adjusted.
* The shininess of the filament will also affect the rendering.
* Filaments with names containing "Metallic", "Pearl", "Silk", "Starlight", or "Elixir" will automatically be rendered with appropriate shine.
* Filaments with Matte or Terra in their name will be rendered with less shine.
* Color Shifting effects for filaments like Starlights can be added.
* Lit Rendering should be considered experimental.

* Mesh height information has been moved to the Preview pane.

* Base thickness and blend depth have been added.
* Base thickness replaces minimum depth but functions differently by moving all layers up while keeping blend depth.
* Blend Depth replaces Max Depth and "floats" on top of Base Thickness. No more moving a bunch of sliders when changing Min Depth.

* Hovering over a layer will create a pulsing highlight the corresponding parts of the image on the mesh.

* There are now options for predicting glow-in-the-dark, fluorescent, and color-shifting filaments. These options should be considered experimental.
* The current system only supports one secondary effect per filament.
* The current prediction system only supports one kind of secondary effect for prediction unless they are widely spaced
* You may have multiple colors of glow, or fluorescence, etc, but not glow going into fluoro etc.

* There are now two CIELAB color matching algorithms:
* **CIELAB** (the original with bug fixes) which puts some extra weight on the brightness of the colors.
* **CIELAB 2**, which puts more weight on perceptual color. The differences are generally small, but can be impactful in some images.

* Holding down control and using the mouse wheel will move all sliders. This has been in but it bears repeating.

* Sliders can now be:
* Selected
* Copied
* Cut
* Pasted (insert or replace)
* Inverted
* All operations can be synchronized between cores so that changes in slider orders etc are shared. (Especially useful for experimenting with different color orders)

* A new feature allows saving Core Fragments, which are sets of sliders that can be saved and reused.
* Core Fragments are accessed using the S key
* You can paste fragments in with Overwrite (replace), Insert, or Merge mode. The footprint of the fragment is displayed on the affected core.

* A blend assistant has been added to help with CMYK color space blending. It does not use the HueForge filament blending algorithm, but can still assist in selecting filaments to achieve new colors.
* You set your source color by color picker (MacOS must use the native picker in the Color Dialog), or drag and drop then set the target color the same way and it will show both intermediate blends and colors you can use to achieve the target color.
* Right clicking on a swatch will give a sorted list (by Delta-E 2000) of the closest colors of filaments you own AND unowned filaments that might be a good match.

* There is now a pixel scaling option for pixel art images. This turns off any interpolation of the image when resizing.

* The configuration can now be managed, allowing users to:
* Move to whatever folder you want
* Use an existing configuration from another location like a shared cloud drive to use between multiple computers.
* Not all configuration is stored in the folder, some is saved in User settings on the system.

* Borders have been improved and bugs have been fixed.
* You may now choose from External Borders or Regular borders.
* External borders will not resize the image.
* Regular Borders will resize the major axis of the model to avoid cropping or distortion of the image.
* If you want to set the major axis to a specific size, use External borders and set the size to desired size - 2 times the border width
* Border sizes on all sides will be uniform.
* Borders now use less triangles.
* Height and Width labels now show a size in () that is the ACTUAL size of the model adjusted by any borders.

* Color Cores have controls between them to allow a set of new functions
* Replace all sliders on a core with the ones on the other core (Arrow buttons allow this to go either way)
* Reset all colors/disables on the sliders to defaults without removing the image (not a new project, just a color reset to defaults)
* Remove all Layer Disables from the Mesh Core
* Turn on/off TD mode for all sliders
* Turn on/off millimeter labels for all active sliders.

Office Hours v0.9.0 UI Changes

2025-03-06T15:49:41Z

HueForge: Created page with "== Summary of UI Updates in HueForge == * The default layout has been updated to use toolbars instead of dock widgets. The old dock widgets were prone to crashing and difficult to recover if something went wrong. They also took up a lot of space. * Filament and model geometry remain in a dock due but don't take up much room. * The slider dock is optional and can be enabled in the Windows menu. The core now includes all the functions of the sliders that are needed. *..."

== Summary of UI Updates in HueForge ==

* The default layout has been updated to use toolbars instead of dock widgets. The old dock widgets were prone to crashing and difficult to recover if something went wrong. They also took up a lot of space.

* Filament and model geometry remain in a dock due but don't take up much room.
* The slider dock is optional and can be enabled in the Windows menu. The core now includes all the functions of the sliders that are needed.

* A very useable 1366x768 default layout is how HueForge will load the first time.

* The cores replace the slider functions. Transmission Distance of sliders (TDs) can be adjusted, and the millimeter height of each slider can be displayed for setting layer swaps in the slicer if you don't use the Describe file (which I don't).

* The filament library is no longer editable directly. To edit a filament, right-click on it and choose edit.

* You can now increase/decrease font size of the UI. This settings is per-computer and is reapplied at startup.

* The filament dialogue has added the ability to add tags to filaments.
* These tags are searchable and filterable.
* Gray filaments have a secret tag for both "gray" and "grey" spellings, ensuring they are searchable under either spelling.

* The filaments menu has a types menu that allows merging PLA and PLA+ into one tab.
* Unwanted tabs for filament types and brands can be turned off, with an option to show owned spools of hidden brands.
* You can hide filaments by type, brand, or type and brand.

* There is now a UI page that breaks down all the UI elements on the HueForge.wiki for v0.8.1 a version for v0.9.0 will come out at release.

* The previous Luminance option (where you switch between modes) is now called Mesh Mode.

* A lit rendering system has been added, allowing users to see how the image will look with lighting.
* The color and intensity of the light can be adjusted.
* The shininess of the filament will also affect the rendering.
* Filaments with names containing "Metallic", "Pearl", "Silk", "Starlight", or "Elixir" will automatically be rendered with appropriate shine.
* Filaments with Matte or Terra in their name will be rendered with less shine.
* Color Shifting effects for filaments like Starlights can be added.
* Lit Rendering should be considered experimental.

* Mesh height information has been moved to the Preview pane.

* Base thickness and blend depth have been added.
* Base thickness replaces minimum depth but functions differently by moving all layers up while keeping blend depth.
* Blend Depth replaces Max Depth and "floats" on top of Base Thickness. No more moving a bunch of sliders when changing Min Depth.

* Hovering over a layer will create a pulsing highlight the corresponding parts of the image on the mesh.

* There are now options for predicting glow-in-the-dark, fluorescent, and color-shifting filaments. These options should be considered experimental.
* The current system only supports one secondary effect per filament.
* The current prediction system only supports one kind of secondary effect for prediction unless they are widely spaced
* You may have multiple colors of glow, or fluorescence, etc, but not glow going into fluoro etc.

* There are now two CIELAB color matching algorithms:
* **CIELAB** (the original with bug fixes) which puts some extra weight on the brightness of the colors.
* **CIELAB 2**, which puts more weight on perceptual color. The differences are generally small, but can be impactful in some images.

* Holding down control and using the mouse wheel will move all sliders. This has been in but it bears repeating.

* Sliders can now be:
* Selected
* Copied
* Cut
* Pasted (insert or replace)
* Inverted
* All operations can be synchronized between cores so that changes in slider orders etc are shared. (Especially useful for experimenting with different color orders)

* A new feature allows saving Core Fragments, which are sets of sliders that can be saved and reused.
* Core Fragments are accessed using the S key
* You can paste fragments in with Overwrite (replace), Insert, or Merge mode. The footprint of the fragment is displayed on the affected core.

* A blend assistant has been added to help with CMYK color space blending. It does not use the HueForge filament blending algorithm, but can still assist in selecting filaments to achieve new colors.
* You set your source color by color picker (MacOS must use the native picker in the Color Dialog), or drag and drop then set the target color the same way and it will show both intermediate blends and colors you can use to achieve the target color.
* Right clicking on a swatch will give a sorted list (by Delta-E 2000) of the closest colors of filaments you own AND unowned filaments that might be a good match.

* There is now a pixel scaling option for pixel art images. This turns off any interpolation of the image when resizing.

* The configuration can now be managed, allowing users to:
* Move to whatever folder you want
* Use an existing configuration from another location like a shared cloud drive to use between multiple computers.
* Not all configuration is stored in the folder, some is saved in User settings on the system.

* Borders have been improved and bugs have been fixed.
* You may now choose from External Borders or Regular borders.
* External borders will not resize the image.
* Regular Borders will resize the major axis of the model to avoid cropping or distortion of the image.
* If you want to set the major axis to a specific size, use External borders and set the size to desired size - 2 times the border width
* Border sizes on all sides will be uniform.
* Borders now use less triangles.
* Height and Width labels now show a size in () that is the ACTUAL size of the model adjusted by any borders.

* Color Cores have controls between them to allow a set of new functions
* Replace all sliders on a core with the ones on the other core (Arrow buttons allow this to go either way)
* Reset all colors/disables on the sliders to defaults without removing the image (not a new project, just a color reset to defaults)
* Remove all Layer Disables from the Mesh Core
* Turn on/off TD mode for all sliders
* Turn on/off millimeter labels for all active sliders.

Video Summaries

2025-03-06T15:25:41Z

HueForge:

====[[v0.7.4 to v0.8.0 UI Changes]]====

====[[What does the Mesh Core Do?]]====

====[[Office Hours v0.9.0 UI Changes]]====

V0.7.4 to v0.8.0 UI Changes

2025-02-10T20:13:02Z

HueForge:

== Recap of YouTube Video: HueForge UI Updates (v0.7.4 - v0.8.0) ==
[https://youtu.be/UGeZdFy_oyk HueForge v0.7.4->v0.8.0 UI Changes]
=== Overview ===
This document summarizes the key user interface (UI) changes and new features introduced in HueForge between versions 0.7.4 and 0.8.0, as detailed in a recording of a live office hours session.

The primary focus is on the new '''Color Match''' functionality, along with improvements to file handling, image editing, and core workflows. The speaker emphasizes the importance of the new UI elements and provides a detailed breakdown of how to use them. Some bugs still exist and will be addressed in an upcoming hotfix. The emphasis is placed on a move towards smaller, more focused updates rather than large releases.

== Key Themes and Ideas ==

=== Enhanced Project Management ===
* '''Browse Projects''': Replaces the traditional "Open File" with a more visual '''Browse Projects''' (''Ctrl+B''), displaying project thumbnails for easy identification.
** Loads the last saved project folder and helps locate project folders.
* '''Browse Example Projects''': (''Ctrl + Shift + B'')
* '''Thumbnail Capture''': Thumbnails represent the view when the project is saved (including zoom level).
* '''Centralized Storage''': Log files and project files are now stored in a centralized location, streamlining file management.
* '''Project Images''': Project images can now be embedded within the project file, simplifying file sharing and reducing dependency on external PNG files.
** "You may save the image inside of the project file, which means you no longer have to worry about that PNG file."
* '''Exporting Project Images''': Project images can be extracted from project files for use in other applications.
** Exported images include edited images (bug fix pending).

=== Image Editing & Brightness Adjustments ===
* '''Edit Image Tool''': Adjusts brightness before color matching, preventing mesh modifications that affect colors.
* '''Brightness Adjustment Modes''':
** ''Alternate'': Applies a strong, blanket shift.
** ''Context-Aware'': Subtle brightness adjustments based on pixel values.
* '''Bright Adjust''': Now works directly on the image instead of the mesh for better results.

=== UI and Workflow Improvements ===
* '''Options Menu''':
** New options to save images inside project files.
** Display images at print size.
* '''Show Image at Print Size''': Displays prints at the correct resolution for better accuracy.
** "When using Color Match, it's easier to compare when the image resolution matches the print size."
* '''Preferences''':
** ''Use Image Size'': Imports images while preserving DPI settings.
** ''Load Image with Default Size'': Scales images to fit within a defined size upon import.
* '''Image Updates''':
** Detects changes in externally edited images and prompts users to reload.
* '''Slider UI Improvements''':
** Clarifies that vertical order, not left-to-right position, determines importance.
** "Sliders don’t matter left to right, but rather top to bottom."
** Filaments can be dragged directly onto the slider bar.
** ''Ctrl + Click'' (''Cmd + Click'' on macOS) allows slider movement.
* '''Hotkeys & Controls''':
** ''Alt + Letter'': Sorting, inverting, resetting, clearing history.
** ''Right-click'':
*** On a slider → Removes it.
*** On a region → Inverts it (only in Colorware Core).
* '''Core Switching''': Click directly on cores to switch them.

=== Color Aware & Color Match Core Functionality ===
* '''Colorware Region Control''':
** Regions are now interactive controls (e.g., inverting blends).
** Swapping white-to-black blending ensures smooth, continuous meshes.
* '''Mesh Core Enhancements''':
** Now displayed simultaneously with color cores for real-time color matching.
** Users can drag non-filament colors from images directly onto the mesh core.
* '''Finding Closest Filament''':
** Right-clicking a non-filament color in the mesh core suggests the closest filament match.
* '''Layer Disabling''':
** Disable layers with the ''D'' hotkey or by right-clicking to prevent matching with that layer.
* '''Slider Enhancements''':
** ''Locking'': Prevents accidental movement via mousewheel (''Ctrl/Alt + Mousewheel'').
** ''Zeroing'': Press ''Z'' to reset sliders to zero.
** ''TD Adjust'': Adjusts in increments of 0.5 via mousewheel.
* '''Color Replacement''': Dragging a filament color onto another retains TD values.

=== Color Match Algorithms & Adjustments ===
* Four Color Match Algorithms:
** ''CAB'': Most accurate but slowest.
** ''Default'': Balanced approach.
** ''HSL'': Best for hue-based matching.
** ''Dot Product'': Fastest but less precise.
* '''Spike Removal''':
** ''Moderate'' setting is best for Color Match but is slower.
* '''Stairstep Algorithm''':
** Creates a posterized effect in the luminance box.
* '''Bright Enhance''':
** Useful for enhancing midtones and suppressing artifacts.
** ''Algorithm 2'' is smoother and preferred.
* '''Color Shift''':
** Adjusts colors directly from the Color Match menu.

=== Other Features and Fixes ===
* '''TD1 Updates''':
** Option to back up the TD1 license to AppData local.
** Recovery option in case of corruption.
** Firmware update option (some bugs pending fixes).
* '''AMD Fix''':
** Compatibility mode for older AMD graphics cards (less efficient but stable).
** Adjust max triangles in the settings.
* '''Filament Library Overhaul (Upcoming)''':
** Plan to improve usability and allow disabling filaments.
* '''Hotfix Incoming''':
** Addresses various bugs and minor issues.

== Key Takeaways ==
* HueForge v0.8.0 significantly improves workflows, especially within Color Match.
* Users should familiarize themselves with new file management, image editing, and core-switching features.
* The '''Edit Image Tool''' and '''Layer Disabling''' provide better control over color blending and print outputs.
* '''Performance Considerations''': Different Color Match algorithms trade speed for accuracy.

This briefing provides an in-depth understanding of the key changes and how to utilize them in the new HueForge version.

What does the Mesh Core Do?

2025-02-10T20:07:44Z

HueForge:

== Briefing Document: HueForge Color Match Deep Dive ==

=== Introduction ===
This document summarizes key concepts, features, and workflows for using the Color Match feature within HueForge, based on two tutorial excerpts. The focus is on understanding how the '''Mesh Core''' functions to map colors and how to utilize various tools and techniques for effective color matching. These tutorials delve into both the practical, hands-on application of the tools and the more theoretical underpinnings of the color matching algorithms.

== Key Themes & Concepts ==

=== Mesh Core as a Custom Luminance Function ===
* The '''Mesh Core''' is not just a visual representation; it acts as a customizable luminance function that defines how colors in an image are mapped to the Z-height of a 3D print.
* The vertical ordering and layering of colors within the Mesh Core directly influence the print's appearance.
* "We're basically making a custom function to define where the heights of what colors are in the image."

=== Layering and Blending ===
* Color matching is approached as a '''layering problem''', where colors are blended rather than simply matched directly.
* Blending '''up''' (from light to dark) has seen significant improvements in recent versions.
* "Blending up means instead of thinking about blending down to a color... I'm planning on getting a darker and darker color above me..."

=== Color Matching Algorithms ===
* HueForge utilizes different color matching algorithms, with '''CIELAB''' currently being the most accurate.
* Testing different algorithms is crucial for achieving the best results.
* "...The CIELAB one is now by far the best. It's not always the one you're going to want to use, but it's by far the best."

=== TD (Thickness Depth) ===
* '''TD values''' control the thickness and blending of each color layer.
* They determine how smoothly one color fades into another.
* The '''T shortcut''' and mouse wheel can be used for quick TD adjustments.

=== Importance of Min Depth ===
* '''Min Depth''' is the bottom layer—'''all layers must be above this level'''.
* "...The bottom here is either the lowest slider or it is the layer below Min Depth."

=== Saturated Color Matching ===
* HueForge always matches to the '''lowest saturated layer''', which can sometimes yield unexpected results when matching dark colors.
* '''Disabling layers''' is an effective technique to manage this.
* "...Color match is always just going to match to the lowest value of that."

=== Filament Selection for Mesh Core ===
* The '''Mesh Core''' can be adjusted independently of filament selection.
* However, '''choosing the filament first''' and then copying to the Color Core makes matching easier.

=== Color Core as a Representation of Filament Colors ===
* Once the '''Mesh Core''' is set, it must be matched to the '''Color Core'''.
* The '''Color Core''' represents the actual filament colors and settings for the print.
* "...Now that we've actually set our Mesh Core, we need to match it to our Color Core."

=== Practical Workflow ===
A typical workflow for Color Match involves:
# Loading an image and switching to '''Color Match''' mode.
# Adjusting the '''Mesh Core''' to map colors to layers.
# Matching the '''Mesh Core''' colors to the '''Color Core''' (filament colors).
# Tweaking colors and placements for optimal blending and visual results.

=== Dynamic vs. Static Mode ===
* '''Static and dynamic modes''' are mostly inactive in Color Match mode.
* The '''top slider''' represents the '''highest Z-height''' in the 3D print.

=== Anti-Aliasing Issues ===
* Anti-aliasing in source images can create unwanted edges in Color Match.
* Using images '''without anti-aliasing''' can help reduce these problems.

=== Experimentation and Iteration ===
* '''Color Matching requires experimentation and iteration'''.
* Every action in Color Match involves trade-offs.
* "It's a trade-off game where you're trying to figure out what the best matches are that don’t take over where you don’t want them."

== Key Features and Functionality (from Tutorials) ==

=== Shortcuts ===
* '''Control/Command + Click + Drag''': Sample color from an image and drag onto a slider. Release '''Control/Command''' before dropping to match correctly.
* '''Z''': Set selected slider to zero.
* '''T + Mouse Wheel''': Adjust '''TD (Thickness Depth)''' of a slider.
* '''D (or Right Click)''': Disable a layer in Color Match.

=== Layout Customization ===
* Move and dock various controls (e.g., General Options, Lighting, Sliders) for an efficient workflow.

=== Layer Disabling ===
* Skipping layers in the matching algorithm allows for full saturation control.

=== Mesh View Flipping ===
* Flip between the model and mesh view using '''double-click, arrows, or buttons'''.

=== Browsing Projects ===
* HueForge allows browsing saved project files for easy access.

== Important Changes in v0.8.0-beta-2 ==

* '''TD Retention''': Dragging a color to a filament slider now retains the original filament's TD instead of defaulting to 1.
* '''Improved Blending Math''': Blending "up" calculations are now more accurate.

== Practical Tips from the Tutorials ==

* Start with '''real colors''' whenever possible to simplify adjustments later.
* Be mindful of '''color saturation''', particularly for dark colors and low layer heights.
* Consider the '''image context''' when stacking layers.
* Prioritize '''important edges'''—it may not be possible to perfect every detail.
* Test different '''Color Match algorithms''' to achieve the best results.
* Watch out for the '''anti-aliasing issue''' and how it affects prints.
* The '''CIELAB method''' is the best for Color Match, but '''Dot Product''' may be necessary when dealing with similar colors.

== Conclusion ==

These tutorials provide a strong foundation for understanding and utilizing the '''HueForge Color Match''' feature.

Key takeaways:
* The '''Mesh Core''' functions as a '''custom luminance function'''.
* '''Strategic layering''' of colors is essential for optimal blending.
* A range of tools and adjustments are available for fine-tuning.
* '''Success with Color Match requires understanding the principles, experimenting with different techniques, and iterative adjustments'''.

What does the Mesh Core Do?

2025-02-10T18:49:19Z

HueForge: Created page with "== Briefing Document: Hue Forge Color Match Deep Dive == === Introduction === This document summarizes key concepts, features, and workflows for using the Color Match feature within Hue Forge, based on two tutorial excerpts. The focus is on understanding how the '''Mesh Core''' functions to map colors and how to utilize various tools and techniques for effective color matching. These tutorials delve into both the practical, hands-on application of the tools and the more..."

== Briefing Document: Hue Forge Color Match Deep Dive ==

=== Introduction ===
This document summarizes key concepts, features, and workflows for using the Color Match feature within Hue Forge, based on two tutorial excerpts. The focus is on understanding how the '''Mesh Core''' functions to map colors and how to utilize various tools and techniques for effective color matching. These tutorials delve into both the practical, hands-on application of the tools and the more theoretical underpinnings of the color matching algorithms.

== Key Themes & Concepts ==

=== Mesh Core as a Custom Luminance Function ===
* The '''Mesh Core''' is not just a visual representation; it acts as a customizable luminance function that defines how colors in an image are mapped to the Z-height of a 3D print.
* The vertical ordering and layering of colors within the Mesh Core directly influence the print's appearance.
* "We're basically making a custom function to define where the heights of what colors are in the image."

=== Layering and Blending ===
* Color matching is approached as a '''layering problem''', where colors are blended rather than simply matched directly.
* Blending '''up''' (from light to dark) has seen significant improvements in recent versions.
* "Blending up means instead of thinking about blending down to a color... I'm planning on getting a darker and darker color above me..."

=== Color Matching Algorithms ===
* Hue Forge utilizes different color matching algorithms, with '''CIELAB''' currently being the most accurate.
* Testing different algorithms is crucial for achieving the best results.
* "...The CIELAB one is now by far the best. It's not always the one you're going to want to use, but it's by far the best."

=== TD (Thickness Depth) ===
* '''TD values''' control the thickness and blending of each color layer.
* They determine how smoothly one color fades into another.
* The '''T shortcut''' and mouse wheel can be used for quick TD adjustments.

=== Importance of Min Depth ===
* '''Min Depth''' is the bottom layer—'''all layers must be above this level'''.
* "...The bottom here is either the lowest slider or it is the layer below Min Depth."

=== Saturated Color Matching ===
* Hue Forge always matches to the '''lowest saturated layer''', which can sometimes yield unexpected results when matching dark colors.
* '''Disabling layers''' is an effective technique to manage this.
* "...Color match is always just going to match to the lowest value of that."

=== Filament Selection for Mesh Core ===
* The '''Mesh Core''' can be adjusted independently of filament selection.
* However, '''choosing the filament first''' and then copying to the Color Core makes matching easier.

=== Color Core as a Representation of Filament Colors ===
* Once the '''Mesh Core''' is set, it must be matched to the '''Color Core'''.
* The '''Color Core''' represents the actual filament colors and settings for the print.
* "...Now that we've actually set our Mesh Core, we need to match it to our Color Core."

=== Practical Workflow ===
A typical workflow for Color Match involves:
# Loading an image and switching to '''Color Match''' mode.
# Adjusting the '''Mesh Core''' to map colors to layers.
# Matching the '''Mesh Core''' colors to the '''Color Core''' (filament colors).
# Tweaking colors and placements for optimal blending and visual results.

=== Dynamic vs. Static Mode ===
* '''Static and dynamic modes''' are mostly inactive in Color Match mode.
* The '''top slider''' represents the '''highest Z-height''' in the 3D print.

=== Anti-Aliasing Issues ===
* Anti-aliasing in source images can create unwanted edges in Color Match.
* Using images '''without anti-aliasing''' can help reduce these problems.

=== Experimentation and Iteration ===
* '''Color Matching requires experimentation and iteration'''.
* Every action in Color Match involves trade-offs.
* "It's a trade-off game where you're trying to figure out what the best matches are that don’t take over where you don’t want them."

== Key Features and Functionality (from Tutorials) ==

=== Shortcuts ===
* '''Control/Command + Click + Drag''': Sample color from an image and drag onto a slider. Release '''Control/Command''' before dropping to match correctly.
* '''Z''': Set selected slider to zero.
* '''T + Mouse Wheel''': Adjust '''TD (Thickness Depth)''' of a slider.
* '''D (or Right Click)''': Disable a layer in Color Match.

=== Layout Customization ===
* Move and dock various controls (e.g., General Options, Lighting, Sliders) for an efficient workflow.

=== Layer Disabling ===
* Skipping layers in the matching algorithm allows for full saturation control.

=== Mesh View Flipping ===
* Flip between the model and mesh view using '''double-click, arrows, or buttons'''.

=== Browsing Projects ===
* Hue Forge allows browsing saved project files for easy access.

== Important Changes in v0.8.0-beta-2 ==

* '''TD Retention''': Dragging a color to a filament slider now retains the original filament's TD instead of defaulting to 1.
* '''Improved Blending Math''': Blending "up" calculations are now more accurate.

== Practical Tips from the Tutorials ==

* Start with '''real colors''' whenever possible to simplify adjustments later.
* Be mindful of '''color saturation''', particularly for dark colors and low layer heights.
* Consider the '''image context''' when stacking layers.
* Prioritize '''important edges'''—it may not be possible to perfect every detail.
* Test different '''Color Match algorithms''' to achieve the best results.
* Watch out for the '''anti-aliasing issue''' and how it affects prints.
* The '''CIELAB method''' is the best for Color Match, but '''Dot Product''' may be necessary when dealing with similar colors.

== Conclusion ==

These tutorials provide a strong foundation for understanding and utilizing the '''Hue Forge Color Match''' feature.

Key takeaways:
* The '''Mesh Core''' functions as a '''custom luminance function'''.
* '''Strategic layering''' of colors is essential for optimal blending.
* A range of tools and adjustments are available for fine-tuning.
* '''Success with Color Match requires understanding the principles, experimenting with different techniques, and iterative adjustments'''.

{{Note|NotebookLM can be inaccurate; please double-check its responses.}}

Video Summaries

2025-02-10T18:49:10Z

HueForge: Created page with "====v0.7.4 to v0.8.0 UI Changes==== ====What does the Mesh Core Do?===="

====[[v0.7.4 to v0.8.0 UI Changes]]====

====[[What does the Mesh Core Do?]]====

Main Page

2025-02-10T18:48:31Z

HueForge:

[[File:Main_image001.png|480px|thumb|center|HueForge Example]]

===[[Common Terms]]===

===[[How To Pages]]===

===[[TD-1]]===

===[[FAQ]]===

===[[Printer Profiles]]===

===[[Troubleshooting]]===

===[[HueForge Hotkeys]]===

===[[HueForge Controls]]===

===[[Video Summaries]]===

V0.7.4 to v0.8.0 UI Changes

2025-02-10T18:42:51Z

HueForge:

== Briefing Document: HueForge UI Updates (v0.7.4 - v0.8.0) ==

=== Overview ===
This document summarizes the key user interface (UI) changes and new features introduced in HueForge between versions 0.7.4 and 0.8.0, as detailed in a recording of a live office hours session.

The primary focus is on the new '''Color Match''' functionality, along with improvements to file handling, image editing, and core workflows. The speaker emphasizes the importance of the new UI elements and provides a detailed breakdown of how to use them. Some bugs still exist and will be addressed in an upcoming hotfix. The emphasis is placed on a move towards smaller, more focused updates rather than large releases.

== Key Themes and Ideas ==

=== Enhanced Project Management ===
* '''Browse Projects''': Replaces the traditional "Open File" with a more visual '''Browse Projects''' (''Ctrl+B''), displaying project thumbnails for easy identification.
** Loads the last saved project folder and helps locate project folders.
* '''Browse Example Projects''': (''Ctrl + Shift + B'')
* '''Thumbnail Capture''': Thumbnails represent the view when the project is saved (including zoom level).
* '''Centralized Storage''': Log files and project files are now stored in a centralized location, streamlining file management.
* '''Project Images''': Project images can now be embedded within the project file, simplifying file sharing and reducing dependency on external PNG files.
** "You may save the image inside of the project file, which means you no longer have to worry about that PNG file."
* '''Exporting Project Images''': Project images can be extracted from project files for use in other applications.
** Exported images include edited images (bug fix pending).

=== Image Editing & Brightness Adjustments ===
* '''Edit Image Tool''': Adjusts brightness before color matching, preventing mesh modifications that affect colors.
* '''Brightness Adjustment Modes''':
** ''Alternate'': Applies a strong, blanket shift.
** ''Context-Aware'': Subtle brightness adjustments based on pixel values.
* '''Bright Adjust''': Now works directly on the image instead of the mesh for better results.

=== UI and Workflow Improvements ===
* '''Options Menu''':
** New options to save images inside project files.
** Display images at print size.
* '''Show Image at Print Size''': Displays prints at the correct resolution for better accuracy.
** "When using Color Match, it's easier to compare when the image resolution matches the print size."
* '''Preferences''':
** ''Use Image Size'': Imports images while preserving DPI settings.
** ''Load Image with Default Size'': Scales images to fit within a defined size upon import.
* '''Image Updates''':
** Detects changes in externally edited images and prompts users to reload.
* '''Slider UI Improvements''':
** Clarifies that vertical order, not left-to-right position, determines importance.
** "Sliders don’t matter left to right, but rather top to bottom."
** Filaments can be dragged directly onto the slider bar.
** ''Ctrl + Click'' (''Cmd + Click'' on macOS) allows slider movement.
* '''Hotkeys & Controls''':
** ''Alt + Letter'': Sorting, inverting, resetting, clearing history.
** ''Right-click'':
*** On a slider → Removes it.
*** On a region → Inverts it (only in Colorware Core).
* '''Core Switching''': Click directly on cores to switch them.

=== Color Aware & Color Match Core Functionality ===
* '''Colorware Region Control''':
** Regions are now interactive controls (e.g., inverting blends).
** Swapping white-to-black blending ensures smooth, continuous meshes.
* '''Mesh Core Enhancements''':
** Now displayed simultaneously with color cores for real-time color matching.
** Users can drag non-filament colors from images directly onto the mesh core.
* '''Finding Closest Filament''':
** Right-clicking a non-filament color in the mesh core suggests the closest filament match.
* '''Layer Disabling''':
** Disable layers with the ''D'' hotkey or by right-clicking to prevent matching with that layer.
* '''Slider Enhancements''':
** ''Locking'': Prevents accidental movement via mousewheel (''Ctrl/Alt + Mousewheel'').
** ''Zeroing'': Press ''Z'' to reset sliders to zero.
** ''TD Adjust'': Adjusts in increments of 0.5 via mousewheel.
* '''Color Replacement''': Dragging a filament color onto another retains TD values.

=== Color Match Algorithms & Adjustments ===
* Four Color Match Algorithms:
** ''CAB'': Most accurate but slowest.
** ''Default'': Balanced approach.
** ''HSL'': Best for hue-based matching.
** ''Dot Product'': Fastest but less precise.
* '''Spike Removal''':
** ''Moderate'' setting is best for Color Match but is slower.
* '''Stairstep Algorithm''':
** Creates a posterized effect in the luminance box.
* '''Bright Enhance''':
** Useful for enhancing midtones and suppressing artifacts.
** ''Algorithm 2'' is smoother and preferred.
* '''Color Shift''':
** Adjusts colors directly from the Color Match menu.

=== Other Features and Fixes ===
* '''TD1 Updates''':
** Option to back up the TD1 license to AppData local.
** Recovery option in case of corruption.
** Firmware update option (some bugs pending fixes).
* '''AMD Fix''':
** Compatibility mode for older AMD graphics cards (less efficient but stable).
** Adjust max triangles in the settings.
* '''Filament Library Overhaul (Upcoming)''':
** Plan to improve usability and allow disabling filaments.
* '''Hotfix Incoming''':
** Addresses various bugs and minor issues.

== Key Takeaways ==
* HueForge v0.8.0 significantly improves workflows, especially within Color Match.
* Users should familiarize themselves with new file management, image editing, and core-switching features.
* The '''Edit Image Tool''' and '''Layer Disabling''' provide better control over color blending and print outputs.
* '''Performance Considerations''': Different Color Match algorithms trade speed for accuracy.

This briefing provides an in-depth understanding of the key changes and how to utilize them in the new HueForge version.

V0.7.4 to v0.8.0 UI Changes

2025-02-10T17:51:43Z

HueForge: Created page with "Summary: HueForge UI Updates (v0.7.4 - v0.8.0) Overview: This document summarizes the key user interface (UI) changes and new features introduced in HueForge between versions 0.7.4 and 0.8.0, as detailed in a recording of a live office hours session. The primary focus is on the new "Color Match" functionality, along with improvements to file handling, image editing, and core workflows. The speaker emphasizes the importance of the new UI elements and provides a detailed..."

Summary: HueForge UI Updates (v0.7.4 - v0.8.0)

Overview:

This document summarizes the key user interface (UI) changes and new features introduced in HueForge between versions 0.7.4 and 0.8.0, as detailed in a recording of a live office hours session. The primary focus is on the new "Color Match" functionality, along with improvements to file handling, image editing, and core workflows. The speaker emphasizes the importance of the new UI elements and provides a detailed breakdown of how to use them. He notes that some bugs still exist and will be addressed in an upcoming hotfix. The emphasis is placed on a move towards smaller, more focused updates rather than large releases.

Key Themes and Ideas:

Enhanced Project Management:
Browse Projects: Replaces the traditional "Open File" with a more visual "Browse Projects" (Ctrl+B), displaying project thumbnails for easy identification. This feature loads the last saved project folder and also helps find the project folders.
Browse Example Projects: (Ctrl + Shift + B)
Thumbnail Capture: Thumbnails represent the view when the project is saved (including zoom level). This helps users better remember projects.
Centralized Storage: Log files and project files are now stored in a centralized location, streamlining file management.
Project Images: Project images can now be embedded within the project file, simplifying file sharing and reducing dependency on external PNG files.
"you may save image inside of the project file which means you no longer have to worry about that PNG file it doesn't get renamed the project it just gets encoded and put inside the project file"
Exporting Project Images: Project images can be exported from project files, useful for extracting images from shared projects or for use in other applications. Also can export edited images, though a bug was discovered here and will be fixed.
Image Editing & Brightness Adjustments:
"Edit Image" Tool: Introduced to address how brightness compensation works within color match. Rather than altering the mesh itself (which would affect colors), the image is edited beforehand.
Alternate & Content-Aware Modes: Two brightness adjustment modes exist: "alternate" (a stronger, blanket shift) and a context-sensitive mode (adjusting brightness more subtly based on pixel values).
"one of them is kind of context sensitive to what the actual pixel values are and the other one is not and is more blanket"
Bright Adjust: The Bright Adjust tool works better now on the image itself rather than the mesh, and is preferred.
UI and Workflow Improvements
Options Menu: New options related to saving the image inside the project file and displaying images at print size.
Show Image at Print Size: Will show the print at the resolution equal to the print size, allowing for better understanding of how it will actually print.
"when you're trying trying to find in color match like why this spot here is not rendering at the same height that you think that it should...it's easier to find it if your image is exactly the same resolution as this image or as the sorry as the actual print"
Preferences: Several new options added to preferences, including "Use image size" and "Load image with default size".
"if youve set your image up to be a particular size and you want it to fit in into some particular print...this is great you use the image size and it'll actually bring in the image and respect that DPI setting"
The "Load Image with Default Size" option scales images to fit within a defined size during import and is recommended for general use.
Image Updates: Hueforge will check for image updates in external image editors and prompts the user if an update to the loaded image is available. Options are given on whether or not to auto-reload.
Slider Handles: The UI has been updated to make it clearer that the vertical order of sliders is what matters not their left-to-right position.
"the sliders don't matter from left to right it doesn't matter what order they are left to right it matters what order they are top to bottom"
Direct Filament Drag: Filaments can be dragged directly onto the slider bar.
Slider Manipulation: Control+click (Command+click on macOS) allows for moving sliders. Alt+letter shortcuts on the slider area are for sorting, inverting, resetting, and clearing the slider history. Right-clicking a slider now makes it disappear, while right-clicking a slider region can be used for inverting that region (only when on the colorware core.)
Core Switching: Cores are now switched by clicking directly on them.
Color Aware & Color Match Core Functionality:
Colorware Region Control: In the colorware core, the regions themselves are now also controls, where they can be inverted. This will swap the blending so the white is on the bottom and black on top, allowing users to get smooth continuous meshes.
Mesh Core: Mesh cores are now shown simultaneously with color cores so that users can see what colors are being matched in real time. Non-filament colors can be dragged from the image itself onto the mesh core.
Finding Closest Filament: Right-clicking a non-filament color on the mesh core allows users to find the closest matching filament color from their library.
Layer Disabling: Layers can be disabled using the "D" hotkey or by right-clicking on a layer itself, to tell color match not to match to that particular layer. This is helpful for fine-tuning outputs and making sure black is on top in silouette images.
"what it says to color match is you can't match to this layer so the layer will still be printed but it will never be um picked to be the top of the mesh"
Slider Locking: Sliders can be locked to prevent accidental movement via the mousewheel or control/alt + mouse wheel
Slider Zeroing: Sliders can be brought to zero with the Z hotkey.
TD Adjust: TD can be adjusted using the mouse wheel in increments of 0.5.
Color Replacement: Filament color can be replaced by dragging a different filament color onto the slider, while retaining the TD from the original color.
Color Match Algorithms: Four color match algorithms are provided (CAB, Default, HSL, and Dot Product), each with different strengths and weaknesses. CAB is generally considered the best but slowest, while dot product is the fastest and is often good for similar shades.
Spike Removal: The "moderate" spike removal setting is often the best for color match, but is also the slowest.
Stairstep Algorithm: A "stairstep" algorithm is available in the luminance box for creating a posterized effect.
Bright Enhance: Bright Enhance and Midtone enhance/supress are suggested for use on color match images for good results. Algorithm 2 is generally smoother and preferred.
Color Shift: A color shift function is available in the color match menu, which will apply to the image.
Other Features and Fixes:
TD1 updates: There is now an option to backup the license for the TD1 to app data local, and a recovery option in case of corruption. There is also an option to update the firmware via downloaded file, though some bugs are present and will be fixed.
AMD Fix: An option is available for users with older AMD graphics cards, which forces it to use a less efficient but more compatible method. The max number of triangles can now be adjusted in the same menu.
Filament Library: The filament library is still due for an overhaul. The speaker wants to make it easier to use, and allow for turning off filaments.
Hotfix: A hotfix is planned to address various bugs and minor issues discovered in this update.
Key Takeaways:

HueForge v0.8.0 brings significant changes focused on improving workflows and adding advanced control, especially within Color Match.
Users should familiarize themselves with the new file management, image editing, and core-switching mechanisms.
The "Edit Image" tool and layer disabling functionality provide more control over color blending and print outputs.
Performance considerations may influence the selection of color match algorithms.
This briefing should provide a good understanding of the key changes and how to use them within the new HueForge version.

Main Page

2025-02-10T17:03:51Z

HueForge: /* Video Summaries */

Main Page

2025-02-10T17:03:16Z

HueForge:

Main Page

2025-02-10T17:02:01Z

HueForge: /* Video Summaries */

Main Page

2025-02-10T17:00:46Z

HueForge:

HueForge Hotkeys

2024-11-22T04:37:11Z

HueForge:

=Hotkeys By Category=
==File Menu==
Ctrl+O : Open Project 
Ctrl+I : Open Image 
Ctrl+Alt+I : Reload Image 
Ctrl+Alt+O : Reload Project 
Ctrl+B : Browse Projects (with thumbnails) 
Ctrl+Shift+B : Browse Example Projects 
Ctrl+S : Save Project 
Ctrl+Shift+S : Save Project As 
Ctrl+E : Export STL 
Ctrl+C : Close Project and reset to defaults 
Ctrl+Q : Quit HueForge 
Ctrl+Z : Undo 
Ctrl+Y : Redo 

==General HueForge==
Ctrl+Shift+I : Launch a new instance 
Alt+F : Select Filament Filter box 
Alt+S : Sort Sliders 
Alt+I : Invert Sliders 
Alt+H : Clear Slider History 
r : Reset View (v0.8.1) 

==Color Sliders==
Space : Disable Slider (when hovering over) 
Up/Down Arrows : Move Current Slider up/down 
Left/Right Arrows : Select Slider to Left/Right in the Slider Dock 

==Color/Mesh Core==
, or < : Make Color Core Active (v0.8.1) 
. or > : Make Mesh Core Active (v0.8.1) 
Space : Enable/Disable Slider 
l : Lock Slider in place will only move when dragged 
t : Toggle Slider Handle to display TD/layer value, Mousewheel can adjust TD by 0.5mm increments when TD is displayed 
z : Zero the slider under the mouse 
Up/Down Arrows : Move slider up/down 
Ctrl+Up/Down Arrows : Move slider and all unlocked sliders above it up and down 
Alt+Up/Down Arrows : Move slider all unlocked sliders below it up and down 
d : Disable a layer on the Mesh Core to make it unavailable for matching

Printer Profiles

2024-11-21T17:45:48Z

HueForge:

Copy preset into notepad, save with .json extension. Import into Bambu Studio by going to File -> Import -> Import Configs...

Note: "zig-zag" is what BambuStudio calls Rectilinear.
=== BambuLab P1S/X1C 0.08mm HueForge preset. ===
<pre>
{
"bottom_shell_layers": "999",
"bottom_surface_pattern": "zig-zag",
"detect_narrow_internal_solid_infill": "0",
"enable_overhang_speed": "0",
"enable_prime_tower": "0",
"ensure_vertical_shell_thickness": "0",
"from": "User",
"inherits": "0.08mm Extra Fine @BBL X1C",
"initial_layer_print_height": "0.2
",
"initial_layer_speed": "60",
"inner_wall_speed": "250",
"internal_solid_infill_speed": "150",
"is_custom_defined": "0",
"name": "HueForge - 0.08mm - Classic Walls",
"outer_wall_speed": "250",
"print_settings_id": "HueForge - 0.08mm - Classic Walls",
"slice_closing_radius": "0.1",
"sparse_infill_density": "100%",
"sparse_infill_pattern": "zig-zag",
"sparse_infill_speed": "150",
"top_shell_layers": "1",
"top_shell_thickness": "0",
"top_surface_pattern": "monotonic",
"top_surface_speed": "150",
"version": "1.8.0.25",
"wall_loops": "1"
}
</pre>

=== BambuLab P1S/X1C 0.04mm HueForge preset. ===
<pre>
{
"bottom_shell_layers": "999",
"bottom_surface_pattern": "zig-zag",
"detect_narrow_internal_solid_infill": "0",
"detect_thin_wall": "1",
"enable_overhang_speed": "0",
"enable_prime_tower": "0",
"ensure_vertical_shell_thickness": "0",
"from": "User",
"gap_infill_speed": "200",
"inherits": "0.08mm Extra Fine @BBL X1C",
"initial_layer_print_height": "0.2",
"inner_wall_speed": "200",
"internal_solid_infill_pattern": "alignedrectilinear",
"internal_solid_infill_speed": "150",
"layer_height": "0.04",
"min_bead_width": "50%",
"min_feature_size": "10%",
"name": "Hue Forge - 0.04mm",
"print_settings_id": "Hue Forge - 0.04mm",
"slice_closing_radius": "0",
"sparse_infill_density": "100%",
"sparse_infill_pattern": "zig-zag",
"sparse_infill_speed": "150",
"top_shell_layers": "1",
"top_shell_thickness": "0",
"top_surface_speed": "150",
"version": "1.8.0.25",
"wall_generator": "arachne",
"wall_loops": "1"
}
</pre>

HueForge Hotkeys

2024-11-20T16:33:09Z

HueForge:

=Hotkeys By Category=
==File Menu==
Ctrl+O : Open Project 
Ctrl+I : Open Image 
Ctrl+Alt+I : Reload Image 
Ctrl+Alt+O : Reload Project 
Ctrl+B : Browse Projects (with thumbnails) 
Ctrl+Shift+B : Browse Example Projects 
Ctrl+S : Save Project 
Ctrl+Shift+S : Save Project As 
Ctrl+E : Export STL 
Ctrl+C : Close Project and reset to defaults 
Ctrl+Q : Quit HueForge 
Ctrl+Z : Undo 
Ctrl+Y : Redo 

==General HueForge==
Ctrl+Shift+I : Launch a new instance 
Alt+F : Select Filament Filter box 
Alt+S : Sort Sliders 
Alt+I : Invert Sliders 
Alt+H : Clear Slider History 
R : Reset View 

==Color Sliders==
Space : Disable Slider (when hovering over) 
Up/Down Arrows : Move Current Slider up/down 
Left/Right Arrows : Select Slider to Left/Right in the Slider Dock 

==Color/Mesh Core==
, or < : Make Color Core Active 
. or > : Make Mesh Core Active 
Space : Enable/Disable Slider 
l : Lock Slider in place will only move when dragged 
t : Toggle Slider Handle to display TD/layer value, Mousewheel can adjust TD by 0.5mm increments when TD is displayed 
z : Zero the slider under the mouse 
Up/Down Arrows : Move slider up/down 
Ctrl+Up/Down Arrows : Move slider and all unlocked sliders above it up and down 
Alt+Up/Down Arrows : Move slider all unlocked sliders below it up and down 
d : Disable a layer on the Mesh Core to make it unavailable for matching

HueForge Hotkeys

2024-11-20T16:30:59Z

HueForge: Created page with "=Hotkeys By Category= ==File Menu== Ctrl+O : Open Project Ctrl+I : Open Image Ctrl+Alt+I : Reload Image Ctrl+Alt+O : Reload Project Ctrl+B : Browse Projects (with thumbnails) Ctrl+Shift+B : Browse Example Projects Ctrl+S : Save Project Ctrl+Shift+S : Save Project As Ctrl+E : Export STL Ctrl+C : Close Project and reset to defaults Ctrl+Q : Quit HueForge Ctrl+Z : Undo Ctrl+Y : Redo ==General HueForge== Ctrl+Shift+I : Launch a new instance Alt+F : Select Filament Filter bo..."

=Hotkeys By Category=
==File Menu==
Ctrl+O : Open Project
Ctrl+I : Open Image
Ctrl+Alt+I : Reload Image
Ctrl+Alt+O : Reload Project
Ctrl+B : Browse Projects (with thumbnails)
Ctrl+Shift+B : Browse Example Projects
Ctrl+S : Save Project
Ctrl+Shift+S : Save Project As
Ctrl+E : Export STL
Ctrl+C : Close Project and reset to defaults
Ctrl+Q : Quit HueForge
Ctrl+Z : Undo
Ctrl+Y : Redo

==General HueForge==
Ctrl+Shift+I : Launch a new instance
Alt+F : Select Filament Filter box
Alt+S : Sort Sliders
Alt+I : Invert Sliders
Alt+H : Clear Slider History
R : Reset View

==Color Sliders==
Space : Disable Slider (when hovering over)
Up/Down Arrows : Move Current Slider up/down
Left/Right Arrows : Select Slider to Left/Right in the Slider Dock

==Color/Mesh Core==
, or < : Make Color Core Active
. or > : Make Mesh Core Active
Space : Enable/Disable Slider
l : Lock Slider in place will only move when dragged
t : Toggle Slider Handle to display TD/layer value, Mousewheel can adjust TD by 0.5mm increments when TD is displayed
z : Zero the slider under the mouse
Up/Down Arrows : Move slider up/down
Ctrl+Up/Down Arrows : Move slider and all unlocked sliders above it up and down
Alt+Up/Down Arrows : Move slider all unlocked sliders below it up and down
d : Disable a layer on the Mesh Core to make it unavailable for matching

Main Page

2024-11-20T16:17:50Z

HueForge:

Troubleshooting

2024-11-20T16:03:04Z

HueForge: Created page with "=Common Issues= ==On MacOS I cannot Drag-and-Drop== On MacOS, instead of Control, use the Command Key. But after getting your drag started, release the Command key or you will not be able to drop. If you are already over the area you want to drop, you will need to release Command, then leave the area and re-enter to be able to drop. ==On Windows, I added an Image and there isn't a Prediction on the left side of the screen== This is caused by your AMD Graphics Card. I..."

=Common Issues=

==On MacOS I cannot Drag-and-Drop==
On MacOS, instead of Control, use the Command Key. But after getting your drag started, release the Command key or you will not be able to drop. If you are already over the area you want to drop, you will need to release Command, then leave the area and re-enter to be able to drop.

==On Windows, I added an Image and there isn't a Prediction on the left side of the screen==
This is caused by your AMD Graphics Card.
If possible, go to the AMD website and update your graphics driver.

If you card is too old and cannot be updated, then go to the Preferences->Older AMD Compatibility option and check it. It will give you some instructions to increase the number of triangles you allow in File->Settings. Do this and then Apply Settings.

Once you have done this, reload the image and you will get a prediction.

Main Page

2024-11-20T15:58:36Z

HueForge:

[[File:Main_image001.png|480px|thumb|center|HueForge Example]]

===[[Common Terms]]===

===[[How To Pages]]===

===[[TD-1]]===

===[[FAQ]]===

===[[Printer Profiles]]===

===[[Troubleshooting]]===

Common Terms

2024-09-10T10:47:51Z

HueForge:

=Common HueForge Terms=

==Blending Down==
This is the traditional way of using HueForge. Darker colors on the bottom with the lighter colors on the top. Your blending is always referencing the colors below the current layer. The benefit of this mode is that darker colors tend to have lower [[#Transmission Distance (TD)]] and do not blend well, where brighter colors are available in higher TDs and can be blended providing shadows. This makes the filament requirements for blending much simpler. The drawback is primarily in modes like Color Pop and Color Aware. Since each section is it's own HueForge, the top of each section often has a white which will show on the edges of the print below the black of the next section.

==Blending Up==
In [[#Standard Luminance]] mode, filaments are blended "down" to darker base layers (most commonly black). Blending up reverses this and puts the lighter colors at the bottom and the darker color at the top. This generally requires either a high TD dark shade, or multiple shades of a color to allow smooth color blending. The benefit is the black layer is generally shared with the next section and there will not be any white lip around the base of the next layer (see [Rebasing]). Blending up is common in [[#Color Match]] but can also be used in [[#Color Pop]] and [[#Color Aware]] using [[#Split Image]] or [[#Invert Region]]

==Color Aware==
Color Aware is a [[#Luminance Mode]] that splits the HueForge mesh into 3 sections by "color". (See [[Color_Aware]] for a basic How To guide) The colors are defined by the RGB color channels red, green, and blue. Color is picked by which color channel has the maximum value. Ties go to red, and if [[#Tolerance]] is 0, grayscale will go into blue unless there is a [[#Color Shift]]. This lets users separate color regions in images by color though sometimes the groupings are not ideal for the image. For instance yellow is in the red bucket, but often conflicts with skin tones or needs to blend smoothly with greens for leaves/plants.
Using the CA Presets can also allow users to effectively remove one of the three ranges from the image when your image is primarily just two colors, though this is currently a byproduct of applying specific settings and is not a true removal of the third color space.

==Color Core==
The color core, in the middle of the HueForge display, is a visual representation of each layer in a HueForge print and how they blend. This reference will show in real-time the way moving color sliders will affect the colors of various layers in the mesh.
In v0.8.0 (currently Beta only) the Color Core gains slider flags which allow direct manipulation of the sliders on the Color Core and the ability to drop a color at a specific layer instead of just on a new slider.

==Color Match==
Currently in Beta release (Commercial License holders only), Color Match effectively lets users create their own "Luminance" function that is defined by color. When Color Match is selected, a new Color Core (called the Mesh Core) will be created. If this is the first time, the filaments on the Color Core will be copied onto the Mesh Core.

Toggling [[#Shown Colors]] will switch which Core is being used to predict mesh visualization (the left side image). This allows a user to use the Mesh Core to create a custom luminance stack by placing colors on the mesh core (either filaments or colors pulled from the image itself using Ctrl+Left-Click and Drag (or Command+Left-Click on MacOS - you must release Cmd after the drag has started to allow dropping)). HueForge will then go pixel-by-pixel and find the best color match on the Mesh Core and make that pixel location the correct height to show that color when printed. This process will build a mesh that can then be colored by switching Shown Colors to the Color Core and applying Filaments. It is not recommended to apply [[#Image Colors]] to the Color Core since they do not represent real filaments and you will not be able to print with them.

Color Match allows for many more "Color Bins" than [[#Color Aware]] but it can still be difficult to distinguish all colors. Highlights in particular often bleed between color regions on the Mesh Core. Also the user should be aware that human color perception is extremely contextual and if you are having a hard time making a color match with filaments, you should grab the [[#Image Color]] and you will often be surprised by what the actual color is.

In Color Match, the [[#Combo Slider]] allows the user to add an upward or downward weighing on color matching. Values above 0.5 will weight matching upwards in the Mesh Core, and values below 0.5 will weight them downwards. This weighting is for all colors.

==Color Pop==
(Set [[Color Pop]] for a basic How To guide)
The [[#Luminance Mode]] splits the image into two regions. One is defined as Grayscale and the other as Color. Grayscale is defined by setting the [[#Tolerance]] and the location of the split is defined by the [[#Combo Slider]] on the far right of the Model Geometry Dock. There are currently some bugs related to the split location indicator and you may need to move it up and down to get the display to properly reset.

A typical Color Pop image is mostly black and white with small, concentrated regions of often just a single color. These images are impossible to recreate in [[#Standard Luminance]] because the grayscale covers the entire luminance scale, and the color is necessarily in the middle of that same scale so your midtone grays become shades of the desired color along with the color regions.

To combat this, HueForge identifies grayscale regions and color regions and turns them into two separate luminance regions stacked on top of each other. You are then free to blend them separately. But it is highly recommended that you [[#Rebase]] the upper region.

==Color Shift==
Color Shifting is available in [[#Color Match]] and [[#Color Aware]] as a spin box next to the color box icons. It allows for adding or subtracting values globally from a given color channel in the image. This can be very useful for moving colors which straddle the border of two color bins into just one of them. A yellow that alternates between red and green for instance. Also commonly Black and White need color shifting to settle into a single bin. This can also be used to shift grayscale (at 0 [[#Tolerance]]) into either the red or green color bins from the default blue.

Some images benefit more from localized color shifting in an image editor to bring small regions of the image fully into a specific bin. This is currently outside the scope of HueForge.

==Combo Slider==
The far right hand side of the Model Geometry dock has an enigmatic slider. This slider originally had a single function. In [[#Combo Luminance]], it allows for weighted mixing between [[#Standard Luminance]] and [[#Max Channel Luminance]] modes. This was very useful when there weren't any color sensitive luminance modes, but is not much used now.
Since then, other [[#Luminance Modes]] also make use of this slider. Specifically [[#Color Pop]] and [[#Color Match]] make use of it.

==Invert Region==
(v0.8.0 Beta only)
In Color Aware, you can right click on one of the color regions next to the Color Core and choose "Invert Region" which will flip the order of the mesh for that color region and show this on the region indicator as well. This can be used to smooth the blending between regions.

==Luminance Modes==
HueForge currently supports these Luminance Modes
[[#Standard Luminance]]
[[#Max Channel Luminance]]
[[#Combo Luminance]]
Scaled Max Channel Luminance
[[#Color Aware]]
[[#Color Pop]]
[[#Color Match]] (Beta Only)

==Max Channel Luminance==
A simplified luminance value which looks at the value of only one color channel, the channel with the maximum value, and uses it to set the luminance with the function Channel Value/255.0.

==Mesh==
HueForge generates a triangular mesh based on the source image and Luminance function. That mesh is displayed to the left of the source image (in the middle of the screen most of the time). You can rotate and move the mesh or turn on the Wireframe mode to see the triangles that make it up. This mesh is manipulated by quite a few controls and updates in real-time and is used to create the color prediction. The image generated part of the mesh starts at Min Depth and goes to Actual Depth which is constrained by Max Depth (it can be a layer taller than Max Depth in some situations). Anything below Min Depth is solid, though you can still blend colors in the Min Depth region.

==Rebasing==
The process of adding a new black (or other dark color) midway up the Color Core in modes like [[#Color Pop]] or [[#Color Aware]] at the start of the next region to bring back shadows and depth to the next region.

==Split Image==
In [[#Color Pop]] for version 0.7.1 on and [[#Color Aware]] in version v0.7.x the Negative button in the General Options dock will turn into Split Image. This option will negate the bottom most region of the mesh (grayscale by default for Color Pop and Blue by default for Color Aware) and make it inverted in color order.

==Standard Luminance==
The standard luminance model is a visual model which attempts to map colors to human perceptions of brightness. This is the model use for making lithophanes and as such was the first model used to build HueForge meshes. The default HueForge Luminance mode is [[#Combo Luminance]] which is a mixture between Standard Luminance and [[#Max Channel Luminance]] but with the weight set to 100% Standard Luminance on the [[#Combo Slider]]. In this mode, colors with overlapping luminance values will be impossible to separate, but if your image is shades of the same colors (fire for instance) or grayscale, it will work beautifully. There are still a large number of images which work well in Standard mode.

==Transmission Distance (TD)==
A measurement in millimeters of how thick a solid block of filament needs to be to block 95%+ of light from passing through.
This is also referred to commonly as TD. This measurement is fundamental to how HueForge calculates how filaments blend.

==Tolerance==
Strict Grayscale is defined by colors with exactly the same values in their RGB channels. However in practice, many "grayscale" images are color shifted slightly to be warmer or cooler as the subject matter warrants. As a result, in modes like [[#Color Pop]], it can be hard for HueForge to correctly separate Grayscale from Color. To allow this, HueForge has a Tolerance slider. This slider allows the user to expand the definition of Grayscale to include more colors. The tolerance number is the amount of counts the individual color channels can differ. In general this should be as low as possible while still separating the grayscale from color. In [[#Color Pop]], your tolerance value will often be in the range of 10-50 and uncommonly be as high as 90. A value of 0 in [[#Color Pop]] is strict Grayscale with 0 deviation allowed between channels. If you have desaturated your image in an image application, 0 often works very well. If you raise the tolerance level too high, the image will revert to [[#Standard Luminance]] but in a compressed area because all color will be treated as grayscale.

In [[#Color Aware]], a Tolerance of 0 will not check for Grayscale at all. In [[#Color Aware]], the goal is 0 tolerance, though some images will need a very low tolerance to separate the black and white into the bottom and top color regions respectively. In [[#Color Aware]], Grayscale is spread through the entire vertical color stack and a non-zero tolerance often leads to colors showing up in unexpected locations in the image.

Common Terms

2024-09-09T13:29:37Z

HueForge:

=Common HueForge Terms=

==Blending Down==
This is the traditional way of using HueForge. Darker colors on the bottom with the lighter colors on the top. Your blending is always referencing the colors below the current layer. The benefit of this mode is that darker colors tend to have lower [[#Transmission Distance (TD)]] and do not blend well, where brighter colors are available in higher TDs and can be blended providing shadows. This makes the filament requirements for blending much simpler. The drawback is primarily in modes like Color Pop and Color Aware. Since each section is it's own HueForge, the top of each section often has a white which will show on the edges of the print below the black of the next section.

==Blending Up==
In [[#Standard Luminance]] mode, filaments are blended "down" to darker base layers (most commonly black). Blending up reverses this and puts the lighter colors at the bottom and the darker color at the top. This generally requires either a high TD dark shade, or multiple shades of a color to allow smooth color blending. The benefit is the black layer is generally shared with the next section and there will not be any white lip around the base of the next layer (see [Rebasing]). Blending up is common in [[#Color Match]] but can also be used in [[#Color Pop]] and [[#Color Aware]] using [[#Split Image]] or [[#Invert Region]]

==Color Aware==
Color Aware is a [Luminance Mode] that splits the HueForge mesh into 3 sections by "color". (See [[Color_Aware]] for a basic How To guide) The colors are defined by the RGB color channels red, green, and blue. Color is picked by which color channel has the maximum value. Ties go to red, and if [Tolerance] is 0, grayscale will go into blue unless there is a [[#Color Shift]]. This lets users separate color regions in images by color though sometimes the groupings are not ideal for the image. For instance yellow is in the red bucket, but often conflicts with skin tones or needs to blend smoothly with greens for leaves/plants.
Using the CA Presets can also allow users to effectively remove one of the three ranges from the image when your image is primarily just two colors, though this is currently a byproduct of applying specific settings and is not a true removal of the third color space.

==Color Core==
The color core, in the middle of the HueForge display, is a visual representation of each layer in a HueForge print and how they blend. This reference will show in real-time the way moving color sliders will affect the colors of various layers in the mesh.
In v0.8.0 (currently Beta only) the Color Core gains slider flags which allow direct manipulation of the sliders on the Color Core and the ability to drop a color at a specific layer instead of just on a new slider.

==Color Match==
Currently in Beta release (Commercial License holders only), Color Match effectively lets users create their own "Luminance" function that is defined by color. When Color Match is selected, a new Color Core (called the Mesh Core) will be created. If this is the first time, the filaments on the Color Core will be copied onto the Mesh Core.

Toggling [[#Shown Colors]] will switch which Core is being used to predict mesh visualization (the left side image). This allows a user to use the Mesh Core to create a custom luminance stack by placing colors on the mesh core (either filaments or colors pulled from the image itself using Ctrl+Left-Click and Drag (or Command+Left-Click on MacOS - you must release Cmd after the drag has started to allow dropping)). HueForge will then go pixel-by-pixel and find the best color match on the Mesh Core and make that pixel location the correct height to show that color when printed. This process will build a mesh that can then be colored by switching Shown Colors to the Color Core and applying Filaments. It is not recommended to apply [Image Colors] to the Color Core since they do not represent real filaments and you will not be able to print with them.

Color Match allows for many more "Color Bins" than [[#Color Aware]] but it can still be difficult to distinguish all colors. Highlights in particular often bleed between color regions on the Mesh Core. Also the user should be aware that human color perception is extremely contextual and if you are having a hard time making a color match with filaments, you should grab the [[#Image Color]] and you will often be surprised by what the actual color is.

In Color Match, the [[#Combo Slider]] allows the user to add an upward or downward weighing on color matching. Values above 0.5 will weight matching upwards in the Mesh Core, and values below 0.5 will weight them downwards. This weighting is for all colors.

==Color Pop==
(Set [[Color Pop]] for a basic How To guide)
The [[#Luminance Mode]] splits the image into two regions. One is defined as Grayscale and the other as Color. Grayscale is defined by setting the [[#Tolerance]] and the location of the split is defined by the [Combo Slider] on the far right of the Model Geometry Dock. There are currently some bugs related to the split location indicator and you may need to move it up and down to get the display to properly reset.

A typical Color Pop image is mostly black and white with small, concentrated regions of often just a single color. These images are impossible to recreate in [[#Standard Luminance]] because the grayscale covers the entire luminance scale, and the color is necessarily in the middle of that same scale so your midtone grays become shades of the desired color along with the color regions.

To combat this, HueForge identifies grayscale regions and color regions and turns them into two separate luminance regions stacked on top of each other. You are then free to blend them separately. But it is highly recommended that you [[#Rebase]] the upper region.

==Color Shift==
Color Shifting is available in [[#Color Match]] and [[#Color Aware]] as a spin box next to the color box icons. It allows for adding or subtracting values globally from a given color channel in the image. This can be very useful for moving colors which straddle the border of two color bins into just one of them. A yellow that alternates between red and green for instance. Also commonly Black and White need color shifting to settle into a single bin. This can also be used to shift grayscale (at 0 [[#Tolerance]]) into either the red or green color bins from the default blue.

Some images benefit more from localized color shifting in an image editor to bring small regions of the image fully into a specific bin. This is currently outside the scope of HueForge.

==Combo Slider==
The far right hand side of the Model Geometry dock has an enigmatic slider. This slider originally had a single function. In [[#Combo Luminance]], it allows for weighted mixing between [[#Standard Luminance]] and [[#Max Channel Luminance]] modes. This was very useful when there weren't any color sensitive luminance modes, but is not much used now.
Since then, other [[#Luminance Modes]] also make use of this slider. Specifically [[#Color Pop]] and [[#Color Match]] make use of it.

==Invert Region==
(v0.8.0 Beta only)
In Color Aware, you can right click on one of the color regions next to the Color Core and choose "Invert Region" which will flip the order of the mesh for that color region and show this on the region indicator as well. This can be used to smooth the blending between regions.

==Luminance Modes==
HueForge currently supports these Luminance Modes
[[#Standard Luminance]]
[[#Max Channel Luminance]]
[[#Combo Luminance]]
Scaled Max Channel Luminance
[[#Color Aware]]
[[#Color Pop]]
[[#Color Match]] (Beta Only)

==Max Channel Luminance==
A simplified luminance value which looks at the value of only one color channel, the channel with the maximum value, and uses it to set the luminance with the function Channel Value/255.0.

==Rebasing==
The process of adding a new black (or other dark color) midway up the Color Core in modes like [Color Pop] or [Color Aware] at the start of the next region to bring back shadows and depth to the next region.

==Split Image==
In [[#Color Pop]] for version 0.7.1 on and [[#Color Aware]] in version v0.7.x the Negative button in the General Options dock will turn into Split Image. This option will negate the bottom most region of the mesh (grayscale by default for Color Pop and Blue by default for Color Aware) and make it inverted in color order.

==Standard Luminance==
The standard luminance model is a visual model which attempts to map colors to human perceptions of brightness. This is the model use for making lithophanes and as such was the first model used to build HueForge meshes. The default HueForge Luminance mode is [[#Combo Luminance]] which is a mixture between Standard Luminance and [[#Max Channel Luminance]] but with the weight set to 100% Standard Luminance on the [[#Combo Slider]]. In this mode, colors with overlapping luminance values will be impossible to separate, but if your image is shades of the same colors (fire for instance) or grayscale, it will work beautifully. There are still a large number of images which work well in Standard mode.

==Transmission Distance (TD)==
A measurement in millimeters of how thick a solid block of filament needs to be to block 95%+ of light from passing through.
This is also referred to commonly as TD. This measurement is fundamental to how HueForge calculates how filaments blend.

==Tolerance==
Strict Grayscale is defined by colors with exactly the same values in their RGB channels. However in practice, many "grayscale" images are color shifted slightly to be warmer or cooler as the subject matter warrants. As a result, in modes like [[#Color Pop]], it can be hard for HueForge to correctly separate Grayscale from Color. To allow this, HueForge has a Tolerance slider. This slider allows the user to expand the definition of Grayscale to include more colors. The tolerance number is the amount of counts the individual color channels can differ. In general this should be as low as possible while still separating the grayscale from color. In [[#Color Pop]], your tolerance value will often be in the range of 10-50 and uncommonly be as high as 90. A value of 0 in [[#Color Pop]] is strict Grayscale with 0 deviation allowed between channels. If you have desaturated your image in an image application, 0 often works very well. If you raise the tolerance level too high, the image will revert to [Standard Luminance] but in a compressed area because all color will be treated as grayscale.

In [[#Color Aware]], a Tolerance of 0 will not check for Grayscale at all. In [[#Color Aware]], the goal is 0 tolerance, though some images will need a very low tolerance to separate the black and white into the bottom and top color regions respectively. In [[#Color Aware]], Grayscale is spread through the entire vertical color stack and a non-zero tolerance often leads to colors showing up in unexpected locations in the image.

Common Terms

2024-09-09T13:23:44Z

HueForge: Created page with "=Common HueForge Terms= ==Blending Down== This is the traditional way of using HueForge. Darker colors on the bottom with the lighter colors on the top. Your blending is always referencing the colors below the current layer. The benefit of this mode is that darker colors tend to have lower #Transmission Distance (TD) and do not blend well, where brighter colors are available in higher TDs and can be blended providing shadows. This makes the filament requirements..."

=Common HueForge Terms=

==Blending Down==
This is the traditional way of using HueForge. Darker colors on the bottom with the lighter colors on the top. Your blending is always referencing the colors below the current layer. The benefit of this mode is that darker colors tend to have lower [[#Transmission Distance (TD)]] and do not blend well, where brighter colors are available in higher TDs and can be blended providing shadows. This makes the filament requirements for blending much simpler. The drawback is primarily in modes like Color Pop and Color Aware. Since each section is it's own HueForge, the top of each section often has a white which will show on the edges of the print below the black of the next section.

==Blending Up==
In [[#Standard Luminance]] mode, filaments are blended "down" to darker base layers (most commonly black). Blending up reverses this and puts the lighter colors at the bottom and the darker color at the top. This generally requires either a high TD dark shade, or multiple shades of a color to allow smooth color blending. The benefit is the black layer is generally shared with the next section and there will not be any white lip around the base of the next layer (see [Rebasing]). Blending up is common in [Color Match] but can also be used in [Color Pop] and [Color Aware] using [Split Image] or [Invert Region]

==Color Aware==
Color Aware is a [Luminance Mode] that splits the HueForge mesh into 3 sections by "color". (See [[Color_Aware]] for a basic How To guide) The colors are defined by the RGB color channels red, green, and blue. Color is picked by which color channel has the maximum value. Ties go to red, and if [Tolerance] is 0, grayscale will go into blue unless there is a [[#Color Shift]]. This lets users separate color regions in images by color though sometimes the groupings are not ideal for the image. For instance yellow is in the red bucket, but often conflicts with skin tones or needs to blend smoothly with greens for leaves/plants.
Using the CA Presets can also allow users to effectively remove one of the three ranges from the image when your image is primarily just two colors, though this is currently a byproduct of applying specific settings and is not a true removal of the third color space.

==Color Core==
The color core, in the middle of the HueForge display, is a visual representation of each layer in a HueForge print and how they blend. This reference will show in real-time the way moving color sliders will affect the colors of various layers in the mesh.
In v0.8.0 (currently Beta only) the Color Core gains slider flags which allow direct manipulation of the sliders on the Color Core and the ability to drop a color at a specific layer instead of just on a new slider.

==Color Match==
Currently in Beta release (Commercial License holders only), Color Match effectively lets users create their own "Luminance" function that is defined by color. When Color Match is selected, a new Color Core (called the Mesh Core) will be created. If this is the first time, the filaments on the Color Core will be copied onto the Mesh Core.

Toggling [[#Shown Colors]] will switch which Core is being used to predict mesh visualization (the left side image). This allows a user to use the Mesh Core to create a custom luminance stack by placing colors on the mesh core (either filaments or colors pulled from the image itself using Ctrl+Left-Click and Drag (or Command+Left-Click on MacOS - you must release Cmd after the drag has started to allow dropping)). HueForge will then go pixel-by-pixel and find the best color match on the Mesh Core and make that pixel location the correct height to show that color when printed. This process will build a mesh that can then be colored by switching Shown Colors to the Color Core and applying Filaments. It is not recommended to apply [Image Colors] to the Color Core since they do not represent real filaments and you will not be able to print with them.

Color Match allows for many more "Color Bins" than [[#Color Aware]] but it can still be difficult to distinguish all colors. Highlights in particular often bleed between color regions on the Mesh Core. Also the user should be aware that human color perception is extremely contextual and if you are having a hard time making a color match with filaments, you should grab the [[#Image Color]] and you will often be surprised by what the actual color is.

In Color Match, the [[#Combo Slider]] allows the user to add an upward or downward weighing on color matching. Values above 0.5 will weight matching upwards in the Mesh Core, and values below 0.5 will weight them downwards. This weighting is for all colors.

==Color Pop==
(Set [[Color Pop]] for a basic How To guide)
The [[#Luminance Mode]] splits the image into two regions. One is defined as Grayscale and the other as Color. Grayscale is defined by setting the [[#Tolerance]] and the location of the split is defined by the [Combo Slider] on the far right of the Model Geometry Dock. There are currently some bugs related to the split location indicator and you may need to move it up and down to get the display to properly reset.

A typical Color Pop image is mostly black and white with small, concentrated regions of often just a single color. These images are impossible to recreate in [[#Standard Luminance]] because the grayscale covers the entire luminance scale, and the color is necessarily in the middle of that same scale so your midtone grays become shades of the desired color along with the color regions.

To combat this, HueForge identifies grayscale regions and color regions and turns them into two separate luminance regions stacked on top of each other. You are then free to blend them separately. But it is highly recommended that you [[#Rebase]] the upper region.

==Color Shift==
Color Shifting is available in [[#Color Match]] and [[#Color Aware]] as a spin box next to the color box icons. It allows for adding or subtracting values globally from a given color channel in the image. This can be very useful for moving colors which straddle the border of two color bins into just one of them. A yellow that alternates between red and green for instance. Also commonly Black and White need color shifting to settle into a single bin. This can also be used to shift grayscale (at 0 [[#Tolerance]]) into either the red or green color bins from the default blue.

Some images benefit more from localized color shifting in an image editor to bring small regions of the image fully into a specific bin. This is currently outside the scope of HueForge.

==Combo Slider==
The far right hand side of the Model Geometry dock has an enigmatic slider. This slider originally had a single function. In [[#Combo Luminance]], it allows for weighted mixing between [[#Standard Luminance]] and [[#Max Channel Luminance]] modes. This was very useful when there weren't any color sensitive luminance modes, but is not much used now.
Since then, other [[#Luminance Modes]] also make use of this slider. Specifically [[#Color Pop]] and [[#Color Match]] make use of it.

==Max Channel Luminance==
A simplified luminance value which looks at the value of only one color channel, the channel with the maximum value, and uses it to set the luminance with the function Channel Value/255.0.

==Rebasing==
The process of adding a new black (or other dark color) midway up the Color Core in modes like [Color Pop] or [Color Aware] at the start of the next region to bring back shadows and depth to the next region.

==Standard Luminance==
The standard luminance model is a visual model which attempts to map colors to human perceptions of brightness. This is the model use for making lithophanes and as such was the first model used to build HueForge meshes. The default HueForge Luminance mode is [[#Combo Luminance]] which is a mixture between Standard Luminance and [[#Max Channel Luminance]] but with the weight set to 100% Standard Luminance on the [[#Combo Slider]]. In this mode, colors with overlapping luminance values will be impossible to separate, but if your image is shades of the same colors (fire for instance) or grayscale, it will work beautifully. There are still a large number of images which work well in Standard mode.

==Transmission Distance (TD)==
A measurement in millimeters of how thick a solid block of filament needs to be to block 95%+ of light from passing through.
This is also referred to commonly as TD. This measurement is fundamental to how HueForge calculates how filaments blend.

==Tolerance==
Strict Grayscale is defined by colors with exactly the same values in their RGB channels. However in practice, many "grayscale" images are color shifted slightly to be warmer or cooler as the subject matter warrants. As a result, in modes like [[#Color Pop]], it can be hard for HueForge to correctly separate Grayscale from Color. To allow this, HueForge has a Tolerance slider. This slider allows the user to expand the definition of Grayscale to include more colors. The tolerance number is the amount of counts the individual color channels can differ. In general this should be as low as possible while still separating the grayscale from color. In [[#Color Pop]], your tolerance value will often be in the range of 10-50 and uncommonly be as high as 90. A value of 0 in [[#Color Pop]] is strict Grayscale with 0 deviation allowed between channels. If you have desaturated your image in an image application, 0 often works very well. If you raise the tolerance level too high, the image will revert to [Standard Luminance] but in a compressed area because all color will be treated as grayscale.

In [[#Color Aware]], a Tolerance of 0 will not check for Grayscale at all. In [[#Color Aware]], the goal is 0 tolerance, though some images will need a very low tolerance to separate the black and white into the bottom and top color regions respectively. In [[#Color Aware]], Grayscale is spread through the entire vertical color stack and a non-zero tolerance often leads to colors showing up in unexpected locations in the image.

Main Page

2024-09-09T11:48:57Z

HueForge:

[[File:Main_image001.png|480px|thumb|center|HueForge Example]]

===[[Common Terms]]===

===[[How To Pages]]===

===[[TD-1]]===

===[[FAQ]]===

TD-1

2024-07-31T14:37:59Z

HueForge: /* Why is the TD I get from the TD-1 Different? */

==Where Can I Buy a TD-1==
The TD-1 is not made by HueForge, but by Ajax-3D which was started by a community member.
TD-1s sell quickly and may not be in stock anywhere, but the list of Resellers is available at [https://ajax-3d.com/resellers/ Ajax-3D]

==Why is the TD I get from the TD-1 Different from the HueForge Library?==
The library TD values in HueForge are taken from just one or two spools of filament. Over time, we have learned that there
can be a large variance in TD between batches or in some cases, parts of a spool. The library values are NOT definitive and your
TD-1 is giving you the correct value for YOUR spool.

==How Much Variance in TD Should I Expect?==
TD Varies in a spool depending on manufacturer. Even those manufacturers that control for TD see variance of +/-10%.
Some users are concerned when the same piece of filament varies by 0.1-0.2 between insertions. This is a non-meaningful change
that will have no impact on the prediction in HueForge. In fact, if you prefer to round to the nearest 0.5mm on TD, you will not
see a difference in the predicted result.

==My Colors are Off==
The TD-1's primary goal is TD and it measures this very well. Color is something we wanted to have as well because it is useful, but the TD-1 measures color of roughly 1x3mm of filament. No color sensor is going to be perfect at that scale.
It is well known that Gray comes in somewhat green, likely due to the LEDs that are on the RGB sensor. Most of the time, if you
double click on the color swatch and edit the Green channel to be equal to the next highest color channel (either Red or Blue), you will get a pretty close gray value. Most other color issues tend to be too bright and a brightness adjustment in the same dialog will let you fix that value.

Efforts are underway to improve color accuracy as possible, but Ajax is prioritizing production to meet demand and HueForge is prioritizing new feature updates at the moment. When time permits, more effort will be made to improve color with the current sensor and future versions will likely have an improved sensor.

TD-1

2024-07-31T14:35:53Z

HueForge: Initial TD-1 Answers

==Where Can I Buy a TD-1==
The TD-1 is not made by HueForge, but by Ajax-3D which was started by a community member.
TD-1s sell quickly and may not be in stock anywhere, but the list of Resellers is available at [https://ajax-3d.com/resellers/ Ajax-3D]

==Why is the TD I get from the TD-1 Different?==
The library TD values in HueForge are taken from just one or two spools of filament. Over time, we have learned that there
can be a large variance in TD between batches or in some cases, parts of a spool. The library values are NOT definitive and your
TD-1 is giving you the correct value for YOUR spool.

==How Much Variance in TD Should I Expect?==
TD Varies in a spool depending on manufacturer. Even those manufacturers that control for TD see variance of +/-10%.
Some users are concerned when the same piece of filament varies by 0.1-0.2 between insertions. This is a non-meaningful change
that will have no impact on the prediction in HueForge. In fact, if you prefer to round to the nearest 0.5mm on TD, you will not
see a difference in the predicted result.

==My Colors are Off==
The TD-1's primary goal is TD and it measures this very well. Color is something we wanted to have as well because it is useful, but the TD-1 measures color of roughly 1x3mm of filament. No color sensor is going to be perfect at that scale.
It is well known that Gray comes in somewhat green, likely due to the LEDs that are on the RGB sensor. Most of the time, if you
double click on the color swatch and edit the Green channel to be equal to the next highest color channel (either Red or Blue), you will get a pretty close gray value. Most other color issues tend to be too bright and a brightness adjustment in the same dialog will let you fix that value.

Efforts are underway to improve color accuracy as possible, but Ajax is prioritizing production to meet demand and HueForge is prioritizing new feature updates at the moment. When time permits, more effort will be made to improve color with the current sensor and future versions will likely have an improved sensor.

Main Page

2024-07-31T14:25:19Z

HueForge:

[[File:Main_image001.png|480px|thumb|center|HueForge Example]]

===[[How To Pages]]===

===[[TD-1]]===

===[[FAQ]]===