Struct Line 

pub struct Line {
    pub width_emu: Option<i64>,
    pub fill: Option<Fill>,
    pub dash: Option<PresetLineDash>,
    pub cap: Option<LineCap>,
    pub join: Option<LineJoin>,
    pub head_end: Option<LineEnd>,
    pub tail_end: Option<LineEnd>,
    pub compound: Option<LineCompound>,
}

A shape’s outline stroke (<a:ln>, CT_LineProperties).

Not modeled: <a:extLst> (extension list) and the pen-alignment (algn — center/inset) attribute — a rare, cosmetic refinement. The compound-line attribute (cmpd) is modeled, see LineCompound.

Fields

width_emu: Option<i64>

w — the stroke’s width, in EMUs.

fill: Option<Fill>

EG_LineFillProperties — how the stroke itself is painted (the same fill choices as a shape’s interior, minus image/group fills, which aren’t valid here per the schema).

dash: Option<PresetLineDash>

<a:prstDash val=".."> — one of the 11 preset dash patterns. Custom dash patterns (<a:custDash>, an explicit dash/space stop list) are deferred.

cap: Option<LineCap>

cap — the stroke’s end-cap style.

join: Option<LineJoin>

EG_LineJoinProperties — how the stroke’s corners are drawn.

head_end: Option<LineEnd>

<a:headEnd> — the arrowhead (or other decoration) at the line’s start.

tail_end: Option<LineEnd>

<a:tailEnd> — the arrowhead (or other decoration) at the line’s end.

compound: Option<LineCompound>

cmpd — the stroke’s compound-line style (single/double/thick-thin/ thin-thick/triple). None omits the attribute (ST_CompoundLine’s own schema default, "sng", applies). Grounded against a real fixture’s slide master border (cmpd="sng").

Implementations

impl Line

pub fn new() -> Line

Examples found in repository

examples/pptx_grouping_and_connectors.rs (line 114)

