Configuration (PDFxStream API Reference)

java.lang.Object
- com.snowtide.pdf.Configuration

```
public class Configuration
extends Object
```
Various configuration options for PDFxStream may be set using this class. A custom configuration may be registered with PDFxStream in any of three ways:
- Retrieving and changing the current default Configuration or by creating a new Configuration, modifying it as desired, and setting it as the new default instance.
- Providing a customized Configuration instance to one of the {code PDF.open} factory methods:
- Setting the configuration used by an existing Document via Document.setConfig(Configuration) function. Note that certain configuration properties are utilized only during Document initialization, so default settings will end up being used during that initialization phase.
Since:

v3.0

Version:

©2004-2014 Snowtide

Constructor Summary

Constructors
Constructor and Description
`Configuration()` Creates a `Configuration` whose properties are derived from the original defaults and the current value of system properties.
`Configuration(Configuration other)` Creates a copy of the given `Configuration` instance.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`static Configuration`	`getDefault()` Returns the configuration that new `Document` instances use by default.
`String`	`getLinebreakString()` Returns the string that `OutputTarget` (and its subclasses) output for each linebreak identified in extracted PDF content.
`int`	`getMinTableCellCount()` Returns the minimum number of adjacent cells that must be present in order for PDFxStream to recognize those cells collectively as a `Table`.
`static boolean`	`isCJKSupportEnabled()` Returns true if this configuration will cause PDFxStream to extract and decode Chinese, Japanese, and Korean content.
`boolean`	`isDeriveType3Fonts()` Returns true if this configuration will cause PDFxStream to derive the Unicode encodings of Type3 PDF fonts.
`boolean`	`isIgnoreNonCardinalRotatedChars()` When true, characters that are rotated by angles other than 0, 90, 180, and 270 will be ignored.
`boolean`	`isImplicitLineDetectionEnabled()`
`boolean`	`isStripXFAFormDataEnabled()`
`boolean`	`isTableDetectionEnabled()` Returns true only if `Table` detection is enabled; defaults to true.
`static void`	`setCJKSupportEnabled(boolean enableCJK)` Changes the setting that controls whether or not PDFxStream extracts and decodes Chinese, Japanese, and Korean content.
`static void`	`setDefault(Configuration defaultConfig)` Sets the configuration that new `Document` instances use by default.
`void`	`setDeriveType3Fonts(boolean deriveType3Fonts)` Changes the setting that controls whether or not PDFxStream derives the Unicode encodings of Type3 PDF fonts.
`void`	`setIgnoreNonCardinalRotatedChars(boolean ignoreRotated)` Sets whether characters that are rotated by angles other than 0, 90, 180, and 270 will be ignored.
`void`	`setImplicitLineDetectionEnabled(boolean detectImplicitLines)`
`void`	`setLinebreakString(String linebreak)` Sets the string that `OutputTarget` (and its subclasses) output for each linebreak identified in extracted PDF content.
`void`	`setMinTableCellCount(int minTableCellCount)` Changes the setting that controls the minimum number of adjacent cells that must be present in order for PDFxStream to recognize those cells collectively as a `Table`.
`void`	`setStripXFAFormDataEnabled(boolean stripXFAFormData)`
`void`	`setTableDetectionEnabled(boolean detectTables)` Sets whether or not `Table` detection is enabled.
`String`	`toString()`

- Constructor Detail
  - Configuration
```
public Configuration(Configuration other)
```
    Creates a copy of the given Configuration instance.
  - Configuration
```
public Configuration()
```
    Creates a Configuration whose properties are derived from the original defaults and the current value of system properties. This does not take the current default configuration into account.
- Method Detail
  - getDefault
```
public static Configuration getDefault()
```
    Returns the configuration that new Document instances use by default.
    
    See Also:
    
    Configuration.setDefault(Configuration)
  - setDefault
```
public static void setDefault(Configuration defaultConfig)
```
    Sets the configuration that new Document instances use by default.
  - toString
```
public String toString()
```
    Overrides:
    
    toString in class Object
  - isTableDetectionEnabled
```
public boolean isTableDetectionEnabled()
```
    Returns true only if Table detection is enabled; defaults to true.
  - setTableDetectionEnabled
```
public void setTableDetectionEnabled(boolean detectTables)
```
    Sets whether or not Table detection is enabled.
  - isStripXFAFormDataEnabled
```
public boolean isStripXFAFormDataEnabled()
```
  - setStripXFAFormDataEnabled
```
public void setStripXFAFormDataEnabled(boolean stripXFAFormData)
```
  - isIgnoreNonCardinalRotatedChars
```
public boolean isIgnoreNonCardinalRotatedChars()
```
    When true, characters that are rotated by angles other than 0, 90, 180, and 270 will be ignored. Defaults to false.
  - setIgnoreNonCardinalRotatedChars
```
public void setIgnoreNonCardinalRotatedChars(boolean ignoreRotated)
```
    Sets whether characters that are rotated by angles other than 0, 90, 180, and 270 will be ignored. Defaults to false.
  - getMinTableCellCount
```
public int getMinTableCellCount()
```
    Returns the minimum number of adjacent cells that must be present in order for PDFxStream to recognize those cells collectively as a Table. This setting defaults to 4.
  - setMinTableCellCount
```
public void setMinTableCellCount(int minTableCellCount)
```
    Changes the setting that controls the minimum number of adjacent cells that must be present in order for PDFxStream to recognize those cells collectively as a Table. This setting defaults to 4.
  - isImplicitLineDetectionEnabled
```
public boolean isImplicitLineDetectionEnabled()
```
  - setImplicitLineDetectionEnabled
```
public void setImplicitLineDetectionEnabled(boolean detectImplicitLines)
```
  - isCJKSupportEnabled
```
public static boolean isCJKSupportEnabled()
```
    Returns true if this configuration will cause PDFxStream to extract and decode Chinese, Japanese, and Korean content. This setting defaults to true.
  - setCJKSupportEnabled
```
public static void setCJKSupportEnabled(boolean enableCJK)
```
    Changes the setting that controls whether or not PDFxStream extracts and decodes Chinese, Japanese, and Korean content. This setting defaults to true. Changing it to false will minimize PDFxStream's memory utilization, but no CJK content will be extracted.
  - isDeriveType3Fonts
```
public boolean isDeriveType3Fonts()
```
    Returns true if this configuration will cause PDFxStream to derive the Unicode encodings of Type3 PDF fonts. This setting defaults to true.
  - setDeriveType3Fonts
```
public void setDeriveType3Fonts(boolean deriveType3Fonts)
```
    Changes the setting that controls whether or not PDFxStream derives the Unicode encodings of Type3 PDF fonts. This setting defaults to true. Changing it to false will result in a small performance improvement, but any PDF content rendered using Type3 fonts that lack a Unicode encoding will not be extracted by PDFxStream.
  - getLinebreakString
```
public String getLinebreakString()
```
    Returns the string that OutputTarget (and its subclasses) output for each linebreak identified in extracted PDF content. This value defaults to the current platform's line break string, as identified by the line.separator system property.
  - setLinebreakString
```
public void setLinebreakString(String linebreak)
```
    Sets the string that OutputTarget (and its subclasses) output for each linebreak identified in extracted PDF content. This value defaults to the current platform's line break string, as identified by the line.separator system property.

Class Configuration

Constructor Summary

Method Summary

Constructor Detail

Configuration

Configuration

Method Detail

getDefault

setDefault

toString

isTableDetectionEnabled

setTableDetectionEnabled

isStripXFAFormDataEnabled

setStripXFAFormDataEnabled

isIgnoreNonCardinalRotatedChars

setIgnoreNonCardinalRotatedChars

getMinTableCellCount

setMinTableCellCount

isImplicitLineDetectionEnabled

setImplicitLineDetectionEnabled

isCJKSupportEnabled

setCJKSupportEnabled

isDeriveType3Fonts

setDeriveType3Fonts

getLinebreakString

setLinebreakString