com.aspose.metafiles
Class EmfMetafile

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

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

Represents EMF Metafile.


Field Summary
 
Fields inherited from interface java.awt.image.renderable.RenderableImage
HINTS_OBSERVED
 
Constructor Summary
EmfMetafile(java.io.InputStream stream)
          This constructor is the primary mechanism to read existing metafile from a stream.
EmfMetafile(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 the metafile's bounds.
 java.awt.RenderingHints getDefaultRenderingHints()
          Returns metafile's default RenderingHints.
 float getHeight()
          Returns the height of the Emf metafile.
 float getMinX()
          Returns the minimum X coordinate of the Emf metafile.
 float getMinY()
          Returns the minimum Y coordinate of the Emf 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 Emf 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.
 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

EmfMetafile

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

Parameters:
stream - - input stream.
Throws:
MetafilesException

EmfMetafile

public EmfMetafile(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

getBounds

public java.awt.Rectangle getBounds()
Returns the metafile's bounds.
Note: this rectangle is not an image size. To get 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.

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.

getMinX

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

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

getMinY

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

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

getWidth

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

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

getHeight

public float getHeight()
Returns the height of the Emf metafile.

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

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.