mirror of
https://github.com/storytold/vectorcraft.git
synced 2026-11-18 19:40:21 +00:00
3D: graphics map onto Extrude & Bevel's walls and bevels
A graphic's face can be `side` on Extrude & Bevel. The side is unrolled flat: x runs along the art's own outline, through corners and curves, clockwise from the top of the outline's middle line, and y runs from the front edge toward the back, across the bevel steps and the walls. Twist and taper carry the graphic with the side. Each piece of the side that faces the viewer draws the part of the graphic that falls on it, shaded as the piece is, as on Revolve's side. The graphics go once, on the solid with the longest outline. A hollow object takes side graphics. The Materials tab offers Side beside Front and Back, and the blue handle moves a side graphic over the visible part of the side. Plane and Revolve drop side graphics on a type change. threeD.mapGraphic fits a new side graphic inside the side unrolled.
This commit is contained in:
@@ -180,7 +180,7 @@ VectorCraft choices; an original approximation, never compared with another appl
|
||||
|---|---|
|
||||
| Revolve | initial: live, editable profile, rotation and light gizmos, default-on Cap with continuous curved rims, smooth vector shading and round seam joins, overlapping faces drawn in the order of their depths where they overlap, SVG/PDF output, Expand Appearance ([revolve.md](revolve.md), #846) |
|
||||
| Extrude & Bevel, Inflate, Rotate | initial: live, round seam joins, depth, twist, taper, solid or hollow caps, five original bevel shapes, Inflate volume, both sides, twist, taper and cap, Rotate of every fill and stroke, groups and layers turned about one shared axis (#4506), contours that cross, touch or overlap merged first ([three-d.md](three-d.md)), Position presets, rotation and light gizmos, SVG/PDF output, Expand Appearance ([three-d.md](three-d.md)) |
|
||||
| Materials panel, lighting, ray-traced render | Window › 3D and Materials panel with the object types (Plane, Extrude, Revolve, Inflate) and the Object, Rotation and Lighting settings of the applied effect, and Quick Actions › Expand as Wireframes ([three-d.md](three-d.md#3d-and-materials-panel)); one to ten directional lights with per-light Color (opaque RGB, white by default), Intensity, Rotation, Height, Softness and neutral Ambient Light, Revolve and colored Inflate use smooth vector shading; Extrude & Bevel and Rotate retain planar shading; original Standard, Diffuse, Top Left and Right lighting rigs; hard-edged shadows behind or below the object from the first light ([three-d.md](three-d.md#shadows)); the Materials tab's Graphics, document symbols mapped onto Extrude & Bevel's caps and onto a plane, moved with an artboard handle, and wrapped around Revolve's side ([three-d.md](three-d.md#graphics)); no base materials, graphics on Inflate or on Extrude & Bevel's walls and bevels, soft shadows or ray tracing |
|
||||
| Materials panel, lighting, ray-traced render | Window › 3D and Materials panel with the object types (Plane, Extrude, Revolve, Inflate) and the Object, Rotation and Lighting settings of the applied effect, and Quick Actions › Expand as Wireframes ([three-d.md](three-d.md#3d-and-materials-panel)); one to ten directional lights with per-light Color (opaque RGB, white by default), Intensity, Rotation, Height, Softness and neutral Ambient Light, Revolve and colored Inflate use smooth vector shading; Extrude & Bevel and Rotate retain planar shading; original Standard, Diffuse, Top Left and Right lighting rigs; hard-edged shadows behind or below the object from the first light ([three-d.md](three-d.md#shadows)); the Materials tab's Graphics, document symbols mapped onto Extrude & Bevel's caps and onto a plane, moved with an artboard handle, and wrapped around Extrude & Bevel's walls and bevels and around Revolve's side ([three-d.md](three-d.md#graphics)); no base materials, graphics on Inflate, soft shadows or ray tracing |
|
||||
| 3D (Classic): Extrude & Bevel, Revolve, Rotate | Extrude & Bevel (Classic) initial: live, round seam joins, Extrude Depth, Cap, five original bevel shapes with Height and Bevel Extent In or Out, Position presets and rotation gizmo, Perspective, Wireframe, No Shading, Diffuse and Plastic surfaces with one to ten lights, Light Intensity, Ambient Light, Highlight Intensity and Size, Blend Steps, Black, Custom or no Shading Color, Draw Hidden Faces ([create 3D objects](https://helpx.adobe.com/illustrator/desktop/special-effects-styles/create-3d-graphics/create-3d-objects.html)); Revolve (Classic) initial: live, round seam joins, Angle, Cap, Offset from the left or right edge, Position presets and rotation gizmo, Perspective, the same four surfaces, lights, highlight, Blend Steps and Shading Color, groups and layers revolved about one shared axis (same page); Rotate (Classic) initial: live, round seam joins, every fill and stroke turned as one plane, Position presets and rotation gizmo, Perspective, No Shading and Diffuse surfaces with lights, Ambient Light, Blend Steps and Shading Color ([rotate objects in 3D](https://helpx.adobe.com/illustrator/desktop/special-effects-styles/create-3d-graphics/rotate-objects-in-3d.html)); Map Art: none |
|
||||
| Turntable (30.0 beta) | none |
|
||||
| Export 3D objects (OBJ, USDA, glTF) | initial: Asset Export's Export 3D Object collects an object with Extrude & Bevel, Revolve, Inflate or Rotate as a 3D asset, and Export writes its solids as a USDA (the default), USDZ, glTF or OBJ mesh with a material in each solid's paint color (`assets.add3D`, `assets.set3DFormat`, `assets.export3D`); no textures, map art or shading ([3D export help](https://helpx.adobe.com/illustrator/desktop/special-effects-styles/create-3d-graphics/export-3d-vector-artwork.html)) |
|
||||
|
||||
+10
-6
@@ -3951,20 +3951,24 @@ unique) and leaves the art as it is: the 3D and Materials panel's Add as Single
|
||||
`name` that is not a string or is empty, or any other key, is refused.
|
||||
|
||||
`threeD.mapGraphic {symbol, face?, x?, y?, scale?, rotation?, index?, item?, ids?|id?}` adds a graphic to the 3D
|
||||
effect of each selected object, in one undo step: `face` is `front` (default) or `back`, `x` and `y` are the
|
||||
effect of each selected object, in one undo step: `face` is `front` (default), `back` or `side`, `x` and `y` are the
|
||||
offset in points of the graphic's center from the center of the object's bounds in the face's plane, `scale` is a
|
||||
percentage of the symbol's size (1..10000; omitted, 100 or less so the graphic fits inside the object) and
|
||||
`rotation` is in degrees counterclockwise (-360..360). Without `index` each object's first 3D effect takes it, and `item` is refused.
|
||||
Every object's 3D effect must be Extrude & Bevel with Cap on (front only at a depth of 0), Rotate (the Plane type,
|
||||
front only) or Revolve (front only: its swept side), and `symbol` must name a document symbol; otherwise the command is refused and nothing changes. It returns `{ids, graphic}`.
|
||||
On Revolve, `x` and `y` are measured on the side unrolled flat from its middle, and a graphic that does not fit
|
||||
starts scaled to fit the half of the side seen from the front ([three-d.md](three-d.md#graphics)).
|
||||
Every object's 3D effect must be Extrude & Bevel (front only at a depth of 0; `front` and `back` need Cap on, and
|
||||
`side`, its walls and bevels, does not), Rotate (the Plane type, front only) or Revolve (front only: its swept
|
||||
side), and `symbol` must name a document symbol; otherwise the command is refused and nothing changes. It returns `{ids, graphic}`.
|
||||
On Revolve and on Extrude & Bevel's side, `x` and `y` are measured on the side unrolled flat from its middle (on
|
||||
Extrude & Bevel, `x` along the outline, clockwise from its top, and `y` from the front toward the back), and a
|
||||
graphic that does not fit starts scaled to fit the part of Extrude & Bevel's side unrolled about `x` = 0 that does
|
||||
not reach its cut, or the half of Revolve's side seen from the front ([three-d.md](three-d.md#graphics)).
|
||||
|
||||
The graphics are the `graphics` parameter of `threeD.extrude`, `threeD.rotate` and `threeD.revolve`, which `effect.setParams` also
|
||||
edits: an array of up to 64 `{symbol, face, x, y, scale, rotation}` objects, drawn on the face turned,
|
||||
foreshortened and shaded with it and clipped to it ([Map artworks on 3D object](https://helpx.adobe.com/illustrator/desktop/special-effects-styles/create-3d-graphics/map-artwork-on-3d-objects.html)).
|
||||
Revolve takes graphics on its swept side and shades them with the object's light ([the archived reference, page 185](https://web.archive.org/web/20210601162814/https://helpx.adobe.com/pdf/illustrator_reference.pdf#page=185));
|
||||
how a graphic wraps around the side is VectorCraft's own rule.
|
||||
how a graphic wraps around the side is VectorCraft's own rule. Extrude & Bevel takes graphics on its side, its
|
||||
walls and bevels unrolled as one surface; how they are unrolled is VectorCraft's own rule.
|
||||
A graphic naming a symbol the document does not have is refused, unless the effect already holds a graphic of it.
|
||||
The drawing rules are VectorCraft's own; see [three-d.md](three-d.md#graphics).
|
||||
|
||||
|
||||
+29
-14
@@ -363,8 +363,8 @@ The public [Map artworks on 3D object](https://helpx.adobe.com/illustrator/deskt
|
||||
page describes graphics: art kept with the document and placed on single surfaces of a 3D object, and the
|
||||
[3D and Materials panel options](https://helpx.adobe.com/illustrator/desktop/special-effects-styles/create-3d-graphics/3d-materials-panel-options.html)
|
||||
page lists Graphics and Add Materials and Graphics on the Materials tab. VectorCraft maps graphics onto
|
||||
Extrude & Bevel's front and back caps, the plane of the Plane type (Rotate), and the swept side of Revolve, which the
|
||||
public page's example of a label on a bottle describes.
|
||||
Extrude & Bevel's front and back caps and its side (its walls and bevels), the plane of the Plane type (Rotate), and
|
||||
the swept side of Revolve, which the public page's example of a label on a bottle describes.
|
||||
|
||||
- The panel's **Materials** tab shows the document's graphics as thumbnails. A graphic is a document symbol, as
|
||||
the public page allows existing symbols to be used. **Add as Single Graphic** keeps the selected art as a new
|
||||
@@ -373,9 +373,9 @@ public page's example of a label on a bottle describes.
|
||||
- Clicking a thumbnail maps that graphic onto the front of the 3D effect of each selected object
|
||||
(`threeD.mapGraphic`), in one undo step. A graphic larger than the object starts scaled down to fit inside it.
|
||||
- Below the thumbnails the tab lists the graphics mapped onto the first selected object. The selected one shows
|
||||
its Face (Front or Back; Plane and Revolve show no Face, as a plane has only a front and Revolve's graphics go
|
||||
on its side), X and Y (the offset of its center from the center of the
|
||||
object's bounds, in the face's plane), Scale (a percentage of the symbol's size) and Rotation
|
||||
its Face (Front, Back or Side; Plane and Revolve show no Face, as a plane has only a front and Revolve's graphics
|
||||
go on its side), X and Y (the offset of its center from the center of the
|
||||
object's bounds, in the face's plane, or on a side from its middle unrolled flat), Scale (a percentage of the symbol's size) and Rotation
|
||||
(counterclockwise), and **Remove Graphic** takes it off. Each change is one undo step.
|
||||
- While the tab is open, a blue handle sits on the center of each mapped graphic whose face is turned toward the
|
||||
viewer. Dragging a handle moves that graphic over its face, previewed while the pointer is down and recorded as
|
||||
@@ -413,6 +413,20 @@ These rules are VectorCraft's own:
|
||||
or point, takes none. A graphic larger than the half of the side seen from the front starts
|
||||
scaled to fit it. The panel shows no handle for a Revolve's graphics; X and Y move them. Expand Appearance keeps
|
||||
every face of a surface with graphics.
|
||||
- On Extrude & Bevel a graphic on the Side lies on the walls and bevels, unrolled flat. X runs along the art's own
|
||||
outline (the front cap's edge, or with a bevel carved into the shape the walls' outline), through its corners and
|
||||
around its curves: 0 is where the outline's top crosses the vertical line
|
||||
through the middle of its bounds, and X grows clockwise around the outline as the front is seen, so the graphic
|
||||
reads the right way round from outside. Y runs from the front cap's edge toward the back cap's, measured from the
|
||||
middle: across each bevel step along its slant, and across the walls along the depth. Both are lengths before
|
||||
the twist and the taper, which carry the graphic with the side. The side is cut at the anchor of the outline
|
||||
nearest half way around from X = 0. On a compound shape the graphics go on its longest contour, and on an object
|
||||
with several solids (a fill and its stroke's outline, or the members of a group or layer) they go once, on the
|
||||
side of the solid with the longest outline. Each piece of the side that shows its outside to the viewer draws the
|
||||
part of the graphic that falls on it, shaded as the piece is, with the same cutting and seams as on Revolve; a
|
||||
piece of a stroke's face cut where it passes through a wall draws the part within its own outline. A graphic larger than the
|
||||
part of the side unrolled about X = 0 that does not reach its cut starts scaled to fit it. The blue handle sits on the graphic's center while that point is on a
|
||||
piece the viewer sees, and dragging it moves the graphic over the visible part of the side.
|
||||
- The symbol's fills and strokes are drawn as filled areas, a stroke as its outline, and their gradients and
|
||||
patterns are placed with the graphic. Images, hidden objects,
|
||||
guides and clipping paths in the symbol are left out, and clipping groups draw their art unclipped. Instances
|
||||
@@ -421,15 +435,16 @@ These rules are VectorCraft's own:
|
||||
- Without perspective, the graphic maps exactly. With perspective, straight lines stay straight and each curve is
|
||||
cut into 8 cubic pieces before it is mapped. The part of a graphic at or behind the eye is left out.
|
||||
- An object takes up to 64 graphics. One graphic draws up to 4,096 fills and strokes, and the graphics of one 3D
|
||||
effect draw up to 400,000 path elements together (on Revolve, 400,000 points after the curves are cut, and up to
|
||||
effect draw up to 400,000 path elements together (on Revolve's side and Extrude & Bevel's, 400,000 points after the curves are cut, and up to
|
||||
2,000,000 once they are cut at the faces, with up to 64,000,000 points cut together, and the copies of their
|
||||
paints in the parts take up to 256 MiB per object, apart from those of the surfaces). Commands refuse a graphic
|
||||
past either limit. A loaded file
|
||||
draws the object without a graphic past the first limit, and without all of its graphics past the second.
|
||||
- A hollow Extrude & Bevel has no caps, so its graphics are not drawn until Cap is turned on again, and
|
||||
`threeD.mapGraphic` refuses to map a new one onto it. Changing the type to Inflate drops the graphics, and
|
||||
changing between Extrude, Plane and Revolve keeps them, except that Plane and Revolve drop the graphics on the
|
||||
back cap; on Revolve the front's graphics go on its side.
|
||||
- A hollow Extrude & Bevel has no caps, so the graphics on its caps are not drawn until Cap is turned on again,
|
||||
and `threeD.mapGraphic` refuses to map a new one onto a cap; its side takes graphics. With a depth of 0 the object
|
||||
is a plane, and `threeD.mapGraphic` maps graphics onto its front only. Changing the type to Inflate drops the
|
||||
graphics, and changing between Extrude, Plane and Revolve keeps them, except that Plane and Revolve drop the
|
||||
graphics on the back cap and on Extrude & Bevel's side; on Revolve the front's graphics go on its side.
|
||||
- `effect.apply` and `effect.setParams` refuse a graphic that names a symbol the document does not have, unless
|
||||
the effect already holds a graphic of that symbol. A graphic whose symbol is deleted is no longer drawn. Renaming a symbol renames it in the graphics that use it,
|
||||
in the layers, in the art of symbols, patterns, graph designs, brushes and opacity masks, and in graphic
|
||||
@@ -444,7 +459,7 @@ uses: `rotationX`, `rotationY`, `rotationZ`, `perspectiveAngle` (degrees), `shad
|
||||
`lightHeight` (degrees), `lightSoftness` (%), `ambient` (%, to 200), `lightBehind`. Lengths are points and scale with the object (Scale Strokes & Effects).
|
||||
Commands validate the shape and the parameters before the document changes. All four also take `lights`: null (the default, use the earlier single-light fields), or an array of one to ten objects. Each object takes `color` (opaque `#rrggbb`, white), `intensity` (0..100%, 80), `rotation` (-180..180 degrees, 125.26), `height` (0..90 degrees, 30), `softness` (0..100%, 0), and `behind` (boolean, false). Omitted settings use those defaults. An explicit list replaces the earlier single light; `ambient` and `shade` remain shared. Set `lights` to null to return to the single-light fields. Invalid lists, counts, keys and values are rejected before editing; malformed loaded lists fall back to the earlier light safely. All four take `shadow` (boolean, false), `shadowPosition` (`behind` or `below`), `shadowDistance` (0..100%, 0) and `shadowBounds` (10..400%, 100) ([Shadows](#shadows)); values out of range are rejected before editing.
|
||||
`threeD.extrude`, `threeD.rotate` and `threeD.revolve` take `graphics` ([Graphics](#graphics)): an array of up to 64 objects, each
|
||||
with `symbol` (the name of a document symbol), `face` (`front` or `back`, default `front`; `threeD.rotate` and
|
||||
with `symbol` (the name of a document symbol), `face` (`front`, `back` or `side`, default `front`; `threeD.rotate` and
|
||||
`threeD.revolve` take `front` only), `x` and `y` (points, default 0), `scale` (1..10000%, default 100) and `rotation` (-360..360 degrees,
|
||||
default 0). Other keys, values out of range and graphics on the other 3D effects are rejected before editing.
|
||||
|
||||
@@ -455,11 +470,11 @@ and [Create 3D objects](https://helpx.adobe.com/illustrator/desktop/special-effe
|
||||
pages, and the archived Extrude & Bevel option list (depth 0–2,000, cap on/off, bevel height, bevel extent in or
|
||||
out, perspective). No Adobe software, assets, presets or bevel shapes were used.
|
||||
|
||||
- **Materials** (base and Adobe Substance), graphics on Inflate and on Extrude & Bevel's walls and bevels, soft
|
||||
- **Materials** (base and Adobe Substance), graphics on Inflate, soft
|
||||
shadows, shadows of lights after the first, and **ray-traced rendering** are not built: shading uses directional
|
||||
lights, in the paint of the fill or stroke the solid is built for ([Fills and strokes](#fills-and-strokes)), and
|
||||
the shadow is hard-edged ([Shadows](#shadows)). Graphics map onto planar faces and Revolve's side only
|
||||
([Graphics](#graphics)).
|
||||
the shadow is hard-edged ([Shadows](#shadows)). Graphics map onto planar faces, Extrude & Bevel's side as one
|
||||
surface unrolled flat, and Revolve's side only ([Graphics](#graphics)).
|
||||
- The bevel shapes and their names are our own; custom bevel paths are not supported.
|
||||
- Visibility is a painter's algorithm: faces of a closed solid turned away are left out, and the rest are drawn
|
||||
back to front, with a flat cap or flat back turned toward the viewer drawn after all of them. Concave solids
|
||||
|
||||
Reference in New Issue
Block a user