Skip to content

Free, open-source 3D sculpting for Linux, macOS and Windows: dense meshes, remeshing, painting, built-in AI (image/text to 3D), Send to Unreal, game-ready LODs, Gaussian splats and OpenUSD.

5.0 KB
Raw Blame
# Your first sculpt in 10 minutes (docs/guide/first-sculpt.md): a cute owl head from the default sphere, step by
# step, in the default look (Forge Terminal, SculptForge layout). The guide's screenshots come from this run:
#   build/sculptforge --ui-test tests/ui/first_sculpt.sfui --ui-out build/first-sculpt
#   python3 tools/guide/make_images.py --first-sculpt build/first-sculpt
# and ctest runs it (ui_first_sculpt) so the lesson keeps working.
expect_value look == 1
expect_value shell_layout == 1

# 1. A fresh sphere (File > New Sphere, Ctrl+N), seen from the front (F frames it). X symmetry is on.
key ctrl+n
wait 0.2
camera 0 0
key f
wait 0.2
expect_value can_undo == 0
expect_value symmetry_x == 1
shot 01-sphere

# 2. Ear tufts: Move (4), a medium brush, pull up and out from the top on each side (symmetry does the other).
key 4
key s
key 1
key 1
key 0
key enter
expect_value draw_size == 110
view_drag 0.3637 0.3437 0.3393 0.2463 1.0
expect_value camera_yaw == 0
hover_window 0.97 0.5
wait 0.6
shot 02-tufts

# 3. The face: Alt+Clay (2) with a big brush digs two round hollows, one around each eye.
key 2
key s
key 1
key 2
key 0
key enter
expect_value draw_size == 120
hold alt
stroke 0.36 0.47 0.36 0.47
stroke 0.36 0.47 0.36 0.47
stroke 0.36 0.47 0.36 0.47
stroke 0.36 0.47 0.36 0.47
hold none
hover_window 0.97 0.5
wait 0.6
shot 03-face

# 4. The beak, on the middle line: Inflate (5) three clicks for a bump, Move (4) a short pull down to point it,
# Smooth (3) once along it to tidy it.
key 5
key s
key 3
key 0
key enter
expect_value draw_size == 30
stroke 0.5 0.6 0.5 0.6
stroke 0.5 0.6 0.5 0.6
stroke 0.5 0.6 0.5 0.6
key 4
key s
key 3
key 0
key enter
expect_value draw_size == 30
view_drag 0.4125 0.5386 0.4125 0.5711 0.6
expect_value camera_yaw == 0
key 3
key s
key 2
key 4
key enter
expect_value draw_size == 24
stroke 0.5 0.58 0.5 0.7
hover_window 0.97 0.5
wait 0.6
shot 04-beak

# 5. Add three levels (Ctrl+D): 5 million triangles, so the details and colours stay sharp.
remember triangles t0
key ctrl+d
key ctrl+d
key ctrl+d
wait_idle 60
expect_value triangles >= $t0*64
hover_window 0.97 0.5
wait 0.6
shot 05-divide

# 6. Eyes: Inflate (5), three clicks in each hollow: big round eyeballs.
key 5
key s
key 5
key 2
key enter
expect_value draw_size == 52
stroke 0.37 0.47 0.37 0.47
stroke 0.37 0.47 0.37 0.47
stroke 0.37 0.47 0.37 0.47
hover_window 0.97 0.5
wait 0.6
shot 06-eyes

# 7. Brows: Clay (2) strokes from between the eyes up and out over each eye.
key 2
key s
key 3
key 0
key enter
expect_value draw_size == 30
stroke 0.49 0.38 0.27 0.3
stroke 0.49 0.38 0.27 0.3
hover_window 0.97 0.5
wait 0.6
shot 07-brows

# 8. Colour: Paint > Fill, a warm brown everywhere.
click "Paint##menu.paint"
run set_color color=150,100,62
click "Color/Fill"
key escape
shot 08-fill

# 9. The Paint brush (P), soft: a big cream dab on each face disc.
key p
key s
key 1
key 0
key 0
key enter
expect_value draw_size == 100
mouse_move 0.6 0.5
key o
key 0
key enter
expect_value focal_shift == 0
run set_color color=240,224,196
stroke 0.37 0.47 0.37 0.47
stroke 0.37 0.47 0.37 0.47
hover_window 0.97 0.5
wait 0.6
shot 09-face

# 10. A hard edge (O, -100, Enter) for the eyes: amber, a black pupil, a white glint.
mouse_move 0.6 0.5
key o
key minus
key 1
key 0
key 0
key enter
expect_value focal_shift == -100
key s
key 4
key 4
key enter
expect_value draw_size == 44
run set_color color=255,176,30
stroke 0.37 0.47 0.37 0.47
key s
key 2
key 4
key enter
expect_value draw_size == 24
run set_color color=18,14,12
stroke 0.375 0.47 0.375 0.47
key s
key 8
key enter
expect_value draw_size == 8
run set_color color=255,255,255
stroke 0.36 0.44 0.36 0.44
hover_window 0.97 0.5
wait 0.6
shot 10-eyes

# 11. An orange beak, and a soft darker brown on the tips of the tufts.
key s
key 1
key 6
key enter
expect_value draw_size == 16
run set_color color=240,150,48
stroke 0.5 0.58 0.5 0.7
stroke 0.488 0.58 0.494 0.69
mouse_move 0.6 0.5
key o
key 0
key enter
expect_value focal_shift == 0
key s
key 7
key 0
key enter
expect_value draw_size == 70
run set_color color=96,60,36
stroke 0.24 0.04 0.24 0.04
stroke 0.24 0.04 0.24 0.04
key p
hover_window 0.97 0.5
wait 0.6
shot 11-beak

# 12. Material and render: White (M), Render > Materials > PBR, a three-quarter view, Save Render.
key m
wait 0.3
click "White##mat"
camera -28 -10
key f
wait 0.2
click "Render##menu.render"
click "Materials##section.material"
click "PBR##view.shading_pbr"
wait_idle 30
wait 1
shot 12-material
click "Material/Save Render##render.save_image"
expect_status Saved Render
key escape

# The ways in: Help > Your first sculpt (10 min), and the welcome's big button, open this chapter.
click "Help##menu.help"
click "Your first sculpt (10 min)##help.first_sculpt"
expect_value guide_open == 1
expect_guide first-sculpt.md
expect_text Your first sculpt in 10 minutes
shot guide
key shift+f1
expect_value guide_open == 0
key f3
type "##Command palette" "welcome"
key enter
expect_value welcome_open == 1
shot welcome
click "Start the 10-minute lesson##welcome.lesson"
expect_value welcome_open == 0
expect_value guide_open == 1
expect_guide first-sculpt.md