Preferences

The Preferences dialog provides access to application-wide settings that affect all projects. Use it to customize Volvicon's behavior, appearance, performance characteristics, and default import options.

note

Changes to most settings take effect immediately. DPI-related settings require an application restart to apply.

Opening Preferences

1. Open the File tab
2. Click Preferences in the navigation panel

---

Settings Tabs

The Preferences dialog is organized into the following tabs:

Tab	Purpose
User Interface	Window behavior, DPI scaling, font size
General	Working directory, undo/redo, performance, data collection
Rendering	Render view interaction options
3D View	Clipping visualization, mask preview settings
2D View	Slice view caching options
Import	CAD file and multi-part import options

---

User Interface Settings

Control the visual appearance and behavior of the application window.

Window Options

Setting	Description	Default
Save size and position on exit	Remember window dimensions and location	Enabled
Show splash screen	Display the splash banner at startup	Enabled
Show border in fullscreen	Add a border in fullscreen mode (Windows)	Disabled

DPI and Scaling

Setting	Description	Default
System DPI aware	Make the application respond to system DPI settings	Enabled
Enable high DPI scaling	Allow the UI to scale for high-resolution displays	Enabled
High DPI scale factor rounding	How to round scaling factors	PassThrough

Scale Factor Rounding Options:

Option	Behavior
Auto	Automatic selection
Round	Round to nearest integer
Ceil	Round up to next integer
Floor	Round down to previous integer
RoundPreferFloor	Round, preferring floor on tie
PassThrough	Use the exact factor without rounding

warning

DPI-related changes require restarting Volvicon to take effect. Save your project before changing these settings.

Application Font Size

Option	Description
System default	Match system font settings
Normal	Standard application font size
Medium	Slightly larger text
Large	Larger text for improved readability
Extra large	Maximum text size

---

General Settings

Configure core application behavior, performance, and data collection preferences.

Default Working Directory

The working directory is used for:

• Default location for file dialogs
• Storage location for undo data when saving to disk
• Temporary file storage

Click Browse to select a custom directory, or leave empty to use the system default.

Undo/Redo Configuration

Setting	Description	Default
Maximum undos	Number of scene actions to remember	10
Maximum camera undos	Number of camera movements to remember	20
Clear buttons	Remove stored undo history
Save undos to	Storage location: RAM or Disk	RAM

Storage Options:

Option	Benefits	Trade-offs
RAM	Faster undo/redo operations	Higher memory usage
Disk	Lower memory footprint	Slower, uses working directory

tip

For large projects with memory constraints, switch to Disk storage. This writes undo data to the working directory.

Recent Files

Setting	Description	Default
Maximum recent items	Number of files shown in the recent files list	9

Performance

Setting	Description	Default
Maximum number of threads	CPU threads for parallel operations	Hardware maximum
Auto-save frequency	Minutes between auto-saves (0 = disabled)	Enabled
Compression level	Project file compression	Fastest

Compression Level Options:

Level	Description	Use Case
Store	No compression	Fastest save, largest files
Fastest	Minimal compression	Good balance for most users
Balanced	Moderate compression	Smaller files, moderate speed
Maximum	Maximum compression	Smallest files, slowest save

User Experience Improvement

Setting	Description	Default
Help improve user experience	Send anonymous usage and crash data	Enabled

A link to the Privacy Policy is provided for details on collected data.

---

Rendering Settings

Configure interaction behavior for all render views.

Zoom Behavior

Setting	Description	Default
Zoom to cursor position	Center zoom operations on the mouse cursor	Enabled

When enabled, zooming focuses on the point under the cursor rather than the view center.

---

3D View Settings

Configure 3D visualization and preview behavior.

3D Clipping Options

Control how the clipping box affects 3D visualization:

Setting	Description	Default
Keep only whole cells	Preserve complete cells when clipping	Enabled
Outline color	Color of the clipping box edges	Black
Handle color	Color of the clipping box manipulation handles	Light gray

Mask 3D Preview

Setting	Description	Default
Automatically regenerate mask 3D preview	Update previews when visible masks change	Disabled
Use accurate surface determination per label	Higher quality surface computation per mask label	Enabled

note

Accurate surface determination produces better quality previews but requires more computation time.

---

2D View Settings

Configure slice view behavior.

Mask Outline Cache

Setting	Description	Default
Enable mask outline cache	Precompute outlines for visible masks	Enabled

When enabled:

• Benefit: Faster slice navigation through volumes with masks
• Trade-off: Higher memory usage for cached outlines

---

Import Settings

Configure default import behavior for volumes, masks, and surface models.

Volume and Mask Import Options

Control how Volvicon handles geometry mismatches when importing volumes or masks into projects with existing data.

Geometry Comparison Precision

Define the tolerance used when comparing imported image geometry with the active volume in the project.

Setting	Description	Default	Range
Spacing comparison precision	Decimal places for voxel spacing comparison	3	1–15
Origin comparison precision	Decimal places for origin position comparison	6	1–15

How Precision Works:

The precision setting determines the tolerance for geometry matching. Values are rounded to the specified number of decimal places before comparison.

Spacing Example (precision = 3):

• Reference spacing: 0.56789 mm → rounds to 0.568 mm
• Import spacing: 0.5678 mm → rounds to 0.568 mm
• Result: Match (import allowed)

Spacing Example (precision = 3):

• Reference spacing: 0.56789 mm → rounds to 0.568 mm
• Import spacing: 0.567 mm → rounds to 0.567 mm
• Result: Mismatch (import blocked unless allowed)

Recommended Precision Settings

Application	Spacing	Origin	Rationale
Medical CT/MRI	3	6	Sub-millimeter spacing, micron-level origin precision
Micro-CT	4–5	2–3	High-resolution imaging with micron-level detail
Industrial CT	3–4	2	Precision measurement requirements

Allow Mismatched Geometry

Setting	Description	Default
Allow import of images with mismatched geometry	Permit importing volumes/masks that do not match the active volume	Disabled

When disabled (default):

• Import operations check dimensions, spacing, and origin against the active volume
• Mismatched images are rejected with a detailed error message showing exact geometry differences
• Ensures all project data shares consistent spatial properties

When enabled:

• Images with geometry differences can be imported
• A warning message appears if resampling is disabled
• Use when combining data from different sources or scanners

Spatial Alignment Considerations

Importing images with mismatched geometry without resampling may result in spatial misalignment. Voxels at the same index position will not correspond to the same physical location. Enable resampling to maintain proper alignment.

Automatic Resampling

Setting	Description	Default
Resample mismatched images to match the project's active volume	Automatically resample imported data to match the active volume geometry	Disabled

When enabled:

• Images detected as mismatched are automatically resampled to match the active volume
• Output dimensions, spacing, and origin will match the reference volume
• Interpolation method is applied according to data type (see below)

When disabled:

• Mismatched images import without modification (if allowed)
• Users must manually resample if spatial alignment is required

Resampling Effects

Resampling modifies voxel values through interpolation. Consider the following effects:

For Volumes:

• Grayscale values may change due to interpolation
• Fine structures smaller than the voxel size may be affected
• Quantitative measurements (density, intensity) may differ from the original

For Masks:

• Label boundaries may shift slightly
• Small structures may be lost if downsampling
• Volume measurements may differ from the original segmentation

Review resampled data carefully before proceeding with analysis.

Interpolation Methods

Select the interpolation algorithm applied during resampling operations.

For Volumes:

Method	Description	Use Case	Default
Nearest	Use value of nearest voxel	Label volumes, discrete data
Linear	Trilinear interpolation	Standard grayscale volumes	✓
Cubic	Tricubic interpolation	High-quality resampling, minimal artifacts

For Masks:

Method	Description	Use Case	Default
Nearest	Use value of nearest voxel	Preserves label IDs, no fractional values	✓
Linear	Trilinear interpolation	Smooth boundaries (may create fractional labels)
Cubic	Tricubic interpolation	High-quality (may create fractional labels)

Interpolation Selection

Use Nearest for masks to preserve integer label IDs and prevent fractional values that would corrupt segmentation data.

Use Linear for volumes as a good balance between quality and speed. Use Cubic only when highest quality is required and processing time is acceptable.

---

Surface and CAD File Import Options

Settings for importing CAD formats (STEP, IGES, BREP) and multi-part surface models.

CAD Geometry Handling

Setting	Description	Default
Preserve original STEP geometry	Maintain non-manifold features from STEP files	Disabled
Fix solid parts	Attempt automatic repair of geometry defects	Enabled

Preserve Original Geometry:

• When enabled, imports STEP files including non-manifold edges and faces
• When disabled, non-manifold features are omitted during import

Fix Solid Parts:

• Attempts to repair gaps, overlaps, and missing faces in solid geometry
• Recommended for CAD data from external sources

Deflection Control

Control the tessellation quality when converting CAD geometry to triangle meshes:

Setting	Description	Default
Auto-calculate deflections	Automatically compute optimal tessellation parameters	Disabled
Linear deflection	Maximum distance between mesh and true surface (mm)	0.001
Angular deflection	Maximum angular deviation between adjacent triangles (degrees)	0.3

Linear Deflection:

• Lower values produce meshes that closely follow curved surfaces
• Higher values produce coarser meshes with fewer triangles
• Typical range: 0.001–1.0 mm

Angular Deflection:

• Controls smoothness of curved regions
• Lower values create more triangles in curved areas
• Typical range: 0.1–1.0 degrees

Deflection Trade-offs

Lower deflection values:

• Benefit: Higher geometric accuracy, smoother appearance
• Trade-off: More triangles, larger file size, slower rendering

Higher deflection values:

• Benefit: Fewer triangles, faster processing
• Trade-off: Faceted appearance, reduced accuracy

Solid Construction

Setting	Description	Default
Build solid	Construct solid geometry from surfaces	Disabled
Intersect parts	Compute Boolean intersections between parts	Disabled
Discard internal parts	Remove geometry hidden inside the solid	Disabled

These options apply Boolean operations during import to create closed solid geometry suitable for volumetric operations.

Multi-Part File Behavior

Setting	Description	Default
Import multi-part files as a single surface object	Merge all parts into one object	Disabled

When enabled:

• All parts from STEP, IGES, VRML, or 3DS files merge into a single surface object
• Simplifies object management for assemblies

When disabled:

• Each valid part imports as a separate surface object
• Allows individual manipulation of components

---

Workflow: Optimizing for Large Projects

1. Open File → Preferences
2. Navigate to the General tab
3. Set Save undos to → Disk to reduce memory usage
4. Reduce Maximum undos if memory is constrained
5. Set Compression level → Store or Fastest for faster saves
6. Verify Auto-save frequency is set appropriately
7. Click Close to apply settings

---

Workflow: Configuring for High-DPI Displays

1. Open File → Preferences
2. Navigate to the User Interface tab
3. Enable System DPI aware
4. Enable Enable high DPI scaling
5. Set High DPI scale factor rounding to PassThrough for smoothest scaling
6. Adjust Application font size if text appears too small or large
7. Click Close
8. Restart Volvicon for DPI changes to take effect

---

Workflow: Configuring Volume/Mask Import Behavior

Configure geometry matching tolerance and automatic resampling:

1. Open File → Preferences
2. Navigate to the Import tab
3. Set Spacing comparison precision based on your data source:
   • Medical imaging: 3 decimal places
   • High-resolution micro-CT: 4–5 decimal places
4. Set Origin comparison precision (typically 6 for medical data)
5. To allow mismatched imports:
   • Enable Allow import of images with mismatched geometry
   • Enable Resample mismatched images to maintain alignment
   • Verify interpolation methods:
     • Volume: Linear (default)
     • Mask: Nearest (default)
6. Click Close to save

When to Adjust Precision

Increase precision (more decimal places) when:

• Working with high-resolution imaging (micro-CT, synchrotron)
• Exact geometric matching is critical
• Datasets should be from identical acquisition protocols

Decrease precision (fewer decimal places) when:

• Combining data from multiple scanners or sessions
• Small numerical variations should be tolerated
• Post-processing has introduced rounding

---

Workflow: Optimizing CAD Import

1. Open File → Preferences
2. Navigate to the Import tab
3. Configure CAD file options:
   • Enable Preserve original geometry for complex STEP assemblies
   • Enable Fix solid parts to repair problematic geometry
4. Set deflection values:
   • Enable Auto-calculate deflections for automatic settings, or
   • Set manual values for precise control
5. Configure solid options if needed for Boolean operations
6. Set multi-part behavior based on your workflow
7. Click Close to save

---

Restore Defaults

To reset all preferences to factory defaults:

1. Open File → Preferences
2. Click Restore Defaults in the dialog button bar
3. A confirmation dialog appears
4. Click Yes to restart the application

warning

Save your project before restoring defaults. The application will restart and unsaved changes will be lost.

---

Best Practices

For Performance

• Increase Maximum threads to match your CPU cores for faster processing
• Use RAM storage for undo if you have sufficient memory
• Set Auto-save to a reasonable interval (5–10 minutes)

For Memory Management

• Switch undo storage to Disk for large projects
• Reduce Maximum undos to limit memory consumption
• Disable Mask outline cache if working with many masks

For Display Quality

• Enable high DPI scaling on high-resolution monitors
• Use PassThrough scale factor for best visual quality
• Adjust font size for comfortable reading

---

Related Topics

• Save - Project saving and auto-save behavior
• Import - Importing data with preferences
• Properties - Project-specific settings