Enum oox::shared::drawingml::colors::ColorTransform

#[repr(C)]
pub enum ColorTransform {
    Tint(PositiveFixedPercentage),
    Shade(PositiveFixedPercentage),
    Complement,
    Inverse,
    Grayscale,
    Alpha(PositiveFixedPercentage),
    AlphaOffset(FixedPercentage),
    AlphaModulate(PositivePercentage),
    Hue(PositiveFixedAngle),
    HueOffset(Angle),
    HueModulate(PositivePercentage),
    Saturation(Percentage),
    SaturationOffset(Percentage),
    SaturationModulate(Percentage),
    Luminance(Percentage),
    LuminanceOffset(Percentage),
    LuminanceModulate(Percentage),
    Red(Percentage),
    RedOffset(Percentage),
    RedModulate(Percentage),
    Green(Percentage),
    GreenOffset(Percentage),
    GreenModulate(Percentage),
    Blue(Percentage),
    BlueOffset(Percentage),
    BlueModulate(Percentage),
    Gamma,
    InverseGamma,
}

Variants

Tint(PositiveFixedPercentage)

This element specifies a lighter version of its input color. A 10% tint is 10% of the input color combined with 90% white.

Xml example

The following manipulates the fill from having RGB value RRGGBB = (00, FF, 00) to value RRGGBB= (BC, FF, BC)

<a:solidFill>
  <a:srgbClr val="00FF00">
    <a:tint val="50000"/>
  </a:srgbClr>
</a:solidFill>

Shade(PositiveFixedPercentage)

This element specifies a darker version of its input color. A 10% shade is 10% of the input color combined with 90% black.

Xml example

The following manipulates the fill from having RGB value RRGGBB = (00, FF, 00) to value RRGGBB= (00, BC, 00)

<a:solidFill>
  <a:srgbClr val="00FF00">
    <a:shade val="50000"/>
  </a:srgbClr>
</a:solidFill>

Complement

This element specifies that the color rendered should be the complement of its input color with the complement being defined as such. Two colors are called complementary if, when mixed they produce a shade of grey. For instance, the complement of red which is RGB (255, 0, 0) is cyan which is RGB (0, 255, 255).

Primary colors and secondary colors are typically paired in this way:

• red and cyan (where cyan is the mixture of green and blue)
• green and magenta (where magenta is the mixture of red and blue)
• blue and yellow (where yellow is the mixture of red and green)

Xml example

<a:solidFill>
  <a:srgbClr val="FF0000">
    <a:comp/>
  </a:srgbClr>
</a:solidFill>

Inverse

This element specifies the inverse of its input color.

Xml example

The inverse of red (1, 0, 0) is cyan (0, 1, 1).

The following represents cyan, the inverse of red:

<a:solidFill>
  <a:srgbClr val="FF0000">
    <a:inv/>
  </a:srgbClr>
</a:solidFill>

Grayscale

This element specifies a grayscale of its input color, taking into relative intensities of the red, green, and blue primaries.

Alpha(PositiveFixedPercentage)

This element specifies its input color with the specific opacity, but with its color unchanged.

Xml example

The following represents a green solid fill which is 50% opaque

<a:solidFill>
  <a:srgbClr val="00FF00">
    <a:alpha val="50000"/>
  </a:srgbClr>
</a:solidFill>

AlphaOffset(FixedPercentage)

This element specifies a more or less opaque version of its input color. Increases or decreases the input alpha percentage by the specified percentage offset. A 10% alpha offset increases a 50% opacity to 60%. A -10% alpha offset decreases a 50% opacity to 40%. The transformed alpha values are limited to a range of 0 to 100%. A 10% alpha offset increase to a 100% opaque object still results in 100% opacity.

Xml example

The following represents a green solid fill which is 90% opaque

<a:solidFill>
  <a:srgbClr val="00FF00">
    <a:alphaOff val="-10000"/>
  </a:srgbClr>
</a:solidFill>

AlphaModulate(PositivePercentage)

This element specifies a more or less opaque version of its input color. An alpha modulate never increases the alpha beyond 100%. A 200% alpha modulate makes a input color twice as opaque as before. A 50% alpha modulate makes a input color half as opaque as before.

Xml example

The following represents a green solid fill which is 50% opaque

<a:solidFill>
  <a:srgbClr val="00FF00">
    <a:alphaMod val="50000"/>
  </a:srgbClr>
</a:solidFill>

Hue(PositiveFixedAngle)

