com.aspose.metafiles
Class WmfMetafile

java.lang.Object
  extended by com.aspose.metafiles.WmfMetafile
All Implemented Interfaces:
java.awt.image.renderable.RenderableImage

public final class WmfMetafile
extends java.lang.Object
implements java.awt.image.renderable.RenderableImage

Represents WMF Metafile.


Field Summary
 
Fields inherited from interface java.awt.image.renderable.RenderableImage
HINTS_OBSERVED
 
Constructor Summary
WmfMetafile(java.io.InputStream stream)
          This constructor is the primary mechanism to read existing metafile from a stream.
WmfMetafile(java.lang.String fileName)
          This constructor is the primary mechanism to read existing presentation from a file.
 
Method Summary
 java.awt.image.RenderedImage createDefaultRendering()
          Creates a RenderedImage with default size.
 java.awt.image.RenderedImage createRendering(java.awt.image.renderable.RenderContext rc)
          Creates RenderedImage from the metafile.
 java.awt.image.RenderedImage createScaledRendering(int w, int h, java.awt.RenderingHints hints)
          Creates a RenderedImage with the specified width and height.
 java.awt.Rectangle getBounds()
          Returns metafile's bounds.
 java.awt.RenderingHints getDefaultRenderingHints()
          Returns metafile's default RenderingHints.
 float getHeight()
          Returns the height of the Wmf Metafile.
 float getMinX()
          Returns the minimum X coordinate of the Wmf metafile.
 float getMinY()
          Returns the minimum Y coordinate of the Wmf metafile.
 java.lang.Object getProperty(java.lang.String name)
          Required by RenderableImage interface.
 java.lang.String[] getPropertyNames()
          Required by RenderableImage interface.
 java.util.Vector getSources()
          Required by RenderableImage interface.
 float getWidth()
          Returns the width of the Wmf metafile.
 boolean isDynamic()
          Required by RenderableImage interface.
 void playMetafile(java.awt.Graphics2D target)
          Draws a metafile without transform to the specified Graphics2D object.
 void playMetafile(java.awt.Graphics2D target, java.awt.geom.AffineTransform trans)
          Draws a metafile to the specified Graphics2D object with transformation.
 void setDefaultRenderingHints(java.awt.RenderingHints rh)
          Replaces current metafile's default RenderingHints.
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

WmfMetafile

public WmfMetafile(java.io.InputStream stream)
            throws MetafilesException
This constructor is the primary mechanism to read existing metafile from a stream.

Parameters:
stream - - the input stream.
Throws:
MetafilesException

WmfMetafile

public WmfMetafile(java.lang.String fileName)
            throws MetafilesException,
                   java.io.FileNotFoundException
This constructor is the primary mechanism to read existing presentation from a file.

Parameters:
fileName - - name of a file.
Throws:
MetafilesException
java.io.FileNotFoundException
Method Detail

getMinX

public float getMinX()
Returns the minimum X coordinate of the Wmf metafile.

Specified by:
getMinX in interface java.awt.image.renderable.RenderableImage

getMinY

public float getMinY()
Returns the minimum Y coordinate of the Wmf metafile.

Specified by:
getMinY in interface java.awt.image.renderable.RenderableImage

getWidth

public float getWidth()
Returns the width of the Wmf metafile.

Specified by:
getWidth in interface java.awt.image.renderable.RenderableImage

getHeight

public float getHeight()
Returns the height of the Wmf Metafile.

Specified by:
getHeight in interface java.awt.image.renderable.RenderableImage

getBounds

public java.awt.Rectangle getBounds()
Returns metafile's bounds.
Note: this rectangle is not an image size. To obtain image size and position use getMinX(), getMinY(), getWidth() and getHeight().

Returns:
metafile's bounds.

playMetafile

public void playMetafile(java.awt.Graphics2D target)
                  throws MetafilesException
Draws a metafile without transform to the specified Graphics2D object.

Parameters:
target - - Graphics2D object.
Throws:
MetafilesException

playMetafile

public void playMetafile(java.awt.Graphics2D target,
                         java.awt.geom.AffineTransform trans)
                  throws MetafilesException
Draws a metafile to the specified Graphics2D object with transformation.

Parameters:
target - - Graphics2D object.
trans - - coordinates transformation from metafile's coordinates to Graphics2D user space.
Throws:
MetafilesException

getSources

public java.util.Vector getSources()
Required by RenderableImage interface. Always returns null.

Specified by:
getSources in interface java.awt.image.renderable.RenderableImage

createRendering

public java.awt.image.RenderedImage createRendering(java.awt.image.renderable.RenderContext rc)
Creates RenderedImage from the metafile.

Specified by:
createRendering in interface java.awt.image.renderable.RenderableImage
Parameters:
rc - - RenderContext object used to create image.

isDynamic

public boolean isDynamic()
Required by RenderableImage interface. Always returns false.

Specified by:
isDynamic in interface java.awt.image.renderable.RenderableImage

getPropertyNames

public java.lang.String[] getPropertyNames()
Required by RenderableImage interface. Returns an empty array.

Specified by:
getPropertyNames in interface java.awt.image.renderable.RenderableImage

getProperty

public java.lang.Object getProperty(java.lang.String name)
Required by RenderableImage interface. Returns java.awt.Image.UndefinedProperty.

Specified by:
getProperty in interface java.awt.image.renderable.RenderableImage

createScaledRendering

public java.awt.image.RenderedImage createScaledRendering(int w,
                                                          int h,
                                                          java.awt.RenderingHints hints)
Creates a RenderedImage with the specified width and height.

Specified by:
createScaledRendering in interface java.awt.image.renderable.RenderableImage
Parameters:
w - - image width.
h - - image height.
hints - - RenderingHits used to draw and scale metafile.

createDefaultRendering

public java.awt.image.RenderedImage createDefaultRendering()
Creates a RenderedImage with default size.

Specified by:
createDefaultRendering in interface java.awt.image.renderable.RenderableImage

setDefaultRenderingHints

public void setDefaultRenderingHints(java.awt.RenderingHints rh)
Replaces current metafile's default RenderingHints.

Note: default rendering hints used only by createRendering(), createDefaultRendering(), createScaledRendering() and methods, which use them. For example Graphics2D.DrawRenderableImage().

PlayMetafile() method uses RenderingHints of the specified Graphics2D object. When another RenderingHints object passed to createScaledRendering() or createRendering() via RenderContext object, function merges it with default RenderingHints. Caller's RenderingHints overrides metafile's default.

Parameters:
rh - - new default RenderingHints.

getDefaultRenderingHints

public java.awt.RenderingHints getDefaultRenderingHints()
Returns metafile's default RenderingHints.