Struct printpdf::types::pdf_layer::PdfLayerReference

pub struct PdfLayerReference {
    pub document: Weak<RefCell<PdfDocument>>,
    pub page: PdfPageIndex,
    pub layer: PdfLayerIndex,
}

A "reference" to the current layer, allows for inner mutability but only inside this library

Fields

document: Weak<RefCell<PdfDocument>>

A weak reference to the document, for inner mutability

page: PdfPageIndex

The index of the page this layer is on

layer: PdfLayerIndex

The index of the layer this layer has (inside the page)

Methods

impl PdfLayerReference

fn add_shape(&self, line: Line)

Add a shape to the layer. Use closed to indicate whether the line is a closed line Use has_fill to determine if the line should be filled.

fn begin_text_section(&self)

Begins a new text section You have to make sure to call end_text_section afterwards

fn end_text_section(&self)

Ends a new text section Only valid if begin_text_section has been called

fn set_fill_color(&self, fill_color: Color)

Set the current fill color for the layer

fn set_font(&self, font: &IndirectFontRef, font_size: i64)

Set the current font, only valid in a begin_text_section to end_text_section block

fn set_outline_color(&self, color: Color)

Set the current line / outline color for the layer

fn set_overprint_fill(&self, overprint: bool)

Set the overprint mode of the stroke color to true (overprint) or false (no overprint)

fn set_overprint_stroke(&self, overprint: bool)

Set the overprint mode of the fill color to true (overprint) or false (no overprint) This changes the graphics state of the current page, don't do it too often or you'll bloat the file size

fn set_blend_mode(&self, blend_mode: BlendMode)

Set the overprint mode of the fill color to true (overprint) or false (no overprint) This changes the graphics state of the current page, don't do it too often or you'll bloat the file size

fn set_outline_thickness(&self, outline_thickness: f64)

Set the current line thickness, in points

NOTE: 0.0 is a special value, it does not make the line disappear, but rather makes it appear 1px wide across all devices

fn set_line_join_style(&self, line_join: LineJoinStyle)

Set the current line join style for outlines

fn set_line_cap_style(&self, line_cap: LineCapStyle)

Set the current line join style for outlines

fn set_line_dash_pattern(&self, dash_pattern: LineDashPattern)

Set the current line join style for outlines

fn set_ctm(&self, ctm: CurTransMat)

Sets (adds to) the current transformation matrix Use save_graphics_state() and restore_graphics_state() to "scope" the transformation matrix to a specific function

fn set_text_matrix(&self, tm: TextMatrix)

Sets (replaces) the current text matrix This does not have to be scoped, since the matrix is replaced instead of concatenated to the current matrix. However, you should only call this function with in a block scoped by begin_text_section() and end_text_section()

fn set_text_cursor(&self, x: Mm, y: Mm)

Sets the position where the text should appear

fn add_line_break(&self)

If called inside a text block scoped by begin_text_section and end_text_section, moves the cursor to a new line. PDF does not have any concept of "alignment" except left-aligned text Note: Use set_line_height earlier to set the line height first

fn set_line_height(&self, height: i64)

Sets the text line height inside a text block (must be called within begin_text_block and end_text_block)

fn set_character_spacing(&self, spacing: i64)

Sets the character spacing inside a text block Values are given in points. A value of 3 (pt) will increase the spacing inside a word by 3pt.

fn set_word_spacing(&self, spacing: i64)

Sets the word spacing inside a text block. Same as set_character_spacing, just for words Note: This does currently not work, because PDF does not recognize unicode fonts, only builtin fonts done with PDFDoc encoding However, the function itself is valid

fn set_text_scaling(&self, scaling: i64)

Sets the horizontal scaling (like a "condensed" font) Default value is 100 (regular scaling). Setting it to 50 will reduce the width of the written text by half, but stretch the text

fn set_line_offset(&self, offset: i64)

Offsets the current text positon (used for superscript and subscript). To reset the superscript / subscript, call this function with 0 as the offset. For superscript, use a positive number, for subscript, use a negative number. This does not change the size of the font

fn set_text_rendering_mode(&self, mode: TextRenderingMode)

fn write_text<S>(&self, text: S, font: &IndirectFontRef) where
    S: Into<String>, 

Sets the position where the text should appear (in mm)

fn save_graphics_state(&self)

Saves the current graphic state

fn restore_graphics_state(&self)

Restores the previous graphic state

fn use_text<S>(
    &self,
    text: S,
    font_size: i64,
    x: Mm,
    y: Mm,
    font: &IndirectFontRef
) where
    S: Into<String>, 

Add text to the file, x and y are measure in millimeter from the bottom left corner

Trait Implementations

impl Debug for PdfLayerReference

fn fmt(&self, __arg_0: &mut Formatter) -> Result

Formats the value using the given formatter.

impl Clone for PdfLayerReference

fn clone(&self) -> PdfLayerReference

Returns a copy of the value.

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

Performs copy-assignment from source.