Files
vectorcraft/crates/engine/src/cmd/flatten.rs
T
dotCooCoo 9aa3297e22 Flatten: look at each node of art without transparency once
The Flattener Preview, Object > Flatten Transparency and the EPS, PDF and
print output that flatten transparency now walk each object without
transparency once, while planning, to list the type, strokes and
overprints that Convert All Text to Outlines, Convert All Strokes to
Outlines and dropping overprints change. The preview's lists, the no-op
check and the outlining all read that list.

On 100 groups of a stroked rectangle and stroked type plus five other
objects (309 nodes), with both options on and overprints dropped, the
preview looks at nodes 309 times where it looked 615 times, and
flattening looks at them 309 times where its walks made 2,352 visits,
outlines they made included. The flattened art and ids match the walk per option for
every mix of the three options.
2026-11-15 13:30:09 -08:00

62 lines
3.4 KiB
Rust

//! Object → Flatten Transparency: transparent art becomes opaque art that looks the same.
//!
//! The targets (`ids` or the selection) split into groups: each object with transparency with the
//! objects it overlaps, and the objects without transparency whose stacking order with a member
//! would change when the group takes its topmost object's place. Objects without transparency
//! that overlap only others without it stay as they are (their type and strokes are outlined on
//! request), as do groups without transparency. The others are
//! cut into atomic regions: the faces of the planar arrangement of every fill, outlined stroke and
//! clipping path in them ([`po::regions`]). The same paints cover each whole region, so its colour
//! is exact: those paints composited as the renderer composites them ([`Composer`], blend modes by
//! [`composite`]), with white under the finished art (or nothing with Preserve Alpha); in CMYK documents their inks
//! composite, plane by plane ([`cmyk_planes`]), and the colour is CMYK. Each region becomes a path
//! filled with that flat colour. Where gradients, patterns, images, opacity masks or raster
//! effects reach there is no single colour: those regions are rendered into one image per group,
//! clipped to them with Clip Complex Regions (else the image is a rectangle that takes in the
//! regions it overlaps). The raster/vector balance rasterizes whole groups that split into more
//! regions than it allows (all of them at 0). For files without transparency (PDF/X-1a, PDF/X-3)
//! a CMYK document's images are opaque CMYK: its colours keep their inks there too.
//!
//! Edit → Transparency Flattener Presets: the built-in presets plus the user's, saved with the
//! preferences ([`crate::Prefs::flattener_presets`]); a `preset` named anywhere options are taken
//! finds both.
//!
//! Window → Flattener Preview: the same plan, worked out without rendering, reports what flattening
//! the document would touch ([`FlattenReport`], `flattener.preview`).
use std::collections::BTreeSet;
use std::sync::Arc;
use serde::{Deserialize, Serialize};
use serde_json::{Value, json};
use vectorcraft_color::blend::{cmyk_planes, composite, planes_cmyk};
use vectorcraft_color::{BlendMode, Color, Paint};
use vectorcraft_doc::appearance::{AppearanceItem, FillLayer};
use vectorcraft_doc::cmyk::Inks;
use vectorcraft_doc::{Appearance, ColorMode, Document, Effect, ImageBlob, ImageObject, Knockout, Node, NodeId, NodeKind};
use vectorcraft_geom::{Affine, FillRule, PathData, Rect, shapes};
use vectorcraft_pathops as po;
use vectorcraft_render::effects;
use super::edit::roots_of;
use super::menucmds::{MAX_PIXELS, isolated_doc, unique_key};
use super::pathops::{leaves, node_path, outline_strokes, separate, shape_node};
use super::{CommandSpec, EngineError, Result, Session, always, bad, bool_or, cmd, has_doc, str_param, targets, unique_name};
mod analysis;
mod apply;
mod commands;
mod compose;
mod options;
mod presets;
mod report;
pub(crate) use analysis::{carry, outlined_text, see_through_images};
pub(crate) use apply::{expand_transparent_tile_images, flatten_document, flatten_expanded, has_transparent_tile_images};
#[cfg(test)]
pub(crate) use apply::{with_clips_ignored, with_every_region};
pub use commands::specs;
pub use options::FlattenOptions;
pub use presets::{FlattenerPreset, PRESET_EXTS, PRESET_FORMAT};
pub use report::{FlattenReport, Highlight, Overprints, report};