Skip to main content

TextBuilder

Struct TextBuilder

pub struct TextBuilder {
    pub codes: Vec<u8>,
    pub font: ObjRef,
    pub size: f32,
    pub position: Point,
    pub render_mode: TextRenderMode,
    pub fill: Color,
}

Expand description

A run of text, ready to PageEdit::push.

The font is named by an indirect /Font dictionary: a regenerated stream writes /Name Tf and ResourceTable::realize allocates that name for TextBuilder::font. Obtain the reference from PageEdit::font_of (a font the page already has) or from EditDoc::embed_font / EditDoc::standard_font (a font this save is adding).

crate::ImageBuilder names an /XObject the same way.

Fields§

§codes: Vec<u8>

The character codes, in the font’s own encoding.

§font: ObjRef

The /Font resource this page reaches the font through.

§size: f32

The font size in page units.

§position: Point

Where the baseline starts, in page space.

§render_mode: TextRenderMode

How the glyphs are painted.

§fill: Color

The fill colour.

The alpha is honoured, as PathBuilder::fill’s is. There is no None here, so alpha 0 paints invisible text rather than no text.

Implementations§

impl TextBuilder

pub fn new(codes: impl Into<Vec<u8>>, font: ObjRef, size: f32) -> Self

A run of codes in the font font names, at size, starting at the origin and painted black.

pub fn build(self) -> PageObject

The page object this describes.

Trait Implementations§

impl Clone for TextBuilder

fn clone(&self) -> TextBuilder

Returns a duplicate of the value. Read more

1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more

impl Debug for TextBuilder

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

Formats the value using the given formatter. Read more

impl PartialEq for TextBuilder

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

Equality operator ==. Read more

1.0.0 (const: unstable) · Source§

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

Inequality operator !=. Read more

impl StructuralPartialEq for TextBuilder

Auto Trait Implementations§

impl Freeze for TextBuilder

impl RefUnwindSafe for TextBuilder

impl Send for TextBuilder

impl Sync for TextBuilder

impl Unpin for TextBuilder

impl UnsafeUnpin for TextBuilder

impl UnwindSafe for TextBuilder

Blanket Implementations§

impl<T> Any for T
where T: 'static + ?Sized,

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

impl<T> Borrow<T> for T
where T: ?Sized,

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

impl<T> BorrowMut<T> for T
where T: ?Sized,

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

impl<T> CloneToUninit for T
where T: Clone,

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)

Performs copy-assignment from self to dest. Read more

impl<T> From<T> for T

fn from(t: T) -> T

Returns the argument unchanged.

impl<T, U> Into<U> for T
where U: From<T>,

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

impl<T> Same for T

type Output = T

Should always be Self

impl<T> ToOwned for T
where T: Clone,

type Owned = T

The resulting type after obtaining ownership.

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more

impl<T, U> TryFrom<U> for T
where U: Into<T>,

type Error = !

The type returned in the event of a conversion error.

fn try_from(value: U) -> Result<T, !>

Performs the conversion.

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.