This element specifies the input color with the specified hue, but with its saturation and luminance unchanged.

Xml example

The following two solid fills are equivalent.

<a:solidFill>
  <a:hslClr hue="14400000" sat="100000" lum="50000">
</a:solidFill>
<a:solidFill>
  <a:hslClr hue="0" sat="100000" lum="50000">
    <a:hue val="14400000"/>
  <a:hslClr/>
</a:solidFill>

HueOffset(Angle)

This element specifies the input color with its hue shifted, but with its saturation and luminance unchanged.

Xml example

The following increases the hue angular value by 10 degrees.

<a:solidFill>
  <a:hslClr hue="0" sat="100000" lum="50000"/>
  <a:hueOff val="600000"/>
</a:solidFill>

HueModulate(PositivePercentage)

This element specifies the input color with its hue modulated by the given percentage. A 50% hue modulate decreases the angular hue value by half. A 200% hue modulate doubles the angular hue value.

Xml example

<a:solidFill>
  <a:hslClr hue="14400000" sat="100000" lum="50000">
    <a:hueMod val="50000"/>
  </a:hslClr>
</a:solidFill>

Saturation(Percentage)

This element specifies the input color with the specified saturation, but with its hue and luminance unchanged. Typically saturation values fall in the range [0%, 100%].

Xml example

The following two solid fills are equivalent:

<a:solidFill>
  <a:hslClr hue="14400000" sat="100000" lum="50000">
</a:solidFill>
<a:solidFill>
  <a:hslClr hue="14400000" sat="0" lum="50000">
    <a:sat val="100000"/>
  <a:hslClr/>
</a:solidFill>

SaturationOffset(Percentage)

This element specifies the input color with its saturation shifted, but with its hue and luminance unchanged. A 10% offset to 20% saturation yields 30% saturation.

Xml example

The following manipulates the fill from having RGB value RRGGBB = (00, FF, 00) to value RRGGBB= (19, E5, 19)

<a:solidFill>
  <a:srgbClr val="00FF00">
    <a:satOff val="-20000"/>
  </a:srgbClr>
</a:solidFill>

SaturationModulate(Percentage)

This element specifies the input color with its saturation modulated by the given percentage. A 50% saturation modulate reduces the saturation by half. A 200% saturation modulate doubles the saturation.

Xml example

The following manipulates the fill from having RGB value RRGGBB = (00, FF, 00) to value RRGGBB= (66, 99, 66)

<a:solidFill>
  <a:srgbClr val="00FF00">
    <a:satMod val="20000"/>
  </a:srgbClr>
</a:solidFill>

Luminance(Percentage)

This element specifies the input color with the specified luminance, but with its hue and saturation unchanged. Typically luminance values fall in the range [0%, 100%].

Xml example

The following two solid fills are equivalent:

<a:solidFill>
  <a:hslClr hue="14400000" sat="100000" lum="50000">
</a:solidFill>
<a:solidFill>
  <a:hslClr hue="14400000" sat="100000" lum="0">
    <a:lum val="50000"/>
  <a:hslClr/>
</a:solidFill>

LuminanceOffset(Percentage)

This element specifies the input color with its luminance shifted, but with its hue and saturation unchanged.

Xml example

The following manipulates the fill from having RGB value RRGGBB = (00, FF, 00) to value RRGGBB= (00, 99, 00)

<a:solidFill>
  <a:srgbClr val="00FF00">
    <a:lumOff val="-20000"/>
  </a:srgbClr>
</a:solidFill>

LuminanceModulate(Percentage)

This element specifies the input color with its luminance modulated by the given percentage. A 50% luminance modulate reduces the luminance by half. A 200% luminance modulate doubles the luminance.

Xml example

The following manipulates the fill from having RGB value RRGGBB = (00, FF, 00) to value RRGGBB= (00, 75, 00)

<a:solidFill>
  <a:srgbClr val="00FF00">
    <a:lumMod val="50000"/>
  </a:srgbClr>
</a:solidFill>

Red(Percentage)

This element specifies the input color with the specified red component, but with its green and blue color components unchanged.

Xml example

The following manipulates the fill from having RGB value RRGGBB = (00, FF, 00) to value RRGGBB= (FF, FF, 00)

<a:solidFill>
  <a:srgbClr val="00FF00">
    <a:red val="100000"/>
  </a:srgbClr>
</a:solidFill>

RedOffset(Percentage)

