Class: ImageView

• Inheritance
• Description
• Related information
• Class protocol
  • initialization
  • queries-plugin
  • startup
• Instance protocol
  • accessing
  • accessing-channels
  • change & update
  • drawing
  • event handling
  • initialization & release
  • queries
  • scrolling
• Examples

Inheritance:

   Object
   |
   +--GraphicsContext
      |
      +--DeviceGraphicsContext
         |
         +--GraphicsMedium
            |
            +--DisplaySurface
               |
               +--SimpleView
                  |
                  +--View
                     |
                     +--ImageView
                        |
                        +--ColorBulletIndicator
                        |
                        +--ImageEditView

Package:

stx:libwidg2

Category:

Views-Misc

Version:

rev: 1.73 date: 2010/03/04 23:32:28

user: cg

file: ImageView.st directory: libwidg2

module: stx stc-classLibrary: libwidg2

Author:

Claus Gittinger

Description:

This View knows how to display a (bitmap-)image (or form).

You can display an image with:

    ImageView openOn:anImageFileName
or:
    ImageView openOnImage:anImage
or:
    ImageView new image:anImage

i.e.

    ImageView openOn:'../../goodies/bitmaps/gifImages/garfield.gif'
    ImageView openOn:'../../goodies/bitmaps/SBrowser.xbm'

    ImageView openOnImage:(Image fromFile:'../../goodies/bitmaps/gifImages/garfield.gif')
    ImageView openOnImage:(Image fromFile:'../../goodies/bitmaps/SBrowser.xbm')

adjust:     
    controls how images are displayed;
    can be one of:
        #topLeft    - image is displayed as usual
        #center     - image is shown centered
        #fitBig     - big images are shrunk to make it fit the view
        #fitSmall   - small images are magnified to make it fit the view,
        #fit        - all images are magnified to fit the view

Related information:

    Image
    Form

Class protocol:

 initialize

 aspectSelectors

 openOn: aFileName

startup an image viewer on an image read from a file

 openOnImage: anImage

startup an image viewer on an image

Instance protocol:

 adjust: layoutSymbol

set the adjust (how the image is displayed);
currently, only support #topLeft, #center, #fitBig, #fitSmall and #fit:
#topLeft - image is displayed as usual
#center - image is shown centered
#fitBig - big images are shrunk to make it fit the view
#fitSmall - small images are magnified to make it fit the view,
#fit - all images are magnified to fit the view

 image

return the image

 image: anImage

set the image

 image: anImage scroll: doScroll

set the image - show a wait cursor, since image dithering may take a while

 image: anImage scroll: doScroll invalidate: doInvalidate

set the image - show a wait cursor, since image dithering may take a while

 magnification

 setImage: anImage

set the image - show a wait cursor, since image dithering may take a while

 setImage: anImage scroll: doScroll

set the image - show a wait cursor, since image dithering may take a while

 setImage: anImage scroll: doScroll invalidate: doInvalidate

set the image - show a wait cursor, since image dithering may take a while

 tileMode: aBoolean tileOffset: aPoint

 imageChannel

 imageChannel: aValueHolder

 update: something with: aParameter from: changedObject

 updateFromModel

the model changes, set my image

 generateMagnifiedImage

 redrawX: x y: y width: w height: h

 buttonMotion: state x: x y: y

 buttonPress: button x: x y: y

 buttonRelease: button x: x y: y

 sizeChanged: how

 destroy

 heightOfContents

return the images height - scrollbar needs this info

 widthOfContents

return the images width - scrollbar needs this info

 scrollToMakeVisible: aPoint

try to arrange for aPoint to be visible (at the center, if possible)

Examples: