"

COPYRIGHT (c) 1997 by eXept Software AG / Claus Gittinger

	      All Rights Reserved

 This software is furnished under a license and may be used

 only in accordance with the terms of that license and with the

 inclusion of the above copyright notice.   This software may not

 be provided or otherwise made available to, or used by, any

 other person.  No title to or ownership of the software is

 hereby transferred.

"

"{ Package: 'stx:libview' }"

"{ NameSpace: Smalltalk }"

GraphicsDevice subclass:#HostGraphicsDevice

	instanceVariableNames:'graphicsContexts deviceColors deviceFonts deviceCursors'

	classVariableNames:''

	poolDictionaries:''

	category:'Interface-Graphics'

!

!HostGraphicsDevice class methodsFor:'documentation'!

copyright

"

COPYRIGHT (c) 1997 by eXept Software AG / Claus Gittinger

	      All Rights Reserved

 This software is furnished under a license and may be used

 only in accordance with the terms of that license and with the

 inclusion of the above copyright notice.   This software may not

 be provided or otherwise made available to, or used by, any

 other person.  No title to or ownership of the software is

 hereby transferred.

"

!

documentation

"

    this abstract class was inserted to provide a home for ST-80 classes

    (previously, DeviceWorkstation was directly under Object).

    We will (over time) move common functionality from there into this class.

    In ST/X, this is mostly dummy.

    [see also:]

	DeviceWorkstation XWorkstation

    [author:]

	Claus Gittinger

"

! !

!HostGraphicsDevice methodsFor:'Compatibility-Squeak'!

deferUpdates: aBoolean

    "Set the deferUpdates flag in the virtual machine. 

     When this flag is true, BitBlt operations on the Display are not 

     automatically propagated to the screen. 

     If this underlying platform does not support deferred updates, 

     this primitive will fail. 

     Answer the receiver if the primitive succeeds, nil if it fails."

"/    <primitive: 126>

    ^ nil  "answer nil if primitive fails"

!

forceDisplayUpdate

    "On platforms that buffer screen updates, 

     force the screen to be updated immediately. 

     On other platforms, or if the primitive is not implemented, do nothing."

"/     <primitive: 231>

    "do nothing if primitive fails"

! !

!HostGraphicsDevice methodsFor:'accessing'!

deviceColors

    "return the registry keeping track of colors which were allocated

     on this device."

    ^ deviceColors ? #()

    "Created: / 24-02-1997 / 18:01:41 / cg"

!

deviceCursors

    "return the registry keeping track of cursors which were allocated

     on this device."

    ^ deviceCursors

    "Created: 24.2.1997 / 18:01:41 / cg"

!

deviceFonts

    "return the registry keeping track of fonts which were allocated

     on this device."

    ^ deviceFonts ? #()

    "Modified: / 28-07-2006 / 19:48:23 / fm"

!

graphicsContexts

    "return the registry keeping track of graphics contexts which were allocated

     on this device."

    ^ graphicsContexts

! !

!HostGraphicsDevice methodsFor:'accessing & queries'!

defaultExtentForTopViews

    |w h|

    w := self width.

    h := self height.

    self isPDA ifTrue:[

        ^ (w - 16) @ (h - 20)

    ].

    ^ (w // 3 * 2) @ (h // 3 * 2)

! !

!HostGraphicsDevice methodsFor:'initialization & release'!

initializeDeviceResourceTables

    graphicsContexts := Registry new.

    deviceColors := Registry new.

    deviceCursors := Registry new.

    deviceFonts := CachingRegistry new:50.

    "Created: 24.2.1997 / 18:29:53 / cg"

!

releaseDeviceColors

    deviceColors notNil ifTrue:[

        deviceColors do:[:aColor |

            aColor releaseFromDevice

        ].

        deviceColors := Registry new.

        "TrueColors are not registered.

         Release them the hard way"

        Color flushDeviceColorsFor:self.

    ].

    "Created: 24.2.1997 / 18:07:49 / cg"

!

releaseDeviceCursors

    deviceCursors notNil ifTrue:[

        deviceCursors do:[:aCursor |

            aCursor releaseFromDevice

        ].

        deviceCursors := Registry new.

    ]

    "Created: 24.2.1997 / 18:07:49 / cg"

!

releaseDeviceFonts

    deviceFonts notNil ifTrue:[

        deviceFonts do:[:aFont |

            aFont releaseFromDevice.

        ].

        deviceFonts := CachingRegistry new:20.

    ].

!

releaseGraphicsContexts

    graphicsContexts notNil ifTrue:[

        graphicsContexts unregisterAllForWhichHandle:[:eachHandle |

            eachHandle finalize. 

            true

        ].

    ]

! !

!HostGraphicsDevice methodsFor:'misc'!

recolorCursorsToFgColor:fgColor defaultBgColor:bgColor

    "change the colors of all existing cursors"

    "/ recolor existing cursors

    deviceCursors do:[:eachCursor | eachCursor foreground:fgColor background:bgColor].

    "

     Display recolorCursorsToFgColor:(Color red) defaultBgColor:(Color white)

     Display recolorCursorsToFgColor:(Color blue) defaultBgColor:(Color white)

     Display recolorCursorsToFgColor:(Color blue) defaultBgColor:(Color black)

     Display recolorCursorsToFgColor:(Color white) defaultBgColor:(Color black)

     Display recolorCursorsToFgColor:(Color white) defaultBgColor:(Color red)

    "

! !

!HostGraphicsDevice methodsFor:'registration'!

cleanupLobbyForChildrenOfViewWithId:anId

    "recursively clean all the subcomponents of the handle with id anId.

     This must be done on finalization, because descendent handles

     are destroyed implicitly when a parent handle is destroyed."

    |parents newChildren|

    parents := Array with:anId address.

    [

        newChildren := Set new.

        graphicsContexts unregisterAllForWhichHandle:[:handle |

            |parentId|

            handle notNil

                and:[(parentId := handle parentId) notNil

                and:[(parents includes:parentId)

                and:[newChildren add:handle id. true]]].

        ].

        parents := newChildren.

    ] doWhile:[parents notEmpty].

!

registerColor:aColor

    deviceColors register:aColor.

    "Created: 24.2.1997 / 18:29:10 / cg"

!

registerCursor:aCursor

    deviceCursors register:aCursor.

    "Created: 24.2.1997 / 18:29:10 / cg"

!

registerFont:aFont

    deviceFonts register:aFont.

    "Created: 24.2.1997 / 18:29:10 / cg"

!

registerGraphicsContext:aGC 

    graphicsContexts register:aGC

!

unregisterColor:aColor

    deviceColors unregister:aColor.

    "Created: 24.2.1997 / 18:29:14 / cg"

!

unregisterCursor:aCursor

    deviceCursors unregister:aCursor.

    "Created: 24.2.1997 / 18:29:14 / cg"

!

unregisterFont:aFont

    deviceFonts unregister:aFont.

    "Created: 24.2.1997 / 18:29:14 / cg"

!

unregisterGraphicsContext:aGC

    graphicsContexts unregister:aGC

! !

!HostGraphicsDevice class methodsFor:'documentation'!

version

    ^ '$Header$'

! !