Merge main into feat/3d-classic-black-overprint

This commit is contained in:
dotCooCoo
2026-11-15 09:34:04 -08:00
50 changed files with 1557 additions and 100 deletions
+28 -3
View File
@@ -275,6 +275,29 @@ of an isometric view (each visible axis foreshortened equally). These are our ow
each view; the dialog shows a preset's name when the angles match it and **Custom** otherwise. The new effects
open at Off-Axis Front.
## Track cube
The Rotation tab of Extrude & Bevel (Classic), Revolve (Classic) and Rotate (Classic) has a track cube below the
presets, drawn at the current X, Y and Z rotation inside a ring
([set 3D rotation position options](https://web.archive.org/web/20220911143322/https://helpx.adobe.com/pdf/cs6/illustrator_reference.pdf#page=249)):
- Dragging a face turns the object freely. With Shift, a drag across turns it about the screen's vertical axis and a
drag up or down about its horizontal axis, whichever the drag follows first.
- Dragging an edge turns it about the object axis that edge runs along. The edge under the pointer shows its axis's
color: red for X, green for Y, blue for Z.
- Dragging in the ring turns it in the plane of the screen.
- The front face is blue, the top and bottom are light gray, the sides are mid gray and the back is dark gray, as
the help page above describes, along with the red, green and blue axis edges.
- Escape during a drag puts the angles back. With the keyboard focus, the arrow keys turn it about the screen's
horizontal and vertical axes, and Page Up and Page Down turn it in the screen plane, 1° a press or 15° with Shift.
The drag changes the effect's `rotationX`, `rotationY` and `rotationZ` and previews live; X, Y and Z and the
presets follow it (**Custom** off a preset). OK keeps the change as one undo step. The angles stay between -180°
and 180°: of the two sets of angles that give the same turn, the cube writes the one nearest the current values.
In the 3D and Materials panel, a drag is one undo step when the pointer is released, and the cube is off while the
selected effects hold different rotations. The cube's 0.5° per point of drag, Escape during a drag and its keyboard
steps are VectorCraft's own.
## Perspective
**Perspective** runs 0° to 160°, as the public panel options give it ("how close or far the object appears"),
@@ -397,7 +420,9 @@ Our reading:
- Softness is not applied to the shadow, and only the first light casts one.
- A shadow is cast from at most 327,680 faces, the solids of one object together (our own limit). Past it, a
command is refused with "The 3D shadow is too complex; turn Shadows off or simplify the art", and a loaded
file draws the source path.
file draws the source path. A command checks the shadow from the same builds that check the solids, as
drawing casts it, so each solid is built once. A stroke whose solid is left out of the art (past its own
limits) casts no shadow.
- Canvas, SVG and PDF exports draw the shadow, the art's bounds take it in, and Expand Appearance keeps it as a
path below the faces. Extrude & Bevel (Classic), Revolve (Classic) and Rotate (Classic) have no shadow.
@@ -555,8 +580,8 @@ out, perspective). No Adobe software, assets, presets or bevel shapes were used.
([Preserve Spot Color](https://help.adobe.com/archive/en_US/illustrator/cs5/illustrator_cs5_help.pdf#page=260)); how
the faces are shaded with it is VectorCraft's own. The Black Overprint shading color keeps each face's paint and
draws the shading over it as overprinting black, without the highlight. The shading is on the black plate in
Separations Preview and PDF output. The track cube, map art, Turntable and 3D export are
separate, unbuilt items.
Separations Preview and PDF output. Their Rotation tab has the track cube
([Track cube](#track-cube)). Map art, Turntable and 3D export are separate, unbuilt items.
Release measurements and a repeatable CLI scene are in [3D lighting performance](3d-lighting-performance.md).