fn main() -> office_toolkit::Result<()> {
    let path = output_path("pptx_grouping_and_connectors.pptx");

    // Every shape below sets an explicit fill (and the connector an
    // explicit line): with neither a fill/line nor a `<p:style>` theme
    // reference, a shape has nothing to paint and renders as fully
    // invisible — the slide then looks blank even though the shapes are
    // there. `AutoShape`/`Connector` have no `<p:style>` support yet, so an
    // explicit `Fill`/`Line` is the only way to make a shape actually show.
    let circle_fill = || Fill::Solid(Color::Rgb("4472C4".to_string()));

    let circle = AutoShape::new(11, "Circle").with_properties(
        ShapeProperties::new()
            .with_transform(
                Transform2D::new()
                    .with_offset(0, 0)
                    .with_extent(1_000_000, 1_000_000),
            )
            .with_fill(circle_fill()),
    );
    let label = AutoShape::new(12, "Label")
        .with_properties(
            ShapeProperties::new()
                .with_transform(
                    Transform2D::new()
                        .with_offset(1_200_000, 300_000)
                        .with_extent(1_500_000, 400_000),
                )
                .with_fill(Fill::Solid(Color::Rgb("E8622C".to_string()))),
        )
        .with_text_body(
            TextBody::new()
                .with_paragraph(TextParagraph::new().with_run(TextRun::text("Grouped label"))),
        );

    let group = ShapeGroup::new(2, "Group")
        .with_transform(
            (838_200, 838_200),
            (2_700_000, 1_000_000),
            (0, 0),
            (2_700_000, 1_000_000),
        )
        .with_shape(Shape::AutoShape(circle))
        .with_shape(Shape::AutoShape(label));

    let rotated_circle = AutoShape::new(11, "Circle").with_properties(
        ShapeProperties::new()
            .with_transform(
                Transform2D::new()
                    .with_offset(0, 0)
                    .with_extent(1_000_000, 1_000_000),
            )
            .with_fill(circle_fill()),
    );
    let rotated_group = ShapeGroup::new(2, "Rotated and flipped group")
        .with_transform(
            (838_200, 838_200),
            (1_000_000, 1_000_000),
            (0, 0),
            (1_000_000, 1_000_000),
        )
        .with_rotation_degrees(45.0)
        .with_flip_horizontal(true)
        .with_shape(Shape::AutoShape(rotated_circle));

    let box_a = AutoShape::new(2, "Box A").with_properties(
        ShapeProperties::new()
            .with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(1_000_000, 1_000_000),
            )
            .with_fill(Fill::Solid(Color::Rgb("2E86AB".to_string()))),
    );
    let box_b = AutoShape::new(3, "Box B").with_properties(
        ShapeProperties::new()
            .with_transform(
                Transform2D::new()
                    .with_offset(3_500_000, 838_200)
                    .with_extent(1_000_000, 1_000_000),
            )
            .with_fill(Fill::Solid(Color::Rgb("6FB98F".to_string()))),
    );
    // `Connector::new` leaves position/size unset, which the writer then
    // emits as a zero-size `<a:xfrm>` (off 0,0 / ext 0,0) — a real point
    // with no length, invisible regardless of line/fill. `stCxn`/`endCxn`
    // alone don't supply geometry; PowerPoint only recomputes it once you
    // drag one of the attached shapes. So this also sets an explicit
    // transform spanning Box A's right edge to Box B's left edge.
    let connector = Connector::new(4, "Connector")
        .with_properties(
            ShapeProperties::new()
                .with_transform(
                    Transform2D::new()
                        .with_offset(1_838_200, 1_338_200)
                        .with_extent(1_662_000, 0),
                )
                .with_line(
                    Line::new()
                        .with_width_emu(25_400)
                        .with_fill(Fill::Solid(Color::Rgb("000000".to_string()))),
                ),
        )
        .with_start_connection(2, 0)
        .with_end_connection(3, 0);

    let presentation = Presentation::new()
        .with_slide(Slide::new().with_shape(Shape::Group(group)))
        .with_slide(Slide::new().with_shape(Shape::Group(rotated_group)))
        .with_slide(
            Slide::new()
                .with_shape(Shape::AutoShape(box_a))
                .with_shape(Shape::AutoShape(box_b))
                .with_shape(Shape::Connector(connector)),
        );

    presentation.save_to_file(&path)?;
    println!("Wrote {}", path.display());
    Ok(())
}

pub fn with_compound(self, compound: LineCompound) -> Line

pub fn with_width_emu(self, width_emu: i64) -> Line

Examples found in repository

examples/pptx_grouping_and_connectors.rs (line 115)

