Contenuto

# Parametri della riga di comando per l'esportazione PDF

Il filtro PDF accetta una stringa di opzioni che contengono le proprietà PDF per l'esportazione.

## Esempi:

#### Prompt dei comandi di Windows CMD

Le virgolette doppie nella stringa dei parametri devono essere precedute dal carattere di escape (\").

Per esportare le pagine da 2 a 5 di un documento Writer:

"C:\Program Files\LibreOffice\program\soffice" --convert-to pdf:writer_pdf_Export:{\"PageRange\":{\"type\":\"string\",\"value\":\"2-5\"}} --outdir C:\Users\myuser\Documents C:\Users\myuser\Documents\myfile.odt

Per aggiungere una filigrana affiancata:

"C:\Program Files\LibreOffice\program\soffice" --convert-to pdf:draw_pdf_Export:{\"TiledWatermark\":{\"type\":\"string\",\"value\":\"draft\"}} C:\Users\myuser\Documents\test.odg

Per cifrare un file:

"C:\Program Files\LibreOffice\program\soffice" --convert-to pdf:draw_pdf_Export:{\"EncryptFile\":{\"type\":\"boolean\",\"value\":\"true\"},\"DocumentOpenPassword\":{\"type\":\"string\",\"value\":\"secret\"}} test.odg

Per impostare la versione 1.5 (anziché quella predefinita, la 1.7):

"C:\Program Files\LibreOffice\program\soffice" --convert-to pdf:draw_pdf_Export:{\"SelectPdfVersion\":{\"type\":\"long\",\"value\":\"15\"}} test.odg

#### PowerShell di Windows

La stringa dei parametri deve essere racchiusa tra virgolette singole per permettere l'analisi delle virgolette doppie. Il carattere & (E commerciale) è noto come operatore di chiamata. Viene utilizzato per eseguire un comando, un blocco di script o una funzione memorizzata in una variabile o in una stringa.

Per esportare le pagine da 2 a 5 di un documento Writer:

& 'C:\Program Files\LibreOffice\program\soffice' --convert-to 'pdf:writer_pdf_Export:{"PageRange":{"type":"string","value":"2-5"}}' --outdir C:\Users\myuser\Documents C:\Users\myuser\Documents\myfile.odt

Per aggiungere una filigrana affiancata:

& 'C:\Program Files\LibreOffice\program\soffice' --convert-to 'pdf:draw_pdf_Export:{"TiledWatermark":{"type":"string","value":"draft"}}' test.odg

Per cifrare un file:

& 'C:\Program Files\LibreOffice\program\soffice' --convert-to 'pdf:draw_pdf_Export:{"EncryptFile":{"type":"boolean","value":"true"},"DocumentOpenPassword":{"type":"string","value":"secret"}}' test.odg

Per impostare la versione 1.5 (anziché quella predefinita, la 1.7):

& 'C:\Program Files\LibreOffice\program\soffice' --convert-to 'pdf:draw_pdf_Export:{"SelectPdfVersion":{"type":"long","value":"15"}}' test.odg

#### Linux (BASH) e MacOS (ZSH)

Per esportare le pagine da 2 a 5 di un documento Writer:

soffice --convert-to 'pdf:writer_pdf_Export:{"PageRange":{"type":"string","value":"2-5"}}' --outdir /home/mioutente miofile.odt

Per aggiungere una filigrana affiancata:

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

Per cifrare un file:

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

Per impostare la versione 1.5 (anziché quella predefinita, la 1.7):

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

## Indice

Proprietà generali

Visualizzazione iniziale

Interfaccia utente

Collegamenti

Sicurezza

Firma digitale

## Proprietà generali

Generale

Nome | Descrizione | Tipo | Valore predefinito
--- | --- | --- | ---
PageRange | Se questa proprietà è impostata, indica l'intervallo di pagine da esportare. Per esportare tutte le pagine, non impostare questa proprietà. Per esportare una selezione, non impostare questa proprietà e impostare soltanto la proprietà Selezione. | string | Vuota (tutte le pagine vengono esportate)
Selection | Una qualsiasi corrispondente alla selezione attiva nel documento. | Any |
UseLosslessCompression | Specifica se le immagini vengono esportate in PDF utilizzando un formato di compressione senza perdita di dati, tipo PNG, o compresso utilizzando il formato JPEG. | boolean | false

Quality

Specifica la qualità dell'esportazione JPG. Un valore più alto produrrà un'immagine di qualità più alta e un file di dimensioni maggiori.

Valore inclusivo minimo: 1. Rappresenta il valore più basso utilizzabile. Un valore inferiore produrrà un'immagine di qualità più scarsa e un file di dimensioni minori.

Valore inclusivo massimo: 100. Rappresenta il valore più alto utilizzabile. Un valore superiore produrrà un'immagine di qualità migliore e un file di dimensioni maggiori.

long

90

ReduceImageResolution | Stabilisce se la risoluzione di ciascuna immagine debba essere ridotta alla risoluzione specificata nella proprietà MaxImageResolution. | boolean | false
MaxImageResolution | Se la proprietà ReduceImageResolution è impostata a «true», tutte le immagini saranno ridotte al valore espresso in DPI. I valori possibili sono: 75, 150, 300, 600 e 1200. | long | 300
SelectPdfVersion | Specifica la versione PDF da generare. I valori possibili sono: 0: PDF 1.7 (scelta predefinita). 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 | Crea un file PDF accessibile che rispetta le specifiche del formato PDF/UA (ISO 14289). | boolean | false
UseTaggedPDF | Determina se i file PDF debbano essere creati utilizzando gli speciali tag per l'accesso facilitato. | boolean | false
ExportFormFields | Stabilisce se i campi del formulario debbano essere esportati come widget o solamente come loro corrispondente rappresentazione stampata fissa. | boolean | true
FormsType | Specifica il formato di invio di un formulario PDF. I valori possibili sono: 0: specifica l'uso del tipo di formulario FDF. 1: specifica l'uso del tipo di formulario PDF. 2: specifica l'uso del tipo di formulario HTML. 3: specifica l'uso del tipo di formulario XML. | long | 0
AllowDuplicateFieldNames | Stabilisce se è possibile esportare più campi del formulario mantenendo lo stesso nome di campo. | boolean | false
ExportBookmarks | Specifica se i segnalibri debbano essere esportati nel PDF. | boolean | true
ExportPlaceholders | Esporta solo i marcatori visivi dei campi segnaposto. Il segnaposto esportato non è utilizzabile. | boolean | false
ExportNotes | Specifica se le note debbano essere esportate nel PDF. | boolean | false
ExportNotesPages | Specifica se le pagine delle note debbano essere esportate nel PDF (esse sono disponibili solo nei documenti Impress). | boolean | false
ExportOnlyNotesPages | Se la proprietà ExportNotesPages è impostata a «true», specifica se debbano esportate nel PDF solo le pagine delle note. | boolean | false
ExportNotesInMargin | Specifica se le note a margine debbano essere esportate nel PDF. | boolean | false
ExportHiddenSlides | Per LibreOffice Impress, esporta le diapositive non incluse nelle presentazioni. | boolean | false
IsSkipEmptyPages | Consente di escludere le pagine vuote inserite automaticamente. Questa opzione è attiva solo se si stanno archiviando documenti Writer. | boolean | false
EmbedStandardFonts | Specifica si debbano incorporare o no i tipi di carattere PDF standard da 14 pollici. | boolean | false
IsAddStream | Consente di inserire nel file PDF un flusso contenente il documento originale a scopo di archiviazione. | boolean | false
Watermark | Specifica il testo della filigrana da riprodurre su ciascuna pagina del file PDF esportato. | string | (empty)
WatermarkColor | Specifica il colore del testo della filigrana. | long | 8388223 (light green)
WatermarkFontHeight | Specifica l'altezza del carattere del testo della filigrana. | long |
WatermarkRotateAngle | Specifica l'angolo del testo della filigrana. | long |
WatermarkFontName | Specifica il nome del carattere del testo della filigrana. | string | Helvetica
TiledWatermark | Specifica il testo della filigrana ripetuta. | string |
UseReferenceXObject | Quando questa opzione è attiva, viene utilizzato il markup XObject di riferimento: si tratta di un'operazione semplice, ma per mostrare immagini vettoriali, i visori devono supportare questo markup. In caso contrario, nel visore verrà mostrata un'immagine bitmap sostitutiva. | boolean | false
IsRedactMode |  | boolean | false
SinglePageSheets | Ignora la dimensione di ogni foglio di carta, le aree di stampa e lo stato mostrato/nascosto, e inserisce ogni foglio (anche quelli nascosti) esattamente su una pagina. | boolean | false

## Visualizzazione iniziale

Visualizzazione iniziale

Nome | Descrizione | Tipo | Valore predefinito
--- | --- | --- | ---
InitialView | Specifica come debba essere visualizzato il documento PDF una volta aperto. I valori possibili sono: 0: seleziona la modalità di visualizzazione predefinita, senza struttura né miniature. 1: il documento è aperto con il pannello della struttura aperto 2: il documento è aperto con il pannello delle miniature aperto | long | 0
InitialPage | Specifica il numero di pagina da aprire del documento PDF, all'interno dell'applicazione di visualizzazione. | long | 1

Magnification

Specifica l'azione da eseguire quando viene aperto il documento PDF. I valori possibili sono:

0: si apre con l'ingrandimento predefinito.

1: si apre con l'ingrandimento per adattarsi all'intera pagina nella finestra.

2: si apre con l'ingrandimento per adattarsi all'intera larghezza della pagina nella finestra.

3: si apre con l'ingrandimento per adattare la larghezza intera del riquadro di delimitazione all'interno della finestra (ritaglia i margini).

4: apre col livello di ingrandimento specificato nella proprietà Zoom.

long

0

Zoom | Specifica il livello di ingrandimento con cui un documento PDF è aperto. Valido solo se Ingrandimento è impostato al valore "4". | long | 100

PageLayout

Specifica l'impaginazione da utilizzare quando viene aperto il documento. I valori possibili sono:

0: mostra le pagine in base alla configurazione del lettore.

1: mostra una pagina alla volta.

2: mostra le pagine in una colonna.

3: mostra le pagine disposte su due colonne, con le pagine dispari a destra; per visualizzarle a sinistra deve essere utilizzata anche la proprietà FirstPageOnLeft.

long

0

FirstPageOnLeft | Utilizzato col valore 3 della proprietà PageLayout, di cui sopra, deve essere «true» se si vuole che la prima pagina (dispari) sia posizionata sul lato sinistro dello schermo. | boolean | false

## Interfaccia utente

Interfaccia utente

Nome | Descrizione | Tipo | Valore predefinito
--- | --- | --- | ---
ResizeWindowToInitialPage | Specifica che la finestra del visualizzatore PDF sia impostata per mostrare la pagina iniziale per intero all'apertura del documento. | boolean | false
CenterWindow | Specifica che la finestra del visore PDF sia centrata nello schermo all'apertura del documento PDF. | boolean | false
OpenInFullScreenMode | Specifica che la finestra del visore PDF sia aperta a schermo intero, sopra tutte le altre finestre. | boolean | false
DisplayPDFDocumentTitle | Specifica che il titolo del documento, se presente nelle proprietà del documento, sia mostrato nella barra del titolo della finestra del visore PDF. | boolean | true
HideViewerMenubar | Specifica se la barra dei menu del visore PDF debba essere nascosta quando il documento è attivo. | boolean | false
HideViewerToolbar | Specifica se la barra degli strumenti del visore PDF debba essere nascosta quando il documento è attivo. | boolean | false
HideViewerWindowControls | Specifica se i controlli del visore PDF debbano essere nascosti quando il documento è attivo. | boolean | false
UseTransitionEffects | Specifica che siano esportate in PDF le transizioni tra diapositive. Questa opzione è attiva solo se si stanno archiviando documenti Impress. | boolean | true
OpenBookmarkLevels | Specifica quanti livelli di segnalibri debbano essere aperti nel programma di lettura quando viene aperto il PDF. I valori possibili sono: -1: sono aperti tutti i livelli di segnalibro 1–10: indica un livello di segnalibro (da 1 a 10) | long | -1

## Collegamenti

Collegamenti

Nome | Descrizione | Tipo | Valore predefinito
--- | --- | --- | ---
ExportBookmarksToPDFDestination | Stabilisce che i segnalibri contenuti nel file LibreOffice di origine vengano esportati nel file PDF come destinazioni denominate. | boolean | false
ConvertOOoTargetToPDFTarget | Specifica che i documenti di destinazione con estensione .od[tpgs] cambino la propria estensione in .pdf, quando il collegamento viene esportato in PDF. Il documento di origine non viene modificato. | boolean | false
ExportLinksRelativeFsys | Specifica che i collegamenti ipertestuali relativi al file system (protocollo file://) presenti nel documento vengano esportati come relativi alla posizione nel documento di origine. | boolean | false

PDFViewSelection

Specifica il modo in cui il PDF esportato sarà visualizzato dall'utente. I valori possibili sono:

0: specifica che il PDF sarà esportato con tutti i collegamenti esterni al documento che saranno trattati come URI. Questo è il metodo predefinito.

1: specifica che il PDF sarà esportato per essere visualizzato solamente con un'applicazione di lettura PDF. Valido solo se non si esporta in PDF/A-1 (per es. SelectPdfVersion non è impostato a 1).

2: specifica che il PDF sarà esportato per essere visualizzato tramite un browser Internet, utilizzando il componente aggiuntivo PDF già incluso. Il segnalibro dell'URI sarà reso compatibile col segnalibro di destinazione generato con la funzione Esportazione PDF di LibreOffice (consultare ExportBookmarksToPDFDestination).

long

0

## Sicurezza

Sicurezza

Nome | Descrizione | Tipo | Valore predefinito
--- | --- | --- | ---
EncryptFile | Se «true», seleziona per cifrare il documento PDF con una password. Il file PDF può essere aperto solo quando l'utente digita la password corretta. | boolean | false
DocumentOpenPassword | Questa è la password che permette all'utente di aprire il file PDF quando EncryptFile è impostato a «true». | string |
RestrictPermissions | Se «true», seleziona per limitare alcuni permessi. I permessi sono modificabili solo quando l'utente digita la password corretta. | boolean | false
PermissionPassword | Questa è la password che permette all'utente di accedere ad alcuni permessi limitati se RestrictPermissions è impostato a «true». | string |
PreparedPasswords |  |  |
PreparedPermissionPassword |  | string |
Printing | Specifica che tipo di stampa è consentita. I valori possibili sono: 0: il documento non può essere stampato. 1: il documento può essere stampato solo a bassa risoluzione. 2: il documento può essere stampato alla massima risoluzione. | long | 2

Changes

Specifica le modifiche applicabili al documento. I valori possibili sono:

0: il documento non può essere modificato.

1: è permesso l'inserimento, l'eliminazione e la rotazione delle pagine.

2: è permessa la compilazione dei campi formulario.

3: è permessa la compilazione dei campi formulario e l'inserimento dei commenti.

4: sono permesse tutte le modifiche delle selezioni precedenti, con la sola esclusione dell'estrazione delle pagine (copia).

long

4

EnableCopyingOfContent | Specifica che le pagine e il contenuto del documento possono essere estratti per essere utilizzati in altri documenti (copia e incolla). | boolean | true
EnableTextAccessForAccessibilityTools | Specifica che il contenuto del documento può essere estratto per essere utilizzato nelle applicazioni di accesso facilitato. | boolean | true

## Firma digitale

Firme digitali

Nome | Descrizione | Tipo | Valore predefinito
--- | --- | --- | ---
SignPDF | Se «true», firma il PDF. | boolean | false
SignatureLocation | Informazioni aggiuntive sulla firma digitale, posizione del firmatario. | string |
SignatureReason | Informazioni aggiuntive sulla firma digitale, motivo della firma. | string |
SignatureContactInfo | Informazioni aggiuntive sulla firma digitale, informazioni di contatto del firmatario. | string |
SignaturePassword | Password certificato | string |
SignatureCertificate |  |  |
SignCertificateSubjectName |  | string |
SignatureTSA | Durante il processo di firma del PDF, verrà utilizzato l'URl dell'autorità di marcatura temporale per ottenere la data e l'ora firmate digitalmente che verranno poi incorporate nella firma. | string |

Sostienici!