https://github.com/0xd3adcode/aetherjfx-imagedecoder-jpegxl

AetherJFX (JavaFX) image decoding (IIO) WebP plugin (JNA-powered)
https://github.com/0xd3adcode/aetherjfx-imagedecoder-jpegxl

image javafx jpegxl

Last synced: 2 days ago
JSON representation

AetherJFX (JavaFX) image decoding (IIO) WebP plugin (JNA-powered)

• Host: GitHub
• URL: https://github.com/0xd3adcode/aetherjfx-imagedecoder-jpegxl
• Owner: 0xD3ADCODE
• Created: 2024-11-12T18:41:59.000Z (2 months ago)
• Default Branch: main
• Last Pushed: 2024-11-12T18:55:41.000Z (2 months ago)
• Last Synced: 2024-11-12T19:44:24.479Z (2 months ago)
• Topics: image, javafx, jpegxl
• Language: Java
• Homepage:
• Size: 0 Bytes
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
[![AetherJFX](https://img.shields.io/badge/Only%20for:-AetherJFX-blue)](https://github.com/0xD3ADCODE/AetherJFX)

![Java](https://img.shields.io/badge/Java-17-b07219)

# AetherJFX JpegXL Image Decoder Plugin

> [!WARNING]  

> This plugin is designed to be used ONLY with [JavaFX](https://github.com/openjdk/jfx) fork [AetherJFX](https://github.com/0xD3ADCODE/AetherJFX). Attempting to use it with standard JavaFX will lead to an exception!

[JpegXL](https://github.com/libjxl/libjxl) image decoding plugin for [AetherJFX](https://github.com/0xD3ADCODE/AetherJFX)

Based on [vavi-image-jpegxl](https://github.com/umjammer/vavi-image-jpegxl) and integrates into JavaFX's `ImageIO` (`IIO`) instead of default one that depends on `AWT`

> [!IMPORTANT]

> Not supported:  

> Animations (looks like, official `jxl-jni` Java bindings don't support them)

## Dependency

> [!WARNING]  

> Prebuild `Windows x86-64` library is included into jar. Refer to [JpegXL](https://github.com/libjxl/libjxl) repository for installation guide for other systems

Define custom Gradle ivy repository in `repositories` block:

```groovy

repositories {

    //...your repositories

    def github = ivy {

        url 'https://github.com/'

        patternLayout {

            artifact '/[organisation]/[module]/releases/download/[revision]/[artifact].[ext]'

        }

        metadataSources { artifact() }

    }

    exclusiveContent {

        forRepositories(github)

        filter { includeGroup("0xD3ADCODE") }

    }

}

```

Add dependency into `dependencies` block:

```groovy

dependencies {

    //...your dependencies

    implementation("0xD3ADCODE:AetherJFX-ImageDecoder-JpegXL:{version}") {

        artifact {

            name = 'AetherJFX-ImageDecoder-JpegXL-{version}'

            type = 'jar'

        }

    }

}

```

Replace `{version}` with latest [Release](https://github.com/0xD3ADCODE/AetherJFX-ImageDecoder-JpegXL/releases) tag (eg, `v1.0`)

## Usage

Register plugin as soon as possible (before JavaFX Toolkit start) with just one line of code:

```java

JpegXLLoader.register();

```

After that all JpegXL images will be decoded using newly installed decoder directly into JavaFX's `Image` without `AWT`

## Development

To properly build `jar` by yourself, clone repository and create `gradle.properties` file with:

```text

AETHER_JFX_SDK_PATH = 

```

## Credits

[libjxl](https://github.com/libjxl) for [JpegXL](https://github.com/libjxl/libjxl) decoder  

[umjammer](https://github.com/umjammer/) for [vavi-image-jpegxl](https://github.com/umjammer/vavi-image-jpegxl) JpegXL decoder/encoder implementation for Java