Minor comment updates in Java library.

PiperOrigin-RevId: 545652652

Author: Material Eng

java/contrast/Contrast.java

@@ -55,7 +55,7 @@ public final class Contrast {
   private static final double CONTRAST_RATIO_EPSILON = 0.04;
 
   // Color spaces that measure luminance, such as Y in XYZ, L* in L*a*b*, or T in HCT, are known as
-  // perceptual accurate color spaces.
+  // perceptually accurate color spaces.
   //
   // To be displayed, they must gamut map to a "display space", one that has a defined limit on the
   // number of colors. Display spaces include sRGB, more commonly understood  as RGB/HSL/HSV/HSB.
@@ -75,7 +75,7 @@ public final class Contrast {
   // result such that the desired contrast ratio will be reached even if inaccuracy is introduced.
   //
   // 0.4 is generous, ex. HCT requires much less delta. It was chosen because it provides a rough
-  // guarantee that as long as a percetual color space gamut maps lightness such that the resulting
+  // guarantee that as long as a perceptual color space gamut maps lightness such that the resulting
   // lightness rounds to the same as the requested, the desired contrast ratio will be reached.
   private static final double LUMINANCE_GAMUT_MAP_TOLERANCE = 0.4;
 

java/hct/HctSolver.java

@@ -661,7 +661,7 @@ public static int solveToInt(double hueDegrees, double chroma, double lstar) {
    * @param hueDegrees The desired hue, in degrees.
    * @param chroma The desired chroma.
    * @param lstar The desired L*.
-   * @return An CAM16 object representing the sRGB color. The color has sufficiently close hue,
+   * @return A CAM16 object representing the sRGB color. The color has sufficiently close hue,
    *     chroma, and L* to the desired values, if possible; otherwise, the hue and L* will be
    *     sufficiently close, and chroma will be maximized.
    */

java/quantize/PointProvider.java

@@ -18,9 +18,15 @@
 
 /** An interface to allow use of different color spaces by quantizers. */
 public interface PointProvider {
+  /** The four components in the color space of an sRGB color. */
   public double[] fromInt(int argb);
 
+  /** The ARGB (i.e. hex code) representation of this color. */
   public int toInt(double[] point);
 
+  /**
+   * Squared distance between two colors. Distance is defined by scientific color spaces and
+   * referred to as delta E.
+   */
   public double distance(double[] a, double[] b);
 }

java/scheme/Scheme.java

@@ -119,18 +119,22 @@ public Scheme(
     this.inversePrimary = inversePrimary;
   }
 
+  /** Creates a light theme Scheme from a source color in ARGB, i.e. a hex code. */
   public static Scheme light(int argb) {
     return lightFromCorePalette(CorePalette.of(argb));
   }
 
+  /** Creates a dark theme Scheme from a source color in ARGB, i.e. a hex code. */
   public static Scheme dark(int argb) {
     return darkFromCorePalette(CorePalette.of(argb));
   }
 
+  /** Creates a light theme content-based Scheme from a source color in ARGB, i.e. a hex code. */
   public static Scheme lightContent(int argb) {
     return lightFromCorePalette(CorePalette.contentOf(argb));
   }
 
+  /** Creates a dark theme content-based Scheme from a source color in ARGB, i.e. a hex code. */
   public static Scheme darkContent(int argb) {
     return darkFromCorePalette(CorePalette.contentOf(argb));
   }