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.

4.0 KB
Raw Blame
# Subdivision levels (Tool > Geometry): Add Level adds levels and keeps the lower ones, D / Shift+D and the Level
# slider step between them, detail sculpted at the top survives sculpting big forms at a low level, and undo
# steps back through strokes and level changes. A cube divided four times becomes a rounded box of quads.
run new_sphere subdivisions=1
run part_append type=cube name=Box
run part_delete index=0
expect_value parts == 1
expect_value triangles == 27648
orbit 140 -70
key f
click "Geometry##tool.geometry"
expect "Geometry/Add Level"
expect "Geometry/Smooth"
expect_value sdiv_levels == 0
expect_text "No subdivision levels"

# Rebuild Lower Levels finds the lower levels of a regular quad grid: 48 cells per side -> 24 -> 12 -> 6 -> 3.
click "Geometry/Rebuild Lower Levels"
expect_value sdiv_levels == 2
expect_value subdiv_level == 1
click "Geometry/Rebuild Lower Levels"
click "Geometry/Rebuild Lower Levels"
click "Geometry/Rebuild Lower Levels"
expect_value sdiv_levels == 5
expect_value triangles == 108
expect_status "Reconstructed"
# Close Geometry first: open, it is taller than the tray and Display's header would be out of reach.
click "Geometry##tool.geometry"
click "Display##tool.display"
click "Wireframe##display"
click "Geometry##tool.geometry"
shot reconstructed-cage

# Remove Above at the base leaves the plain 108-triangle cage to start from.
click "Geometry/Remove Above"
expect_text "Remove levels 2 to"
click "Delete Levels/Remove Levels Above"
expect_value sdiv_levels == 0
expect_value triangles == 108

# Add Level (Ctrl+D or the button): every level has four times the quads.
click "Geometry/Add Level"
expect_value sdiv_levels == 2
expect_value subdiv_level == 2
expect_value triangles == 432
key ctrl+d
key ctrl+d
key ctrl+d
expect_value sdiv_levels == 5
expect_value triangles == 27648
expect_text "Level 5 / 5"
expect_status "Level 5/5"
shot divided-wire
click "Geometry##tool.geometry"
click "Display##tool.display"
click "Wireframe##display"
click "Geometry##tool.geometry"

# Fine detail at the top level (B S T: Standard).
key b
key s
key t
snapshot
stroke 0.25 0.35 0.75 0.4
stroke 0.3 0.5 0.7 0.55
expect_value moved > 200
shot top-detail

# Step down twice (Shift+D) and sculpt a big form: few vertices move.
key shift+d
key shift+d
expect_value subdiv_level == 3
expect_value triangles == 1728
expect_text "Level 3 / 5"
shot level-3
snapshot
key ]
key ]
key ]
key ]
key ]
key ]
key ]
stroke 0.2 0.7 0.75 0.75 1.0
key [
key [
key [
key [
key [
key [
key [
expect_value moved > 3
expect_value moved < 300
shot level-3-form

# Back up (D twice): the top level shows the big form with the fine detail on it.
key d
key d
expect_value subdiv_level == 5
expect_value triangles == 27648
shot top-after-low-edit

# Undo goes back through the steps and strokes in order: two steps, the low stroke, two steps, the detail.
key ctrl+z
expect_value subdiv_level == 4
key ctrl+z
expect_value subdiv_level == 3
snapshot
key ctrl+z
expect_value moved > 3
key ctrl+z
key ctrl+z
expect_value subdiv_level == 5
snapshot
key ctrl+z
expect_value moved > 200
expect_value subdiv_level == 5
key ctrl+shift+z
expect_value subdiv_level == 5

# The Level slider: drag it to the left end for the base cage.
drag_item "Geometry/##level" -400 0
expect_value subdiv_level == 1
expect_value triangles == 108
shot base-level

# The Part list shows the level.
click "Parts##tool.part"
expect_text "Level 1/5"
shot part-list

# Remove Below at level 2 makes it the new base; Remove Above drops the top.
click "Geometry##tool.geometry"
key d
click "Geometry/Remove Below"
# It asks first (Discord 11-02: destructive steps confirm before levels go).
expect_text "Remove levels 1 to 1?"
click "Delete Levels/Remove Levels Below"
expect_value subdiv_level == 1
expect_value sdiv_levels == 4
expect_value triangles == 432
click "Geometry/Higher Level"
click "Geometry/Remove Above"
expect_text "Remove levels 3 to 4"
shot delete-levels-confirm
click "Delete Levels/Remove Levels Above"
expect_value sdiv_levels == 2
key ctrl+z
expect_value sdiv_levels == 4
shot after-delete