org.apache.poi.hwpf.model
Class PicturesTable

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

public 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, FSPATable fspa, EscherRecordHolder dgg)
           
 
Method Summary
 Picture extractPicture(CharacterRun run, boolean fillBytes)
          Returns picture object tied to specified CharacterRun
 java.util.List 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

public PicturesTable(HWPFDocument _document,
                     byte[] _dataStream,
                     byte[] _mainStream,
                     FSPATable fspa,
                     EscherRecordHolder dgg)
Parameters:
document -
_dataStream -
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 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 2008 The Apache Software Foundation or its licensors, as applicable.