Enum printpdf::RenderingIntent
source · pub enum RenderingIntent {
AbsoluteColorimetric,
RelativeColorimetric,
Saturation,
Perceptual,
}
Expand description
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.
Implementations§
source§impl RenderingIntent
impl RenderingIntent
pub fn into_stream_op(self) -> Vec<Operation>
Trait Implementations§
source§impl Clone for RenderingIntent
impl Clone for RenderingIntent
source§fn clone(&self) -> RenderingIntent
fn clone(&self) -> RenderingIntent
1.0.0 · source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read moresource§impl Debug for RenderingIntent
impl Debug for RenderingIntent
source§impl From<RenderingIntent> for Object
impl From<RenderingIntent> for Object
source§fn from(val: RenderingIntent) -> Self
fn from(val: RenderingIntent) -> Self
Consumes the object and converts it to an PDF object
source§impl PartialEq for RenderingIntent
impl PartialEq for RenderingIntent
source§fn eq(&self, other: &RenderingIntent) -> bool
fn eq(&self, other: &RenderingIntent) -> bool
self
and other
values to be equal, and is used
by ==
.