Enum printpdf::types::plugins::graphics::extgstate::RenderingIntent

pub enum RenderingIntent {
    AbsoluteColorimetric,
    RelativeColorimetric,
    Saturation,
    Perceptual,
}

Although CIE-based color specifications are theoretically device-independent, they are subject to practical limitations in the color reproduction capabilities of the output device. Such limitations may sometimes require compromises to be made among various properties of a color specification when rendering colors for a given device. Specifying a rendering intent (PDF 1.1) allows a PDF file to set priorities regarding which of these properties to preserve and which to sacrifice.

Variants

AbsoluteColorimetric

Colors are represented solely with respect to the light source; no correction is made for the output medium’s white point (such as the color of unprinted paper). Thus, for example, a monitor’s white point, which is bluish compared to that of a printer’s paper, would be reproduced with a blue cast. In-gamut colors are reproduced exactly; out-of-gamut colors are mapped to the nearest value within the reproducible gamut. This style of reproduction has the advantage of providing exact color matches from one output medium to another. It has the disadvantage of causing colors with Y values between the medium’s white point and 1.0 to be out of gamut. A typical use might be for logos and solid colors that require exact reproduction across different media.

RelativeColorimetric

Colors are represented with respect to the combination of the light source and the output medium’s white point (such as the color of unprinted paper). Thus, for example, a monitor’s white point would be reproduced on a printer by simply leaving the paper unmarked, ignoring color differences between the two media. In-gamut colors are reproduced exactly; out-of-gamut colors are mapped to the nearest value within the reproducible gamut. This style of reproduction has the advantage of adapting for the varying white points of different output media. It has the disadvantage of not providing exact color matches from one me- dium to another. A typical use might be for vector graphics.

Saturation

Colors are represented in a manner that preserves or emphasizes saturation. Reproduction of in-gamut colors may or may not be colorimetrically accurate. A typical use might be for business graphics, where saturation is the most important attribute of the color.

Perceptual

Colors are represented in a manner that provides a pleasing perceptual appearance. To preserve color relationships, both in-gamut and out-of-gamut colors are generally modified from their precise colorimetric values. A typical use might be for scanned images.

Methods

impl RenderingIntent

pub fn into_stream_op(self) -> Vec<Operation>

Trait Implementations

impl Clone for RenderingIntent

fn clone(&self) -> RenderingIntent

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Into<Object> for RenderingIntent

fn into(self) -> Object

Consumes the object and converts it to an PDF object

impl PartialEq<RenderingIntent> for RenderingIntent

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

This method tests for self and other values to be equal, and is used by ==.

#[must_use] fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl Copy for RenderingIntent

impl Debug for RenderingIntent

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

Formats the value using the given formatter.