## org.apache.poi.hwpf.usermodel
Class Picture

    java.lang.Object
      org.apache.poi.hwpf.usermodel.Picture

    public final class Picture

extends java.lang.Object

Represents embedded picture extracted from Word Document

Field Summary
`static byte[]` `BMP` Deprecated.
`static byte[]` `COMPRESSED1`
`static byte[]` `COMPRESSED2`
`static byte[]` `EMF` Deprecated.
`static byte[]` `GIF` Deprecated.
`static byte[]` `IHDR`
`static byte[]` `JPG` Deprecated.
`static byte[]` `PNG` Deprecated.
`static byte[]` `TIFF` Deprecated.
`static byte[]` `TIFF1` Deprecated.
`static byte[]` `WMF1` Deprecated.
`static byte[]` `WMF2` Deprecated.

Constructor Summary
`Picture(EscherBlipRecord blipRecord)` Builds a Picture object for a Picture stored as Escher.
`Picture(int dataBlockStartOfsset, byte[] _dataStream, boolean fillBytes)` Builds a Picture object for a Picture stored in the DataStream

Method Summary
`int` `getAspectRatioX()` Deprecated. use more precise `getHorizontalScalingFactor()`
`int` `getAspectRatioY()` Deprecated. use more precise `getVerticalScalingFactor()`
`byte[]` `getContent()`
`int` `getDxaCropLeft()` Deprecated.
`int` `getDxaCropRight()` Deprecated.
`int` `getDxaGoal()` Gets the initial width of the picture, in twips, prior to cropping or scaling.
`int` `getDyaCropBottom()` Deprecated.
`int` `getDyaCropTop()` Deprecated.
`int` `getDyaGoal()` Gets the initial height of the picture, in twips, prior to cropping or scaling.
`int` `getHeight()` returns pixel height of the picture or -1 if dimensions determining was failed
`int` `getHorizontalScalingFactor()`
`java.lang.String` `getMimeType()` Returns the MIME type for the image
`byte[]` `getRawContent()` Returns picture's content as it stored in Word file, i.e.
`int` `getSize()`
`int` `getStartOffset()`
`int` `getVerticalScalingFactor()`
`int` `getWidth()` returns pixel width of the picture or -1 if dimensions determining was failed
`java.lang.String` `suggestFileExtension()` tries to suggest extension for picture's file by matching signatures of popular image formats to first bytes of picture's contents
`java.lang.String` `suggestFullFileName()` Tries to suggest a filename: hex representation of picture structure offset in "Data" stream plus extension that is tried to determine from first byte of picture's content.
`PictureType` `suggestPictureType()`
`void` `writeImageContent(java.io.OutputStream out)` Writes Picture's content bytes to specified OutputStream.

Methods inherited from class java.lang.Object
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

Field Detail

### BMP

    @Deprecated
    public static final byte[] BMP

  Deprecated.

### COMPRESSED1

    public static final byte[] COMPRESSED1

### COMPRESSED2

    public static final byte[] COMPRESSED2

### EMF

    @Deprecated
    public static final byte[] EMF

  Deprecated.

### GIF

    @Deprecated
    public static final byte[] GIF

  Deprecated.

### IHDR

    public static final byte[] IHDR

### JPG

    @Deprecated
    public static final byte[] JPG

  Deprecated.

### PNG

    @Deprecated
    public static final byte[] PNG

  Deprecated.

### TIFF

    @Deprecated
    public static final byte[] TIFF

  Deprecated.

### TIFF1

    @Deprecated
    public static final byte[] TIFF1

  Deprecated.

### WMF1

    @Deprecated
    public static final byte[] WMF1

  Deprecated.

### WMF2

    @Deprecated
    public static final byte[] WMF2

  Deprecated.

Constructor Detail

### Picture

    public Picture(EscherBlipRecord blipRecord)

  Builds a Picture object for a Picture stored as Escher. TODO We need to pass in the PICF data too somehow!

### Picture

    public Picture(int dataBlockStartOfsset,
                   byte[] _dataStream,
                   boolean fillBytes)

  Builds a Picture object for a Picture stored in the DataStream

Method Detail

### getAspectRatioX

    @Deprecated
    public int getAspectRatioX()

  Deprecated. use more precise `getHorizontalScalingFactor()`

  Returns:
    the horizontal aspect ratio for picture provided by user

### getAspectRatioY

    @Deprecated
    public int getAspectRatioY()

  Deprecated. use more precise `getVerticalScalingFactor()`

  Returns:
    the vertical aspect ratio for picture provided by user

### getContent

    public byte[] getContent()

  Returns:
    picture's content as byte array

### getDxaCropLeft

    @Deprecated
    public int getDxaCropLeft()

  Deprecated.

  Returns:
    The amount the picture has been cropped on the left in twips

### getDxaCropRight

    @Deprecated
    public int getDxaCropRight()

  Deprecated.

  Returns:
    The amount the picture has been cropped on the right in twips

### getDxaGoal

    public int getDxaGoal()

  Gets the initial width of the picture, in twips, prior to cropping or scaling.

  Returns:
    the initial width of the picture in twips

### getDyaCropBottom

    @Deprecated
    public int getDyaCropBottom()

  Deprecated.

  Returns:
    The amount the picture has been cropped on the bottom in twips

### getDyaCropTop

    @Deprecated
    public int getDyaCropTop()

  Deprecated.

  Returns:
    The amount the picture has been cropped on the top in twips

### getDyaGoal

    public int getDyaGoal()

  Gets the initial height of the picture, in twips, prior to cropping or scaling.

  Returns:
    the initial width of the picture in twips

### getHeight

    public int getHeight()

  returns pixel height of the picture or -1 if dimensions determining was failed

### getHorizontalScalingFactor

    public int getHorizontalScalingFactor()

  Returns:
    Horizontal scaling factor supplied by user expressed in .001% units

### getMimeType

    public java.lang.String getMimeType()

  Returns the MIME type for the image

  Returns:
    MIME-type for known types of image or "image/unknown" if unknown

### getRawContent

    public byte[] getRawContent()

  Returns picture's content as it stored in Word file, i.e. possibly in compressed form.

  Returns:
    picture's content as it stored in Word file

### getSize

    public int getSize()

  Returns:
    size in bytes of the picture

### getStartOffset

    public int getStartOffset()

  Returns:
    The offset of this picture in the picture bytes, used when matching up with `CharacterRun.getPicOffset()`

### getVerticalScalingFactor

    public int getVerticalScalingFactor()

  Returns:
    Vertical scaling factor supplied by user expressed in .001% units

### getWidth

    public int getWidth()

  returns pixel width of the picture or -1 if dimensions determining was failed

### suggestFileExtension

    public java.lang.String suggestFileExtension()

  tries to suggest extension for picture's file by matching signatures of popular image formats to first bytes of picture's contents

  Returns:
    suggested file extension

### suggestFullFileName

    public java.lang.String suggestFullFileName()

  Tries to suggest a filename: hex representation of picture structure offset in "Data" stream plus extension that is tried to determine from first byte of picture's content.

  Returns:
    suggested file name

### suggestPictureType

    public PictureType suggestPictureType()

### writeImageContent

    public void writeImageContent(java.io.OutputStream out)
                           throws java.io.IOException

  Writes Picture's content bytes to specified OutputStream. Is useful when there is need to write picture bytes directly to stream, omitting its representation in memory as distinct byte array.

  Parameters:
    `out` - a stream to write to
  Throws:
    `java.io.IOException` - if some exception is occured while writing to specified out

Copyright 2012 The Apache Software Foundation or its licensors, as applicable.