[gmf-dev] [GMF - API CHANGE] Bugzilla 111436 Improve performance of SVG

[Steven Shaw <steveshaw@xxxxxxxxxx>]

Description:
Some improvements to the SVG rendering capability in GMF to support (clients
of ScalableImageFigure should benefit from these changes transparently):
- asynchronous rendering of SVG files to avoid locking up the UI during
rendering operation. 
- removing of java.awt package dependency from the root and public classes
to enable future plug-in separation and extensibility of the RenderedImage
infrastructure. 
- allow maximum rendering size to avoid rendering a huge image unnecessarily.
 This is useful for display. 

Summary of changes: (Old api is currently preserved in deprecated form)
- Subclass RenderedImage interface from IAdaptable to allow implementors
to adapt to different image formats.  Specifically this allows the
removal of the getBufferedImage method and instead clients can call getAdapter(BufferedImage.class)
instead.  Or if native rendering support to BufferedImage isn't supported
clients can use ImageConverter.convert( myRenderedImage.getSWTImage() ).
- RenderInfo#getFillColor and RenderInfo#getOutlineColor have been deprecated
and replaced with replaced by getBackgroundColor and getForegroundColor
respectively.  They return RGB values. 
- RenderInfo#setValues(int width, int height, java.awt.Color fill, java.awt.Color
outline,boolean maintainAspectRatio,boolean antialias) is deprecated and
replaced with RenderInfo#setValues(int width, int height, boolean maintainAspectRatio,
boolean antialias, RGB background, RGB foreground).  Note: color
parameters have been moved to the end of the method signature to avoid
ambiguous null parameters and to group other parameters more appropriately.

New API Availability: 
now (in gmf-head)

Old API Removal: 
Friday, Jan 24th, 2005

Tracking:                  
      
Bugzilla 111436

Clients Taken Care of:        
GMF

Other Clients' Action:        
Replace usage of deprecated API with new API. 

________________________________________
Steven R. Shaw
Rational Modeling Platform Diagram Layer Lead
Rational Software | IBM Software Group
770 Palladium Drive, Kanata, ON, Canada, K2V 1C8
tel: 613.591.7979
steveshaw@xxxxxxxxxx