BCL easyConverter SDK Word
easyConverter SDK Usermanual
PDF-to-Word Programming API  |  Download Free Trial  |  Contact Us to Purchase

Reference

Control Switches

The following switches control the command-line application, instead of easyConverter SDK.

-version

Description: Displays the SDK version number

-silent

Description: Switches to Silent Mode, where only errors that are considered failures are displayed. Warnings and progress messages are not displayed.

Note: If the -version switch is used with -silent, the version information is displayed.

Common Settings

-output docx|doc|rtf

Description: The output document / file type: DOCX, DOC or RTF.

Type: enumeration: (docx, doc, rtf)

Default: docx

-pages all|<int>-<int> or -page <int>

Description: Restricts the conversion to the specified range of pages. Use a single page number, or a range, such as -pages 1-5.

Type: a range of pages

Default: all

-fileTimeout <seconds>

Description: Maximum time allowed to convert each document.

Type: integer (seconds)

Default: 300 seconds (= 5 minutes)

-quality <int>

Description: Specifies image compression quality for JPEG. Quality is not a percentage, and it is highly non-linear (quality will fall steeply as the value decreases). Even a quality of 100 is not necessarily perfectly lossless.

Type: integer, range: 5-100

Default: 85

-method flow|spaces|textboxes|reflow

Description: The conversion method:

Type: enumeration: (flow, spaces, absolute, reflow)

Default: flow

-password <password>

Description: Master password to open the PDF (if necessary). Password must give unrestricted content extraction permissions.

Type: string (ASCII)

Default: none (blank)

Flow Text Settings

The following settings only apply for -method flow, which is the default method.

-bookmarks page|extract|none

Description: Bookmark generation in the output document:

Type: enumeration: (page, extract, none)

Default: page

-ocred image+text|text|image

Description: How to handle special OCRed PDFs that only contain full-page images with hidden text. OCR engines can provide such output. The text is selectable, but invisible. Choices:

Note: this setting is ignored unless the PDF was produced by an OCR engine based on a scanned image.

Type: enumeration: (image+text, text, image)

Default: image+text

-connectHyphens [on|off]

Description: Determines whether to re-connect hyphenated words. Only works for basic English dictionary words that are hyphenated at the end of a line. This does not remove hyphens from expressions that require a hyphen, such as "counter-clockwise" or "well-intentioned". Only works for English, due to special grammatical (stemming) rules. You cannot simply replace the dictionary with a different language.

Type: Flag (on when switch is without value)

Default: off

-condense [on|off]

Description: Determines whether to shrink character spacing to prevent wrap.

Type: Flag (on when switch is without value)

Default: off

-matchLines [on|off]

Description: Determines whether to insert line new characters into the output in order to match precise line breaks in the PDF. Note that this interferes with the detection of paragraphs. You may end up with a new paragraph for each line.

Type: Flag (on when switch is without value)

Default: off

-noAdjustFonts [on|off]

Description: Determines whether to stop adjusting and shrinking of fonts. By default, fonts are shrunk in order to fit them in the available space. Note that disabling font adjustments may sometimes cause a single page PDF to come out as two pages in Word.

Type: Flag (on when switch is without value)

Default: off

-removeInvisibleText [on|off]

Description: Determines whether to remove text that has the same color as the background.

Type: Flag (on when switch is without value)

Default: on

-wordPad [on|off]

Description: Determines whether to generate RTF with uncompressed images for WordPad compatibility. This only applies to RTF files. Note that uncompressed images can significantly blow up your file size.

Type: Flag (on when switch is without value)

Default: off

Absolute Positioning Settings

The following settings only apply for -method spaces, -method flow, -method reflow. Absolute positioning is a special feature that is not suitable for most customers.

-doctype single|multi|pleading

Description: The document type. Choices:

Type: enumeration: (single, multi, pleading)

Default: single

-text [on|off]

Description: Determines whether to extract text out of the PDF.

Type: Flag (on when switch is without value)

Default: on

-images [on|off]

Description: Determines whether to extract images out of the PDF.

Type: Flag (on when switch is without value)

Default: on

-adjustSpacing [on|off]

Description: Determines whether to adjust spacing.

Type: Flag (on when switch is without value)

Default: off

-headers [on|off]

Description: Determines whether to detect headers.

Type: Flag (on when switch is without value)

Default: off

-hyperlinks [on|off]

Description: Determines whether to extract hyperlinks.

Type: Flag (on when switch is without value)

Default: off

-mergeText [on|off]

Description: Determines whether to merge text.

Type: Flag (on when switch is without value)

Default: on

-mergeParagraphs [on|off]

Description: Determines whether to merge paragraphs.

Type: Flag (on when switch is without value)

Default: on

-shrink [on|off]

Description: Determines whether to allow the shrinking of fonts when necessary.

Type: Flag (on when switch is without value)

Default: on

-adjustFontNames [on|off]

Description: Determines whether to allow the adjusting of the font names when necessary.

Type: Flag (on when switch is without value)

Default: on