Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Appendix C: Faceting Glossary, Troubleshooting & FAQ

APPENDIX C · GLOSSARY & FAQ Gemological & CAD Terminology · Common Error Solutions · Keyboard Shortcuts

Part 1: Gemological & ProFacet Glossary

TermDefinition
ASET (Angular Spectrum Evaluation Tool)A diagnostic map that colors every pixel on the crown according to the hemisphere angle of the light ray it returns: Red (15°–45°) for direct overhead brilliance, Blue (0°–15°) for viewer head-shadow contrast, Green (45°–90°) for low horizon light, and Black for light leakage.
Break FacetsFacets sitting immediately adjacent to the girdle (e.g., P2 on the Pavilion or C1 on the Crown) that level out the girdle line and split main facets into smaller virtual facets.
CAM (Centerpoint Angle Method)A preforming technique where temporary pavilion facets (PF1, PF2…) are cut to a single central point (cp()) at calculated angles, followed by 90° vertical girdle cuts (G1, G2…) meeting mp(PFk) to form an exact non-round outline.
Critical Angle (θc)The minimum internal angle of incidence θc=arcsin(1/RI) required for a light ray to undergo Total Internal Reflection (TIR) instead of leaking out the back of the pavilion.
Crown (C)The upper dome of the gemstone above the girdle.
Culet (cp())The bottom apex where the lowest Pavilion facets meet at a point.
Dispersion (Fire)The splitting of white light into spectral rainbow flashes caused by wavelength-dependent refractive index variation.
DopThe metal rod to which the rough gemstone crystal is attached during cutting.
FCI (Faceting Complexity Index)ProFacet’s 0–100 difficulty score computed from total facet count, tier count, acute angle changes, and delicate meetpoint tolerances.
Girdle (G)The 90° vertical perimeter belt separating the Pavilion from the Crown.
Index Gear (96)A toothed wheel on the faceting quill that divides the 360° circle into discrete stops (e.g., 96 teeth = 3.75° per tooth).
Main FacetsThe primary structural facets of the Pavilion (P1) or Crown (C2 / bezel facets) that drive primary light reflection and refraction.
Meetpoint (mp())A 3D vertex where three or more facet planes intersect at a single sharp corner.
Pavilion (P)The conical bottom section of the gemstone below the girdle, designed to reflect light upward via Total Internal Reflection.
ScintillationThe dynamic interplay of bright and dark flashes (virtual facets turning on and off) as the gemstone, light source, or viewer moves.
Star FacetsShallow triangular facets surrounding the flat Table (T) on the upper Crown (e.g., C3).
Table (T)The flat 0.0° horizontal facet at the very top of the Crown.
TIR (Total Internal Reflection)100% mirror-like reflection of light inside a gemstone when a ray strikes an internal facet at an angle steeper than the critical angle (θc).
WindowingUndesirable light leakage through the bottom of the pavilion when pavilion facets are cut too shallow (< θc), creating a dead, see-through zone under the table.

Part 2: Troubleshooting Common Cut & Script Errors

1. "Interactive slicer only works in Monochrome or Palette mode"

  • Cause: Your 3D Viewport is currently set to Raytraced, ASET, Window, Fire, Scintillation, or BDPT.
  • Fix: Use the dropdown in the top-right corner of the 3D Viewport to switch to Palette or Mono while slicing facets visually.

2. "Process the design (Cmd/Ctrl + Enter) before running analysis"

  • Cause: You edited the code in the Spec Editor (or have an uncommitted live preview in the Slicer) that hasn't been compiled yet.
  • Fix: Switch to the 3D Studio, click Process 🚀 (or press Cmd/Ctrl + Enter), and then click Analyzer or Optimizer.

3. "Facet did not cut the stone" or "Meetpoint not found"

  • Cause: Either:
    1. You referenced a tier in mp(TierX) before TierX was cut (check your top-to-bottom tier order!), or
    2. An earlier tier cut so deeply that it completely ground away the tier you are trying to meet, or
    3. On a Pavilion break tier (P2), your angle is shallower than P1 (cp()) instead of steeper than P1.
  • Fix: Ensure Pavilion tiers that meet cp() (P1) are slightly shallower (e.g. 41.5°) than outer Pavilion break tiers meeting gp() (P2 at 43.0°), and verify in Palette mode with Facet Info turned on that the target tier exists on the mesh.

4. "Open Girdle" or Knife-Edge Girdle Corners

  • Cause: You forgot to include + girdle on the first Crown tier that meets the Pavilion girdle (C1 0 @ 42.0 : gp() + girdle x8 m 3 or C1 3 @ 42.0 : gp() + girdle xx8), or an optimization range (+/-) allowed a Crown tier to cut deeper than the girdle.
  • Fix: Click +girdle on your first Crown tier, and check Protect Girdle (Enforce closed girdle) in the GPU Optimizer!

Part 3: Studio Keyboard Shortcuts

Press ? anywhere in the 3D Studio (outside a text input) or click ☰ → Keyboard Shortcuts to view all shortcuts:

ShortcutAction
Cmd/Ctrl + EnterProcess / Run the current FSL or Lua specification
Shift + Cmd/Ctrl + FAuto-format and align FSL source code
Cmd/Ctrl + LToggle the Script Output (print()) console
?Open the Keyboard Shortcuts reference dialog
EscapeClose the active modal, popover, or in-place Slicer edit