ColorWithFallback (Apache FOP Core 2.11 API)
Date: 2025-04-24

org.apache.fop.util

## Class ColorWithFallback

- java.lang.Object
- - java.awt.Color
  - - org.apache.xmlgraphics.java2d.color.ColorWithAlternatives
    - - org.apache.fop.util.ColorWithFallback

- All Implemented Interfaces:
    Paint, Transparency, Serializable

      public class ColorWithFallback
      extends org.apache.xmlgraphics.java2d.color.ColorWithAlternatives

  This class is a `Color` subclass adding a fallback color that FOP uses to re-serialize color specifications as textual functions. The fallback is otherwise not used in producing output formats.
  See Also:
    Serialized Form

- - ### Field Summary

    - ### Fields inherited from class java.awt.Color

      `black, BLACK, blue, BLUE, cyan, CYAN, DARK_GRAY, darkGray, gray, GRAY, green, GREEN, LIGHT_GRAY, lightGray, magenta, MAGENTA, orange, ORANGE, pink, PINK, red, RED, white, WHITE, yellow, YELLOW`

    - ### Fields inherited from interface java.awt.Transparency

      `BITMASK, OPAQUE, TRANSLUCENT`

  - ### Constructor Summary

    Constructors
    Constructor and Description
    `ColorWithFallback(Color color, Color fallback)` Copy constructor adding a fallback color.
    `ColorWithFallback(ColorSpace cspace, float[] components, float alpha, Color[] alternativeColors, Color fallback)` Creates a new color

  - ### Method Summary

    All Methods Instance Methods Concrete Methods
    Modifier and Type | Method and Description
    --- | ---
    `boolean` | `equals(Object obj)`
    `Color` | `getFallbackColor()` Returns the fallback color.
    `int` | `hashCode()`

    - ### Methods inherited from class org.apache.xmlgraphics.java2d.color.ColorWithAlternatives

      `getAlternativeColors, getFirstAlternativeOfType, hasAlternativeColors, hasSameAlternativeColors`

    - ### Methods inherited from class java.awt.Color

      `brighter, createContext, darker, decode, getAlpha, getBlue, getColor, getColor, getColor, getColorComponents, getColorComponents, getColorSpace, getComponents, getComponents, getGreen, getHSBColor, getRed, getRGB, getRGBColorComponents, getRGBComponents, getTransparency, HSBtoRGB, RGBtoHSB, toString`

    - ### Methods inherited from class java.lang.Object

      `clone, finalize, getClass, notify, notifyAll, wait, wait, wait`

- - ### Constructor Detail

    - #### ColorWithFallback

          public ColorWithFallback(ColorSpace cspace,
                                   float[] components,
                                   float alpha,
                                   Color[] alternativeColors,
                                   Color fallback)

      Creates a new color
      Parameters:
        `cspace` - the color space of the primary color
        `components` - the color components
        `alpha` - the alpha component
        `alternativeColors` - the array of alternative colors if applicable (may be null)
        `fallback` - the fallback color (usually an sRGB color)

    - #### ColorWithFallback

          public ColorWithFallback(Color color,
                                   Color fallback)

      Copy constructor adding a fallback color.
      Parameters:
        `color` - the color to be duplicated
        `fallback` - the fallback color (usually an sRGB color)

  - ### Method Detail

    - #### getFallbackColor

          public Color getFallbackColor()

      Returns the fallback color.
      Returns:
        the fallback color

    - #### hashCode

          public int hashCode()

      Overrides:
        `hashCode` in class `org.apache.xmlgraphics.java2d.color.ColorWithAlternatives`

    - #### equals

          public boolean equals(Object obj)

      Overrides:
        `equals` in class `Color`

Copyright © 2025 Apache Software Foundation. All rights reserved.