Modifier and Type	Class and Description
public static class	DPIUtil.AutoScaleImageDataProvider AutoScale ImageDataProvider.
private static enum	DPIUtil.AutoScaleMethod
public static record	DPIUtil.ElementAtZoom< type of the element to be presented, e.g., `ImageData` T> Represents an element, such as some image data, at a specific zoom level.

Modifier and Type	Field and Description
private static DPIUtil.AutoScaleMethod	autoScaleMethod
private static DPIUtil.AutoScaleMethod	autoScaleMethodSetting
private static String	autoScaleValue
private static int	deviceZoom
private static final int	DPI_ZOOM_100
private static int	nativeDeviceZoom
private static final String	SWT_AUTOSCALE System property that controls the autoScale functionality.
private static final String	SWT_AUTOSCALE_METHOD System property that controls the method for scaling images: "nearest": nearest-neighbor interpolation, may look jagged "smooth": smooth edges, may look blurry
private static boolean	useCairoAutoScale

Access	Constructor and Description
public	DPIUtil()

Method Summary

Modifier and Type	Method and Description
public static Rectangle	autoScaleBounds(Rectangle rect, int targetZoom, int currentZoom) Returns a new rectangle as per the scaleFactor.
public static ImageData	autoScaleDown(Device device, final ImageData imageData) Auto-scale down ImageData
public static int[]	autoScaleDown(int[] pointArray)
public static int[]	autoScaleDown(Drawable drawable, int[] pointArray)
public static float[]	autoScaleDown(float[] size) Auto-scale down float array dimensions.
public static float[]	autoScaleDown(Drawable drawable, float[] size) Auto-scale down float array dimensions if enabled for Drawable class.
public static int	autoScaleDown(int size) Auto-scale down int dimensions.
public static int	autoScaleDown(Drawable drawable, int size) Auto-scale down int dimensions if enabled for Drawable class.
public static float	autoScaleDown(float size) Auto-scale down float dimensions.
public static float	autoScaleDown(Drawable drawable, float size) Auto-scale down float dimensions if enabled for Drawable class.
public static Point	autoScaleDown(Point point) Returns a new scaled down Point.
public static Point	autoScaleDown(Drawable drawable, Point point) Returns a new scaled down Point if enabled for Drawable class.
public static Rectangle	autoScaleDown(Rectangle rect) Returns a new scaled down Rectangle.
public static Rectangle	autoScaleDown(Drawable drawable, Rectangle rect) Returns a new scaled down Rectangle if enabled for Drawable class.
public static ImageData	autoScaleImageData(Device device, final ImageData imageData, int targetZoom, int currentZoom) Auto-scale image with ImageData
private static ImageData	autoScaleImageData(Device device, final ImageData imageData, float scaleFactor)
public static ImageData	autoScaleImageData(Device device, final ImageData imageData, int imageDataZoomFactor) Auto-scale ImageData to device zoom that are at given zoom factor.
public static ImageData	autoScaleUp(Device device, final ImageData imageData) Auto-scale up ImageData to device zoom that is at 100%.
public static int[]	autoScaleUp(int[] pointArray)
public static int[]	autoScaleUp(Drawable drawable, int[] pointArray)
public static int	autoScaleUp(int size) Auto-scale up int dimensions.
public static int	autoScaleUp(Drawable drawable, int size) Auto-scale up int dimensions if enabled for Drawable class.
public static float	autoScaleUp(float size)
public static float	autoScaleUp(Drawable drawable, float size)
public static Point	autoScaleUp(Point point) Returns a new scaled up Point.
public static Point	autoScaleUp(Drawable drawable, Point point) Returns a new scaled up Point if enabled for Drawable class.
public static Rectangle	autoScaleUp(Rectangle rect) Returns a new scaled up Rectangle.
public static Rectangle	autoScaleUp(Drawable drawable, Rectangle rect) Returns a new scaled up Rectangle if enabled for Drawable class.
public static int	autoScaleUpUsingNativeDPI(int size) Auto-scale up int dimensions using Native DPI
public static int	getDeviceZoom()
private static <T> DPIUtil.ElementAtZoom<T>	getElementAtZoom(Function<Integer, T> elementForZoomProvider, int zoom)
private static float	Returns: float scaling factor getScalingFactor() Returns Scaling factor from the display
public static int	getZoomForAutoscaleProperty(int nativeDeviceZoom)
public static int	Returns: zoom mapDPIToZoom(int dpi) Compute the zoom value based on the DPI value.
public static void	setDeviceZoom(int nativeDeviceZoom)
public static void	setUseCairoAutoScale(boolean cairoAutoScale)
public static boolean	useCairoAutoScale()
public static DPIUtil.ElementAtZoom<ImageData>	validateAndGetImageDataAtZoom(ImageDataProvider provider, int zoom) Gets ImageData that are appropriate for the specified zoom level together with the zoom level at which the image data are.
public static DPIUtil.ElementAtZoom<String>	validateAndGetImagePathAtZoom(ImageFileNameProvider provider, int zoom) Gets the image file path that are appropriate for the specified zoom level together with the zoom level at which the image data are.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

