gKSLb‖

ofagn‖PDF Export Command Line Parameters

9WZWX‖The PDF filter accepts a string of options containing PDF properties for export.

LprVp‖Examples:

RpP9D‖To skip the first page of a Draw document:

soffice --convert-to 'pdf:draw_pdf_Export:{"PageRange":{"type":"string","value":"2-"}}' test.odg

Wi9jG‖To add a tiled watermark:

soffice --convert-to 'pdf:draw_pdf_Export:{"TiledWatermark":{"type":"string","value":"draft"}}' test.odg

XApuF‖To encrypt a file:

soffice --convert-to 'pdf:draw_pdf_Export:{"EncryptFile":{"type":"boolean","value":"true"},"DocumentOpenPassword":{"type":"string","value":"secret"}}' test.odg

taFEp‖To set version 1.5 (instead of the default 1.7):

soffice --convert-to 'pdf:draw_pdf_Export:{"SelectPdfVersion":{"type":"long","value":"15"}}' test.odg

iRpXC‖Index

General Properties

Initial View

User Interface

Links

Security

Digital Signature

Gce7M‖General Properties

General

CLYTU‖Name

wPDUh‖Description

UmoHC‖Type

8X2ru‖Default Value

PageRange

uWdYs‖ If this property is set, it indicates the range of pages to be exported.

TtPCS‖To export all the pages, leave this property unset.

DzQF3‖To export a selection, leave this property unset and set only the property Selection.

string

7GBX9‖Empty (all pages are exported)

Selection

EP7tx‖An any corresponding to the current selection in the document.

Any

UseLosslessCompression

uG6Ez‖Specifies if images are exported to PDF using a lossless compression format like PNG or compressed using the JPEG format.

boolean

false

Quality

LHD2T‖Specifies the quality of the JPG export. A higher value produces a higher-quality image and a larger file.

9XEdE‖Minimum inclusive value: 1. Represents the lowest value that can be used. The lower the value, the worse is the image quality and the smaller is the file size.

gmZ5r‖Maximum inclusive value: 100. Represents the highest value that can be used. The higher the value, the better is the image quality and the larger is the file size.

long

90

ReduceImageResolution

zvtpL‖Specifies if the resolution of each image is reduced to the resolution specified by the property MaxImageResolution.

boolean

false

MaxImageResolution

QVA7F‖If the property ReduceImageResolution is set to true, all images will be reduced to the given value in DPI. Possible values are: 75, 150, 300, 600 and 1200.

long

300

SelectPdfVersion

YA52W‖Specifies the PDF version to emit. Possible values are:

jSAc3‖0: PDF 1.7 (default choice).

1: PDF/A-1b

2: PDF/A-2b

3: PDF/A-3b

15: PDF 1.5

16: PDF 1.6

17: PDF 1.7

long

0

PDFUACompliance

J6GGg‖Creates an accessible PDF file that follows the requirements of the PDF/UA (ISO 14289) specification.

boolean

false

UseTaggedPDF

6jnKY‖Determines if PDFs are created using special accessibility tags.

boolean

false

ExportFormFields

sU7xg‖Specifies whether form fields are exported as widgets or only their fixed print representation is exported.

boolean

true

FormsType

xWJcc‖Specifies the submit format of a PDF form. Possible values are:

rvZyx‖0: Specifies that form type FDF is used.

sjaDZ‖1: Specifies that form type PDF is used.

SV4nK‖2: Specifies that form type HTML is used.

e2vAz‖3: Specifies that form type XML is used.

long

0

AllowDuplicateFieldNames

xTH7a‖Specifies whether multiple form fields exported are allowed to have the same field name.

boolean

false

ExportBookmarks

YewmA‖ Specifies if bookmarks are exported to PDF.

boolean

true

ExportPlaceholders

GGvAH‖Export the placeholders fields visual markings only. The exported placeholder is ineffective.

boolean

false

ExportNotes

cwShm‖Specifies if notes are exported to PDF.

boolean

false

ExportNotesPages

sJHAF‖Specifies if notes pages are exported to PDF. (Notes pages are available in Impress documents only).

boolean

false

ExportOnlyNotesPages

jAPh6‖If the property ExportNotesPages is set to true, specifies if only notes pages are exported to PDF.

