Package swingtree

Class SwingTreeInitConfig

java.lang.Object

swingtree.SwingTreeInitConfig

public final class SwingTreeInitConfig
extends Object

An immutable configuration object for the SwingTree library, which can be configured using a functional SwingTreeConfigurator lambda passed to SwingTree.initialiseUsing(SwingTreeConfigurator).

It allows for the configuration of the default font, font installation, scaling, event processing and application wide StyleSheet.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static enum	SwingTreeInitConfig.FontInstallation	Defines how the Font, specified through defaultFont(Font), is installed in the UIManager.
static enum	SwingTreeInitConfig.Scaling	Defines how the scaling factor for the UI should be determined.

Method Summary

Modifier and Type	Method	Description
SwingTreeInitConfig	defaultAnimationInterval(long newDefaultAnimationInterval)	Used to configure the default animation interval in milliseconds, which is a property that determines the delay between two consecutive animation steps.
SwingTreeInitConfig	defaultFont(Font newDefaultFont)	Used to configure the default font, which may be used by the SwingTree to derive the UI scaling factor and or to install the font in the UIManager depending on the SwingTreeInitConfig.FontInstallation mode (see defaultFont(Font, FontInstallation)).
SwingTreeInitConfig	defaultFont(Font newDefaultFont, SwingTreeInitConfig.FontInstallation newFontInstallation)	Used to configure both the default Font and the SwingTreeInitConfig.FontInstallation mode.
SwingTreeInitConfig	eventProcessor(EventProcessor newEventProcessor)	Used to configure the EventProcessor, which is used to process both UI and application events.
SwingTreeInitConfig	isUiScaleDownAllowed(boolean newUiScaleAllowScaleDown)	Used to configure whether values smaller than 100% are allowed for the user scale factor as is specified by the system property swingtree.uiScale.allowScaleDown.
SwingTreeInitConfig	isUiScaleFactorEnabled(boolean newUiScaleEnabled)	Used to configure whether the UI scaling mode is enabled as is specified by the system property swingtree.uiScale.enabled.
SwingTreeInitConfig	logMarker(org.slf4j.Marker newLogMarker)	Allows you to configure the logging Marker used by SwingTree for all its logging.
static SwingTreeInitConfig	standard()
SwingTreeInitConfig	styleSheet(StyleSheet newStyleSheet)	Used to configure a global StyleSheet serving as a base for all StyleSheets used inside your application (see UIFactoryMethods.use(swingtree.style.StyleSheet, Supplier)).
SwingTreeInitConfig	uiScaleFactor(float newUiScale)	Use this to configure the UI scaling factor.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

standard

public static SwingTreeInitConfig standard()

defaultFont

public SwingTreeInitConfig defaultFont(Font newDefaultFont)

Used to configure the default font, which may be used by the SwingTree to derive the UI scaling factor and or to install the font in the UIManager depending on the SwingTreeInitConfig.FontInstallation mode (see defaultFont(Font, FontInstallation)).

Parameters:

newDefaultFont - The new default font, or null to unset the default font.

Returns:

A new SwingTreeInitConfig instance with the new default font.

defaultFont

public SwingTreeInitConfig defaultFont(Font newDefaultFont,
 SwingTreeInitConfig.FontInstallation newFontInstallation)

Used to configure both the default Font and the SwingTreeInitConfig.FontInstallation mode.

The SwingTreeInitConfig.FontInstallation mode determines how the Font is installed in the UIManager (see SwingTreeInitConfig.FontInstallation).

If the SwingTreeInitConfig.FontInstallation mode is SwingTreeInitConfig.FontInstallation.SOFT, then the Font will only be installed as the "defaultFont" property in the UIManager. If on the other hand the SwingTreeInitConfig.FontInstallation mode is SwingTreeInitConfig.FontInstallation.HARD, then the Font will be installed by replacing all Fonts in the UIManager.

Parameters:

newDefaultFont - The new default font, or null to unset the default font.

