Enum DisplayElement 

#[non_exhaustive]
pub enum DisplayElement {
    Fill {
        path: PsPath,
        params: FillParams,
    },
    Stroke {
        path: PsPath,
        params: StrokeParams,
    },
    Clip {
        path: PsPath,
        params: ClipParams,
    },
    InitClip,
    Image {
        sample_data: Arc<Vec<u8>>,
        params: ImageParams,
    },
    ErasePage,
    AxialShading {
        params: AxialShadingParams,
    },
    RadialShading {
        params: RadialShadingParams,
    },
    MeshShading {
        params: MeshShadingParams,
    },
    PatchShading {
        params: PatchShadingParams,
    },
    PatternFill {
        params: PatternFillParams,
    },
    Text {
        params: TextParams,
    },
    Group {
        elements: DisplayList,
        params: GroupParams,
    },
    OcgGroup {
        elements: DisplayList,
        visibility: OcgVisibility,
    },
    SoftMasked {
        mask: DisplayList,
        content: DisplayList,
        params: SoftMaskParams,
        mask_cache: Arc<Mutex<Option<Option<MaskRaster>>>>,
    },
}

A single recorded drawing operation.

Marked #[non_exhaustive] so additional element kinds can land without breaking third-party renderers; consumers must include a wildcard arm in their match expressions. See docs/DISPLAY-LIST.md (“Stability”) for the policy.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Fill

Fill a path.

Fields

path: PsPath

params: FillParams

Stroke

Stroke a path.

Fields

path: PsPath

params: StrokeParams

Clip

Intersect the clip region with a path.

Fields

path: PsPath

params: ClipParams

InitClip

Reset clipping to the full page.

Image

Draw an image (raw sample data in native color space).

Fields

sample_data: Arc<Vec<u8>>

params: ImageParams

ErasePage

Erase the page (fill with white).

AxialShading

Axial (linear) gradient shading.

Fields

params: AxialShadingParams

RadialShading

Radial gradient shading.

Fields

params: RadialShadingParams

MeshShading

Gouraud-shaded triangle mesh.

Fields

params: MeshShadingParams

PatchShading

Coons/tensor-product patch mesh.

Fields

params: PatchShadingParams

PatternFill

Tiled pattern fill.

Fields

params: PatternFillParams

Text

Text element from show operators (used by PDF device, ignored by rasterizer).

Fields

params: TextParams

Group

Transparency group: render children offscreen, composite with blend mode + alpha.

Fields

elements: DisplayList

params: GroupParams

OcgGroup

PDF Optional Content Group (layer). Children are rendered only when OcgVisibility evaluates to true under the active LayerSet (consult stet-pdf-reader’s LayerSet::evaluate). default_visible on each variant is the fallback used when the renderer has no LayerSet opinion for the relevant OCGs.

Fields

elements: DisplayList

visibility: OcgVisibility

Visibility predicate: a single OCG, an OCMD membership policy, or a /VE expression.

SoftMasked

Soft-masked content: render mask form to grayscale, multiply with content alpha.

Fields

mask: DisplayList

content: DisplayList

params: SoftMaskParams

mask_cache: Arc<Mutex<Option<Option<MaskRaster>>>>

Render-time cache of the rasterized mask. None means “not yet rasterized”. Some(None) means “rasterized and produced no visible mask” — memoized so subsequent bands skip the rasterization work. Some(Some(raster)) is the populated raster; the renderer compares raster.scale_x/scale_y against the current render scale and re-rasterizes if they differ.

Wrapped in Arc<Mutex<...>> so cloned display lists (e.g. by the egui viewer or the WASM viewport during zoom) share the same cache cell, and so the cache can be replaced when the scale changes.

Trait Implementations

impl Clone for DisplayElement

fn clone(&self) -> DisplayElement

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.