Radiance libraries

Radiance is a collection of libraries for writing modern, elegant and fast Swing applications based on the Ephemeral design system. It is built with Java 17, and runs on Java 9 and later.

General questions

This document is where you may find answers to some of the general questions on Radiance. If there's anything missing there, let me know.

Core Java libraries

Common

Common provides APIs to work with images and text that scale with the display resolution. Radiance icons scale to maintain crisp, pixel-perfect visuals for application icons. Font APIs can be used to render platform-consistent textual content across a variety of supported platforms.

Animation

Animation provides powerful and flexible animation APIs that scale from simple, single-property cases to complex scenarios that involve multiple animations. It powers all animations in the Radiance libraries.

Theming

Theming provides a comprehensive set of APIs for skinning Swing applications, addressing the most demanding, modern design requirements. It comes with built-in support for all core Swing components, and a flexible API surface for rendering third-party / application components.

Components

Components provides a robust set of additional Swing components that can be used as building blocks for creating modern, rich Swing applications. In addition to providing the powerful command button and breadcrumb bar components, it packs an Office Command Bar (ribbon) container that hosts complex hierarchies of content on a flexible and adaptive surface.

Core Kotlin libraries

• Core Swing extensions is a set of Kotlin extensions that expose selected core Swing APIs for idiomatic Kotlin usage.

• Animation extensions exposes a subset of the API surface of Animation as a concise, focused and approachable Kotlin domain-specific language (DSL). It also provides a number of Kotlin extensions for Animation APIs.

• Theming extensions is a set of Kotlin extensions that provide a more elegant way of working with scoped Radiance theming APIs.

• Component extensions exposes a subset of the API surface of Components as a concise, focused and approachable Kotlin domain-specific language (DSL). It also provides a number of Kotlin extensions for Components APIs.

Tools

• Laf Benchmark provides tools for Swing look-and-feel developers to measure the performance of their libraries.

• Theming Debugger is a visual runtime debugger for Radiance look-and-feel.

• Screenshot has utilities for taking screenshots for Radiance documentation.

• SVG Transcoder enables usage of vector-based icons in Swing applications. SVG content is transcoded offline to Java / Kotlin classes that use pure Java2D canvas operations that do not require expensive runtime overhead of third-party dependencies.

• SVG Transcoder Plugin is a Gradle plugin that wraps the SVG Transcoder library to allow build-time transcoding of SVG content into Java / Kotlin classes.

Demos

This document lists all major demos and samples that showcase how to use various Radiance APIs.

Radiance artifacts

Radiance artifacts are available in the Maven Central repository under groupId=org.pushing-pixels

Core artifacts

• radiance-common for Common
• radiance-animation for Animation
• radiance-theming for Theming
• radiance-component for Component
• radiance-theming-extras for Theming extras

Kotlin extension artifacts

• radiance-swing-ktx for Swing Kotlin extensions
• radiance-animation-ktx for Animation Kotlin extensions
• radiance-theming-ktx for Theming Kotlin extensions
• radiance-component-ktx for Component Kotlin extensions

Tools artifacts

• radiance-svg-transcoder for SVG transcoder
• radiance-svg-transcoder-gradle-plugin for SVG transcoder Gradle plugin
• radiance-theming-debugger for Theming debugger

Snapshots

Radiance snapshot artifacts are available in the Maven Central snapshot repository using the https://central.sonatype.com/repository/maven-snapshots/ URL.

Building Radiance

This document is an overview of how to build Radiance artifacts locally.