"

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' }"

Object subclass:#GraphicsDevice

	instanceVariableNames:'displayId screen eventListeners deviceType'

	classVariableNames:''

	poolDictionaries:''

	category:'Interface-Graphics'

!

!GraphicsDevice 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).

    In ST/X, this is mostly dummy.

    [instance variables:]

      displayId       <Handle>            the device handle

      screen          any                 another some device specific id

      eventListeners  <Collection> | nil  bunch of objects interested in events.

      deviceType      <Symbol>             some arbitrary symbol, used to choose windowSpecs.

    [see also:]

	DeviceWorkstation XWorkstation

    [author:]

	Claus Gittinger

"

! !

!GraphicsDevice methodsFor:'accessing & queries'!

addEventListener:aListener

    "add a local eventListener (with new protocol - #processEvent:)

     This one gets a chance to intercept all events for this device"

    eventListeners isNil ifTrue:[

        eventListeners := OrderedCollection new:2

    ].

    (eventListeners includesIdentical:aListener) ifFalse:[

        eventListeners add:aListener

    ].

!

bePDA

    self deviceType:#pda

!

deviceType

    ^ deviceType

!

deviceType:aSymbol

    deviceType := aSymbol

!

isPDA

    ^ self deviceType == #pda

!

isWebServiceDevice

    "I am not a WebService pseude-device"

    ^ false

!

removeEventListener:aListener

    "remove a local eventListener (with new protocol - #processEvent:)"

    eventListeners notNil ifTrue:[

	eventListeners removeIdentical:aListener ifAbsent:nil

    ].

! !

!GraphicsDevice methodsFor:'creating graphics contexts'!

newGraphicsContextFor:aGraphicsMedium

    "create a new graphics context.

     The defaults is to use the inherited graphics context.

     Subclasses may redefine this to use their own graphics context"

    |gc|

    GraphicsMedium superclass == DeviceGraphicsContext ifTrue:[

        "this is for transition to delegatest GC"

        ^ aGraphicsMedium.

    ].

    gc := DeviceGraphicsContext onDevice:self.

    gc font:aGraphicsMedium class defaultFont.

    ^ gc.

! !

!GraphicsDevice methodsFor:'event processing'!

notifyEventListenersAbout:anEvent

    "notify all eventHandlers about an incoming event.

     If any returns true, it is assumed to be eaten by the handler and not

     enqueued (i.e. not passed to the windowGroup process)"

    |anyListenerReturnedTrue|

    anyListenerReturnedTrue := false.

    "/ local listeners ...

    eventListeners notNil ifTrue:[

	eventListeners do:[:aListener |

	    anyListenerReturnedTrue := anyListenerReturnedTrue |

				       (aListener processEvent:anEvent)

	]

    ].

    ^ anyListenerReturnedTrue.

! !

!GraphicsDevice methodsFor:'misc'!

roundTripTime

    "answer the round trip time in milliseconds.

     May be used to detect slow device connections.

     Subclasses redefine this. Assume a fast Diplay connection

     and answer 0 here"

    ^ 0

    "

     Screen current roundTripTime

    "

! !

!GraphicsDevice class methodsFor:'documentation'!

version

    ^ '$Header: /cvs/stx/stx/libview/GraphicsDevice.st,v 1.14 2014-03-25 09:01:41 stefan Exp $'

!

version_CVS

    ^ '$Header: /cvs/stx/stx/libview/GraphicsDevice.st,v 1.14 2014-03-25 09:01:41 stefan Exp $'

! !