Um TIFF não tem necessariamente apenas uma imagem: o processamento quadro a quadro não perderá páginas.

Um TIFF pode conter várias páginas de imagens e só porque um programa abre o arquivo não significa que todas as páginas foram processadas. Se apenas a primeira página for lida, o programa termina normalmente, mas o restante do conteúdo é perdido. Este artigo é destinado a desenvolvedores e profissionais de documentos que precisam processar digitalizações em lote, imagens de vários quadros ou arquivos de várias páginas. Explica como primeiro identificar o número de páginas, processá-las quadro a quadro e registrar os resultados de cada página.

O código neste artigo é demonstrado usando amostras sintéticas e passou na inspeção de amostra em um ambiente isolado, mas isso não representa uma garantia de todos os arquivos reais ou efeitos do produto. Antes de processar documentos importantes, guarde os originais e revise-os de acordo com os limites e itens de aceitação do texto.

Como o TIFF multiquadro não pode perder páginas? Conclusão de uma frase

Primeiro leia o número da página e processe-o quadro a quadro. Os resultados de cada página devem ser registrados e as páginas faltantes devem ser claramente marcadas.

Copia a imagem atual ao iterar sobre frames

ImageSequence.Iterator é adequado para iterar em vários quadros, mas os objetos de quadro podem estar relacionados ao estado de decodificação subjacente. Se cada página for usada independentemente posteriormente, ela deverá ser copiada durante a iteração ou processada imediatamente. Não salve referências ao mesmo objeto mutável repetidamente e espere obter páginas que não afetem umas às outras.

Construa dois quadros de TIFF para verificar se nenhuma página foi perdida

from io import BytesIO
from PIL import Image, ImageSequence

first = Image.new("RGB", (12, 8), "white")
second = Image.new("RGB", (12, 8), "black")
stream = BytesIO()
first.save(stream, format="TIFF", save_all=True, append_images=[second])
stream.seek(0)
with Image.open(stream) as document:
    assert document.n_frames == 2
    pages = [frame.copy() for frame in ImageSequence.Iterator(document)]
assert len(pages) == 2
assert pages[0].getpixel((0, 0)) == (255, 255, 255)
assert pages[1].getpixel((0, 0)) == (0, 0, 0)
pages[0].putpixel((0, 0), (255, 0, 0))
assert pages[1].getpixel((0, 0)) == (0, 0, 0)

Aqui, todas as duas páginas são mantidas na memória, o que é adequado apenas para este pequeno exemplo de síntese. Arquivos de digitalização reais devem ser processados página por página ou usar lotes controlados, e os resultados de cada página devem ser registrados. Todos os quadros de alta resolução não podem ser copiados e empilhados indefinidamente.

Além do número da página, existem diferenças página por página

No mesmo arquivo multiquadro, as diferenças entre as páginas costumam ser maiores do que se imagina. Ao verificar página por página, recomenda-se registrar os seguintes itens:

Sucessos parciais devem ser claramente declarados

Se apenas nove em cada dez páginas forem processadas, você não pode devolver apenas um arquivo e marcá-lo como completo. A lista de entregas deve listar as páginas faltantes e seus motivos, permitindo que os usuários decidam se retransmitem, tratam separadamente ou aceitam entregas parciais. É melhor manter o número da página da fonte; não renumere só porque uma página falha, caso contrário os usuários podem ter dificuldade para se reconectar com o original.

A completude da tradução começa com o número de páginas inseridas

Ao processar dados escaneados em várias páginas com o fluxo de trabalho OmniDoc (Entrada de Produto), você pode comparar a lista de páginas de entrada com a faixa de conteúdo pós-tradução. Ter a mesma contagem de páginas não prova automaticamente que o conteúdo está completo, mas números de página ou números de página ausentes são alertas valiosos. As verificações de integridade devem preceder o polimento da linguagem.

📊 Comparação de Núcleos

🎯 Qual método combina com você?

Se você precisar exportar ou traduzir página por página

Primeiro, o número de páginas é contado, depois processado página por página, com cada página registrada em tamanho, modo e resultados de processamento.

Se você está lidando com um grande número de varreduras de alta resolução

Utiliza processamento em lote controlado para evitar empilhar infinitamente todos os quadros na memória após a cópia.

Se você quiser entregar para os outros

Anexe uma lista das páginas faltantes e explicações dos motivos; não marque apenas como concluído.

❓ Perguntas Frequentes (FAQ)

1. Se o programa não reporta erros, isso significa que o TIFF já processou tudo completamente?

Não necessariamente. O exemplo no artigo mostra que, quando apenas a primeira página é lida, o programa pode terminar normalmente, mas as páginas restantes foram perdidas. Abrir um arquivo com sucesso e processá-lo totalmente são duas coisas diferentes.

2. Por que não podemos salvar diretamente a referência para cada quadro?

Objetos frame podem estar relacionados ao estado de decodificação subjacente. Se quiser usar cada página de forma independente, copie ou processe imediatamente durante a iteração, e não salve repetidamente referências no mesmo objeto mutável.

3. Ter o mesmo número de páginas significa que o conteúdo está completo?

Não pode ser concluído dessa forma. Ter a mesma contagem de páginas não prova automaticamente que o conteúdo está completo, mas números de página ou números de página ausentes são sinais para ter cautela. Verificações de integridade devem ser realizadas antes de aprimorar a linguagem.

4. O que você deve fazer se uma página não for processada?

A lista de entrega lista páginas faltantes e motivos de falha, mantendo o número da página como número de origem, permitindo que os usuários decidam se retransmitem, tratam separadamente ou aceitam entrega parcial.

📝 Resumo

A chave do TIFF multi-quadro é primeiro confirmar o número de páginas, depois processar e registrar os resultados página por página. Cada página deve ter um status claro, e as páginas faltantes devem ser escritas.

Experimente agora: Envie seu documento para começar a traduzir, preservando a formatação original

Referências: Pillow ImageSequence.