fn main() -> office_toolkit::Result<()> {
    let path = output_path("pptx_grouping_and_connectors.pptx");

    // Every shape below sets an explicit fill (and the connector an
    // explicit line): with neither a fill/line nor a `<p:style>` theme
    // reference, a shape has nothing to paint and renders as fully
    // invisible — the slide then looks blank even though the shapes are
    // there. `AutoShape`/`Connector` have no `<p:style>` support yet, so an
    // explicit `Fill`/`Line` is the only way to make a shape actually show.
    let circle_fill = || Fill::Solid(Color::Rgb("4472C4".to_string()));

    let circle = AutoShape::new(11, "Circle").with_properties(
        ShapeProperties::new()
            .with_transform(
                Transform2D::new()
                    .with_offset(0, 0)
                    .with_extent(1_000_000, 1_000_000),
            )
            .with_fill(circle_fill()),
    );
    let label = AutoShape::new(12, "Label")
        .with_properties(
            ShapeProperties::new()
                .with_transform(
                    Transform2D::new()
                        .with_offset(1_200_000, 300_000)
                        .with_extent(1_500_000, 400_000),
                )
                .with_fill(Fill::Solid(Color::Rgb("E8622C".to_string()))),
        )
        .with_text_body(
            TextBody::new()
                .with_paragraph(TextParagraph::new().with_run(TextRun::text("Grouped label"))),
        );

    let group = ShapeGroup::new(2, "Group")
        .with_transform(
            (838_200, 838_200),
            (2_700_000, 1_000_000),
            (0, 0),
            (2_700_000, 1_000_000),
        )
        .with_shape(Shape::AutoShape(circle))
        .with_shape(Shape::AutoShape(label));

    let rotated_circle = AutoShape::new(11, "Circle").with_properties(
        ShapeProperties::new()
            .with_transform(
                Transform2D::new()
                    .with_offset(0, 0)
                    .with_extent(1_000_000, 1_000_000),
            )
            .with_fill(circle_fill()),
    );
    let rotated_group = ShapeGroup::new(2, "Rotated and flipped group")
        .with_transform(
            (838_200, 838_200),
            (1_000_000, 1_000_000),
            (0, 0),
            (1_000_000, 1_000_000),
        )
        .with_rotation_degrees(45.0)
        .with_flip_horizontal(true)
        .with_shape(Shape::AutoShape(rotated_circle));

    let box_a = AutoShape::new(2, "Box A").with_properties(
        ShapeProperties::new()
            .with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(1_000_000, 1_000_000),
            )
            .with_fill(Fill::Solid(Color::Rgb("2E86AB".to_string()))),
    );
    let box_b = AutoShape::new(3, "Box B").with_properties(
        ShapeProperties::new()
            .with_transform(
                Transform2D::new()
                    .with_offset(3_500_000, 838_200)
                    .with_extent(1_000_000, 1_000_000),
            )
            .with_fill(Fill::Solid(Color::Rgb("6FB98F".to_string()))),
    );
    // `Connector::new` leaves position/size unset, which the writer then
    // emits as a zero-size `<a:xfrm>` (off 0,0 / ext 0,0) — a real point
    // with no length, invisible regardless of line/fill. `stCxn`/`endCxn`
    // alone don't supply geometry; PowerPoint only recomputes it once you
    // drag one of the attached shapes. So this also sets an explicit
    // transform spanning Box A's right edge to Box B's left edge.
    let connector = Connector::new(4, "Connector")
        .with_properties(
            ShapeProperties::new()
                .with_transform(
                    Transform2D::new()
                        .with_offset(1_838_200, 1_338_200)
                        .with_extent(1_662_000, 0),
                )
                .with_line(
                    Line::new()
                        .with_width_emu(25_400)
                        .with_fill(Fill::Solid(Color::Rgb("000000".to_string()))),
                ),
        )
        .with_start_connection(2, 0)
        .with_end_connection(3, 0);

    let presentation = Presentation::new()
        .with_slide(Slide::new().with_shape(Shape::Group(group)))
        .with_slide(Slide::new().with_shape(Shape::Group(rotated_group)))
        .with_slide(
            Slide::new()
                .with_shape(Shape::AutoShape(box_a))
                .with_shape(Shape::AutoShape(box_b))
                .with_shape(Shape::Connector(connector)),
        );

    presentation.save_to_file(&path)?;
    println!("Wrote {}", path.display());
    Ok(())
}

pub fn with_fill(self, fill: Fill) -> Line

Examples found in repository

examples/pptx_grouping_and_connectors.rs (line 116)

