## org.apache.poi.hwpf.model
Class PicturesTable

    java.lang.Object
      org.apache.poi.hwpf.model.PicturesTable

    @Internal
    public final class PicturesTable

extends java.lang.Object

Holds information about all pictures embedded in Word Document either via "Insert -> Picture -> From File" or via clipboard. Responsible for images extraction and determining whether some document's piece contains embedded image. Analyzes raw data bytestream 'Data' (where Word stores all embedded objects) provided by HWPFDocument. Word stores images as is within so called "Data stream" - the stream within a Word docfile containing various data that hang off of characters in the main stream. For example, binary data describing in-line pictures and/or formfields an also embedded objects-native data. Word picture structures are concatenated one after the other in the data stream if the document contains pictures. Data stream is easily reachable via HWPFDocument._dataStream property. A picture is represented in the document text stream as a special character, an Unicode whose CharacterRun.isSpecial() returns true. The file location of the picture in the Word binary file is accessed via CharacterRun.getPicOffset(). The CharacterRun.getPicOffset() is a byte offset into the data stream. Beginning at the position recorded in picOffset, a header data structure, will be stored.

Author:
  Dmitry Romanov

Constructor Summary
`PicturesTable(HWPFDocument _document, byte[] _dataStream, byte[] _mainStream)`
`PicturesTable(HWPFDocument _document, byte[] _dataStream, byte[] _mainStream, FSPATable fspa, EscherRecordHolder dgg)` Deprecated.

Method Summary
`Picture` `extractPicture(CharacterRun run, boolean fillBytes)` Returns picture object tied to specified CharacterRun
`java.util.List<Picture>` `getAllPictures()` Not all documents have all the images concatenated in the data stream although MS claims so.
`boolean` `hasEscherPicture(CharacterRun run)`
`boolean` `hasHorizontalLine(CharacterRun run)` determines whether specified CharacterRun contains reference to a picture
`boolean` `hasPicture(CharacterRun run)` determines whether specified CharacterRun contains reference to a picture

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

Constructor Detail

### PicturesTable

    @Deprecated
    public PicturesTable(HWPFDocument _document,
                                    byte[] _dataStream,
                                    byte[] _mainStream,
                                    FSPATable fspa,
                                    EscherRecordHolder dgg)

  Deprecated.

  Parameters:
    `_document` -
    `_dataStream` -

### PicturesTable

    public PicturesTable(HWPFDocument _document,
                         byte[] _dataStream,
                         byte[] _mainStream)

Method Detail

### hasPicture

    public boolean hasPicture(CharacterRun run)

  determines whether specified CharacterRun contains reference to a picture

  Parameters:
    `run` -

### hasEscherPicture

    public boolean hasEscherPicture(CharacterRun run)

### hasHorizontalLine

    public boolean hasHorizontalLine(CharacterRun run)

  determines whether specified CharacterRun contains reference to a picture

  Parameters:
    `run` -

### extractPicture

    public Picture extractPicture(CharacterRun run,
                                  boolean fillBytes)

  Returns picture object tied to specified CharacterRun

  Parameters:
    `run` -
    `fillBytes` - if true, Picture will be returned with filled byte array that represent picture's contents. If you don't want to have that byte array in memory but only write picture's contents to stream, pass false and then use Picture.writeImageContent
  Returns:
    a Picture object if picture exists for specified CharacterRun, null otherwise. PicturesTable.hasPicture is used to determine this.
  See Also:
    `Picture.writeImageContent(java.io.OutputStream)`, `hasPicture(org.apache.poi.hwpf.usermodel.CharacterRun)`

### getAllPictures

    public java.util.List<Picture> getAllPictures()

  Not all documents have all the images concatenated in the data stream although MS claims so. The best approach is to scan all character runs.

  Returns:
    a list of Picture objects found in current document

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