Struct CustomPrinter

pub struct CustomPrinter { /* private fields */ }

The main struct to construct printing commands and accomplish actual printing.

The APIs are designed to be able to concatenate one after the other.

Examples

let mut printer = CustomPrinter::new("/dev/usb/lp0").unwrap();
printer
    .bit_image(
        "logo.bmp",
        BitImageMode::Dots24DoubleDensity
    )
    .unwrap()
    .cut_paper(CutType::PartialCut)
    .run()
    .unwrap()
    .bit_image(
        "greeting.bmp",
        BitImageMode::Dots24DoubleDensity
    )
    .unwrap()
    .cut_paper(CutType::TotalCut)
    .run()
    .unwrap();

Implementations

impl CustomPrinter

pub fn new(dev: &str) -> Result<Self, Error>

Create a new CustomPrinter with the device node dev.

NOTE: Device node dev must be readable and writable by current user.

Examples

CustomPrinter::new("/dev/usb/lp0")

Examples found in repository

examples/bitimage.rs (line 6)

fn main() {
    // Replace /dev/null with actual device node when the printer is connected
    // e.g.: /dev/usb/lp0
    let mut printer = CustomPrinter::new("/dev/null").unwrap();
    printer
        .bit_image(
            "tests/data/Thermal_Test_Image.png",
            BitImageMode::Dots24DoubleDensity,
        )
        .unwrap()
        .cut_paper(CutType::TotalCut)
        .run()
        .unwrap();
}

pub fn bit_image( &mut self, path: &str, mode: BitImageMode, ) -> Result<&mut Self, Error>

Append commands for printing a bit image from path in mode. See BitImageMode for supported modes.

NOTE: Because opening and reading the image file may fail, so the return Self is wrapped in a Result and needs to be unwrapped before concatenating with other constructing functions.

Examples

printer
    .bit_image(
        "tests/data/Thermal_Test_Image.png",
        BitImageMode::Dots24DoubleDensity
    )
    .unwrap();

Examples found in repository

examples/bitimage.rs (lines 8-11)

fn main() {
    // Replace /dev/null with actual device node when the printer is connected
    // e.g.: /dev/usb/lp0
    let mut printer = CustomPrinter::new("/dev/null").unwrap();
    printer
        .bit_image(
            "tests/data/Thermal_Test_Image.png",
            BitImageMode::Dots24DoubleDensity,
        )
        .unwrap()
        .cut_paper(CutType::TotalCut)
        .run()
        .unwrap();
}

pub fn cut_paper(&mut self, cut_type: CutType) -> &mut Self

Append a command for cutting the paper totally (CutType::TotalCut) or partially (CutType::PartialCut).

Examples

printer.cut_paper(CutType::TotalCut);

Examples found in repository

examples/bitimage.rs (line 13)

fn main() {
    // Replace /dev/null with actual device node when the printer is connected
    // e.g.: /dev/usb/lp0
    let mut printer = CustomPrinter::new("/dev/null").unwrap();
    printer
        .bit_image(
            "tests/data/Thermal_Test_Image.png",
            BitImageMode::Dots24DoubleDensity,
        )
        .unwrap()
        .cut_paper(CutType::TotalCut)
        .run()
        .unwrap();
}

pub fn run(&mut self) -> Result<&mut Self, Error>

Run the constructed commands in the CustomPrinter.

The constructed commands will be cleared if the printing succeeds.

NOTE: Because writing to the device node may fail, so the return Self is wrapped in a Result and needs to be unwrapped before concatenating with other constructing functions.

Examples

printer
    .bit_image(
        "tests/data/Thermal_Test_Image.png",
        BitImageMode::Dots24DoubleDensity
    )
    .unwrap()
    .cut_paper(CutType::TotalCut)
    .run()
    .unwrap();

Examples found in repository

examples/bitimage.rs (line 14)

fn main() {
    // Replace /dev/null with actual device node when the printer is connected
    // e.g.: /dev/usb/lp0
    let mut printer = CustomPrinter::new("/dev/null").unwrap();
    printer
        .bit_image(
            "tests/data/Thermal_Test_Image.png",
            BitImageMode::Dots24DoubleDensity,
        )
        .unwrap()
        .cut_paper(CutType::TotalCut)
        .run()
        .unwrap();
}