Skip to content

iTitus/dds

Repository files navigation

dds / ddsiio / ddsfx

GitHub License Repo Size Maven Central - dds Maven Central - ddsiio Maven Central - ddsfx Gradle Build

Read dds images (DirectDrawSurface), an image format made by Microsoft for DirectX.

Targets:

  • DdsFile (dds module)
  • Java BufferedImage (ddsiio module)
  • JavaFX Image (ddsfx module)

Currently targeting Java 17+ and JavaFX 19+.

dds

  • contains the reading logic and api

ddsiio

  • adds dds support to ImageIO automatically
  • this requires the java.desktop module

ddsfx

  • adds dds support for JavaFX Image
  • one needs to call io.github.ititus.ddsfx.DdsFx.setup() once to register the format
  • this requires the java.desktop module (via ddsiio) and JavaFX
  • JavaFX needs to be included separately, there is no transitive dependency
  • if you have problems with duplicate JavaFX dependencies see openjfx/javafx-gradle-plugin#65
  • when including this in a modular build you will need to add the following compile and run options:
    • --add-export javafx.graphics/com.sun.javafx.iio=io.github.ititus.ddsfx
    • --add-export javafx.graphics/com.sun.javafx.iio.common=io.github.ititus.ddsfx