fn main() -> office_toolkit::Result<()> {
    let path = output_path("pptx_grouping_and_connectors.pptx");

    // Every shape below sets an explicit fill (and the connector an
    // explicit line): with neither a fill/line nor a `<p:style>` theme
    // reference, a shape has nothing to paint and renders as fully
    // invisible — the slide then looks blank even though the shapes are
    // there. `AutoShape`/`Connector` have no `<p:style>` support yet, so an
    // explicit `Fill`/`Line` is the only way to make a shape actually show.
    let circle_fill = || Fill::Solid(Color::Rgb("4472C4".to_string()));

    let circle = AutoShape::new(11, "Circle").with_properties(
        ShapeProperties::new()
            .with_transform(
                Transform2D::new()
                    .with_offset(0, 0)
                    .with_extent(1_000_000, 1_000_000),
            )
            .with_fill(circle_fill()),
    );
    let label = AutoShape::new(12, "Label")
        .with_properties(
            ShapeProperties::new()
                .with_transform(
                    Transform2D::new()
                        .with_offset(1_200_000, 300_000)
                        .with_extent(1_500_000, 400_000),
                )
                .with_fill(Fill::Solid(Color::Rgb("E8622C".to_string()))),
        )
        .with_text_body(
            TextBody::new()
                .with_paragraph(TextParagraph::new().with_run(TextRun::text("Grouped label"))),
        );

    let group = ShapeGroup::new(2, "Group")
        .with_transform(
            (838_200, 838_200),
            (2_700_000, 1_000_000),
            (0, 0),
            (2_700_000, 1_000_000),
        )
        .with_shape(Shape::AutoShape(circle))
        .with_shape(Shape::AutoShape(label));

    let rotated_circle = AutoShape::new(11, "Circle").with_properties(
        ShapeProperties::new()
            .with_transform(
                Transform2D::new()
                    .with_offset(0, 0)
                    .with_extent(1_000_000, 1_000_000),
            )
            .with_fill(circle_fill()),
    );
    let rotated_group = ShapeGroup::new(2, "Rotated and flipped group")
        .with_transform(
            (838_200, 838_200),
            (1_000_000, 1_000_000),
            (0, 0),
            (1_000_000, 1_000_000),
        )
        .with_rotation_degrees(45.0)
        .with_flip_horizontal(true)
        .with_shape(Shape::AutoShape(rotated_circle));

    let box_a = AutoShape::new(2, "Box A").with_properties(
        ShapeProperties::new()
            .with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(1_000_000, 1_000_000),
            )
            .with_fill(Fill::Solid(Color::Rgb("2E86AB".to_string()))),
    );
    let box_b = AutoShape::new(3, "Box B").with_properties(
        ShapeProperties::new()
            .with_transform(
                Transform2D::new()
                    .with_offset(3_500_000, 838_200)
                    .with_extent(1_000_000, 1_000_000),
            )
            .with_fill(Fill::Solid(Color::Rgb("6FB98F".to_string()))),
    );
    // `Connector::new` leaves position/size unset, which the writer then
    // emits as a zero-size `<a:xfrm>` (off 0,0 / ext 0,0) — a real point
    // with no length, invisible regardless of line/fill. `stCxn`/`endCxn`
    // alone don't supply geometry; PowerPoint only recomputes it once you
    // drag one of the attached shapes. So this also sets an explicit
    // transform spanning Box A's right edge to Box B's left edge.
    let connector = Connector::new(4, "Connector")
        .with_properties(
            ShapeProperties::new()
                .with_transform(
                    Transform2D::new()
                        .with_offset(1_838_200, 1_338_200)
                        .with_extent(1_662_000, 0),
                )
                .with_line(
                    Line::new()
                        .with_width_emu(25_400)
                        .with_fill(Fill::Solid(Color::Rgb("000000".to_string()))),
                ),
        )
        .with_start_connection(2, 0)
        .with_end_connection(3, 0);

    let presentation = Presentation::new()
        .with_slide(Slide::new().with_shape(Shape::Group(group)))
        .with_slide(Slide::new().with_shape(Shape::Group(rotated_group)))
        .with_slide(
            Slide::new()
                .with_shape(Shape::AutoShape(box_a))
                .with_shape(Shape::AutoShape(box_b))
                .with_shape(Shape::Connector(connector)),
        );

    presentation.save_to_file(&path)?;
    println!("Wrote {}", path.display());
    Ok(())
}

pub fn with_dash(self, dash: PresetLineDash) -> Line

pub fn with_cap(self, cap: LineCap) -> Line

pub fn with_join(self, join: LineJoin) -> Line

pub fn with_head_end(self, end: LineEnd) -> Line

pub fn with_tail_end(self, end: LineEnd) -> Line

Trait Implementations

impl Clone for Line

fn clone(&self) -> Line

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Line

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Default for Line

fn default() -> Line

Returns the “default value” for a type.

impl PartialEq for Line

fn eq(&self, other: &Line) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for Line