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

Start Here

This quick tour shows you how to open the studio, look at a stone, and print a faceting diagram in a couple of minutes.

Tip: The studio autosaves in your browser. Close the tab and come back later - your last design reopens automatically.

1. Learn the controls

  • Drag with the left mouse button (or a single finger) to orbit. Use the right button or a two-finger drag to pan, and the scroll wheel or pinch gesture to zoom.
  • The toolbar above the canvas holds your helpers. View cycles shading styles, Flip jumps from crown to pavilion, and the menu button reveals extra overlays such as wireframe and debug points.

2. Edit your first design

Click New to load the starter template, place the cursor in the editor, paste the snippet below, and press Process (or hit Cmd/Ctrl + Enter):

set name "Simple Octagon"

// Cut a pavilion tier (named 'P') starting at index 0, 
// and at 45 degrees, towards the centerpoint (cp).
// Repeat this 8 times (8-fold symmetry)
P 0 @ 45 : cp x 8

// Cut the girdle (at 90 degrees) with a fixed depth (size).
// Note that we don't need to specify the symmetry again. 
G 0 @ 90 : size

// Cut the crown at 28 degrees, aiming for the meetpoint G, P
// but keeping the girdle.
C 0 @ 28 : mp(G, P) +girdle

// Add a floating table (at 0.2).
T 0 @ 0 : 0.2

The viewer updates instantly, the diagnostics area stays quiet, and the Printable Instructions panel lists your tiers. Each line in the snippet follows the same pattern: tier name (P, G, C, T), index, angle or reference point, and optional symmetry (x 8). Change an angle, press Process again, and watch the stone respond.

3. Preview and print

  1. Open the Diagram panel on the left.
  2. Pick a theme, toggle Compact if you need tighter tables, and choose Small or Large SVGs.
  3. Click Print to switch into a clean preview, then save as PDF or send it straight to paper.

4. What to explore next

  • Visit Tooling -> Web Studio for a deeper tour of the editor, viewer, and instructions panels.
  • Read the Analyzer and Optimizer guides to see how optical analysis and auto-tuning work.
  • Browse the FSL Tour for more language building blocks and design patterns.