HueForge v8.1 UI Break Down: Difference between revisions

Revision as of 23:40, 24 February 2025

HueForge v8.1 UI Breakdown

Main Interface

1. Lighting Settings

LED Light Type

The Illumination light temperature. It is only active in Lithophane mode and when the Back Lit button is selected. Selections are Warm White 2700K, Natural White 4000K (default), Cold White 6500K, Red, Green, Blue, Cyan and Magenta.

Light Intensity

Adjusts the strength of illumination in Lithophane mode and when Back Lit Button is selected.

Blending Type

Select from Filament Painting or Lithophane modes. Filament Painting is normally the default and sets the Front Lit button to on. Lithophane mode invokes the Back lit mode and inverts the layer heights of populated filaments (sliders and on Color Core).

Front Lit

Select to preview image as a filament painting (i.e. the print is to be lit from the front).

Back Lit

Select to preview image as a colored lithophane or a mixed mode filament painting with the light source positioned behind the print. Used by itself, it does not affect filament layer heights.

Slicer View

Select to preview the print as it would appear in a properly configured slicer view. Select Front or Back Lit button to restore to blended view. As an alternative, press and the scroll control button to temporarily switch to Slicer View while mouse cursor is in the preview window.

2. General Options and Operations

Remesh (momentary)

Recomputes the model mesh in the unlikely event that control actions are not properly reflected in the displayed geometry model. (May be removed in later versions.)

Wireframe check box

Changes the preview to show the geometry model's wireframe. Use Reset View button to restore

Reset View (momentary)

Press to restore properly scaled preview after a zoom, tilt or pan operation operation. Also used to clear Wireframe check box and restore normal preview.

Describe Button (momentary)

Opens a popup window listing the description of the current filaments and layer swaps needed in the slicer. Note: The information is also written in a [project_name]_describe.txt file when a project is saved.

Negative Button (toggle on/off)

Reverses the heights in the luminance map of an image - ON = dark (low) to light (high). Off = light (high) to dark (low). ON is the default setting for a filament painting; OFF for a lithophane. Selecting Lithophane mode turns this button off, but the button has no impact on Blending Type selection.

Width

The width of the model in mm. Note that the aspect ratio of the model is set by the image, so that this value might be adjusted to be consistent with the image aspect ratio.

Height

Height of the model in mm consistent with the image aspect ratio.

Border Width

Width of the border in mm when the Border Button is selected. The image shrinks by the width of the border. The border width is dependent on the relative model height and width. It has no effect if Border Button is not selected.

Border Depth

The height of the border in mm when the Border Button is selected. It can be taller than the overall height of the image part of the model. Its color is determined by the height of the color layer it ends on. If it is taller than the image part, its color corresponds to the color at the top of the image.

Full Range

When selected, if the luminance of an image does not extend over the full range of zero to one (black to white) the luminance range is stretch linearly to fill the entire range. This control is disabled in Color Match Luminance mode because the luminance mapping is no longer a linear function.

Border Button (toggle)

Places a rectangular border around the model. Does not follow the edges of an image with a transparent outline.

3. Filament Library

Panel

The panel displays a collection of available filaments, their colors, and transmission distances. Easily select filaments by dragging and dropping color icons from the library onto the sliders or cores.

New Filament

Add your own filaments that aren't in the library.

Filter

Easily search for specific filaments.

Sort

Sort your filaments by brand, color, transmission distance, or name.

Save Library

Save any changes you've made to the filament library.

4. Color & Mesh Core

Settings Menu

HueForge's Color and Mesh Cores are essential components of the software's color matching and 3D model creation process:

Color Core

Used to generate instructions for printing.
Allows users to manipulate colors and create the final appearance of the print.
Users can drag and drop colors from the filament library directly onto the cores.
Does not need to exactly match the arrangement of the Mesh Core.

Mesh Core

Only used in Color Match mode
Used to modify and create the 3D model structure.
Allows users to instruct HueForge on how to build the 3D model.
Allows for more control of the 3D model for complex images.
When working with the Mesh Core, users should aim for logical color layering. A disjointed blend can result in jarring transitions and more noticeable edges in the final mesh, potentially affecting the overall quality of the print.

5. Color Sliders

Color Sliders

Sort Sliders

Sorts the color sliders in ascending order based on their height.

Invert Sliders

Inverts the relationship between color and height for all sliders in the project. Particularly useful when switching in and out of Negative Mode

Clear Slider History

Removes the history of previous slider arrangements. This allows your current slider arrangement to be duplicated when switching modes. If you do not clear slider history when switching back to a mode it will remember it's previous sliders and positions.

6. Model Geometry