Struct image::codecs::pnm::PnmEncoder

source ·
pub struct PnmEncoder<W: Write> { /* private fields */ }
Expand description

Encodes images to any of the pnm image formats.

Implementations§

source§

impl<W: Write> PnmEncoder<W>

source

pub fn new(writer: W) -> Self

Create new PnmEncoder from the writer.

The encoded images will have some pnm format. If more control over the image type is required, use either one of with_subtype or with_header. For more information on the behaviour, see with_dynamic_header.

source

pub fn with_subtype(self, subtype: PnmSubtype) -> Self

Encode a specific pnm subtype image.

The magic number and encoding type will be chosen as provided while the rest of the header data will be generated dynamically. Trying to encode incompatible images (e.g. encoding an RGB image as Graymap) will result in an error.

This will overwrite the effect of earlier calls to with_header and with_dynamic_header.

source

pub fn with_header(self, header: PnmHeader) -> Self

Enforce the use of a chosen header.

While this option gives the most control over the actual written data, the encoding process will error in case the header data and image parameters do not agree. It is the users obligation to ensure that the width and height are set accordingly, for example.

Choose this option if you want a lossless decoding/encoding round trip.

This will overwrite the effect of earlier calls to with_subtype and with_dynamic_header.

source

pub fn with_dynamic_header(self) -> Self

Create the header dynamically for each image.

This is the default option upon creation of the encoder. With this, most images should be encodable but the specific format chosen is out of the users control. The pnm subtype is chosen arbitrarily by the library.

This will overwrite the effect of earlier calls to with_subtype and with_header.

source

pub fn encode<'s, S>( &mut self, image: S, width: u32, height: u32, color: ColorType ) -> ImageResult<()>where S: Into<FlatSamples<'s>>,

Encode an image whose samples are represented as u8.

Some pnm subtypes are incompatible with some color options, a chosen header most certainly with any deviation from the original decoded image.

Trait Implementations§

source§

impl<W: Write> ImageEncoder for PnmEncoder<W>

source§

fn write_image( self, buf: &[u8], width: u32, height: u32, color_type: ColorType ) -> ImageResult<()>

Writes all the bytes in an image to the encoder. Read more

Auto Trait Implementations§

§

impl<W> RefUnwindSafe for PnmEncoder<W>where W: RefUnwindSafe,

§

impl<W> Send for PnmEncoder<W>where W: Send,

§

impl<W> Sync for PnmEncoder<W>where W: Sync,

§

impl<W> Unpin for PnmEncoder<W>where W: Unpin,

§

impl<W> UnwindSafe for PnmEncoder<W>where W: UnwindSafe,

Blanket Implementations§

source§

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

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

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

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

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

source§

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

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

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

source§

fn into(self) -> U

Calls U::from(self).

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

source§

impl<T> Pointable for T

source§

const ALIGN: usize = _

The alignment of pointer.
§

type Init = T

The type for initializers.
source§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
source§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
source§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
source§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
source§

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

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

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

§

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

The type returned in the event of a conversion error.
source§

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

Performs the conversion.