Corrigir automaticamente a orientação de páginas em documentos

Marius Kleidl

Engenheiro de software · Munique, Alemanha · Mostrar biografia

As páginas de documentos digitalizados muitas vezes ficam na orientação incorreta devido a um erro no processo de digitalização manual. Esses problemas de orientação dificultam a leitura e exigem que o leitor gire o documento manualmente. Nosso novo Robot /document/autorotate pode corrigir a orientação automaticamente com base no texto presente no documento, melhorando a experiência do usuário.

Usar 🤖/document/autorotate

Vamos começar com um documento de exemplo. A captura de tela a seguir mostra um documento digitalizado na orientação incorreta porque o papel foi inserido incorretamente no scanner. Em vez de aparecer na vertical, o texto está de lado.

Para corrigir o problema com o Robot /document/autorotate, podemos usar o Template a seguir.

{
  "steps": {
    ":original": {
      "robot": "/upload/handle"
    },
    "autorotate": {
      "use": ":original",
      "robot": "/document/autorotate",
      "result": true
    },
    "thumbnail": {
      "use": "autorotate",
      "robot": "/document/thumbs",
      "width": 200,
      "format": "png",
      "resize_strategy": "fit",
      "trim_whitespace": false,
      "result": true
    },
    "export": {
      "use": [":original", "autorotate", "thumbnail"],
      "robot": "/s3/store",
      "credentials": "YOUR_AWS_CREDENTIALS",
      "path": "my_target_folder/${unique_prefix}/${file.url_name}"
    }
  }
}

No Template acima, primeiro passamos o documento pelo Robot /document/autorotate. Ele não exige que você especifique parâmetros adicionais. Se o documento já estiver na orientação correta ou se o Robot não conseguir inferir a orientação correta, ele mantém o documento inalterado e permite que ele siga para o próximo Step sem recorrer a uma alternativa.

Em seguida, passamos o documento corrigido pelo Robot /document/thumbs para gerar uma miniatura do documento, que pode ser usada para visualizar o documento em um painel, por exemplo.

Por fim, o arquivo original, o documento corrigido e a miniatura passam pelo Robot /s3/store para armazenar o documento em um bucket S3. Você pode substituir esse Robot por qualquer um dos nossos outros Robots de exportação de arquivos, que oferecem suporte ao Google Cloud Storage, ao Azure Blob Storage e ao Digital Ocean Spaces, entre outros.

Após o processamento do nosso arquivo de exemplo, podemos ver que a orientação foi corrigida e que o documento agora está na vertical:

Formatos compatíveis

Este Robot oferece suporte a PDFs e também aos formatos de imagem mais comuns: JPEG, PNG, GIF, TIFF, WebP, BMP e JPEG 2000. Isso permite corrigir problemas de orientação em documentos fotografados com um celular ou uma câmera. Para usar este Robot com outros formatos, use primeiro o 🤖/document/convert para converter o documento em um PDF ou em um formato de imagem compatível.

Observe que documentos e imagens precisam conter texto suficiente para que a orientação correta possa ser inferida. Imagens sem texto não serão giradas.

Conclusão

Com o novo Robot /document/autorotate, você pode corrigir automaticamente a orientação de documentos e imagens. Essa é uma ótima maneira de melhorar a legibilidade de documentos digitalizados e fotografados e é uma adição útil ao seu pipeline de processamento de documentos.

Para conhecer todos os recursos disponíveis no Robot, consulte sua documentação.