Perspec

Perspectiva

Aplicativo e fluxo de trabalho para corrigir imagens em perspectiva. Por exemplo, quadros brancos, digitalizações de documentos ou fachadas.

• Fluxo de trabalho do aplicativo
• Instalação
  • Pré-construído
  • Da fonte
• Uso via CLI
• Fluxo de trabalho de digitalização de fotos
  • Etapas Adicionais
• Características
• Algoritmos
  • Transformação de Perspectiva
  • Conversão em escala de cinza
  • Conversão de peso corporal
  • Interpolação de peças faltantes
• Tecnologias
• Relacionado

Fluxo de trabalho do aplicativo

Etapa	Descrição	Resultado
1	Tire fotos
2	Abra o aplicativo Perspec
3	Solte as imagens na janela
4	Marque os cantos clicando neles
5	Clique em um dos botões salvar (ou [Enter])

Instalação

AVISO: Atualmente, o Perspec só funciona em macOS e Linux. Qualquer ajuda para fazê-lo funcionar no Microsoft (Ticket) seria muito apreciada!

Pré-construído

Você pode obter esta versão (e as anteriores) na página de lançamentos.

A versão noturna atual pode ser baixada em https://github.com/feramhq/Perspec/actions. Porém, é necessário corrigir as permissões do arquivo após o download:

chmod +x 
  ./Perspec.app/Contents/MacOS/Perspec 
  ./Perspec.app/Contents/Resources/{perspec,script,imagemagick/bin/convert}

No macOS você também pode instalá-lo através deste toque Homebrew:

brew install --cask ad-si/tap/perspec

Da fonte

Construa-o a partir do código-fonte com a pilha de Haskell.

O Platypus, com ferramentas de linha de comando habilitadas, é necessário para compilar a partir do código-fonte.

git clone https://github.com/feramhq/Perspec
cd Perspec
make install

Isso copia o Perspec.app para o diretório /Applications e disponibiliza o comando perspec em seu caminho. Você pode então soltar imagens na janela do aplicativo ou usá-las por meio da CLI, como perspec fix image.jpeg

Uso via CLI

Também é possível invocar diretamente o Perspec por meio da CLI da seguinte forma:

/Applications/Perspec.app/Contents/Resources/perspec fix path/to/image.jpeg

Você também pode passar várias imagens e todas elas serão abertas uma após a outra. Isto é muito útil para corrigir em lote um grande conjunto de imagens.

Fluxo de trabalho de digitalização de fotos

1. Tire fotos
   1. Use o aplicativo da câmera que permite bloquear a rotação (por exemplo, OpenCamera). Caso contrário, consulte o guia abaixo para corrigir a rotação.
   2. Use uma câmera ativada por som para tirar fotos simplesmente clicando com a língua ou cortando o dedo. Por exemplo, com:
   • Plutão Trigger - Dispositivo de hardware
   • Lanterna Mágica - firmware de terceiros para Canon
   • iSoundCam - aplicativo Android
2. Use o subcomando perspec rename para corrigir a ordem e os nomes dos arquivos digitalizados.
3. Verifique isso
   • Todas as páginas foram capturadas e possuem o nome de arquivo correto
   • As imagens são nítidas o suficiente
   • As imagens têm alto contraste
   • As imagens têm orientação correta
4. Para obter melhor qualidade de imagem, converta as imagens opcionalmente para um formato sem perdas (por exemplo, png ), aplique rotações e converta-as em tons de cinza. Atenção: Exclua as capas!

   mogrify -verbose -format png 
     -auto-orient -colorspace gray photos/ * .jpeg

5. Use Perspec para cortar imagens

   perspec fix photos/ * .png

Etapas Adicionais

Melhore as cores com uma das seguintes etapas:

1. Normalizar faixa dinâmica:

mogrify -verbose -normalize photos/ * .png

1. Converter para preto e branco:

    #! /usr/bin/env bash
   
   find . -iname " *.png " | 
   while read -r file
   do
     convert 
       -verbose 
       " $file " 
       ( +clone -blur 0x60 -brightness-contrast 40 ) 
       -compose minus 
       -composite 
       -negate 
       -auto-threshold otsu 
       " $( basename " $file " " .png " ) " -fixed.png
   done

Para girar todas as fotos para o modo retrato, você pode usar

mogrify -verbose -auto-orient -rotate " 90> " photos/ * .jpeg

ou

mogrify -verbose -auto-orient -rotate " -90> " photos/ * .jpeg

Características

• Redimensionar imagem na alteração da viewport
• Lidar com rotação JPEG
• Desenhe linhas entre os cantos para simplificar a adivinhação dos cantos cortados
• Pacote ImagemMagick
• Melhor erro se o formato de arquivo errado for descartado (images/error-message.jpg)
• Centralizar janela Perspec na tela
• Arrastar e soltar para marcadores de canto
• Botão "Enviar"
• Botão "Converter para escala de cinza"
• Adicione suporte para tamanho de saída personalizado (por exemplo, A4)
• Botões de rotação manual
• Visualização de zoom para cantos
• Etiquetar marcadores de canto

Algoritmos

Transformação de Perspectiva

Uma vez marcados os cantos, a correção equivale a:

convert 
  images/example.jpg 
  -distort Perspective 
    ' 8,35 0,0 27,73 0,66 90,72 63,66 67,10 63,0 ' 
  -crop 63x66+0+0 
  images/example-fixed.jpg

Conversão em escala de cinza

Converte a imagem em tons de cinza e depois normaliza o intervalo de valores. (Usa -colorspace gray -normalize do Imagemagick)

Conversão de peso corporal

Converte imagem em formato binário com o método OTSU. (Usa -auto-threshold OTSU -monochrome do Imagemagick)

Interpolação de peças faltantes

O Perspec interpola automaticamente as partes faltantes usando o pixel mais próximo. (https://www.imagemagick.org/Usage/misc/#edge)

Tecnologias

• O núcleo é escrito em Haskell
• A transformação de perspectiva é feita pelo ImageMagick
• O pacote de aplicativos é criado com Platypus

Relacionado

Confira ad-si/awesome-scanning para uma extensa lista de projetos relacionados.