autoScaleMethod	back to summary
private static DPIUtil.AutoScaleMethod autoScaleMethod

autoScaleMethodSetting	back to summary
private static DPIUtil.AutoScaleMethod autoScaleMethodSetting

autoScaleValue	back to summary
private static String autoScaleValue

deviceZoom	back to summary
private static int deviceZoom

DPI_ZOOM_100	back to summary
private static final int DPI_ZOOM_100

nativeDeviceZoom	back to summary
private static int nativeDeviceZoom

SWT_AUTOSCALE	back to summary
private static final String SWT_AUTOSCALE System property that controls the autoScale functionality. false: deviceZoom is set to 100% integer: deviceZoom depends on the current display resolution, but only uses integer multiples of 100%. The detected native zoom is generally rounded down (e.g. at 150%, will use 100%), unless close to the next integer multiple (currently at 175%, will use 200%). integer200: like integer, but the maximal zoom level is 200%. half: deviceZoom depends on the current display resolution, but only uses integer multiples of 50%. The detected native zoom is rounded to the closest permissible value, with tie-breaker towards even. quarter: deviceZoom depends on the current display resolution, but only uses integer multiples of 25%. The detected native zoom is rounded to the closest permissible value. exact: deviceZoom uses the native zoom (with 1% as minimal step). <value>: deviceZoom uses the given integer value in percent as zoom level. The current default is "integer200".

SWT_AUTOSCALE

back to summary

private static final String SWT_AUTOSCALE

System property that controls the autoScale functionality.

false: deviceZoom is set to 100%
integer: deviceZoom depends on the current display resolution, but only uses integer multiples of 100%. The detected native zoom is generally rounded down (e.g. at 150%, will use 100%), unless close to the next integer multiple (currently at 175%, will use 200%).
integer200: like integer, but the maximal zoom level is 200%.
half: deviceZoom depends on the current display resolution, but only uses integer multiples of 50%. The detected native zoom is rounded to the closest permissible value, with tie-breaker towards even.
quarter: deviceZoom depends on the current display resolution, but only uses integer multiples of 25%. The detected native zoom is rounded to the closest permissible value.
exact: deviceZoom uses the native zoom (with 1% as minimal step).
<value>: deviceZoom uses the given integer value in percent as zoom level.

The current default is "integer200".

SWT_AUTOSCALE_METHOD	back to summary
private static final String SWT_AUTOSCALE_METHOD System property that controls the method for scaling images: "nearest": nearest-neighbor interpolation, may look jagged "smooth": smooth edges, may look blurry The current default is to use "nearest", except on GTK when the deviceZoom is not an integer multiple of 100%. The smooth strategy currently doesn't work on Win32 and Cocoa, see bug 493455.

SWT_AUTOSCALE_METHOD

back to summary

private static final String SWT_AUTOSCALE_METHOD

System property that controls the method for scaling images:

"nearest": nearest-neighbor interpolation, may look jagged
"smooth": smooth edges, may look blurry

The current default is to use "nearest", except on GTK when the deviceZoom is not an integer multiple of 100%. The smooth strategy currently doesn't work on Win32 and Cocoa, see bug 493455.

useCairoAutoScale	back to summary
private static boolean useCairoAutoScale

Constructor Detail

DPIUtil	back to summary
public DPIUtil()

Method Detail

autoScaleBounds	back to summary
public static Rectangle autoScaleBounds(Rectangle rect, int targetZoom, int currentZoom) Returns a new rectangle as per the scaleFactor.

autoScaleDown	back to summary
public static ImageData autoScaleDown(Device device, final ImageData imageData) Auto-scale down ImageData

autoScaleDown	back to summary
public static int[] autoScaleDown(int[] pointArray)

autoScaleDown	back to summary
public static int[] autoScaleDown(Drawable drawable, int[] pointArray)

autoScaleDown	back to summary
public static float[] autoScaleDown(float[] size) Auto-scale down float array dimensions.

autoScaleDown	back to summary
public static float[] autoScaleDown(Drawable drawable, float[] size) Auto-scale down float array dimensions if enabled for Drawable class.

autoScaleDown	back to summary
public static int autoScaleDown(int size) Auto-scale down int dimensions.

autoScaleDown	back to summary
public static int autoScaleDown(Drawable drawable, int size) Auto-scale down int dimensions if enabled for Drawable class.

autoScaleDown	back to summary
public static float autoScaleDown(float size) Auto-scale down float dimensions.

autoScaleDown	back to summary
public static float autoScaleDown(Drawable drawable, float size) Auto-scale down float dimensions if enabled for Drawable class.

autoScaleDown	back to summary
public static Point autoScaleDown(Point point) Returns a new scaled down Point.

autoScaleDown	back to summary
public static Point autoScaleDown(Drawable drawable, Point point) Returns a new scaled down Point if enabled for Drawable class.

autoScaleDown	back to summary
public static Rectangle autoScaleDown(Rectangle rect) Returns a new scaled down Rectangle.

autoScaleDown	back to summary
public static Rectangle autoScaleDown(Drawable drawable, Rectangle rect) Returns a new scaled down Rectangle if enabled for Drawable class.

autoScaleImageData	back to summary
public static ImageData autoScaleImageData(Device device, final ImageData imageData, int targetZoom, int currentZoom) Auto-scale image with ImageData

autoScaleImageData	back to summary
private static ImageData autoScaleImageData(Device device, final ImageData imageData, float scaleFactor)

autoScaleImageData	back to summary
public static ImageData autoScaleImageData(Device device, final ImageData imageData, int imageDataZoomFactor) Auto-scale ImageData to device zoom that are at given zoom factor.

autoScaleUp	back to summary
public static ImageData autoScaleUp(Device device, final ImageData imageData) Auto-scale up ImageData to device zoom that is at 100%.

autoScaleUp	back to summary
public static int[] autoScaleUp(int[] pointArray)

autoScaleUp	back to summary
public static int[] autoScaleUp(Drawable drawable, int[] pointArray)

autoScaleUp	back to summary
public static int autoScaleUp(int size) Auto-scale up int dimensions.

autoScaleUp	back to summary
public static int autoScaleUp(Drawable drawable, int size) Auto-scale up int dimensions if enabled for Drawable class.

autoScaleUp	back to summary
public static float autoScaleUp(float size)

autoScaleUp	back to summary
public static float autoScaleUp(Drawable drawable, float size)

autoScaleUp	back to summary
public static Point autoScaleUp(Point point) Returns a new scaled up Point.

autoScaleUp	back to summary
public static Point autoScaleUp(Drawable drawable, Point point) Returns a new scaled up Point if enabled for Drawable class.

autoScaleUp	back to summary
public static Rectangle autoScaleUp(Rectangle rect) Returns a new scaled up Rectangle.

autoScaleUp	back to summary
public static Rectangle autoScaleUp(Drawable drawable, Rectangle rect) Returns a new scaled up Rectangle if enabled for Drawable class.

autoScaleUpUsingNativeDPI	back to summary
public static int autoScaleUpUsingNativeDPI(int size) Auto-scale up int dimensions using Native DPI

getDeviceZoom	back to summary
public static int getDeviceZoom()

getElementAtZoom	back to summary
private static <T> DPIUtil.ElementAtZoom<T> getElementAtZoom(Function<Integer, T> elementForZoomProvider, int zoom)

getScalingFactor	back to summary
private static float getScalingFactor() Returns Scaling factor from the display Returns:float float scaling factor

getScalingFactor

back to summary

private static float getScalingFactor()

Returns Scaling factor from the display

Returns:float: float scaling factor

getZoomForAutoscaleProperty	back to summary
public static int getZoomForAutoscaleProperty(int nativeDeviceZoom)

mapDPIToZoom	back to summary
public static int mapDPIToZoom(int dpi) Compute the zoom value based on the DPI value. Returns:int zoom

mapDPIToZoom

back to summary

public static int mapDPIToZoom(int dpi)

Compute the zoom value based on the DPI value.

Returns:int: zoom

setDeviceZoom	back to summary
public static void setDeviceZoom(int nativeDeviceZoom)

setUseCairoAutoScale	back to summary
public static void setUseCairoAutoScale(boolean cairoAutoScale)

useCairoAutoScale	back to summary
public static boolean useCairoAutoScale()

validateAndGetImageDataAtZoom

back to summary

public static DPIUtil.ElementAtZoom<ImageData> validateAndGetImageDataAtZoom(ImageDataProvider provider, int zoom)

Gets ImageData that are appropriate for the specified zoom level together with the zoom level at which the image data are. If there is an image at the specified zoom level, it is returned. Otherwise the next larger image at 150% and 200% is returned, if existing. If none of these is found, the 100% image is returned as a fallback. If provider or fallback image is not available, an error is thrown.

validateAndGetImagePathAtZoom

back to summary

public static DPIUtil.ElementAtZoom<String> validateAndGetImagePathAtZoom(ImageFileNameProvider provider, int zoom)

Gets the image file path that are appropriate for the specified zoom level together with the zoom level at which the image data are. If there is an image at the specified zoom level, it is returned. Otherwise the next larger image at 150% and 200% is returned, if existing. If none of these is found, the 100% image is returned as a fallback. If provider or fallback image is not available, an error is thrown.

org.eclipse.swt.internal back to summary

public final Class DPIUtil.AutoScaleImageDataProvider

Class Inheritance

extends Object
implements ImageDataProvider

java.lang.Object
org.eclipse.swt.internal.DPIUtil.AutoScaleImageDataProvider

All Implemented Interfaces

org.eclipse.swt.graphics.ImageDataProvider

AutoScale ImageDataProvider.

Field Summary

Modifier and Type	Field and Description
pack-priv int	currentZoom
pack-priv Device	device
pack-priv ImageData	imageData

Constructor Summary

Access	Constructor and Description
public	AutoScaleImageDataProvider(Device device, ImageData data, int zoom)

Method Summary

Modifier and Type	Method and Description
public ImageData	getImageData(int The zoom level in % of the standard resolution (which is 1 physical monitor pixel == 1 SWT logical point). Typically 100, 150, or 200. zoom) Implements org.eclipse.swt.graphics.ImageDataProvider.getImageData. Returns the image data for the given zoom level.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

currentZoom	back to summary
pack-priv int currentZoom

device	back to summary
pack-priv Device device

imageData	back to summary
pack-priv ImageData imageData

Constructor Detail

AutoScaleImageDataProvider	back to summary
public AutoScaleImageDataProvider(Device device, ImageData data, int zoom)

Method Detail

getImageData back to summary

public ImageData getImageData(int zoom)

Implements org.eclipse.swt.graphics.ImageDataProvider.getImageData.

Doc from org.eclipse.swt.graphics.ImageDataProvider.getImageData.

Returns the image data for the given zoom level.

If no image is available for a particular zoom level, this method should return null. For zoom == 100, returning null is not allowed, and SWT will throw an exception.

Parameters

zoom:int: The zoom level in % of the standard resolution (which is 1 physical monitor pixel == 1 SWT logical point). Typically 100, 150, or 200.

Returns:ImageData

the image data, or null if zoom != 100 and no image is available for the given zoom level.

Annotations

@Override

org.eclipse.swt.internal back to summary

private final Enum DPIUtil.AutoScaleMethod

Class Inheritance

extends Enum<DPIUtil.AutoScaleMethod>

java.lang.Object
java.lang.Enum
org.eclipse.swt.internal.DPIUtil.AutoScaleMethod

Field Summary

Modifier and Type	Field and Description
public static final DPIUtil.AutoScaleMethod	AUTO
public static final DPIUtil.AutoScaleMethod	NEAREST
public static final DPIUtil.AutoScaleMethod	SMOOTH

Constructor Summary

Access	Constructor and Description
private	AutoScaleMethod()

Method Summary

Modifier and Type	Method and Description
public static DPIUtil.AutoScaleMethod	valueOf(String name)
public static DPIUtil.AutoScaleMethod[]	values()

Inherited from java.lang.Enum:: clone compareTo describeConstable equals finalize getDeclaringClass hashCode name ordinal toString valueOf

Field Detail

AUTO	back to summary
public static final DPIUtil.AutoScaleMethod AUTO

NEAREST	back to summary
public static final DPIUtil.AutoScaleMethod NEAREST

SMOOTH	back to summary
public static final DPIUtil.AutoScaleMethod SMOOTH

Constructor Detail

AutoScaleMethod	back to summary
private AutoScaleMethod()

Method Detail

valueOf	back to summary
public static DPIUtil.AutoScaleMethod valueOf(String name)

values	back to summary
public static DPIUtil.AutoScaleMethod[] values()

org.eclipse.swt.internal back to summary

public final Record DPIUtil.ElementAtZoom<T>

Class Inheritance

extends Record

java.lang.Object
java.lang.Record
org.eclipse.swt.internal.DPIUtil.ElementAtZoom

Record Components

element:T
zoom:int

Type Parameters

<T>: type of the element to be presented, e.g., ImageData

Represents an element, such as some image data, at a specific zoom level.

Field Summary

Modifier and Type	Field and Description
private final T	element Record Component accessed by element().
private final int	zoom Record Component accessed by zoom().

Constructor Summary

Access	Constructor and Description
public	ElementAtZoom(T element, int zoom)

Method Summary

Modifier and Type	Method and Description
public T	element() Record Component getter of element.
public final boolean	equals(Object the reference object with which to compare. o) Implements abstract java.lang.Record.equals. Indicates whether some other object is "equal to" this one.
public final int	hashCode() Implements abstract java.lang.Record.hashCode. Returns a hash code value for the record.
public final String	toString() Implements abstract java.lang.Record.toString. Returns a string representation of the record.
public int	zoom() Record Component getter of zoom.

Field Detail

element	back to summary
private final T element Record Component accessed by element().

zoom	back to summary
private final int zoom Record Component accessed by zoom().

Constructor Detail

ElementAtZoom	back to summary
public ElementAtZoom(T element, int zoom)

Method Detail

element	back to summary
public T element() Record Component getter of element.

equals back to summary

public final boolean equals(Object o)

Implements abstract java.lang.Record.equals.

Doc from java.lang.Record.equals.

Indicates whether some other object is "equal to" this one. In addition to the general contract of Object.equals, record classes must further obey the invariant that when a record instance is "copied" by passing the result of the record component accessor methods to the canonical constructor, as follows:

    R copy = new R(r.c1(), r.c2(), ..., r.cn());

then it must be the case that r.equals(copy).

Parameters

o:Object: the reference object with which to compare.

Returns:boolean

true if this record is equal to the argument; false otherwise.

hashCode back to summary

public final int hashCode()

Implements abstract java.lang.Record.hashCode.

Doc from java.lang.Record.hashCode.

Returns a hash code value for the record. Obeys the general contract of Object.hashCode. For records, hashing behavior is constrained by the refined contract of Record.equals, so that any two records created from the same components must have the same hash code.

Returns:int: a hash code value for this record.

toString back to summary

public final String toString()

Implements abstract java.lang.Record.toString.

Doc from java.lang.Record.toString.

Returns a string representation of the record. In accordance with the general contract of Object#toString(), the toString method returns a string that "textually represents" this record. The result should be a concise but informative representation that is easy for a person to read.

In addition to this general contract, record classes must further participate in the invariant that any two records which are equal must produce equal strings. This invariant is necessarily relaxed in the rare case where corresponding equal component values might fail to produce equal strings for themselves.

Returns:String: a string representation of the object.

zoom	back to summary
public int zoom() Record Component getter of zoom.

public Class DPIUtil

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

public final Class DPIUtil.AutoScaleImageDataProvider

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private final Enum DPIUtil.AutoScaleMethod

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

public final Record DPIUtil.ElementAtZoom<T>

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail