"

 COPYRIGHT (c) 1995 by 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:libview2' }"

Object subclass:#Icon

	instanceVariableNames:'image mask'

	classVariableNames:'KnownIcons'

	poolDictionaries:''

	category:'Graphics-Images'

!

!Icon class methodsFor:'documentation'!

copyright

"

 COPYRIGHT (c) 1995 by 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

"

    The Icon class keeps track of already loaded Images and caches

    them for later reuse.

    Icons are accessed by a symbolic name, so there is no need to

    remember their names (they must have been registered under that name

    before - of course).

    Icon was mostly added for ST-80 Compatibility:

    Images are returned via the #constantNamed: message which is used by 

    some ST-80 PD classes and returns corresponding ST/X icons.

    Notice, that ST/X does not provide Icon instances - Icon only consists

    of class mimicri protocol, to make your life easier.

    If you like the original ST-80 icons, install the image files in the `bitmap'

    directory under a name foo.xbm, where `foo' corresponds to the icons

    name symbol 

    (i.e. for the `Icon constantNamed:#foo', a 'foo.xbm' file is required).

    You can grab those icons from manchester or from the PrimeTime Freeware 

    (PTF) CD. A copy of those bitmaps (from the PTF-CD) is found in 

    'goodies/bitmaps/st80bitmaps'.

    CAVEAT:

        masks are not yet implemented

    [See also:]

        Image Form ImageReader

    [author:]

        Claus Gittinger

"

! !

!Icon class methodsFor:'initialization'!

initialize

    KnownIcons isNil ifTrue:[

        KnownIcons := Dictionary new

    ]

    "

     Icon initialize

    "

    "Modified: 20.5.1996 / 09:24:10 / cg"

!

replacementNameFor:aName

    "return a replacement ST/X name for an ST80 icon name."

    self replacementNames do:[:aPair |

	(aPair at:1) == aName ifTrue:[^ aPair at:2].

    ].

    ^ nil

!

replacementNames

    "return an ST-80 constant name to ST/X file name translation.

     This was added for ST-80 compatibility, to support code which uses

     things like 'Icon constantNamed:#categoryBrowser'."

    ^ #( 

        #(file             FBrowser)

        #(debugger         Debugger)

        #(systembrowser    SBrowser)

        #(classbrowser     SBrowser)

        #(categoryBrowser  SBrowser)

        #(hierarchyBrowser SBrowser)

        #(methodBrowser    SBrowser)

        #(launcher         SmalltalkX)

        #(workspace        SmalltalkX)

        #(transcript       SmalltalkX)

        #(inspector        Inspector)

        #(default          SmalltalkX)

       )

    "

     Icon constantNamed:#categoryBrowser

     Icon constantNamed:#default

    "

    "Modified: 13.5.1996 / 10:29:43 / cg"

! !

!Icon class methodsFor:'accessing'!

constantNamed:aName

    "return the image registered under aName."

    |icon nm|

    icon := KnownIcons at:aName ifAbsent:[].

    icon isNil ifTrue:[

        nm := self replacementNameFor:aName.

        nm notNil ifTrue:[

            icon := Smalltalk imageFromFileNamed:nm forClass:self.

            icon isNil ifTrue:[

                icon := Smalltalk imageFromFileNamed:(nm , '.xbm') forClass:self.

            ]

        ].

        icon isNil ifTrue:[

            icon := Smalltalk imageFromFileNamed:aName forClass:self.

            icon isNil ifTrue:[

                icon := Smalltalk imageFromFileNamed:(aName , '.xbm') forClass:self.

            ].

            icon isNil ifTrue:[

                ^ nil

            ].

            icon := icon onDevice:Screen default.

        ].

        KnownIcons at:aName put:icon.

    ].

    ^ icon

    "

     Icon constantNamed:#file     

     Icon constantNamed:#debugger     

     Icon constantNamed:#systembrowser     

     Icon constantNamed:#SBrowser     

     Icon constantNamed:#SBrowser     

    "

    "Modified: 10.1.1997 / 17:52:06 / cg"

!

constantNamed:aName ifAbsentPut: aBlock

    "if an image for aName is registered, return it;

    otherwise, register the result from evaluating aBlock

    (which also could be a value holder) and return it."

    |image|

    (image := self constantNamed: aName) isNil

    ifTrue:

    [

        self constantNamed: aName put: (image := aBlock value)

    ].

    ^image

!

constantNamed:aName ifAbsentPutImageFromFile:aFileName

    "if an image for aName is registered, return it;

    otherwise, load the image from aFileName (searched in bitmaps directories),

    register the result and return it."

    ^ self

        constantNamed:aName

        ifAbsentPut:[Smalltalk imageFromFileNamed:aFileName forClass:self]

!

constantNamed:aName put:anImage

    "register anImage under aName."

    KnownIcons at:aName put:anImage

    "Modified: 23.4.1996 / 11:40:51 / cg"

! !

!Icon class methodsFor:'image specs'!

backwardIcon

    "This resource specification was automatically generated

     by the ImageEditor of ST/X."

    "Do not manually edit this!! If it is corrupted,

     the ImageEditor may not be able to read the specification."

    "

     self moveOutButtonIcon inspect

     ImageEditor openOnClass:self andSelector:#moveOutButtonIcon

    "

    <resource: #image>

    ^Icon

        constantNamed:#'VRMLWorldNavigationPanel moveOutButtonIcon'

        ifAbsentPut:[(Depth2Image new) width: 22; height: 22; photometric:(#palette); bitsPerSample:(#(2 )); samplesPerPixel:(1); bits:(ByteArray fromPackedString:'UUUUUUUPUUUUUUUPUUT@EUUPUUT*%UUPUUT*%UUPUUT*%UUPUUT*%UUPWUT*%UUPWWR*)UUPWUR*)UUP_5R*)UUP_UJ**UUP_UJ**UUPUUJ**UUPUPJ**UUPUR***)UPUTJ**UUPUUP*%UUPUUUAUUUPUUUUUUUPUUUUUUUPUUUUUUUP') ; colorMapFromArray:#[255 255 255 0 0 0 0 127 0 255 0 0]; mask:((Depth1Image new) width: 22; height: 22; photometric:(#blackIs0); bitsPerSample:(#(1 )); samplesPerPixel:(1); bits:(ByteArray fromPackedString:'@@@@@@@@@O @@O0@@O0@@O0@@O0@@O0@@_8@@_8@@_8@@?<@@?<@@?<@C??@C??@A?>@@_8@@G @@@@@@@@@@@@@') ; yourself); yourself]

!

copyIcon

    "This resource specification was automatically generated

     by the ImageEditor of ST/X."

    "Do not manually edit this!! If it is corrupted,

     the ImageEditor may not be able to read the specification."

    "

     ImageEditor openOnClass:self andSelector:#copyIcon

    "

    <resource: #image>

    ^Icon

        constantNamed:#'ToolApplicationModel copyIcon'

cutIcon

    "This resource specification was automatically generated

     by the ImageEditor of ST/X."

    "Do not manually edit this!! If it is corrupted,

     the ImageEditor may not be able to read the specification."

    "

     ImageEditor openOnClass:self andSelector:#cutIcon

    "

    <resource: #image>

    ^Icon

        constantNamed:#'ToolApplicationModel cutIcon'

deleteIcon

    "This resource specification was automatically generated

     by the ImageEditor of ST/X."

    "Do not manually edit this!! If it is corrupted,

     the ImageEditor may not be able to read the specification."

    "

     ImageEditor openOnClass:self andSelector:#deleteIcon

    "

    <resource: #image>

    ^Icon

        constantNamed:#'ToolApplicationModel deleteIcon'

downIcon

    "This resource specification was automatically generated

     by the ImageEditor of ST/X."

    "Do not manually edit this!! If it is corrupted,

     the ImageEditor may not be able to read the specification."

    "

     ImageEditor openOnClass:self andSelector:#downIcon

    "

    <resource: #image>

    ^Icon

downRightIcon

    "This resource specification was automatically generated

     by the ImageEditor of ST/X."

    "Do not manually edit this!! If it is corrupted,

     the ImageEditor may not be able to read the specification."

    "

     ImageEditor openOnClass:self andSelector:#downRightIcon

    "

    <resource: #image>

    ^Icon

forwardIcon

    "This resource specification was automatically generated

     by the ImageEditor of ST/X."

    "Do not manually edit this!! If it is corrupted,

     the ImageEditor may not be able to read the specification."

    "

     self moveInButtonIcon inspect

     ImageEditor openOnClass:self andSelector:#moveInButtonIcon

    "

    <resource: #image>

    ^Icon

        constantNamed:#'VRMLWorldNavigationPanel moveInButtonIcon'

        ifAbsentPut:[(Depth2Image new) width: 22; height: 22; photometric:(#palette); bitsPerSample:(#(2 )); samplesPerPixel:(1); bits:(ByteArray fromPackedString:'UUUUUUUPUUUUUUUPUUUUUUUPUUUQUUUPUUTJUUUPUUB*)UUPUP***%UPUQU*%UUPUUT*%UUP_UT*%UUP_UT*%UUP_5R*)UUPWUR*)UUPWWR*)UUPWUJ**UUPUUJ**UUPUT***%UPUT***%UPUR***)UPUUUUUUUPUUUUUUUPUUUUUUUP') ; colorMapFromArray:#[255 255 255 0 0 0 0 127 0 255 0 0]; mask:((Depth1Image new) width: 22; height: 22; photometric:(#blackIs0); bitsPerSample:(#(1 )); samplesPerPixel:(1); bits:(ByteArray fromPackedString:'@@@@@@@@@@@@@C@@@O0@@?<@C??@C??@@O0@@O0@@O0@@_8@@_8@@_8@@?<@@?<@A?>@A?>@C??@A??@@@@@@@@@') ; yourself); yourself]

!

helpIcon

    "This resource specification was automatically generated

     by the ImageEditor of ST/X."

    "Do not manually edit this!! If it is corrupted,

     the ImageEditor may not be able to read the specification."

    "

     ImageEditor openOnClass:self andSelector:#helpIcon

    "

    <resource: #image>

    ^Icon

        constantNamed:#'ToolApplicationModel helpIcon'

leftDownIcon

    "This resource specification was automatically generated

     by the ImageEditor of ST/X."

    "Do not manually edit this!! If it is corrupted,

     the ImageEditor may not be able to read the specification."

    "

     ImageEditor openOnClass:self andSelector:#leftDownIcon

    "

    <resource: #image>

    ^Icon

leftIcon

    "This resource specification was automatically generated

     by the ImageEditor of ST/X."

    "Do not manually edit this!! If it is corrupted,

     the ImageEditor may not be able to read the specification."

    "

     ImageEditor openOnClass:self andSelector:#leftIcon

    "

    <resource: #image>

    ^Icon

loadIcon

    "This resource specification was automatically generated

     by the ImageEditor of ST/X."

    "Do not manually edit this!! If it is corrupted,

     the ImageEditor may not be able to read the specification."

    "

     ImageEditor openOnClass:self andSelector:#loadIcon

    "

    <resource: #image>

    ^Icon

        constantNamed:#'ToolApplicationModel loadIcon'

newIcon

    "This resource specification was automatically generated

     by the ImageEditor of ST/X."

    "Do not manually edit this!! If it is corrupted,

     the ImageEditor may not be able to read the specification."

    "

     ImageEditor openOnClass:self andSelector:#newIcon

    "

    <resource: #image>

    ^Icon

        constantNamed:#'ToolApplicationModel newIcon'

pasteIcon

    "This resource specification was automatically generated

     by the ImageEditor of ST/X."

    "Do not manually edit this!! If it is corrupted,

     the ImageEditor may not be able to read the specification."

    "

     ImageEditor openOnClass:self andSelector:#pasteIcon

    "

    <resource: #image>

    ^Icon

        constantNamed:#'ToolApplicationModel pasteIcon'

rightIcon

    "This resource specification was automatically generated

     by the ImageEditor of ST/X."

    "Do not manually edit this!! If it is corrupted,

     the ImageEditor may not be able to read the specification."

    "

     ImageEditor openOnClass:self andSelector:#rightIcon

    "

    <resource: #image>

    ^Icon

saveIcon

    "This resource specification was automatically generated

     by the ImageEditor of ST/X."

    "Do not manually edit this!! If it is corrupted,

     the ImageEditor may not be able to read the specification."

    "

     ImageEditor openOnClass:self andSelector:#saveIcon

    "

    <resource: #image>

    ^Icon

        constantNamed:#'ToolApplicationModel saveIcon'

startIcon

    "This resource specification was automatically generated