Provided by: pdf2djvu_0.9.18.2-2build6_amd64 
NOME
pdf2djvu - cria ficheiros DjVu a partir de ficheiros PDF
SINOPSE
pdf2djvu [{-o | --output} ficheiro-djvu-resultante] [opção...] ficheiro-pdf...
pdf2djvu {-i | --indirect} ficheiro-djvu-índice [opção...] ficheiro-pdf...
pdf2djvu {--version | --help | -h}
DESCRIÇÃO
Este programa cria um ficheiro DjVu a partir de um ou mais ficheiros Portable Document
Format.
OPÇÕES
pdf2djvu aceita as seguintes opções:
Tipo de documento, nome de ficheiros
-o, --output=ficheiro-djvu-resultante
Gera um documento agrupado de várias páginas. Escreve o ficheiro em
ficheiro-djvu-resultante em vez de o fazer na saída standard.
-i, --indirect=ficheiro-djvu-índice
Gera um documento de várias páginas indirecto. Use ficheiro-djvu-índice como o nome do
ficheiro do índice; ponha os ficheiros dos componentes no mesmo directório. O
directório tem de existir e ser passível de escrita.
--page-id-template=modelo
Especifica o esquema de nomeação para os identificadores das páginas. Consulte a
secção “SINTAXE DE LINGUAGEM” para a descrição da linguagem do modelo.
O modelo predefinido é “p{page:04*}.djvu”.
Por razões de portabilidade, os identificadores de páginas:
• devem consistir apenas de letras ASCII minúsculas, dígitos, _, +, - e ponto,
• não podem começar com um +, - ou um ponto,
• não podem conter dois pontos consecutivos.
• têm de terminar com a extensão .djvu ou .djv.
--page-id-prefix=prefixo
Equivalente a “--page-id-template=prefixo{page:04*}.djvu”.
--page-title-template=modelo
Especifica o modelo para os títulos das páginas. Consulte a secção “SINTAXE DE
LINGUAGEM” para a descrição da linguagem do modelo.
O modelo predefinido é “{label}”.
--no-page-titles
Não define títulos das páginas.
Resolução, tamanho da página
-d, --dpi=resolução
Especifica a resolução desejada para resolução em pontos por polegada. A predefinição
é 300 dpi. Os limites permitidos são 72 ≤ resolução ≤ 6000.
--media-box
Use MediaBox para determinar o tamanho da página. Por predefinição é usado CropBox.
--page-size=larguraxaltura
Especifica o tamanho de página preferido para largura pixeis × altura pixeis. O
tamanho de pagina real pode ser alterado de modo a respeitar o rácio de aspecto e as
limitações do DjVu em resolução. (Esta opção toma precedência sobre -d/--dpi.)
--guess-dpi
Tenta adivinhar a resolução nativa ao inspeccionar as imagens embebidas. Use com
cuidado.
Qualidade de imagem
--bg-slices=n+...+n, --bg-slices=n,...,n
Especifica a qualidade de codificação da camada de fundo IW44. Esta opção é semelhante
à opção -slice do c44. Consulte o manual do c44(1) para detalhes. A predefinição é
72+11+10+10.
--bg-subsample=n
Especifica o rácio de sub-amostragem do fundo. A predefinição é 3. Os valores válidos
são números inteiros entre 1 e 12, inclusive.
--fg-colors=default
Tenta preservar todas as cores da camada de fundo. Isto é a predefinição.
--fg-colors=web
Reduz as cores da camada de fundo para a palete web (256 cores). Esta opção não é
recomendada.
--fg-colors=n
Usa o GraphicsMagick para reduzir o número de cores distintas na camada do primeiro
plano para n. Os valores válidos são números inteiros entre 1 e 4080. Esta opção não é
recomendada.
--fg-colors=black
Descarta qualquer informação de cores da camada do primeiro plano.
--monochrome
Renderiza as páginas como mapas de bits monocromáticos. Com esta opção, as opções
--bg-... e --fg-... não são respeitadas.
--loss-level=n
Especifica a agressividade da compressão com perdas. A predefinição é 0 (sem perdas)
Os valores válidos são números inteiros entre 0 e 200, inclusive. Esta opção é
semelhante à opção -losslevel do cjb2; consulte o manual do cjb2(1) para detalhes.
Esta opção pode ser usada apenas se a opção --monochrome estiver também activa.
--lossy
Sinónimo para --loss-level=100.
--anti-alias
Activa o anti-aliasing das font e vectores. Esta opção não é recomendada.
Extracção
--no-metadata
Não extrai os meta-dados.
Por predefinição:
• As seguintes entradas do dicionário de informação do documento são extraídas:
Título, Autor, Assunto, Criador, Produtor, Data de Criação, Data de Modificação.
As amostras de tempo são formatadas em conformidade com RFC 3999[1], com os
componentes de data e a hora separados por um único espaço.
• Os meta-dados XMP são extraídos (ou criados) e actualizados em conformidade.
Nota
Se forem especificados múltiplos documentos, apenas os meta-dados do primeiro é
tomado em conta.
--verbatim-metadata
Mantêm os meta-dados originais intactos.
--no-outline
Não extrai os contornos do documento.
--hyperlinks=border-avis
Torna os limites das hiperligações sempre visíveis
Por predefinição, os limites das hiperligações são visíveis apenas quando o rato está
sobre a hiperligação.
--hyperlinks=#RRGGBB
Força a cor especificada para os limites das hiperligações.
--no-hyperlinks, --hyperlinks=none
Não extrai as hiperligações
--no-text
Não extrai o texto.
--words
Extrai o texto. Recorda a localização de cada palavra. Isto é a predefinição.
--lines
Extrai o texto. Recorda a localização de cada linha, em vez de cada palavra.
--crop-text
Não extrai nenhum texto fora dos limites da página.
--no-nfkc
Não aplica a normalização NFKC[2] no texto, excepto para caracteres de Alphabetic
Presentation Forms block[3] (U+FB00–U+FB4F), os quais são normalizados
incondicionalmente.
A predefinição é aplicar a normalização NFKC a todos os caracteres.
--filter-text=linha-de-comandos
Filtra o texto através da linha de comandos. O filtro fornecido tem de preservar os
espaços em branco, caracteres de controle e dígitos decimais.
Esta opção implica --no-nfkc.
-p, --pages=alcance-de-páginas
Especifica as páginas a converter. alcance-de-páginas é uma lista de sub-alcances
separados por vírgulas. Cada sub-alcance é ou uma página única (ex. 17) ou uma
sequência continua de páginas (ex. 37-42). Não é permitido números de página
duplicados. As páginas são numeradas a partir de número 1.
A predefinição é converter todas as páginas.
Performance
-j, --jobs=n
Usa n linhas de execução (threads) para fazer a conversão. A predefinição é usar uma
linha de execução.
-j0, --jobs=0
Determina automaticamente quantas linhas de execução usar para fazer a conversão.
Informação detalhada, ajuda
-v, --verbose
Mostra mais mensagens informativas enquanto converte o ficheiro.
-q, --quiet
Não mostra mensagens informativas enquanto converte o ficheiro.
--version
Mostra informação de versão e termina.
-h, --help
Mostra a ajuda e termina.
AMBIENTE
As seguintes variáveis de ambiente afectam o pdf2djvu em sistemas UNIX:
OMP_*
Detalhes no comportamento em tempo de execução com respeito a paralelismo podem ser
controlados por várias variáveis de ambiente. Por favor use a especificação OpenMP
API[4] como referência para detalhes.
TMPDIR
O pdf2djvu faz uso pesado de ficheiros temporários. Irá guardá-los num directório
especificado por esta variável. A predefinição é /tmp.
SINTAXE DE LINGUAGEM
Sintaxe de modelo
A linguagem de modelo é mais ou menos modelada na Sintaxe de formatação de strings de
Python[5].
Um modelo é um pedaço de texto que contém campos, limitados por chavetas {}. Os campos são
substituídos por valores formatados apropriadamente quando o modelo é avaliado. Além
disso, {{ é substituído por uma única { e }} é substituído por uma única }.
Sintaxe de campo
Cada campo consiste num nome de variável, seguido opcionalmente de um shift, seguido
opcionalmente de uma especificação de formato.
A shift é um número inteiro assinalado (isto é, começa com um caractere + ou -.
A especificação consiste de dois pontos (:), seguido de uma especificação de largura.
A especificação de largura é um número inteiro decimal que define a largura mínima do
campo. Se não especificada, então a largura do campo será determinada pelo conteúdo.
Preceder a especificação de largura com um caractere zero (0) activa enchimento-zero.
A especificação de largura é opcionalmente seguida de um caractere asterisco (*), o qual
aumenta a largura de campo mínimo para a largura do conteúdo mais longo possível da
variável.
Variáveis disponíveis
dpage
Número de página no documento DjVu.
page, spage
Número de página no documento PDF.
label
Etiqueta de página (número de página lógico) no documento PDF.
Esta variável está disponível apenas para títulos de páginas.
DETALHES DE IMPLEMENTAÇÃO
Algoritmo de separação de camadas
A menos que a opção --monochrome seja usada, o pdf2djvu usa o seguinte algoritmo de
separação de camadas nativas:
1. Para cada página, faz o seguinte:
1. "Rasteriza" a página num mapa de pixeis, na maneira usual.
2. "Rasteriza" a página em outro mapa de pixeis, omitindo os seguintes elementos da
página:
• texto,
• imagens raster de 1 bit-por-pixel,
• elementos vectoriais (excepto preenchimentos e áreas grandes).
3. Compara ambos mapas de pixeis, pixel por pixel:
1. Se as suas cores coincidirem, classifica o pixel como parte da camada de
fundo.
2. Caso contrário, classifica o pixel como parte da cama de primeiro plano.
RELATÓRIOS DE BUGS
Se você encontrar um bug em pdf2djvu, por favor reporte-o no Acompanhamento de
problemas[6] ou para a lista de mail[7].
VEJA TAMBÉM
djvu(1), djvudigital(1), csepdjvu(1)
NOTAS
1. RFC 3999
https://www.ietf.org/rfc/rfc3339
2. NFKC
https://unicode.org/reports/tr15/
3. Alphabetic Presentation Forms block
https://unicode.org/charts/PDF/UFB00.pdf
4. especificação OpenMP API
https://www.openmp.org/specifications/
5. Sintaxe de formatação de strings de Python
https://docs.python.org/2/library/string.html#format-string-syntax
6. Acompanhamento de problemas
https://github.com/jwilk/pdf2djvu/issues
7. a lista de mail
https://groups.io/g/pdf2djvu