Package de.uka.ipd.sdq.dialogs

Class SWTResourceManager

java.lang.Object
de.uka.ipd.sdq.dialogs.SWTResourceManager
public class SWTResourceManager extends Object
Utility class for managing OS resources associated with SWT controls such as colors, fonts, images, etc. !!! IMPORTANT !!! Application code must explicitly invoke the dispose() method to release the operating system resources managed by cached objects when those objects and OS resources are no longer needed (e.g. on application shutdown) This class may be freely distributed as part of any application or plugin.

Copyright (c) 2003 - 2005, Instantiations, Inc.
All Rights Reserved

  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    static final int
    BOTTOM_LEFT
    Style constant for placing decorator image in bottom left corner of base image.
    static final int
    BOTTOM_RIGHT
    Style constant for placing decorator image in bottom right corner of base image.
    static final int
    TOP_LEFT
    Style constant for placing decorator image in top left corner of base image.
    static final int
    TOP_RIGHT
    Style constant for placing decorator image in top right corner of base image.

  • Constructor Summary

    Constructors
    Constructor
    Description
    SWTResourceManager()
     

  • Method Summary

    Modifier and Type
    Method
    Description
    static Image
    decorateImage(Image baseImage, Image decorator)
    Returns an image composed of a base image decorated by another image
    static Image
    decorateImage(Image baseImage, Image decorator, int corner)
    Returns an image composed of a base image decorated by another image
    static void
    dispose()
    Dispose of cached objects and their underlying OS resources.
    static void
    disposeColors()
    Dispose of all the cached colors
    static void
    disposeCursors()
    Dispose all of the cached cursors
    static void
    disposeFonts()
    Dispose all of the cached fonts
    static void
    disposeImages()
    Dispose all of the cached images
    static void
    disposeImages(String section)
    Dispose cached images in specified section
    static void
    fixCoolBarSize(CoolBar bar)
    Fix the layout of the specified CoolBar
    static Font
    getBoldFont(Font baseFont)
    Return a bold version of the give font
    static Color
    getColor(int systemColorID)
    Returns the system color matching the specific ID
    static Color
    getColor(int r, int g, int b)
    Returns a color given its red, green and blue component values
    static Color
    getColor(RGB rgb)
    Returns a color given its RGB value
    static Cursor
    getCursor(int id)
    Returns the system cursor matching the specific ID
    static Font
    getFont(String name, int height, int style)
    Returns a font based on its name, height and style
    static Font
    getFont(String name, int size, int style, boolean strikeout, boolean underline)
    Returns a font based on its name, height and style.
    protected static Image
    getImage(InputStream is)
    Returns an image encoded by the specified input stream
    static Image
    getImage(Class<?> clazz, String path)
    Returns an image stored in the file at the specified path relative to the specified class
    static Image
    getImage(String path)
    Returns an image stored in the file at the specified path
    static Image
    getImage(String section, String path)
    Returns an image stored in the file at the specified path

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

  • Field Details

    • TOP_LEFT

      public static final int TOP_LEFT
      Style constant for placing decorator image in top left corner of base image.
      See Also:

    • TOP_RIGHT

      public static final int TOP_RIGHT
      Style constant for placing decorator image in top right corner of base image.
      See Also:

    • BOTTOM_LEFT

      public static final int BOTTOM_LEFT
      Style constant for placing decorator image in bottom left corner of base image.
      See Also:

    • BOTTOM_RIGHT

      public static final int BOTTOM_RIGHT
      Style constant for placing decorator image in bottom right corner of base image.
      See Also:

  • Constructor Details

    • SWTResourceManager

      public SWTResourceManager()

  • Method Details

    • dispose

      public static void dispose()
      Dispose of cached objects and their underlying OS resources. This should only be called when the cached objects are no longer needed (e.g. on application shutdown)

    • getColor

      public static Color getColor(int systemColorID)
      Returns the system color matching the specific ID
      Parameters:
      systemColorID - int The ID value for the color
      Returns:
      Color The system color matching the specific ID

    • getColor

      public static Color getColor(int r, int g, int b)
      Returns a color given its red, green and blue component values
      Parameters:
      r - int The red component of the color
      g - int The green component of the color
      b - int The blue component of the color
      Returns:
      Color The color matching the given red, green and blue componet values

    • getColor

      public static Color getColor(RGB rgb)
      Returns a color given its RGB value
      Parameters:
      rgb - RGB The RGB value of the color
      Returns:
      Color The color matching the RGB value

    • disposeColors

      public static void disposeColors()
      Dispose of all the cached colors

    • getImage

      protected static Image getImage(InputStream is)
      Returns an image encoded by the specified input stream
      Parameters:
      is - InputStream The input stream encoding the image data
      Returns:
      Image The image encoded by the specified input stream

    • getImage

      public static Image getImage(String path)
      Returns an image stored in the file at the specified path
      Parameters:
      path - String The path to the image file
      Returns:
      Image The image stored in the file at the specified path

    • getImage

      public static Image getImage(String section, String path)
      Returns an image stored in the file at the specified path
      Parameters:
      section - The section to which belongs specified image
      path - String The path to the image file
      Returns:
      Image The image stored in the file at the specified path

    • getImage

      public static Image getImage(Class<?> clazz, String path)
      Returns an image stored in the file at the specified path relative to the specified class
      Parameters:
      clazz - Class The class relative to which to find the image
      path - String The path to the image file
      Returns:
      Image The image stored in the file at the specified path

    • decorateImage

      public static Image decorateImage(Image baseImage, Image decorator)
      Returns an image composed of a base image decorated by another image
      Parameters:
      baseImage - Image The base image that should be decorated
      decorator - Image The image to decorate the base image
      Returns:
      Image The resulting decorated image

    • decorateImage

      public static Image decorateImage(Image baseImage, Image decorator, int corner)
      Returns an image composed of a base image decorated by another image
      Parameters:
      baseImage - Image The base image that should be decorated
      decorator - Image The image to decorate the base image
      corner - The corner to place decorator image
      Returns:
      Image The resulting decorated image

    • disposeImages

      public static void disposeImages()
      Dispose all of the cached images

    • disposeImages

      public static void disposeImages(String section)
      Dispose cached images in specified section
      Parameters:
      section - the section do dispose

    • getFont

      public static Font getFont(String name, int height, int style)
      Returns a font based on its name, height and style
      Parameters:
      name - String The name of the font
      height - int The height of the font
      style - int The style of the font
      Returns:
      Font The font matching the name, height and style

    • getFont

      public static Font getFont(String name, int size, int style, boolean strikeout, boolean underline)
      Returns a font based on its name, height and style. Windows-specific strikeout and underline flags are also supported.
      Parameters:
      name - String The name of the font
      size - int The size of the font
      style - int The style of the font
      strikeout - boolean The strikeout flag (warning: Windows only)
      underline - boolean The underline flag (warning: Windows only)
      Returns:
      Font The font matching the name, height, style, strikeout and underline

    • getBoldFont

      public static Font getBoldFont(Font baseFont)
      Return a bold version of the give font
      Parameters:
      baseFont - Font The font for whoch a bold version is desired
      Returns:
      Font The bold version of the give font

    • disposeFonts

      public static void disposeFonts()
      Dispose all of the cached fonts

    • fixCoolBarSize

      public static void fixCoolBarSize(CoolBar bar)
      Fix the layout of the specified CoolBar
      Parameters:
      bar - CoolBar The CoolBar that shgoud be fixed

    • getCursor

      public static Cursor getCursor(int id)
      Returns the system cursor matching the specific ID
      Parameters:
      id - int The ID value for the cursor
      Returns:
      Cursor The system cursor matching the specific ID

    • disposeCursors

      public static void disposeCursors()
      Dispose all of the cached cursors