HueForge Wiki - User contributions [en]

What does the Mesh Core Do?

2025-02-11T03:49:37Z

HueForgeWikiAdmin: /* Introduction */

== 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 (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'''.

V0.7.4 to v0.8.0 UI Changes

2025-02-11T03:02:58Z

HueForgeWikiAdmin: /* Overview */

== 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.

<youtube>UGeZdFy_oyk</youtube>

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-11T03:01:55Z

HueForgeWikiAdmin: /* Overview */

== 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.

<youtube>https://www.youtube.com/watch?v=UGeZdFy_oyk</youtube>

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-11T02:58:51Z

HueForgeWikiAdmin: /* Overview */

== 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.

<embedvideo service="youtube">https://www.youtube.com/watch?v=UGeZdFy_oyk</embedvideo>

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.

File:ColorPop-Parrot.png

2024-07-05T03:04:14Z

HueForgeWikiAdmin: