Overview

Introduction

Installation

Getting Started

Core Features

Influence Modes

Deformation

Refinement & Smoothing

Material Layer System

Modular Character Support

API Reference

Blueprint API

Editor Guide

Asset Editor Overview

Debug Visualization

Resources & Support

Troubleshooting & FAQ

Changelog

FleshRing Debug Visualization

Purpose: This is the definitive reference for all debug visualization features in the FleshRing Asset Editor. Use these tools to diagnose issues, optimize parameters, and understand exactly what's happening under the hood.

What is Debug Visualization?

Debug Visualization is a suite of editor-only overlays that display internal computation data on top of your mesh in the 3D viewport. These tools help you:

• Verify that influence regions cover the correct vertices
• Diagnose why deformation isn't working as expected
• Optimize parameter values by seeing real-time visual feedback
• Understand SDF quality and bulge direction calculations

Important: All debug features are editor-only and automatically stripped from packaged builds. They have zero runtime cost.

Accessing Debug Visualization

Method 1: Show Menu (Recommended)

1. Click "Show" dropdown in viewport toolbar (top-left corner)
2. Navigate to "Debug / Visualization" section
3. Click a debug option to toggle

Method 2: Keyboard Shortcuts (Fastest)

• Press the corresponding number key
• See Keyboard Shortcuts section below

Master Toggle: Show Debug Visualization

Shortcut: 1

Description:

• Master switch that must be enabled FIRST before other debug options become visible
• When OFF, all other debug overlays are hidden regardless of their individual state
• When ON, individually enabled debug options will display

When to Use:

• Enable at start of debug session
• Disable for final aesthetic review (hides all overlays instantly)

Workflow:

1. Press 1 to enable master toggle
2. Press 2/3/4/5 to enable specific debug overlays
3. Press 1 again to hide all overlays without losing individual settings
4. Press 1 again to restore previous overlay configuration

Tip: Use this to quickly toggle between "debug view" and "clean view" without manually disabling each overlay.

Debug Visualization Options

1. Show SDF Volume

Shortcut: 2

Availability: Mesh Based mode only

Description: Displays the axis-aligned bounding box (AABB) of the Ring mesh's SDF influence volume as a Blue & Green wireframe box.

What You See:

• Blue & Green wireframe rectangular box
• Box encompasses ring mesh + Effect Bounds Expand X/Y padding
• Box represents voxel grid boundaries used for SDF computation

When to Use:

• Verify SDF bounds cover target area - If deformation cuts off abruptly, bounds may be too small
• Optimize SDF size - Smaller bounds = faster computation, but must cover all affected vertices
• Debug "no deformation" issues - Ensure target vertices are inside box

How to Interpret:

• Too small: Deformation cuts off, vertices outside box are not affected
• Too large: Wasted computation, slower editor preview
• Just right: Box covers all compressed vertices with minimal excess

Related Parameters:

• Effect Bounds Expand X (Deformation → Tightness)
• Effect Bounds Expand Y (Deformation → Tightness)

Tuning Workflow:

1. Enable Show SDF Volume (2)
2. Enable Show Affected Vertices (3) simultaneously
3. If red vertices (high influence) are cut off at box boundary, increase Expand X/Y
4. Adjust until all affected vertices are comfortably inside box

Too-small

The image below was taken inside the leg mesh.

Correctly-sized

2. Show Affected Vertices

Shortcut: 3

Availability: All modes

Description: Displays vertices affected by Tightness deformation with a color gradient representing influence strength.

Color Legend:

• Blue (0.0) - No influence, vertex is outside Tightness range
• Green (0.5) - Medium influence, partial compression
• Red (1.0) - Maximum influence, full compression at ring center