Class: Icon

• Inheritance
• Description
• Related information
• Class protocol
  • accessing
  • image specs
  • initialization
  • startup & release

Inheritance:

   Object
   |
   +--Icon

Package:

stx:libview2

Category:

Graphics-Images

Version:

rev: 1.37 date: 2009/10/14 14:07:15

user: cg

file: Icon.st directory: libview2

module: stx stc-classLibrary: libview2

Author:

Claus Gittinger

Description:

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

Related information:

    Image
    Form
    ImageReader

Class protocol:

 constantNamed: aName

return the image registered under aName.

 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.

 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.

 constantNamed: aName put: anImage

register anImage under aName.

 constantNamed: aName searchForFile: doSearchForFile

return the image registered under aName.

 backwardIcon

Obsolete - please goto ToolbarIconLibrary directly

 copyIcon

Obsolete - please goto ToolbarIconLibrary directly

 cutIcon

Obsolete - please goto ToolbarIconLibrary directly

 deleteIcon

Obsolete - please goto ToolbarIconLibrary directly

 downIcon

Obsolete - please goto ToolbarIconLibrary directly

 downRightIcon

Obsolete - please goto ToolbarIconLibrary directly

 forwardIcon

Obsolete - please goto ToolbarIconLibrary directly

 helpIcon

Obsolete - please goto ToolbarIconLibrary directly

 leftDownIcon

Obsolete - please goto ToolbarIconLibrary directly

 leftIcon

Obsolete - please goto ToolbarIconLibrary directly

 loadIcon

Obsolete - please goto ToolbarIconLibrary directly

 newIcon

Obsolete - please goto ToolbarIconLibrary directly

 pasteIcon

Obsolete - please goto ToolbarIconLibrary directly

 rightIcon

Obsolete - please goto ToolbarIconLibrary directly

 saveIcon

Obsolete - please goto ToolbarIconLibrary directly

 startIcon

Obsolete - please goto ToolbarIconLibrary directly

 stxIcon

 stxIcon16x16

This resource specification was automatically generated
by the ImageEditor of ST/X.

 stxIconOld

This resource specification was automatically generated
by the ImageEditor of ST/X.

 stxIconTransparent

This resource specification was automatically generated
by the ImageEditor of ST/X.

 stxIconTransparent2

This resource specification was automatically generated
by the ImageEditor of ST/X.

 stxIconTransparent3

This resource specification was automatically generated
by the ImageEditor of ST/X.

 upIcon

Obsolete - please goto ToolbarIconLibrary directly

 upRightIcon

Obsolete - please goto ToolbarIconLibrary directly

 initialize

 replacementNameFor: aName

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

 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'.

 flushCachedIcons

 preSnapshot