newFontInstallation - The new SwingTreeInitConfig.FontInstallation mode.

Returns:

A new SwingTreeInitConfig instance with the new default font and SwingTreeInitConfig.FontInstallation mode.

eventProcessor

public SwingTreeInitConfig eventProcessor(EventProcessor newEventProcessor)

Used to configure the EventProcessor, which is used to process both UI and application events. You may create your own EventProcessor implementation or use one of the predefined ones like EventProcessor.COUPLED_STRICT, EventProcessor.COUPLED or EventProcessor.DECOUPLED.

Parameters:

newEventProcessor - The new EventProcessor.

Returns:

A new SwingTreeInitConfig instance with the new EventProcessor.

styleSheet

public SwingTreeInitConfig styleSheet(StyleSheet newStyleSheet)

Used to configure a global StyleSheet serving as a base for all StyleSheets used inside your application (see UIFactoryMethods.use(swingtree.style.StyleSheet, Supplier)).

Parameters:

newStyleSheet - The new StyleSheet, or null to unset the StyleSheet.

Returns:

A new SwingTreeInitConfig instance with the new StyleSheet.

uiScaleFactor

public SwingTreeInitConfig uiScaleFactor(float newUiScale)

Use this to configure the UI scaling factor. The default factor determined by the system property "swingtree.uiScale".

If Java runtime scales (Java 9 or later), this scale factor is applied on top of the Java system scale factor. Java 8 does not scale and this scale factor replaces the user scale factor that SwingTree computes based on the font. To replace the Java 9+ system scale factor, use system property "sun.java2d.uiScale", which has the same syntax as this one.

Allowed Values e.g. 1.5, 1.5x, 150% or 144dpi (96dpi is 100%)

Parameters:

newUiScale - The new UI scaling factor.

Returns:

A new SwingTreeInitConfig instance with the new UI scaling factor.

isUiScaleFactorEnabled

public SwingTreeInitConfig isUiScaleFactorEnabled(boolean newUiScaleEnabled)

Used to configure whether the UI scaling mode is enabled as is specified by the system property swingtree.uiScale.enabled.

Allowed Values false and true
Default true

Parameters:

newUiScaleEnabled - The new UI scaling mode.

Returns:

A new SwingTreeInitConfig instance with the new UI scaling mode.

isUiScaleDownAllowed

public SwingTreeInitConfig isUiScaleDownAllowed(boolean newUiScaleAllowScaleDown)

Used to configure whether values smaller than 100% are allowed for the user scale factor as is specified by the system property swingtree.uiScale.allowScaleDown.

Allowed Values false and true
Default false

Parameters:

newUiScaleAllowScaleDown - The new UI scaling mode.

Returns:

A new SwingTreeInitConfig instance with the new UI scaling mode.

defaultAnimationInterval

public SwingTreeInitConfig defaultAnimationInterval(long newDefaultAnimationInterval)

Used to configure the default animation interval in milliseconds, which is a property that determines the delay between two consecutive animation steps. You can think of it as the time between the heartbeats of the animation. The smaller the interval, the higher the refresh rate and the smoother the animation will look. However, the smaller the interval, the more CPU time will be used. The default interval is 16 ms which corresponds to 60 fps. See standard(), returning an instance of this config with the default value.
This property is used as default value by the LifeTime object which is used to define the duration of an Animation.

Parameters:

newDefaultAnimationInterval - The new default animation interval.

Returns:

A new SwingTreeInitConfig instance with the new default animation interval.

logMarker

public SwingTreeInitConfig logMarker(org.slf4j.Marker newLogMarker)

Allows you to configure the logging Marker used by SwingTree for all its logging. This is typically passed to methods like logger.debug(Marker, String), logger.info(Marker, String) and so on.
You may use this marker to channel SwingTree logs to a separate log file or to filter them in any other way you like.

Parameters:

newLogMarker - The new logging Marker which is passed to methods of the SLF4J logger.

Returns:

A new SwingTreeInitConfig instance with the new logging Marker.