View Javadoc
1   /*
2    * Licensed to the Apache Software Foundation (ASF) under one or more
3    * contributor license agreements.  See the NOTICE file distributed with
4    * this work for additional information regarding copyright ownership.
5    * The ASF licenses this file to You under the Apache License, Version 2.0
6    * (the "License"); you may not use this file except in compliance with
7    * the License.  You may obtain a copy of the License at
8    *
9    *      http://www.apache.org/licenses/LICENSE-2.0
10   *
11   * Unless required by applicable law or agreed to in writing, software
12   * distributed under the License is distributed on an "AS IS" BASIS,
13   * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14   * See the License for the specific language governing permissions and
15   * limitations under the License.
16   */
17  package org.apache.commons.imaging.color;
18  
19  /**
20   * Represents a color in the CIELUV color space..
21   *
22   * <p>
23   * Contains the constant values for black, white, red, green, and blue.
24   * </p>
25   *
26   * @see <a href="https://en.wikipedia.org/wiki/CIELUV">https://en.wikipedia.org/wiki/CIELUV</a>
27   * @since 1.0-alpha1
28   */
29  public final class ColorCieLuv {
30  
31      /**
32       * A constant for color black. Color components are:
33       *
34       * <pre>
35       *     L: 0.000
36       *     u: 0.000
37       *     v: 0.000
38       * </pre>
39       */
40      public static final ColorCieLuv BLACK = new ColorCieLuv(0, 0, 0);
41  
42      /**
43       * A constant for color white. Color components are:
44       *
45       * <pre>
46       *     L: 100.000
47       *     u:   0.000
48       *     v:  -0.017
49       * </pre>
50       */
51      public static final ColorCieLuv WHITE = new ColorCieLuv(100, 0, -0.017);
52  
53      /**
54       * A constant for color red. Color components are:
55       *
56       * <pre>
57       *     L:  53.233
58       *     u: 175.053
59       *     v:  37.751
60       * </pre>
61       */
62      public static final ColorCieLuv RED = new ColorCieLuv(53.233, 175.053, 37.751);
63  
64      /**
65       * A constant for color green. Color components are:
66       *
67       * <pre>
68       *     L:  87.737
69       *     u: -83.080
70       *     v: 107.401
71       * </pre>
72       */
73      public static final ColorCieLuv GREEN = new ColorCieLuv(87.737, -83.080, 107.401);
74  
75      /**
76       * A constant for color blue. Color components are:
77       *
78       * <pre>
79       *     L:   32.303
80       *     u:   -9.400
81       *     v: -130.358
82       * </pre>
83       */
84      public static final ColorCieLuv BLUE = new ColorCieLuv(32.303, -9.400, -130.358);
85  
86      public final double l;
87      public final double u;
88      public final double v;
89  
90      public ColorCieLuv(final double l, final double u, final double v) {
91          this.l = l;
92          this.u = u;
93          this.v = v;
94      }
95  
96      @Override
97      public boolean equals(final Object o) {
98          if (this == o) {
99              return true;
100         }
101         if (o == null || getClass() != o.getClass()) {
102             return false;
103         }
104 
105         final ColorCieLuv that = (ColorCieLuv) o;
106         if (Double.compare(that.l, l) != 0) {
107             return false;
108         }
109         if (Double.compare(that.u, u) != 0) {
110             return false;
111         }
112         if (Double.compare(that.v, v) != 0) {
113             return false;
114         }
115 
116         return true;
117     }
118 
119     @Override
120     public int hashCode() {
121         int result;
122         long temp;
123         temp = Double.doubleToLongBits(l);
124         result = (int) (temp ^ temp >>> 32);
125         temp = Double.doubleToLongBits(u);
126         result = 31 * result + (int) (temp ^ temp >>> 32);
127         temp = Double.doubleToLongBits(v);
128         return 31 * result + (int) (temp ^ temp >>> 32);
129     }
130 
131     @Override
132     public String toString() {
133         return "{L: " + l + ", u: " + u + ", v: " + v + "}";
134     }
135 }