Parâmetros de linha de comando para PDF

Sumário

# Parâmetros de linha de comando para exportação PDF

O filtro PDF aceita uma string de opções contendo propriedades PDF para exportação.

## Exemplos:

#### Prompt de comando CMD do Windows

As aspas duplas na string do parâmetro devem ser escapadas (\").

Para exportar as páginas 2 a 5 de um documento do 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

Para adicionar uma marca d'água em mosaico:

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

Para criptografar um arquivo:

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

Para definir a versão 1.5 (em vez da versão padrão 1.7):

"C:\Arquivos de programas\LibreOffice\program\soffice" --convert-to pdf:draw_pdf_Export:{\"SelectPdfVersion\":{\"type\":\"long\",\"value\":\"15\"}} teste.odg

#### Windows PowerShell

A string do parâmetro deve ser colocada entre aspas simples para permitir a análise das aspas duplas. O caractere e comercial (&) é conhecido como operador de chamada. Ele é usado para executar um comando, bloco de script ou função armazenada em uma variável ou string.

Para exportar as páginas 2 a 5 de um documento do 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

Para adicionar uma marca d'água em mosaico:

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

Para criptografar um arquivo:

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

Para definir a versão 1.5 (em vez da versão padrão 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)

Para exportar as páginas 2 a 5 de um documento do Writer:

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

Para adicionar uma marca d'água em mosaico:

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

Para criptografar um arquivo:

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

Para definir a versão 1.5 (em vez da versão padrão 1.7):

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

## Índice

Propriedades gerais

Visualização inicial

Interface do usuário

Vínculos

Segurança

Assinatura digital

## Propriedades gerais

Geral

Nome | Descrição | Tipo | Valor padrão
--- | --- | --- | ---
PageRange | Quando definida, indica o intervalo de páginas a exportar. Para exportar todas as páginas, deixe esta propriedade indefinida. Para exportar uma seleção, deixe esta propriedade em branco e defina somente a propriedade Selection. | string | Vazio (todas as páginas são exportadas)
Selection | Um any correspondendo à seleção atual no documento. | Any |
UseLosslessCompression | Especifica se as figuras são exportadas para PDF usando um formato com compressão sem perdas, por exemplo PNG, ou comprimidas usando o formato JPEG. | boolean | false
Quality | Especifica a qualidade da exportação JPG. Um valor mais alto produz uma imagem de maior qualidade e um arquivo maior. Valor mínimo inclusivo: 1. Representa o menor valor que pode ser utilizado. Quanto menor o valor, pior a qualidade da imagem e menor o tamanho do arquivo. Valor máximo inclusivo: 100. Representa o maior valor que pode ser utilizado. Quanto maior o valor, melhor a qualidade da imagem e maior o tamanho do arquivo. | long | 90
ReduceImageResolution | Especifica se a resolução de cada imagem é reduzida para a resolução especificada pela propriedade MaxImageResolution. | boolean | false
MaxImageResolution | Se a propriedade ReduceImageResolution for definida como true, todas as imagens serão reduzidas ao valor fornecido em PPI. Os valores possíveis são: 75, 150, 300, 600 e 1200. | long | 300
SelectPdfVersion | Especifica a versão do PDF a emitir. Os valores possíveis são: 0: PDF 1.7 (valor padrão). 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 | Cria um arquivo PDF acessível que atende os requisitos das especificações PDF/UA (ISO 14289). | boolean | false
UseTaggedPDF | Determina se os PDFs são criados utilizando tags de acessibilidade especiais. | boolean | false
ExportFormFields | Especifica se os campos de formulário são exportados como widgets ou exporta apenas sua representação de impressão fixa. | boolean | true
FormsType | Especifica o formato de envio de um formulário PDF. Valores possíveis: 0: Especifica formulários do tipo FDF. 1: Especifica formulários do tipo PDF. 2: Especifica formulários do tipo HTML. 3: Especifica formulários do tipo XML. | long | 0
AllowDuplicateFieldNames | Especifica se vários campos de formulário exportados podem ter o mesmo nome de campo. | boolean | false
ExportBookmarks | Especifica se os marca-páginas são exportados para PDF. | boolean | true
ExportPlaceholders | Exporta somente as marcações visuais dos espaços reservados. Os espaços reservados exportados não são ativos. | boolean | false
ExportNotes | Especifica se as notas são exportadas para PDF. | boolean | false
ExportNotesPages | Especifica se as páginas de notas são exportadas para PDF. (As páginas de notas estão disponíveis apenas em documentos Impress). | boolean | false
ExportOnlyNotesPages | Se a propriedade ExportNotesPages for definida como true, especifica se apenas as páginas de notas são exportadas para PDF. | boolean | false
ExportNotesInMargin | Especifica se as notas na margem são exportadas para PDF. | boolean | false
ExportHiddenSlides | Para o LibreOffice Impress, exporta os slides não incluídos na apresentação de slides. | boolean | false
IsSkipEmptyPages | Especifica que as páginas vazias inseridas automaticamente são suprimidas. Esta opção está ativa somente se estiver armazenando documentos do Writer. | boolean | false
EmbedStandardFonts | Especifica se as 14 fontes PDF padrão devem ser incorporadas ou não. | boolean | false
IsAddStream | Especifica que um fluxo é inserido no arquivo PDF que contém o documento original para fins de arquivamento. | boolean | false
Watermark | Especifica o texto para uma marca d'água a ser desenhada em cada página do arquivo PDF exportado. | string | (empty)
WatermarkColor | Especifica a cor do texto da marca d'água. | long | 8388223 (light green)
WatermarkFontHeight | Especifica o tamanho da fonte da marca d'água. | long |
WatermarkRotateAngle | Especifica o ângulo do texto da marca d'água. | long |
WatermarkFontName | Especifica o nome da fonte da marca d'água. | string | Helvetica
TiledWatermark | Especifica o texto da marca d'água em mosaico. | string |
UseReferenceXObject | Quando a opção está habilitada, usa a marcação do XObject de referência: é uma operação simples, mas os visualizadores devem oferecer suporte a essa marcação para mostrar as imagens vetoriais. Caso contrário, mostra um bitmap substituto no visualizador. | boolean | false
IsRedactMode |  | boolean | false
SinglePageSheets | Ignora o tamanho do papel de cada folha, os intervalos de impressão e o status exibido/oculto e coloca cada folha (mesmo as ocultas) em exatamente uma página. | boolean | false

## Visualização inicial

Visualização inicial

Nome | Descrição | Tipo | Valor padrão
--- | --- | --- | ---
InitialView | Especifica como o documento PDF deve ser exibido quando aberto. Valores possíveis: 0: Modo de visualização padrão, sem tópicos ou miniaturas. 1: Abre o documento com a janela de tópicos aberta. 2: Abre o documento com a janela de miniaturas aberta. | long | 0
InitialPage | Especifica a página na qual um documento PDF deve ser aberto no aplicativo visualizador. | long | 1
Magnification | Especifica a ação a executar quando o documento PDF for aberto. Valores possíveis: 0: Abre com ampliação de zoom padrão. 1: Abre com ampliação para caber a página inteira dentro da janela. 2: Abre com ampliação para caber a largura inteira da página dentro da janela. 3: Abre com ampliação de zoom para caber a largura inteira nos limites da janela (corta as margens). 4: Abre com ampliação de zoom especificada na propriedade Zoom. | long | 0
Zoom | Especifica o nível de zoom para abrir um documento PDF. Válido apenas se Magnification for definido como "4". | long | 100
PageLayout | Especifica o leiaute da página ao abrir o documento. Valores possíveis: 0: Exibe as páginas de acordo com a configuração do leitor. 1: Exibe uma página por vez. 2: Exibe as página em uma coluna. 3: Exibe as páginas em duas colunas páginas ímpares à direita, para ter as páginas ímpares à esquerda a propriedade FirstPageOnLeft também deve ser usada. | long | 0
FirstPageOnLeft | Usado com o valor 3 da propriedade PageLayout acima, verdadeiro se a primeira página (ímpar) deve estar no lado esquerdo da tela. | boolean | false

## Interface do usuário

Interface do usuário

Nome | Descrição | Tipo | Valor padrão
--- | --- | --- | ---
ResizeWindowToInitialPage | Especifica para abrir a janela do visualizador de PDF mostrando a página inicial inteira ao abrir o documento. | boolean | false
CenterWindow | Especifica para abrir a janela do visualizador de PDF centralizada na tela ao abrir o documento. | boolean | false
OpenInFullScreenMode | Especifica para abrir a janela do visualizador de PDF em tela inteira, em cima de todas as janelas. | boolean | false
DisplayPDFDocumentTitle | Especifica que o título do documento, se presente nas propriedades do documento, seja exibido na barra de título da janela do visualizador de PDF. | boolean | true
HideViewerMenubar | Especifica se a barra de menu do visualizador de PDF deve ser ocultada quando o documento está ativo. | boolean | false
HideViewerToolbar | Especifica se a barra de ferramentas do visualizador de PDF deve ser ocultada quando o documento está ativo. | boolean | false
HideViewerWindowControls | Especifica se os controles do visualizador de PDF devem ser ocultados quando o documento está ativo. | boolean | false
UseTransitionEffects | Especifica que as transições de slides são exportadas para PDF. Esta opção está ativa somente se estiver armazenando documentos do Impress. | boolean | true
OpenBookmarkLevels | Especifica quantos níveis de marca-páginas devem ser abertos no aplicativo de leitura ao abrir o PDF. Valores possíveis: -1: abrir todos os níveis de marca-páginas 1 – 10: indica um nível de marca-página (de 1 a 10) | long | -1

## Vínculos

Vínculos

Nome | Descrição | Tipo | Valor padrão
--- | --- | --- | ---
ExportBookmarksToPDFDestination | Especifica que os marca-páginas contidos no arquivo LibreOffice de origem devem ser exportados para o arquivo PDF como Destino nomeado. | boolean | false
ConvertOOoTargetToPDFTarget | Especifica que os documentos de destino com extensão .od[tpgs] terão essa extensão alterada para .pdf quando o link for exportado para PDF. O documento de origem permanece intocado. | boolean | false
ExportLinksRelativeFsys | Especifica que os hiperlinks relacionados ao sistema de arquivos (protocolo file://) presentes no documento serão exportados como relativos ao local do documento de origem. | boolean | false
PDFViewSelection | Especifica a forma como o PDF exportado será visualizado (experimentado) pelo usuário. Valores possíveis: 0: Especifica que o PDF será exportado com todos os links externos ao documento tratados como URI. Este é o padrão 1: Especifica que o PDF será exportado para ser visualizado apenas por meio de um aplicativo de leitura de PDF. Válido somente se não estiver exportando para PDF/A-1 (por exemplo, SelectPdfVersion não definido como 1). 2: Especifica que o PDF será exportado para ser visualizado por meio de um navegador da Internet, usando o plug-in PDF fornecido com ele. O marca-página do URI será compatível com o marca-página de destino gerado com o recurso de exportação de PDF do LibreOffice (consulte ExportBookmarksToPDFDestination). 3: Especifica que o documento será exportado para PDF sem incluir links externos. | long | 0

## Segurança

Segurança

Nome | Descrição | Tipo | Valor padrão
--- | --- | --- | ---
EncryptFile | Se verdadeiro (true), criptografa o documento PDF com uma senha. O arquivo PDF pode ser aberto somente quando o usuário digitar a senha correta. | boolean | false
DocumentOpenPassword | Senha que permite ao usuário abrir o arquivo PDF quando EncryptFile for true. | string |
RestrictPermissions | Se verdadeiro (true), seleciona para restringir algumas permissões. As permissões podem ser alteradas apenas quando o usuário inserir a senha correta. | boolean | false
PermissionPassword | Senha que permite ao usuário acessar algumas permissões restritas se RestrictPermissions for definido como true. | string |
PreparedPasswords |  |  |
PreparedPermissionPassword |  | string |
Printing | Especifica que tipo de impressão é permitida. Valores possíveis: 0: O documento não pode ser impresso. 1: O documento pode ser impresso somente em baixa resolução. 2: O documento pode ser impresso na resolução máxima. | long | 2
Changes | Especifica as alterações permitidas no documento. Valores possíveis: 0: O documento não pode ser modificado. 1: Inserção, exclusão e rotação de páginas são permitidas. 2: Permitido o preenchimento de campos do formulário. 3: Preenchimento de campos e comentários ambos permitidos. 4: São permitidas todas as alterações das seleções anteriores, com exceção apenas da extração de página (cópia). | long | 4
EnableCopyingOfContent | Especifica que as páginas e o conteúdo do documento podem ser extraídos para serem usados em outros documentos (copiar e colar). | boolean | true
EnableTextAccessForAccessibilityTools | Especifica que o conteúdo do documento pode ser extraído para ser usado em aplicativos de acessibilidade. | boolean | true

## Assinatura digital

Assinaturas digitais

Nome | Descrição | Tipo | Valor padrão
--- | --- | --- | ---
SignPDF | Se true, assina o documento PDF. | boolean | false
SignatureLocation | Informações adicionais sobre a assinatura digital, localização do signatário. | string |
SignatureReason | Informações adicionais sobre a assinatura digital, razão da assinatura. | string |
SignatureContactInfo | Informações adicionais sobre a assinatura digital, informação de contato do signatário. | string |
SignaturePassword | Senha do certificado | string |
SignatureCertificate |  |  |
SignCertificateSubjectName |  | string |
SignatureTSA | Durante o processo de assinatura do PDF, o URL da autoridade do carimbo de tempo será usado para obter um carimbo de tempo assinado digitalmente que será incorporado à assinatura. | string |

♥ Doe para nosso projeto! ♥