Skip to content

hsluv/hsluv-java

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Build Status Package Version Javadocs

About: https://www.hsluv.org

Installation

If you are using Maven, add the following to your pom.xml file:

<dependency>
    <groupId>org.hsluv</groupId>
    <artifactId>hsluv</artifactId>
    <version>1.0</version>
</dependency>

Usage

The API is designed to avoid heap allocation. The HSLuv class defines the following public fields:

  • RGB: hex:String, rgb_r [0;1], rgb_g [0;1], rgb_r [0;1]
  • CIE XYZ: xyz_x, xyz_y, xyz_z
  • CIE LUV: luv_l, luv_u, luv_v
  • CIE LUV LCh: lch_l, lch_c, lch_h
  • HSLuv: hsluv_h [0;360], hsluv_s [0;100], hsluv_l [0;100]
  • HPLuv: hpluv_h [0;360], hpluv_p [0;100], hpluv_l [0;100]

To convert between color spaces, simply set the properties of the source color space, run the conversion methods, then read the properties of the target color space.

Use the following methods to convert to and from RGB:

  • HSLuv: hsluvToRgb(), hsluvToHex(), rgbToHsluv(), hexToHsluv()
  • HPLuv: hpluvToRgb(), hpluvToHex(), rgbToHpluv(), hexToHpluv()

Use the following methods to do step-by-step conversion:

  • Forward: hsluvToLch() (or hpluvToLch()), lchToLuv(), luvToXyz(), xyzToRgb(), rgbToHex()
  • Backward: hexToRgb(), rgbToXyz(), xyzToLuv(), luvToLch(), lchToHsluv() (or lchToHpluv())

For advanced usage, we also export the bounding lines in slope-intercept format, two for each RGB channel representing the limit of the gamut.

  • R < 0: r0s, r0i
  • R > 1: r1s, r1i
  • G < 0: g0s, g0i
  • G > 1: g1s, g1i
  • B < 0: b0s, b0i
  • B > 1: b1s, b1i

Example:

HsluvColorConverter conv = new HsluvColorConverter();
conv.hsluv_h = 10;
conv.hsluv_s = 75;
conv.hsluv_l = 65;
conv.hsluvToHex();
System.out.println(conv.hex); // Will print "#ec7d82"

Testing

mvn test

Deployment

Docs:

Set ~/m2/settings.xml:

<settings>
    <servers>
        <server>
            <id>ossrh</id>
            <username>hsluv</username>
            <password>REDACTEDREDACTEDREDACTED</password>
        </server>
    </servers>
    <profiles>
        <profile>
            <id>ossrh</id>
            <activation>
                <activeByDefault>true</activeByDefault>
            </activation>
            <properties>
                <gpg.passphrase>REDACTEDREDACTEDREDACTED</gpg.passphrase>
            </properties>
        </profile>
    </profiles>
</settings>

Then run:

mvn versions:set -DnewVersion=0.3 # bump version
mvn clean deploy -P release

About

Java implementation of HSLuv (revision 4)

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages