OSX JAWT version option to use CALayer

OSX JAWT CALayer availability on Mac OS X >= 10.6 Update 4 (recommended)

OSX JAWT CALayer required with Java >= 1.7.0 (implies OS X >= 10.7

CALayer position needs to be derived from AWT position in relation to super CALayer.

AWT's super-calayer, i.e. the AWT top-container's CALayer, does not layout our root-calayer in respect to this component's position and size, at least when resizing programmatically.

CALayer position has origin 0/0 at bottom/left, where AWT component has origin 0/0 at top/left.

The super-calayer bounds exclude the frame's heavyweight border/insets.

The super-calayer lies within the AWT top-container client space (content).

Component's location in super-calayer:

     p0 = c.locationOnScreen();
     p0 -= c.getOutterComp.getPos();
     p0 -= c.getOutterComp.getInsets();

    p0 = 0/0;
    while( null != c ) {
      p0 += c.getPos();
    }

This flags also sets JAWT_OSX_CALAYER_QUIRK_SIZE, i.e. they are related.

As of today, this flag is enabled for w/ AWT >= 1.7.0_40.

Sync w/ NativeWindowProtocols.h

CALayer position needs to be set to zero.

AWT's super-calayer, i.e. the AWT's own component CALayer, has a broken layout and needs it's sub-layers to be located at position 0/0.

See http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=7172187.

Further more a re-layout seems to be required in this case, i.e. a programmatic forced resize +1 and it's inverted resize -1.

This flag is enabled w/ AWT < 1.7.0_40.

Sync w/ NativeWindowProtocols.h

CALayer size needs to be set using the AWT component size.

AWT's super-calayer, i.e. the AWT's own component CALayer, does not layout our root-calayer in respect to this component's position and size, at least when resizing programmatically.

As of today, this flag is enabled for all known AWT versions.

Sync w/ NativeWindowProtocols.h

Parameters

awtComp:Component

must be displayable and must have a GraphicsConfiguration

Returns:AbstractGraphicsDevice

AbstractGraphicsDevice instance reflecting the awtComp

Exceptions

IllegalArgumentException:

if awtComp is not displayable or has null GraphicsConfiguration.

See Also

getAbstractGraphicsScreen(java.awt.Component)

Parameters

awtComp:Component

must be displayable and must have a GraphicsConfiguration

Returns:AbstractGraphicsScreen

AbstractGraphicsScreen instance reflecting the awtComp

Exceptions

IllegalArgumentException:

if awtComp is not displayable or has null GraphicsConfiguration.

See Also

createDevice(java.awt.Component)

Returns bitfield of required JAWT OSX CALayer quirks to mediate AWT impl. bugs.

Returns zero, if platform is not Platform.OSType#MACOS or not supporting CALayer, i.e. OSX < 10.6.4.

Otherwise includes

• JAWT_OSX_CALAYER_QUIRK_SIZE (always)
• JAWT_OSX_CALAYER_QUIRK_POSITION if JVM < 1.7.0_40
• JAWT_OSX_CALAYER_QUIRK_LAYOUT if JVM >= 1.7.0_40

Returns the pixel scale factor of the given GraphicsDevice, if supported.

If the component does not support pixel scaling the default one is returned.

Parameters

device:GraphicsDevice

the GraphicsDevice instance used to query the pixel scale

minScale:float[]

current and output min scale values

maxScale:float[]

current and output max scale values

Returns:boolean

true if the given min and max scale values have changed, otherwise false.

Returns the pixel scale factor of the given GraphicsConfiguration's GraphicsDevice, if supported.

If the GraphicsDevice is null, zero is returned.

If the component does not support pixel scaling the default one is returned.

Parameters

gc:GraphicsConfiguration

the GraphicsConfiguration instance used to query the pixel scale

minScale:float[]

current and output min scale values

maxScale:float[]

current and output max scale values

Returns:boolean

true if the given min and max scale values have changed, otherwise false.

Called by NativeWindowFactory#initSingleton()

Returns true if this platform's JAWT implementation requires using offscreen layer.

Returns true if this platform's JAWT implementation supports offscreen layer.

Locks the AWT's global ReentrantLock.

JAWT's native Lock() function calls SunToolkit.awtLock(), which just uses AWT's global ReentrantLock.

AWT locking is wrapped through a recursive lock object.

Called by NativeWindowFactory#shutdown()

Unlocks the AWT's global ReentrantLock.

JAWT's native Unlock() function calls SunToolkit.awtUnlock(), which just uses AWT's global ReentrantLock.

AWT unlocking is wrapped through a recursive lock object.