boolean

false

ExportNotesInMargin

GvGLs‖Specifies if notes in margin are exported to PDF.

boolean

false

ExportHiddenSlides

f5Qfk‖For LibreOfficeDev Impress, exports slides not included in slide shows.

boolean

false

IsSkipEmptyPages

s7ZTV‖Specifies that automatically inserted empty pages are suppressed. This option is active only if storing Writer documents.

boolean

false

EmbedStandardFonts

kBHwd‖Specifies whether to embed the 14 standard PDF fonts or not.

boolean

false

IsAddStream

L6EfU‖Specifies that a stream is inserted to the PDF file which contains the original document for archiving purposes.

boolean

false

Watermark

R4f6x‖Specifies the text for a watermark to be drawn on every page of the exported PDF file.

string

(empty)

WatermarkColor

BpGDK‖Specifies the color of the watermark text

long

8388223 (light green)

WatermarkFontHeight

erWJF‖Specifies the font height of the watermark text.

long

WatermarkRotateAngle

xLqxD‖Specifies angle of the watermark text.

long

WatermarkFontName

aWVT6‖Specifies font name of the watermark text.

string

Helvetica

TiledWatermark

uzphD‖Specifies the tiled watermark text.

string

UseReferenceXObject

WGEgU‖When the option is enabled, then the reference XObject markup is used: this is a simple operation, but viewers have to support this markup to show vector images. Otherwise a fallback bitmap is shown in the viewer.

boolean

false

IsRedactMode

boolean

false

SinglePageSheets

CnAJS‖Ignores each sheet’s paper size, print ranges and shown/hidden status and puts every sheet (even hidden sheets) on exactly one page.

boolean

false


CWgpi‖Initial View

Initial View

Name

Description

Type

Default Value

InitialView

fTBNo‖Specifies how the PDF document should be displayed when opened. Possible values are:

SGrec‖0: Select the default viewer mode, neither outlines nor thumbnails.

LGTNj‖1: The document is opened with outline pane opened

fDgWG‖2: The document is opened with thumbnail pane opened

long

0

InitialPage

AoAbp‖Specifies the page on which a PDF document should be opened in the viewer application.

long

1

Magnification

AjfVJ‖Specifies the action to be performed when the PDF document is opened. Possible values are:

iXS9W‖0: Opens with default zoom magnification.

uAWjD‖1: Opens magnified to fit the entire page within the window.

7GXcL‖2: Opens magnified to fit the entire page width within the window.

yMJXs‖3: Opens magnified to fit the entire width of its bounding box within the window (cuts out margins).

aFHWi‖4: Opens with the zoom level specified in the Zoom property.

long

0

Zoom

SdrKA‖Specifies the zoom level a PDF document is opened with. Only valid if Magnification is set to "4".

long

100

PageLayout

Rs82T‖Specifies the page layout to be used when the document is opened. Possible values are:

Fj5yP‖0: Display the pages according to the reader configuration.

uLGJr‖1: Display one page at a time.

udbpj‖2: Display the pages in one column.

VeRT9‖3: Display the pages in two columns odd pages on the right, to have the odd pages on the left the FirstPageOnLeft property should be used as well.

long

0

FirstPageOnLeft

WQh3Z‖Used with the value 3 of the PageLayout property above, true if the first page (odd) should be on the left side of the screen.

boolean

false


vhDQj‖User Interface

User Interface

Name

Description

Type

Default Value

ResizeWindowToInitialPage

nyGzt‖Specifies that the PDF viewer window is opened showing whole initial page when the document is opened.

boolean

false

CenterWindow

rRaEB‖Specifies that the PDF viewer window is centered to the screen when the PDF document is opened.

boolean

false

OpenInFullScreenMode

eVWiN‖Specifies that the PDF viewer window is opened full screen, on top of all windows.

boolean

false

DisplayPDFDocumentTitle

iBGa3‖Specifies that the title of the document, if present in the document properties, is displayed in the PDF viewer window title bar.

boolean

true

HideViewerMenubar

YQa5f‖Specifies whether to hide the PDF viewer menubar when the document is active.

boolean

false

HideViewerToolbar

JkbDc‖Specifies whether to hide the PDF viewer toolbar when the document is active.

boolean

false

HideViewerWindowControls

CtDon‖Specifies whether to hide the PDF viewer controls when the document is active.

boolean

false

UseTransitionEffects

8NGRD‖Specifies slide transitions are exported to PDF. This option is active only if storing Impress documents.

boolean

true

OpenBookmarkLevels

HjEG9‖Specifies how many bookmark levels should be opened in the reader application when the PDF gets opened. Possible values are:

MugGi‖-1: all bookmark levels are opened

QD5o2‖1–10: indicate a bookmark level (from 1 to 10)

long

-1


9Vni2‖Links

Links

Name

Description

Type

Default Value

ExportBookmarksToPDFDestination

PLqRL‖Specifies that the bookmarks contained in the source LibreOfficeDev file should be exported to the PDF file as Named Destination.

boolean

false

ConvertOOoTargetToPDFTarget

3WvUa‖Specifies that the target documents with .od[tpgs] extension, will have that extension changed to .pdf when the link is exported to PDF. The source document remains untouched.

boolean

false

ExportLinksRelativeFsys

gBKQg‖Specifies that the file system related hyperlinks (file:// protocol) present in the document will be exported as relative to the source document location.

boolean

false

PDFViewSelection

z96J8‖Specifies the way the exported PDF will be viewed (experienced) by the user. Possible values are:

jBFzq‖0: Specifies that the PDF will be exported with all the links external to the document treated as URI. This is the Default

6GKvK‖1: Specifies that the PDF will be exported in order to be viewed through a PDF reader application only. Valid only if not exporting to PDF/A-1 (e.g. SelectPdfVersion not set to 1).

ECcRs‖2: Specifies that the PDF will be exported in order to be viewed through an Internet browser, using the PDF plug-in provided with it. The bookmark of the URI will be rendered compatible with the target bookmark generated with LibreOfficeDev PDF Export feature (see ExportBookmarksToPDFDestination).

long

0


kxDNY‖Security

Security

Name

Description

Type

Default Value

EncryptFile

QrCmH‖If true, selects to encrypt the PDF document with a password. The PDF file can be opened only when the user enters the correct password.

boolean

false

DocumentOpenPassword

AviDp‖This is the password that allows the user to open the PDF file when EncryptFile is set to true.

string

RestrictPermissions

hEmrg‖If true, selects to restrict some permissions. The permissions can be changed only when the user enters the correct password.

boolean

false

PermissionPassword

AYGFc‖This is the password that allows the user to access some permissions restricted if RestrictPermissions is set to true.

string

PreparedPasswords

PreparedPermissionPassword

string

Printing

rnFXH‖Specifies what printing is allowed. Possible values are:

ihQew‖0: The document cannot be printed.

R67Dw‖1: The document can be printed at low resolution only.

hhBsT‖2: The document can be printed at maximum resolution.

long

2

Changes

NLwwg‖Specifies the changes that can be made to the document. Possible values are:

z8ghG‖0: The document cannot be changed.

LHS7W‖1: Inserting deleting and rotating pages is allowed.

yrEBR‖2: Filling of form field is allowed.

w5Cru‖3: Both filling of form field and commenting is allowed.

f4Bwv‖4: All the changes of the previous selections are permitted, with the only exclusion of page extraction (copy).

long

4

EnableCopyingOfContent

pum6c‖Specifies that the pages and the document content can be extracted to be used in other documents (copy and paste).

boolean

true

EnableTextAccessForAccessibilityTools

DX8NT‖Specifies that the document content can be extracted to be used in accessibility applications.

boolean

true


MbaEt‖Digital Signature

Digital Signatures

Name

Description

Type

Default Value

SignPDF

GUMxB‖If true, sign the PDF.

boolean

false

SignatureLocation

wVBSA‖Additional information about the digital signature, location of the signatory.

string

SignatureReason

CHHzr‖Additional information about the digital signature, reason for signature.

string

SignatureContactInfo

icBzP‖Additional information about the digital signature, signatory contact information.

string

SignaturePassword

E7ePZ‖Certificate password

string

SignatureCertificate

SignCertificateSubjectName

string

SignatureTSA

U5tZD‖During the PDF signing process, the timestamp authority URL will be used to obtain a digitally signed timestamp that is then embedded in the signature.

string