Merge pull request #7871 from dotCooCoo/feat/3d-classic-black-overprint

3D (Classic): the Black Overprint shading color shades with overprinting black over the fill
This commit is contained in:
BFlat
2026-11-16 08:13:18 +07:00
committed by GitHub
37 changed files with 282 additions and 31 deletions
+3 -3
View File
@@ -210,21 +210,21 @@ pub fn effect_catalog() -> Vec<EffectInfo> {
CLASSIC_EXTRUDE,
"Extrude & Bevel (Classic)…",
&["Effect", "3D and Materials", "3D (Classic)"],
"{depth: pt (0..2000, 50), cap: bool (true: solid; false: hollow), bevel: none|classic|rounded|cove|step|ogee (none), bevelHeight: pt (1..100, 4; the bevel is as wide as it is tall), bevelInside: bool (false: added around the shape; true: carved into it), rotationX: degrees (-180..180, -21.88), rotationY: degrees (-180..180, -23.4), rotationZ: degrees (-180..180, 9.06; the defaults are the Off-Axis Front position), perspectiveAngle: degrees (0..160, 0; 0 is none, wider brings the eye nearer), surface: wireframe|none|diffuse|plastic (plastic; wireframe draws the edges of every face, hidden ones included, and fills none; none keeps the paint unlit; diffuse lights the faces softly; plastic adds a glossy highlight), lights: null or array of 1..10 objects (intensity: % 0..100, rotation: degrees -180..180, height: degrees 0..90, behind: bool; overrides the single-light fields; the lights add up; color and softness are not used), lightRotation: degrees (-180..180, 125.26; round the object on the page, 0 on its right, counterclockwise), lightHeight: degrees (0..90, 30; 0 beside the object, 90 straight in front), lightBehind: bool (false; true lights it from behind), lightIntensity: % (0..100, 100), ambient: % (0..100, 50; Ambient Light, every face whichever way it faces), highlightIntensity: % (0..100, 60; plastic only), highlightSize: % (0..100, 90; 100 broad, 0 a small spot; plastic only), blendSteps: integer (1..256, 25; how many levels the shading and the highlight are rounded to), shadingColor: black|custom|none (black; the color the faces darken toward; none keeps the paint and adds only the highlight), shadingCustom: #rrggbb (#000000; the color shadingColor custom darkens toward), preserveSpotColors: bool (false; a color linked to a spot or global swatch stays a tint of that swatch, lighter where the highlight is, with black multiplied and overprinting where the faces darken, so a spot color keeps its plate; it does nothing while shadingColor is custom), drawHiddenFaces: bool (false; also draws the faces turned away, behind the others)}. The front face is the art, extruded backwards about the center of its bounds; a solid is built for the top fill and for each stroke, each in its own paint. The defaults are VectorCraft's own.",
"{depth: pt (0..2000, 50), cap: bool (true: solid; false: hollow), bevel: none|classic|rounded|cove|step|ogee (none), bevelHeight: pt (1..100, 4; the bevel is as wide as it is tall), bevelInside: bool (false: added around the shape; true: carved into it), rotationX: degrees (-180..180, -21.88), rotationY: degrees (-180..180, -23.4), rotationZ: degrees (-180..180, 9.06; the defaults are the Off-Axis Front position), perspectiveAngle: degrees (0..160, 0; 0 is none, wider brings the eye nearer), surface: wireframe|none|diffuse|plastic (plastic; wireframe draws the edges of every face, hidden ones included, and fills none; none keeps the paint unlit; diffuse lights the faces softly; plastic adds a glossy highlight), lights: null or array of 1..10 objects (intensity: % 0..100, rotation: degrees -180..180, height: degrees 0..90, behind: bool; overrides the single-light fields; the lights add up; color and softness are not used), lightRotation: degrees (-180..180, 125.26; round the object on the page, 0 on its right, counterclockwise), lightHeight: degrees (0..90, 30; 0 beside the object, 90 straight in front), lightBehind: bool (false; true lights it from behind), lightIntensity: % (0..100, 100), ambient: % (0..100, 50; Ambient Light, every face whichever way it faces), highlightIntensity: % (0..100, 60; plastic only), highlightSize: % (0..100, 90; 100 broad, 0 a small spot; plastic only), blendSteps: integer (1..256, 25; how many levels the shading and the highlight are rounded to), shadingColor: black|custom|none|blackOverprint (black; the color the faces darken toward; none keeps the paint and adds only the highlight; blackOverprint keeps the paint and draws the shading over it as overprinting black, on the black plate, with no highlight), shadingCustom: #rrggbb (#000000; the color shadingColor custom darkens toward), preserveSpotColors: bool (false; a color linked to a spot or global swatch stays a tint of that swatch, lighter where the highlight is, with black multiplied and overprinting where the faces darken, so a spot color keeps its plate; it does nothing while shadingColor is custom, and with blackOverprint every face keeps its paint and swatch link whether it is on or off), drawHiddenFaces: bool (false; also draws the faces turned away, behind the others)}. The front face is the art, extruded backwards about the center of its bounds; a solid is built for the top fill and for each stroke, each in its own paint. The defaults are VectorCraft's own.",
json!({"depth":50.0,"cap":true,"bevel":"none","bevelHeight":4.0,"bevelInside":false,"rotationX":-21.88,"rotationY":-23.4,"rotationZ":9.06,"perspectiveAngle":0.0,"surface":"plastic","lights":null,"lightRotation":125.26438968275465,"lightHeight":30.0,"lightBehind":false,"lightIntensity":100.0,"ambient":50.0,"highlightIntensity":60.0,"highlightSize":90.0,"blendSteps":25,"shadingColor":"black","shadingCustom":"#000000","preserveSpotColors":false,"drawHiddenFaces":false}),
),
g(
CLASSIC_REVOLVE,
"Revolve (Classic)…",
&["Effect", "3D and Materials", "3D (Classic)"],
"{angle: degrees (0..360, 360; how far the profile sweeps round the axis), cap: bool (true: solid, the open ends closed; false: hollow), offset: pt (0..1000, 0; the axis's distance from the profile, a ring past 0), edge: left|right (left; the axis is at the left or the right edge of the profile's bounds), rotationX: degrees (-180..180, -21.88), rotationY: degrees (-180..180, -23.4), rotationZ: degrees (-180..180, 9.06; the defaults are the Off-Axis Front position), perspectiveAngle: degrees (0..160, 0; 0 is none, wider brings the eye nearer), surface: wireframe|none|diffuse|plastic (plastic; wireframe draws the edges of every face and fills none; none keeps the paint unlit; diffuse lights the faces softly; plastic adds a glossy highlight), lights: null or array of 1..10 objects (intensity: % 0..100, rotation: degrees -180..180, height: degrees 0..90, behind: bool; overrides the single-light fields; the lights add up; color and softness are not used), lightRotation: degrees (-180..180, 125.26; round the object on the page, 0 on its right, counterclockwise), lightHeight: degrees (0..90, 30; 0 beside the object, 90 straight in front), lightBehind: bool (false; true lights it from behind), lightIntensity: % (0..100, 100), ambient: % (0..100, 50; Ambient Light, every face whichever way it faces), highlightIntensity: % (0..100, 60; plastic only), highlightSize: % (0..100, 90; 100 broad, 0 a small spot; plastic only), blendSteps: integer (1..256, 25; how many levels the shading and the highlight are rounded to), shadingColor: black|custom|none (black; the color the faces darken toward; none keeps the paint and adds only the highlight), shadingCustom: #rrggbb (#000000; the color shadingColor custom darkens toward), preserveSpotColors: bool (false; a color linked to a spot or global swatch stays a tint of that swatch, lighter where the highlight is, with black multiplied and overprinting where the faces darken, so a spot color keeps its plate; it does nothing while shadingColor is custom)}. The profile sweeps round a vertical axis, as Revolve's does, painted with the top fill (else the top stroke); every face is drawn, back to front. The defaults are VectorCraft's own.",
"{angle: degrees (0..360, 360; how far the profile sweeps round the axis), cap: bool (true: solid, the open ends closed; false: hollow), offset: pt (0..1000, 0; the axis's distance from the profile, a ring past 0), edge: left|right (left; the axis is at the left or the right edge of the profile's bounds), rotationX: degrees (-180..180, -21.88), rotationY: degrees (-180..180, -23.4), rotationZ: degrees (-180..180, 9.06; the defaults are the Off-Axis Front position), perspectiveAngle: degrees (0..160, 0; 0 is none, wider brings the eye nearer), surface: wireframe|none|diffuse|plastic (plastic; wireframe draws the edges of every face and fills none; none keeps the paint unlit; diffuse lights the faces softly; plastic adds a glossy highlight), lights: null or array of 1..10 objects (intensity: % 0..100, rotation: degrees -180..180, height: degrees 0..90, behind: bool; overrides the single-light fields; the lights add up; color and softness are not used), lightRotation: degrees (-180..180, 125.26; round the object on the page, 0 on its right, counterclockwise), lightHeight: degrees (0..90, 30; 0 beside the object, 90 straight in front), lightBehind: bool (false; true lights it from behind), lightIntensity: % (0..100, 100), ambient: % (0..100, 50; Ambient Light, every face whichever way it faces), highlightIntensity: % (0..100, 60; plastic only), highlightSize: % (0..100, 90; 100 broad, 0 a small spot; plastic only), blendSteps: integer (1..256, 25; how many levels the shading and the highlight are rounded to), shadingColor: black|custom|none|blackOverprint (black; the color the faces darken toward; none keeps the paint and adds only the highlight; blackOverprint keeps the paint and draws the shading over it as overprinting black, on the black plate, with no highlight), shadingCustom: #rrggbb (#000000; the color shadingColor custom darkens toward), preserveSpotColors: bool (false; a color linked to a spot or global swatch stays a tint of that swatch, lighter where the highlight is, with black multiplied and overprinting where the faces darken, so a spot color keeps its plate; it does nothing while shadingColor is custom, and with blackOverprint every face keeps its paint and swatch link whether it is on or off)}. The profile sweeps round a vertical axis, as Revolve's does, painted with the top fill (else the top stroke); every face is drawn, back to front. The defaults are VectorCraft's own.",
json!({"angle":360.0,"cap":true,"offset":0.0,"edge":"left","rotationX":-21.88,"rotationY":-23.4,"rotationZ":9.06,"perspectiveAngle":0.0,"surface":"plastic","lights":null,"lightRotation":125.26438968275465,"lightHeight":30.0,"lightBehind":false,"lightIntensity":100.0,"ambient":50.0,"highlightIntensity":60.0,"highlightSize":90.0,"blendSteps":25,"shadingColor":"black","shadingCustom":"#000000","preserveSpotColors":false}),
),
g(
CLASSIC_ROTATE,
"Rotate (Classic)…",
&["Effect", "3D and Materials", "3D (Classic)"],
"{rotationX: degrees (-180..180, -21.88), rotationY: degrees (-180..180, -23.4), rotationZ: degrees (-180..180, 9.06; the defaults are the Off-Axis Front position), perspectiveAngle: degrees (0..160, 0; 0 is none, wider brings the eye nearer), surface: none|diffuse (diffuse; none keeps the paint unlit; diffuse lights the art softly), lights: null or array of 1..10 objects (intensity: % 0..100, rotation: degrees -180..180, height: degrees 0..90, behind: bool; overrides the single-light fields; the lights add up; color and softness are not used), lightRotation: degrees (-180..180, 125.26; round the object on the page, 0 on its right, counterclockwise), lightHeight: degrees (0..90, 30; 0 beside the object, 90 straight in front), lightBehind: bool (false; true lights it from behind), lightIntensity: % (0..100, 100), ambient: % (0..100, 50; Ambient Light, the art whichever way it faces), blendSteps: integer (1..256, 25; how many levels the shading is rounded to), shadingColor: black|custom|none (black; the color the art darkens toward; none keeps the paint), shadingCustom: #rrggbb (#000000; the color shadingColor custom darkens toward), preserveSpotColors: bool (false; a color linked to a spot or global swatch stays a tint of that swatch, with black multiplied and overprinting where the art darkens, so a spot color keeps its plate; it does nothing while shadingColor is custom)}. Every fill and stroke turns as one flat plane about the center of the object's bounds, as Rotate's do, each in its own paint, and is seen from either side. The defaults are VectorCraft's own.",
"{rotationX: degrees (-180..180, -21.88), rotationY: degrees (-180..180, -23.4), rotationZ: degrees (-180..180, 9.06; the defaults are the Off-Axis Front position), perspectiveAngle: degrees (0..160, 0; 0 is none, wider brings the eye nearer), surface: none|diffuse (diffuse; none keeps the paint unlit; diffuse lights the art softly), lights: null or array of 1..10 objects (intensity: % 0..100, rotation: degrees -180..180, height: degrees 0..90, behind: bool; overrides the single-light fields; the lights add up; color and softness are not used), lightRotation: degrees (-180..180, 125.26; round the object on the page, 0 on its right, counterclockwise), lightHeight: degrees (0..90, 30; 0 beside the object, 90 straight in front), lightBehind: bool (false; true lights it from behind), lightIntensity: % (0..100, 100), ambient: % (0..100, 50; Ambient Light, the art whichever way it faces), blendSteps: integer (1..256, 25; how many levels the shading is rounded to), shadingColor: black|custom|none|blackOverprint (black; the color the art darkens toward; none keeps the paint; blackOverprint keeps the paint and draws the shading over it as overprinting black, on the black plate), shadingCustom: #rrggbb (#000000; the color shadingColor custom darkens toward), preserveSpotColors: bool (false; a color linked to a spot or global swatch stays a tint of that swatch, with black multiplied and overprinting where the art darkens, so a spot color keeps its plate; it does nothing while shadingColor is custom, and with blackOverprint the art keeps its paint and swatch link whether it is on or off)}. Every fill and stroke turns as one flat plane about the center of the object's bounds, as Rotate's do, each in its own paint, and is seen from either side. The defaults are VectorCraft's own.",
json!({"rotationX":-21.88,"rotationY":-23.4,"rotationZ":9.06,"perspectiveAngle":0.0,"surface":"diffuse","lights":null,"lightRotation":125.26438968275465,"lightHeight":30.0,"lightBehind":false,"lightIntensity":100.0,"ambient":50.0,"blendSteps":25,"shadingColor":"black","shadingCustom":"#000000","preserveSpotColors":false}),
),
g(
+35
View File
@@ -164,6 +164,41 @@ mod tests {
}
}
/// With Black Overprint every face keeps the blue, and the faces that darken get black over it,
/// overprinting, as strong as the darkening of the shading color Black.
#[test]
fn black_overprint_keeps_the_blue_under_overprinting_black() {
let darkened = revolved(json!({"surface": "diffuse"}));
let art = revolved(json!({"surface": "diffuse", "shadingColor": "blackOverprint"}));
let (darkened, drawn) = (faces(&darkened), faces(&art));
assert_eq!(darkened.len(), drawn.len());
let mut shaded = 0;
for (face, black) in drawn.iter().zip(&darkened) {
let fills: Vec<&vectorcraft_doc::FillLayer> = face
.appearance
.items
.iter()
.filter_map(|i| match i {
AppearanceItem::Fill(f) => Some(f),
AppearanceItem::Stroke(_) => None,
})
.collect();
assert_eq!((fills[0].paint.color(), fills[0].overprint), (Some(BLUE), false));
let k = match fills.get(1) {
Some(shadow) => {
let Some(Color::Gray { k }) = shadow.paint.color() else { panic!("black shading: {:?}", shadow.paint) };
assert_eq!((shadow.blend, shadow.overprint), (vectorcraft_doc::color::BlendMode::Multiply, true));
shaded += 1;
k
}
None => 0.0,
};
let b = fill(black).unwrap().to_rgb()[2];
assert!((b - 0.8 * (1.0 - k)).abs() < 1e-3, "black at {k} matches the darkened blue {b}");
}
assert!(shaded > 0, "faces turned from the light get black");
}
#[test]
fn angle_offset_edge_and_cap_shape_the_surface() {
let full = revolved(json!({"rotationX": 0, "rotationY": 0, "rotationZ": 0})).visual_bounds().unwrap();
+52 -19
View File
@@ -20,8 +20,8 @@ pub const ROTATE_SURFACES: [&str; 2] = ["none", "diffuse"];
/// The width of a Wireframe edge, in points.
const WIRE: f64 = 0.5;
/// The Shading Color choices: black, a custom color, or none.
pub const SHADING_COLORS: [&str; 3] = ["black", "custom", "none"];
/// The Shading Color choices: black, a custom color, none, or black overprinting the paint.
pub const SHADING_COLORS: [&str; 4] = ["black", "custom", "none", "blackOverprint"];
/// The surface settings of Extrude & Bevel (Classic)'s parameters.
pub fn classic_shading(p: &Value) -> ClassicShading {
@@ -55,8 +55,8 @@ pub fn classic_extrude_options(p: &Value) -> Extrude {
}
}
/// The color faces darken toward: black, the custom color, or none (faces keep their paint and only
/// the highlight lightens them).
/// The color faces darken toward: black (for Black Overprint too), the custom color, or none (faces
/// keep their paint and only the highlight lightens them).
fn shading_color(p: &Value) -> Option<Color> {
match text(p, "shadingColor", "black") {
"none" => None,
@@ -200,27 +200,54 @@ fn preserves_spot_colors(p: &Value) -> bool {
/// A face of `paint`, a color linked to a swatch, with Preserve Spot Colors: the swatch at a lower
/// tint for the highlight `spec`, its link kept so a spot color stays on its own plate, and, where
/// tone `tone` is below full light and the faces darken (`shade`), black over it at `1 - tone`,
/// multiplied and overprinting, so it prints on the black plate. `seam` is the width of the seam
/// tone `tone` is below full light and the faces darken (`shade`), black over it as
/// [`overprinting_black`] draws it, so it prints on the black plate. `seam` is the width of the seam
/// stroke each layer draws around the face.
fn linked_face(paint: &Paint, tone: f64, spec: f64, shade: Option<Color>, seam: f64) -> Vec<AppearanceItem> {
let Paint::Solid { color, swatch, tint } = paint else { return vec![] };
let keep = (1.0 - spec).clamp(0.0, 1.0) as f32;
let fill = Paint::Solid { color: color.tinted(keep), swatch: swatch.clone(), tint: tint * keep };
let mut items = vec![AppearanceItem::Fill(FillLayer::new(fill.clone())), AppearanceItem::Stroke(crate::lighting::seam_stroke(fill, seam))];
if shade.is_some() && tone < 1.0 {
let black = Paint::solid(Color::gray((1.0 - tone).clamp(0.0, 1.0) as f32));
let mut layer = FillLayer::new(black.clone());
layer.blend = BlendMode::Multiply;
layer.overprint = true;
let mut edge = crate::lighting::seam_stroke(black, seam);
edge.blend = BlendMode::Multiply;
edge.overprint = true;
items.extend([AppearanceItem::Fill(layer), AppearanceItem::Stroke(edge)]);
if shade.is_some() {
items.extend(overprinting_black(tone, seam));
}
items
}
/// The black that shades a face at tone `tone` on the black plate, when the tone is below full
/// light: a fill of black at `1 - tone`, multiplied and overprinting, and its seam stroke `seam`
/// wide, overprinting with Darken, so where the stroke lies over the face's own black, or over a
/// neighbor's, the face is not darkened twice.
fn overprinting_black(tone: f64, seam: f64) -> Vec<AppearanceItem> {
if tone >= 1.0 {
return vec![];
}
let black = Paint::solid(Color::gray((1.0 - tone).clamp(0.0, 1.0) as f32));
let mut layer = FillLayer::new(black.clone());
layer.blend = BlendMode::Multiply;
layer.overprint = true;
let mut edge = crate::lighting::seam_stroke(black, seam);
edge.blend = BlendMode::Darken;
edge.overprint = true;
vec![AppearanceItem::Fill(layer), AppearanceItem::Stroke(edge)]
}
/// Whether the shading color of parameters `p` is Black Overprint.
fn black_overprint(p: &Value) -> bool {
text(p, "shadingColor", "black") == "blackOverprint"
}
/// A face of `paint` with Black Overprint: the paint unchanged, and where tone `tone` is below full
/// light, black over it as [`overprinting_black`] draws it, so the paint's own inks print as they
/// are and the shading prints on the black plate. The highlight is not drawn. `seam` is the width of
/// the seam stroke each layer draws around the face.
fn overprinted_face(paint: &Paint, tone: f64, seam: f64) -> Vec<AppearanceItem> {
let mut items =
vec![AppearanceItem::Fill(FillLayer::new(paint.clone())), AppearanceItem::Stroke(crate::lighting::seam_stroke(paint.clone(), seam))];
items.extend(overprinting_black(tone, seam));
items
}
/// The width of the stroke [`surface`] draws around `face` with parameters `p`: a wire edge on
/// Wireframe, else the seam between faces.
pub(crate) fn stroke_width(face: &Facet, p: &Value) -> f64 {
@@ -229,15 +256,17 @@ pub(crate) fn stroke_width(face: &Facet, p: &Value) -> f64 {
/// One solid's faces in paint `paint`, as a group with the paint's opacity and blend mode, one child
/// for each facet: the edges of the faces on Wireframe, else each face filled in its paint shaded by
/// its tone and highlight (with Preserve Spot Colors, a color linked to a swatch as [`linked_face`]
/// draws it). A gradient with transparent stops is shaded opaque and then masked by
/// its own transparency, so the shading follows the gradient's coverage; without a placement of its
/// own, it is placed once on all the faces ([`crate::lighting::opaque_surface_paint`]).
/// its tone and highlight (with Black Overprint, as [`overprinted_face`] draws it; with Preserve Spot
/// Colors, a color linked to a swatch as [`linked_face`] draws it). A gradient with transparent stops
/// is shaded opaque and then masked by its own transparency, so the shading follows the gradient's
/// coverage; without a placement of its own, it is placed once on all the faces
/// ([`crate::lighting::opaque_surface_paint`]).
pub(crate) fn surface(n: &Node, facets: Vec<Facet>, source: &Paint, opacity: f32, blend: BlendMode, p: &Value) -> Node {
let shading = classic_shading(p);
let lights = lights(p);
let shade = shading_color(p);
let preserve = preserves_spot_colors(p);
let overprint = black_overprint(p);
let wire = shading.surface == ClassicSurface::Wireframe;
let (paint, mask) = if wire { (source.clone(), None) } else { crate::lighting::opaque_surface_paint(source, || super::facets_bounds(&facets)) };
let paint = &paint;
@@ -252,6 +281,10 @@ pub(crate) fn surface(n: &Node, facets: Vec<Facet>, source: &Paint, opacity: f32
let (tone, spec) = shading.tone(face.normal, &lights);
// A narrow stroke of the face's own paint closes the hairline seams between faces.
let seam = super::seam_width(&face);
if overprint {
let items = overprinted_face(paint, tone, seam);
return Arc::new(Node::path(n.id, face.path(), Appearance { items, ..Default::default() }));
}
let items = match paint.color() {
// Unshaded (No Shading, no shading color, or a face in full light) with no
// highlight: the paint itself, its color space and swatch kept.
+89 -2
View File
@@ -1908,6 +1908,89 @@ fn classic_shading_color_blend_steps_and_lights() {
assert_eq!(with(json!({"drawHiddenFaces": true})).len(), 6);
}
/// The fills, then the strokes, of face `face`.
fn layers_of(face: &Node) -> (Vec<&vectorcraft_doc::FillLayer>, Vec<&StrokeLayer>) {
let fills = face.appearance.items.iter().filter_map(|i| if let AppearanceItem::Fill(f) = i { Some(f) } else { None }).collect();
let strokes = face.appearance.items.iter().filter_map(|i| if let AppearanceItem::Stroke(s) = i { Some(s) } else { None }).collect();
(fills, strokes)
}
/// The black over face `face` with Black Overprint, checked to be opaque and overprinting in
/// both its fill (multiplied) and its seam stroke (Darken, so it does not darken the face twice);
/// `None` when the face has none.
fn overprinted_black(face: &Node) -> Option<f32> {
let (fills, strokes) = layers_of(face);
assert_eq!(fills.len(), strokes.len(), "each fill has its seam stroke");
let shadow = fills.get(1)?;
let Some(Color::Gray { k }) = shadow.paint.color() else { panic!("black shading: {:?}", shadow.paint) };
assert_eq!((shadow.blend, shadow.overprint, shadow.opacity), (BlendMode::Multiply, true, 1.0));
assert_eq!((strokes[1].paint.clone(), strokes[1].blend, strokes[1].overprint), (shadow.paint.clone(), BlendMode::Darken, true));
assert!(!fills[0].overprint && !strokes[0].overprint, "the paint itself knocks out");
Some(k)
}
/// Black Overprint keeps the paint on every face and draws the shading over it as black,
/// overprinting, as strong as the darkening of the shading color Black; the
/// highlight is not drawn, and No Shading adds no black.
#[test]
fn classic_black_overprint_keeps_the_paint_under_overprinting_black() {
let diffuse = json!({"surface": "diffuse", "ambient": 20});
let mut over = diffuse.clone();
over["shadingColor"] = json!("blackOverprint");
let darkened: Vec<[f32; 3]> = classic_faces(diffuse).iter().map(fill_rgb).collect();
let faces = classic_faces(over);
assert_eq!(faces.len(), darkened.len());
let mut shaded = 0;
for (face, rgb) in faces.iter().zip(&darkened) {
assert_eq!(layers_of(face).0[0].paint, Paint::solid(RED), "the paint is kept");
let k = overprinted_black(face).unwrap_or(0.0);
assert!((rgb[0] - 0.8 * (1.0 - k)).abs() < 1e-3, "black at {k} matches the darkened {rgb:?}");
shaded += usize::from(k > 0.0);
}
assert!(shaded > 0, "faces turned from the light get black");
// Plastic: no white layer for the highlight.
let shiny = json!({"shadingColor": "blackOverprint", "highlightIntensity": 100, "highlightSize": 100, "lightHeight": 60});
for face in classic_faces(shiny) {
let (fills, _) = layers_of(&face);
assert_eq!(fills[0].paint, Paint::solid(RED));
assert!(fills.len() <= 2 && overprinted_black(&face).is_none_or(|k| k > 0.0), "{fills:?}");
}
// No Shading: the paint alone.
for face in classic_faces(json!({"surface": "none", "shadingColor": "blackOverprint"})) {
assert_eq!(overprinted_black(&face), None);
assert_eq!(layers_of(&face).0[0].paint, Paint::solid(RED));
}
}
/// Black Overprint keeps a gradient fill on every face, with the black over it, and Rotate
/// (Classic) draws its plane the same way.
#[test]
fn classic_black_overprint_keeps_gradients_and_shades_rotate() {
use vectorcraft_doc::color::{Gradient, GradientKind, GradientPaint};
let gradient = Paint::Gradient(Box::new(GradientPaint::new(Gradient::new(
GradientKind::Linear,
vec![vectorcraft_doc::color::GradientStop::new(0.0, RED), vectorcraft_doc::color::GradientStop::new(1.0, BLUE)],
))));
let mut n = classic(json!({"shadingColor": "blackOverprint", "surface": "diffuse"}));
if let Some(AppearanceItem::Fill(f)) = n.appearance.items.first_mut() {
f.paint = gradient.clone();
}
let art = solid_art(&n).unwrap();
let mut shaded = 0;
for face in faces(&art) {
assert_eq!(layers_of(face).0[0].paint, gradient);
shaded += usize::from(overprinted_black(face).is_some());
}
assert!(shaded > 0);
// Rotate (Classic), turned from the light: red with black over it; facing it: red alone.
let turned = classic_rotate(json!({"rotationX": 0, "rotationY": 70, "rotationZ": 0, "lightHeight": 90, "shadingColor": "blackOverprint"}));
let face = &turned[0].children().unwrap()[0];
assert_eq!(layers_of(face).0[0].paint, Paint::solid(RED));
assert!(overprinted_black(face).is_some_and(|k| k > 0.05));
let lit = classic_rotate(json!({"rotationX": 0, "rotationY": 0, "rotationZ": 0, "lightHeight": 90, "shadingColor": "blackOverprint"}));
assert_eq!(overprinted_black(&lit[0].children().unwrap()[0]), None);
}
#[test]
fn classic_bevel_height_extent_and_cap_shape_the_solid() {
let bounds = |p: Value| solid_art(&classic(p)).unwrap().visual_bounds().unwrap();
@@ -2134,9 +2217,12 @@ fn classic_parameters_are_checked() {
let check = |p: Value| validate_solid(&n, CLASSIC_EXTRUDE, &crate::merged_params(CLASSIC_EXTRUDE, &p));
assert!(check(json!({})).is_ok());
assert!(check(json!({"surface": "wireframe", "shadingColor": "custom", "shadingCustom": "#12aBcd", "blendSteps": 256, "bevel": "ogee"})).is_ok());
assert!(check(json!({"shadingColor": "blackOverprint"})).is_ok());
for (p, says) in [
(json!({"surface": "glossy"}), "`surface` must be one of wireframe, none, diffuse, plastic"),
(json!({"shadingColor": "red"}), "`shadingColor` must be one of black, custom, none"),
(json!({"shadingColor": "red"}), "`shadingColor` must be one of black, custom, none, blackOverprint"),
(json!({"shadingColor": "blackoverprint"}), "`shadingColor` must be one of"),
(json!({"shadingColor": true}), "`shadingColor` must be one of"),
(json!({"shadingCustom": "blue"}), "`shadingCustom` must be a #rrggbb color"),
(json!({"shadingCustom": "#fff"}), "`shadingCustom` must be a #rrggbb color"),
(json!({"depth": 2001}), "`depth` must be between 0 and 2000 (got 2001)"),
@@ -2213,11 +2299,12 @@ fn classic_rotate_parameters_are_checked() {
let check = |p: Value| validate_solid(&n, CLASSIC_ROTATE, &crate::merged_params(CLASSIC_ROTATE, &p));
assert!(check(json!({})).is_ok());
assert!(check(json!({"surface": "none", "shadingColor": "custom", "shadingCustom": "#12aBcd", "blendSteps": 1})).is_ok());
assert!(check(json!({"shadingColor": "blackOverprint"})).is_ok());
for (p, says) in [
(json!({"surface": "plastic"}), "`surface` must be one of none, diffuse"),
(json!({"surface": "wireframe"}), "`surface` must be one of none, diffuse"),
(json!({"surface": 2}), "`surface` must be one of"),
(json!({"shadingColor": "red"}), "`shadingColor` must be one of black, custom, none"),
(json!({"shadingColor": "red"}), "`shadingColor` must be one of black, custom, none, blackOverprint"),
(json!({"shadingCustom": "#fff"}), "`shadingCustom` must be a #rrggbb color"),
(json!({"rotationX": 181}), "`rotationX` must be between -180 and 180 (got 181)"),
(json!({"perspectiveAngle": 161}), "`perspectiveAngle` must be between 0 and 160 (got 161)"),
+58
View File
@@ -276,3 +276,61 @@ fn overprint_black_covers_type_gradients_spots_and_groups() {
s.execute("edit.colors.overprintBlack", &json!({"includeCmyBlacks": true, "includeSpotBlacks": true})).unwrap();
assert!(fill(&s, g) && fill(&s, spot));
}
/// The plate `plate` of `doc`, drawn as Separations Preview draws one plate, as one gray value per
/// pixel (0 full ink, 255 none).
fn plate(doc: &Document, plate: &str) -> Vec<u8> {
let mut r = Renderer::new();
r.threads = 0;
let seps = vectorcraft_render::proof::ProofSetup { separations: Some(vec![plate.into()]), ..Default::default() };
let opts = RenderOptions { background: Some([255, 255, 255, 255]), proof: Some(seps), ..Default::default() };
let image = r.render(doc, 100, 100, Affine::IDENTITY, &opts);
(0..100 * 100).map(|i| image.pixel(i % 100, i / 100)[0]).collect()
}
/// 3D (Classic) with the shading color Black Overprint puts the shading on the black plate, shows
/// it as the cyan darkened, and writes it to PDF as overprinting fills.
#[test]
fn classic_3d_black_overprint_shades_on_the_black_plate() {
let doc = |params: Value| {
let mut s = session();
rect(&mut s, [30.0, 30.0, 40.0, 40.0], cyan_ink(), None, 0.0);
s.execute("effect.apply", &json!({"effect": "threeD.classicExtrude", "item": null, "params": params})).unwrap();
s
};
let over = doc(json!({"surface": "diffuse", "depth": 20, "shadingColor": "blackOverprint"}));
let flat = doc(json!({"surface": "none", "depth": 20, "shadingColor": "blackOverprint"}));
let black = doc(json!({"surface": "diffuse", "depth": 20}));
let (over_doc, flat_doc) = (&over.doc().unwrap().doc, &flat.doc().unwrap().doc);
let inked = |p: &[u8]| p.iter().filter(|v| **v < 250).count();
assert!(inked(&plate(over_doc, "Cyan")) > 1000, "the solid is drawn");
assert!(inked(&plate(over_doc, "Black")) > 100, "the shading is on the black plate");
assert_eq!(inked(&plate(flat_doc, "Black")), 0, "No Shading adds no black");
// On screen a shaded face is the cyan darkened, not gray: the black multiplies the cyan.
let image = |d: &Document| {
let mut r = Renderer::new();
r.threads = 0;
let opts = RenderOptions { background: Some([255, 255, 255, 255]), ..Default::default() };
r.render(d, 100, 100, Affine::IDENTITY, &opts)
};
let (shaded, unshaded) = (image(over_doc), image(flat_doc));
let mut darker = 0;
for (x, y) in (0..100u32).flat_map(|y| (0..100u32).map(move |x| (x, y))) {
let (s, u) = (shaded.pixel(x, y), unshaded.pixel(x, y));
// Inside the solid (no white mixed in at an antialiased edge) where the shading darkens it.
if u[0] < 30 && (s[1] as i32) + 20 < u[1] as i32 {
darker += 1;
assert!(s[2] as i32 > s[0] as i32 + 20, "a shaded face keeps its cyan at ({x}, {y}): {s:?}");
}
}
assert!(darker > 100, "the faces turned from the light are darker");
let pdf_overprints = |s: &mut Session| {
let v = s.execute("document.exportPdf", &json!({"compression": {"compressText": false}, "preserveEditing": false})).unwrap();
let bytes = vectorcraft_format::base64_decode(v["dataBase64"].as_str().unwrap()).unwrap();
String::from_utf8_lossy(&bytes).matches("/OP true/op true/OPM 1").count()
};
let (mut over, mut black) = (over, black);
assert!(pdf_overprints(&mut over) > 0, "the black is written overprinting");
assert_eq!(pdf_overprints(&mut black), 0);
}
+1 -1
View File
@@ -545,7 +545,7 @@ pub(super) fn own_choices(effect: &str, key: &str, cmyk: bool) -> Option<Vec<(&'
}
(vectorcraft_effects::CLASSIC_ROTATE, "surface") => vec![(tl!("No Shading"), "none"), (tl!("Diffuse"), "diffuse")],
(vectorcraft_effects::CLASSIC_EXTRUDE | vectorcraft_effects::CLASSIC_REVOLVE | vectorcraft_effects::CLASSIC_ROTATE, "shadingColor") => {
vec![(tl!("Black"), "black"), (tl!("Custom"), "custom"), (tl!("None"), "none")]
vec![(tl!("Black"), "black"), (tl!("Custom"), "custom"), (tl!("None"), "none"), (tl!("Black Overprint"), "blackOverprint")]
}
(vectorcraft_effects::EXTRUDE | vectorcraft_effects::CLASSIC_EXTRUDE, "bevel") => vec![
(tl!("None"), "none"),
+1
View File
@@ -1167,6 +1167,7 @@ font-technology Variable Променливи
Highlight Size Размер на отблясъка
Blend Steps Стъпки на преливане
Shading Color Цвят на засенчването
Black Overprint Черно с напечатване
Draw Hidden Faces Изчертаване на скритите страни
Eyedropper Пипета
Eyedropper Applies: Пипетата прилага:
Can't render this file because it is too large.
+1
View File
@@ -520,6 +520,7 @@
Highlight Size Veličina odsjaja
Blend Steps Koraci prelaza
Shading Color Boja sjenčenja
Black Overprint Crni pretisak
Draw Hidden Faces Crtaj skrivene strane
Revolve… Rotaciono tijelo…
Inflate… Napuhni…
Can't render this file because it contains an unexpected character in line 2 and column 73.
+1
View File
@@ -1657,6 +1657,7 @@ antiAlias Sharp Nítid
Highlight Size Mida de la brillantor
Blend Steps Passos de fusió
Shading Color Color de l’ombra
Black Overprint Negre en sobreimpressió
Draw Hidden Faces Dibuixa les cares ocultes
Eyedropper Comptagotes
Eyedropper Applies: El comptagotes aplica:
Can't render this file because it contains an unexpected character in line 2 and column 73.
+1
View File
@@ -533,6 +533,7 @@
Highlight Size Velikost odlesku
Blend Steps Kroky prolnutí
Shading Color Barva stínování
Black Overprint Přetisk černou
Draw Hidden Faces Kreslit skryté stěny
Revolve… Rotační těleso…
Inflate… Nafouknutí…
Can't render this file because it is too large.
+1
View File
@@ -1132,6 +1132,7 @@ liquify-list-end {0}, {1} {0} og {1}
Highlight Size Højlysstørrelse
Blend Steps Overgangstrin
Shading Color Skyggefarve
Black Overprint Sort overprint
Draw Hidden Faces Tegn skjulte flader
Revolve… Omdrej…
Inflate… Pust op…
Can't render this file because it contains an unexpected character in line 2 and column 73.
+1
View File
@@ -1185,6 +1185,7 @@ font-technology Variable Variabel
Highlight Size Glanzpunktgröße
Blend Steps Angleichungsstufen
Shading Color Schattierungsfarbe
Black Overprint Überdruckendes Schwarz
Draw Hidden Faces Verdeckte Flächen zeichnen
Eyedropper Pipette
Sample Color from Screen Farbe vom Bildschirm aufnehmen
Can't render this file because it is too large.
+1
View File
@@ -1152,6 +1152,7 @@ font-technology Variable Μεταβλητές
Highlight Size Μέγεθος ανταύγειας
Blend Steps Βήματα ανάμειξης
Shading Color Χρώμα σκίασης
Black Overprint Μαύρο με υπερεκτύπωση
Draw Hidden Faces Σχεδίαση κρυφών εδρών
Eyedropper Σταγονόμετρο (Eyedropper Tool)
Eyedropper Applies: Το σταγονόμετρο εφαρμόζει:
Can't render this file because it is too large.
+1
View File
@@ -1208,6 +1208,7 @@ font-technology Variable Variables
Highlight Size Tamaño del brillo
Blend Steps Pasos de fusión
Shading Color Color de sombreado
Black Overprint Negro sobreimpreso
Draw Hidden Faces Dibujar caras ocultas
Eyedropper Cuentagotas
Sample Color from Screen Tomar color de la pantalla
Can't render this file because it contains an unexpected character in line 2 and column 73.
+1
View File
@@ -530,6 +530,7 @@
Highlight Size Kiillon koko
Blend Steps Sulautusvaiheet
Shading Color Varjostusväri
Black Overprint Päällepainettu musta
Draw Hidden Faces Piirrä piilotetut pinnat
Revolve… Pyöräytä…
Inflate… Täytä ilmalla…
Can't render this file because it contains an unexpected character in line 2 and column 73.
+1
View File
@@ -1203,6 +1203,7 @@ font-technology Variable Variables
Highlight Size Taille de la brillance
Blend Steps Étapes de transition
Shading Color Couleur d’ombrage
Black Overprint Noir en surimpression
Draw Hidden Faces Dessiner les faces cachées
Eyedropper Pipette
Sample Color from Screen Prélever une couleur à l’écran
Can't render this file because it is too large.
+1
View File
@@ -3479,6 +3479,7 @@
Setup… સેટઅપ…
Shading શેડિંગ
Shading Color શેડિંગ રંગ
Black Overprint કાળો ઓવરપ્રિન્ટ
Shadows and Glows પડછાયા અને ગ્લો
Shape શેપ
Shape Builder શેપ બિલ્ડર
Can't render this file because it contains an unexpected character in line 72 and column 5.
+1
View File
@@ -1855,6 +1855,7 @@ antiAlias Sharp शार्प
Highlight Size हाइलाइट आकार
Blend Steps ब्लेंड चरण
Shading Color शेडिंग रंग
Black Overprint काला ओवरप्रिंट
Draw Hidden Faces छिपे हुए फलक बनाएँ
Eyedropper आईड्रॉपर
Eyedropper Applies: आईड्रॉपपर लागू होता है:
Can't render this file because it is too large.
+1
View File
@@ -1510,6 +1510,7 @@ font-technology Variable Változó
Highlight Size Csillanás mérete
Blend Steps Átmenetlépések
Shading Color Árnyékolás színe
Black Overprint Felülnyomó fekete
Draw Hidden Faces Rejtett lapok rajzolása
Eyedropper Pipetta
Sample Color from Screen Szín mintavétele a képernyőről
Can't render this file because it is too large.
+1
View File
@@ -487,6 +487,7 @@
Highlight Size Ukuran kilau
Blend Steps Langkah campuran
Shading Color Warna pengarsiran
Black Overprint Hitam overprint
Draw Hidden Faces Gambar sisi tersembunyi
Revolve… Revolusi…
Inflate… Gelembungkan…
1 # Indonesian (id) catalog. Same format as zh-hant.tsv: context <TAB> source <TAB> translation
487
488
489
490
491
492
493
+1
View File
@@ -1215,6 +1215,7 @@ font-technology Variable Variabili
Highlight Size Dimensione lucentezza
Blend Steps Passaggi di fusione
Shading Color Colore ombreggiatura
Black Overprint Nero in sovrastampa
Draw Hidden Faces Disegna facce nascoste
Eyedropper Contagocce
Sample Color from Screen Campiona colore dallo schermo
Can't render this file because it is too large.
+1
View File
@@ -579,6 +579,7 @@ digits Malayalam マラヤーラム数字
Highlight Size ハイライトのサイズ
Blend Steps ブレンドの階調
Shading Color 陰影のカラー
Black Overprint ブラックオーバープリント
Draw Hidden Faces 隠れた面を描画
Revolve… 回転体…
Inflate… 膨張…
Can't render this file because it is too large.
+1
View File
@@ -2544,6 +2544,7 @@
Highlight Size ელვარების ზომა
Blend Steps შერევის საფეხურები
Shading Color დაჩრდილვის ფერი
Black Overprint ზედდაბეჭდილი შავი
Draw Hidden Faces დამალული წახნაგების დახატვა
Revolve… ბრუნვა…
Inflate… გაბერვა…
Can't render this file because it is too large.
+1
View File
@@ -572,6 +572,7 @@ digits Malayalam 말라얄람어
Highlight Size 하이라이트 크기
Blend Steps 혼합 단계
Shading Color 셰이딩 색상
Black Overprint 검정 겹쳐찍기
Draw Hidden Faces 숨겨진 면 그리기
Revolve… 회전체…
Inflate… 부풀리기…
Can't render this file because it is too large.
+1
View File
@@ -1028,6 +1028,7 @@ liquify-list-end {0}, {1} {0} en {1}
Highlight Size Glansgrootte
Blend Steps Overvloeistappen
Shading Color Arceringskleur
Black Overprint Zwart overprinten
Draw Hidden Faces Verborgen vlakken tekenen
Revolve… Draaien…
Inflate… Opblazen…
Can't render this file because it is too large.
+1
View File
@@ -492,6 +492,7 @@
Highlight Size Rozmiar połysku
Blend Steps Kroki przejścia
Shading Color Kolor cieniowania
Black Overprint Czarny nadruk
Draw Hidden Faces Rysuj ukryte ściany
Revolve… Obrót…
Inflate… Nadmuchanie…
Can't render this file because it is too large.
+1
View File
@@ -1098,6 +1098,7 @@ antiAlias Sharp Nítido
Highlight Size Tamanho do Realce
Blend Steps Etapas de Mesclagem
Shading Color Cor do Sombreamento
Black Overprint Preto em Sobreimpressão
Draw Hidden Faces Desenhar Faces Ocultas
Eyedropper Conta-gotas
Eyedropper Applies: O Conta-gotas Aplica:
Can't render this file because it is too large.
+1
View File
@@ -1206,6 +1206,7 @@ font-technology Variable Вариативные
Highlight Size Размер блика
Blend Steps Шаги перехода
Shading Color Цвет затенения
Black Overprint Чёрный с наложением
Draw Hidden Faces Рисовать скрытые грани
Eyedropper Пипетка
Sample Color from Screen Взять цвет с экрана
Can't render this file because it is too large.
+1
View File
@@ -1185,6 +1185,7 @@ font-technology Variable Variabla
Highlight Size Högdagerstorlek
Blend Steps Övergångssteg
Shading Color Skuggningsfärg
Black Overprint Svart övertryck
Draw Hidden Faces Rita dolda ytor
Eyedropper Pipett
Eyedropper Applies: Pipetten tillämpar:
Can't render this file because it is too large.
+1
View File
@@ -1179,6 +1179,7 @@ font-technology Variable Değişken
Highlight Size Parlama Boyutu
Blend Steps Karışım Adımları
Shading Color Gölgeleme Rengi
Black Overprint Siyah Üst Baskı
Draw Hidden Faces Gizli Yüzleri Çiz
Eyedropper Damlalık
Sample Color from Screen Ekrandan Örnek Renk
Can't render this file because it is too large.
+1
View File
@@ -1209,6 +1209,7 @@ font-technology Variable Варіативні
Highlight Size Розмір відблиску
Blend Steps Кроки переходу
Shading Color Колір затінення
Black Overprint Чорний із накладенням
Draw Hidden Faces Малювати приховані грані
Eyedropper Піпетка
Sample Color from Screen Взяти колір з екрана
Can't render this file because it is too large.
+1
View File
@@ -1395,6 +1395,7 @@ font-technology Variable Biến thiên
Highlight Size Kích thước điểm sáng
Blend Steps Số bước hòa trộn
Shading Color Màu tô bóng
Black Overprint Đen in chồng
Draw Hidden Faces Vẽ các mặt ẩn
Eyedropper Ống hút màu
Sample Color from Screen Lấy mẫu màu từ màn hình
Can't render this file because it contains an unexpected character in line 205 and column 5.
+1
View File
@@ -1146,6 +1146,7 @@ antiAlias Sharp 锐利
Highlight Size 高光大小
Blend Steps 混合步骤
Shading Color 底纹颜色
Black Overprint 黑色叠印
Draw Hidden Faces 绘制隐藏表面
Eyedropper 吸管
Sample Color from Screen 从屏幕取样颜色
Can't render this file because it is too large.
+1
View File
@@ -1179,6 +1179,7 @@ font-technology Variable 可變
Highlight Size 亮部大小
Blend Steps 漸變階數
Shading Color 網底顏色
Black Overprint 黑色疊印
Draw Hidden Faces 繪製隱藏表面
Eyedropper 滴管
Sample Color from Screen 從螢幕取樣顏色
Can't render this file because it is too large.
+1 -1
View File
@@ -181,7 +181,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, Render Settings › Wireframe, which draws the live effect as the edges of its faces, 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 |
| 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)); Preserve Spot Colors in all three, unavailable with a Custom Shading Color ([Preserve Spot Color](https://help.adobe.com/archive/en_US/illustrator/cs5/illustrator_cs5_help.pdf#page=260)); all three: a lighting sphere on the Lighting tab whose lights drag, move to the back or front, and are added at the front center or deleted down to one ([lighting options](https://help.adobe.com/archive/en_US/illustrator/cs5/illustrator_cs5_help.pdf#page=272)); all three: the track cube (face, edge, Shift and ring drags, keyboard steps; [three-d.md](three-d.md#track-cube)); Map Art: none |
| 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, Black Overprint or no Shading Color ([Black Overprint](https://web.archive.org/web/20210601162814/https://helpx.adobe.com/pdf/illustrator_reference.pdf#page=188)), 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)); Preserve Spot Colors in all three, unavailable with a Custom Shading Color ([Preserve Spot Color](https://help.adobe.com/archive/en_US/illustrator/cs5/illustrator_cs5_help.pdf#page=260)); all three: a lighting sphere on the Lighting tab whose lights drag, move to the back or front, and are added at the front center or deleted down to one ([lighting options](https://help.adobe.com/archive/en_US/illustrator/cs5/illustrator_cs5_help.pdf#page=272)); all three: the track cube (face, edge, Shift and ring drags, keyboard steps; [three-d.md](three-d.md#track-cube)); Map Art: none |
| Turntable (30.0 beta) | none |
| Export 3D objects (OBJ, USDA, glTF) | initial: Asset Export's Export 3D Object, and the 3D and Materials panel's Export 3D Object button (which then shows Asset Export with the new assets selected, [three-d.md](three-d.md#3d-and-materials-panel)), collect 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)) |
+12 -4
View File
@@ -4417,16 +4417,24 @@ is tall), `bevelInside` (false adds the bevel around the shape, true carves it i
`softness` are not used). `ambient` (0..100%, default 50) lights every face.
- `highlightIntensity` (0..100%, default 60) and `highlightSize` (0..100%, default 90; 100 is broad) shape the Plastic
highlight. `blendSteps` (whole number, 1..256, default 25) is how many levels the shading is rounded to.
- `shadingColor`: `black` (the default), `custom` (darkens toward `shadingCustom`, a `#rrggbb` color) or `none` (the
paint is kept and only the highlight lightens it). `drawHiddenFaces` also draws the faces turned away from the
viewer, behind the others.
- `shadingColor`: `black` (the default), `custom` (darkens toward `shadingCustom`, a `#rrggbb` color), `none` (the
paint is kept and only the highlight lightens it) or `blackOverprint`. With `blackOverprint` every face keeps the
paint unchanged, and each face that darkens gets overprinting black over it, as strong as `black` would darken it.
The paint's own inks print as they are and the shading prints on the black plate. On screen the black is multiplied
over the paint, Separations Preview shows it on the Black plate, and `document.exportPdf` writes it as overprinting
fills
([Shading Color options](https://web.archive.org/web/20210601162814/https://helpx.adobe.com/pdf/illustrator_reference.pdf#page=188)).
The highlight is not drawn with `blackOverprint`; that rule is VectorCraft's own. On a pattern face the black covers
the whole face, transparent pattern cells included, as the shading of the other shading colors does.
`drawHiddenFaces` also draws the faces turned away from the viewer, behind the others.
- `preserveSpotColors` (default false) is the Lighting tab's Preserve Spot Colors checkbox. When it is on, a fill or
stroke linked to a spot or global swatch stays linked on every face, so a spot color prints on its own plate in
separations and PDF. The highlight lowers the swatch's tint, and a face that darkens gets black at the shade's
strength over the swatch, multiplied and overprinting. These rules for drawing the shading are VectorCraft's own. The
option does nothing while `shadingColor` is `custom`, since a custom shading color cannot keep a spot color
([Preserve Spot Color](https://help.adobe.com/archive/en_US/illustrator/cs5/illustrator_cs5_help.pdf#page=260)).
Unlinked colors, gradients, patterns and the Wireframe surface draw as they do with it off.
Unlinked colors, gradients, patterns and the Wireframe surface draw as they do with it off. With `blackOverprint`
every face keeps its paint, swatch link included, whether the option is on or off.
The defaults are VectorCraft's own. An unknown parameter, a number out of range, a flag that is not true or false, or
an unknown surface or shading color is refused with an error and the document is not changed.
+3 -1
View File
@@ -604,7 +604,9 @@ out, perspective). No Adobe software, assets, presets or bevel shapes were used.
face that darkens gets black over it, multiplied and overprinting, so a spot color stays on its own plate. The
checkbox is unavailable while Shading Color is Custom
([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. Their Rotation tab has the track cube
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. 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).