This element specifies the input color with its red component shifted, but with its green and blue color components unchanged.

Xml example

The following manipulates the fill from having RGB value RRGGBB = (FF, 00, 00) to value RRGGBB= (CC, 00, 00)

<a:solidFill>
  <a:srgbClr val="FF0000">
    <a:redOff val="-20000"/>
  </a:srgbClr>
</a:solidFill>

RedModulate(Percentage)

This element specifies the input color with its red component modulated by the given percentage. A 50% red modulate reduces the red component by half. A 200% red modulate doubles the red component.

Xml example

The following manipulates the fill from having RGB value RRGGBB = (FF, 00, 00) to value RRGGBB= (80, 00, 00)

<a:solidFill>
  <a:srgbClr val="FF0000">
    <a:redMod val="50000"/>
  </a:srgbClr>
</a:solidFill>

Green(Percentage)

This elements specifies the input color with the specified green component, but with its red and blue color components unchanged.

Xml example

The following manipulates the fill from having RGB value RRGGBB = (00, 00, FF) to value RRGGBB= (00, FF, FF)

<a:solidFill>
  <a:srgbClr val="0000FF">
    <a:green val="100000"/>
  </a:srgbClr>
</a:solidFill>

GreenOffset(Percentage)

This element specifies the input color with its green component shifted, but with its red and blue color components unchanged.

Xml example

The following manipulates the fill from having RGB value RRGGBB = (00, FF, 00) to value RRGGBB= (00, CC, 00).

<a:solidFill>
  <a:srgbClr val="00FF00">
    <a:greenOff val="-20000"/>
  </a:srgbClr>
</a:solidFill>

GreenModulate(Percentage)

This element specifies the input color with its green component modulated by the given percentage. A 50% green modulate reduces the green component by half. A 200% green modulate doubles the green component.

Xml example

The following manipulates the fill from having RGB value RRGGBB = (00, FF, 00) to value RRGGBB= (00, 80, 00)

<a:solidFill>
  <a:srgbClr val="00FF00">
    <a:greenMod val="50000"/>
  </a:srgbClr>
</a:solidFill>

Blue(Percentage)

This element specifies the input color with the specific blue component, but with the red and green color components unchanged.

Xml example

The following manipulates the fill from having RGB value RRGGBB = (00, FF, 00) to value RRGGBB= (00, FF, FF)

<a:solidFill>
  <a:srgbClr val="00FF00">
    <a:blue val="100000"/>
  </a:srgbClr>
</a:solidFill>

BlueOffset(Percentage)

This element specifies the input color with its blue component shifted, but with its red and green color components unchanged.

Xml example

The following manipulates the fill from having RGB value RRGGBB = (00, 00, FF) to value RRGGBB= (00, 00, CC)

<a:solidFill>
  <a:srgbClr val="00FF00">
    <a:blueOff val="-20000"/>
  </a:srgbClr>
</a:solidFill>

BlueModulate(Percentage)

This element specifies the input color with its blue component modulated by the given percentage. A 50% blue modulate reduces the blue component by half. A 200% blue modulate doubles the blue component.

Xml example

The following manipulates the fill from having RGB value RRGGBB = (00, 00, FF) to value RRGGBB= (00, 00, 80)

<a:solidFill>
  <a:srgbClr val="0000FF">
    <a:blueMod val="50000"/>
  </a:srgbClr>
</a:solidFill>

Gamma

This element specifies that the output color rendered by the generating application should be the sRGB gamma shift of the input color.

InverseGamma

This element specifies that the output color rendered by the generating application should be the inverse sRGB gamma shift of the input color.

Trait Implementations

impl Clone for ColorTransform

fn clone(&self) -> ColorTransform

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for ColorTransform

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

Formats the value using the given formatter.

impl PartialEq<ColorTransform> for ColorTransform

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

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

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

This method tests for !=.

impl StructuralPartialEq for ColorTransform

impl XsdChoice for ColorTransform

fn is_choice_member<T: AsRef<str>>(name: T) -> bool

fn try_from_xml_element(
    xml_node: &XmlNode
) -> Option<Result<Self, Box<dyn Error>>>

Tries to parse an XmlNode as a choice member. None is returned if the XmlNode is not a member of the choice element (implementors should return a boxed NotGroupMemberError), otherwise Some is returned with the Result of from_xml_element.

impl XsdType for ColorTransform

fn from_xml_element(xml_node: &XmlNode) -> Result<ColorTransform>