Chapter 2
Guia de referência rápida
2-Este capítulo descreve como descompactar e exibir imagens de maneira rápida com o kit de desenvolvimento de software (SDK) para captura de imagens .NET RasterMaster. Caso você não encontre a informação desejada neste manual, insira um pedido de suporte no endereço www.support.snowbound.com solicitando uma amostra específica, para obter informações sobre o método ou para ajudar a encontrar as informações necessárias. Estamos empenhados em auxiliar nossos clientes e estamos aprimorando constantemente nossos produtos com base em sugestões de clientes como você.
Guia de referência rápida com a amostra de conversão
A maneira mais rápida de começar é executar a amostra de conversão que acompanha este produto. As amostras estão localizadas no diretório C:\Program Files\Snowbound Software\ RasterMaster® .NET Evaluation\Net\Sample. A amostra de conversão converterá e exibirá qualquer tipo de documento suportado ao formato de arquivo desejado. Para mais informações, consulte Appendix H, ‘‘.NET Samples’’ sobre como localizar e executar a ‘Conversion’’ amostra. A amostra de conversão utiliza três rotinas que são a essência do RasterMaster:
1. ‘‘CIMG_decompress_bitmap()’’ - Lê documentos em qualquer formato e converte-os em uma imagem do Snowbound válida.
2. ‘‘CIMG_display_bitmap()’’ - Exibe a imagem Snowbound válida.
3. ‘‘CIMG_save_bitmap()’’ - Salva a imagem Snowbound válida em qualquer formato disponível.
As funções acima são descritas em detalhes em outras seções deste manual. Este manual também inclui os seguintes tópicos:
1. Como ler e salvar documentos com várias páginas. Para mais informações, consulte Chapter 3, ‘‘Saving and Reading Multi-page Images’’.
2. Como ajustar os atributos de cor, compactação e resolução de documentos para melhor desempenho ou maior ou menor qualidade de imagem. Para mais informações, consulte Chapter 30, ‘‘Color Promotion Functions’’ e Chapter 31, ‘‘Color Reduction Functions’’. 3. Como extrair texto e localizar texto em documentos. Para mais informações, consulte
Chapter 29, ‘‘Document Conversion and Text Extraction Functions’’. O software
Snowbound não oferece suporte para OCR (reconhecimento ótico de caracteres). Portanto, só é possível extrair texto de documentos que contêm texto. Use o RasterMaster em conjunto com ferramentas de OCR de outras empresas se precisar extrair o texto de imagens de documentos digitalizados.
Incluímos diversas amostras de código para ajudá-lo a começar. As amostras estão localizadas em Appendix H, ‘‘.NET Samples’’. Além disso, indexamos nossa documentação em modo de pesquisa para ajudá-lo a encontrar rapidamente o que está procurando.
Caso você tenha dúvidas, entre em contato com o serviço de suporte pelo endereço www.support.snowbound.com.
Exibir amostras contidas na biblioteca
Exibir amostras contidas na biblioteca
Para executar uma amostra, clique em qualquer uma das amostas a seguir no ambiente de desenvolvimento, como o Visual Studio, por exemplo.
Arquivos de diretório de amostras
O diretório de amostras contém amostras do SDK para captura de imagens .NET descritas na Tabela 2-1. Todas as amostras .NET incluem o código-fonte C#.NET e VB.NET. Para obter mais informações sobre cada amostra, consulte Appendix H.
Tabela 2-1: Diretório de amostras do SDL para captura de imagens .NET RasterMaster
Amostra Descrição
Alpha_csharp Amostra que demonstra como usar a biblioteca .NET em C# para
carregar, exibir a imagem e usar operações básicas como zoom e girar,
para manipulação da imagem. Consulte ‘Alpha’’ para mais informações.
Alpha_VB Amostra que demonstra como usar a biblioteca .NET em Visual Basic para
carregar, exibir a imagem e usar operações básicas como zoom e girar, para
manipulação da imagem.. Consulte ‘Alpha’’ para mais informações.
Animate_CSHARP Amostra para exibição de uma imagem de GIF animado em C#.
Consulte Animate’’ para mais informações.
Animate_VB Amostra para exibição de uma imagem de GIF animado em Visual
Basic. Consulte Animate’’ para mais informações.
annaction_csharp Amostra que demonstra como usar o identificador de mouse
da biblioteca .NET em C# para adição de anotações.
Consulte ‘Annaction’’ para mais informações.
annaction_VB Amostra que demonstra como usar o identificador de mouse
da biblioteca .NET em Visual Basic para adição de anotações.
Consulte ‘Annaction’’ para mais informações.
Annotation_CSHARP Amostra da biblioteca .NET em C# para adição de anotações.
Consulte ‘‘Annotation’’ para mais informações.
Annotation_VB Amostra da biblioteca .NET em Visual Basic para adição
de anotações. Consulte ‘‘Annotation’’ para mais informações.
ASPConversion_CSHARP Amostra para demonstração de conversão simples em C#.
Consulte ‘‘ASP Conversion’’ para mais informações.
ASPMemCopy_CSHARP Amostra para demonstrar o uso das bibliotecas ASP .NET e Snowbound .NET em C# para salvar e ler a imagem na memória. Consulte para mais informações.
ASPMemCopy_VB Amostra para demonstrar o uso das bibliotecas ASP .NET
e Snowbound .NET em Visual Basic para salvar e ler a imagem na
memória. Consulte ‘‘ASP Memory Copy’’ para mais informações.
ASPMultiPage_CSHARP Amostra para demonstrar o uso das bibliotecas ASP .NET
e Snowbound .NET em C# para pesquisa de imagens com diversas
páginas. Consulte ‘‘ASP Multiple Pages’’ para mais informações.
ASPMultiPage_VB Amostra para demonstrar o uso das bibliotecas ASP .NET e Snowbound
.NET em Visual Basic para pesquisa de imagens com diversas páginas.
Consulte ‘‘ASP Multiple Pages’’ para mais informações.
Contrast_CSHARP Amostra para comparar uma imagem com brilho e o contraste
alterado com a imagem original/inalterada em C#.
Consulte ‘Contrast’’ para mais informações.
Contrast_VB Amostra para comparar uma imagem com brilho e o contraste
alterado com a imagem original/inalterada em Visual Basic.
Consulte ‘Contrast’’ para mais informações.
Conversion_CSHARP Amostra para demonstração de conversão simples em C#.
Consulte ‘‘Conversion’’ para mais informações.
Conversion_VB Amostra para demonstração de conversão simples em Visual Basic.
Consulte ‘‘Conversion’’ para mais informações.
ddbeffect_CSHARP Amostra para exibir como obter o efeito de exibição DDB de uma
imagem em C#. Consulte ‘‘DDB Effect’’ para mais informações.
ddbeffect_VB Amostra para exibir como obter o efeito de exibição DDB de uma
imagem em Visual Basic Consulte para mais informações.
Encrypt_csharp Amostra para demonstrar o uso da biblioteca Snowbound.Net em C #
para descompactação e exibição de imagens de forma transparente.
Consulte ‘‘Encryption’’ para mais informações.
Encrypt_VB Amostra para demonstrar o uso da biblioteca Snowbound.Net em
Visual Basic para descompactação e exibição de imagens de forma
transparente. Consulte ‘‘Encryption’’ para mais informações.
FileMem_CSHARP Amostra para demonstrar como ler um arquivo de imagem para a
memória e usar a biblioteca Snowbound .NET em C# para descompactar
a imagem da memória. Consulte ‘‘FileMem’’ para mais informações.
ImageProcessing_CSHARP Amostra para demonstrar a aplicação do operador de processamento de
imagem em C#.Consulte ‘‘Image Processing’’ para mais informações.
ImageProcessing_VB Amostra para demonstrar a aplicação do operador de processamento
de imagem em Visual Basic. Consulte ‘‘Image Processing’’ para mais
informações.
memcopy_csharp Amostra para demonstrar o uso das bibliotecas Snowbound .NET
em C# para salvar e ler a imagem na memória.Consulte ‘‘Memory
Copy’’ para mais informações.
Tabela 2-1: Diretório de amostras do SDL para captura de imagens .NET RasterMaster
(continuação)
Exibir amostras contidas na biblioteca
Memcopy_VB Amostra para demonstrar o uso das bibliotecas Snowbound .NET
em Visual Basic para salvar e ler a imagem na memória.Consulte
‘‘Memory Copy’’ para mais informações.
mergeimage_CSHARP Amostra para demonstrar como mesclar duas imagens.Consulte
‘‘Merge Image’’ para mais informações.
page_csharp Amostra para visualização de qualquer página com suavização de
contornos, se necessário, em C#. Consulte ‘‘Page’’ para mais informações.
Page_VB Amostra para visualização de qualquer página com suavização
de contornos, se necessário, em Visual Basic. Consulte ‘‘Page’’
para mais informações.
panning_csharp Amostra que demonstra o efeito panning em C#.
Consulte ‘Panning’’ para mais informações.
panning_VB Amostra que demonstra o efeito panning em Visual Basic.
Consulte ‘Panning’’ para mais informações.
Print_CSHARP Amostra para demonstrar a impressão e visualização em C# com
o produto Snowbound. Consulte ‘‘Print’ para mais informações.
Print_VB Amostra para demonstrar a impressão e visualização em Visual Basic
com o produto Snowbound. Consulte ‘‘Print’ para mais informações.
Scan_CSHARP Amostra que demonstra o uso da biblioteca Snowbound .NET em C#
para funções de digitalização. Consulte ‘‘Scan’’ para mais informações.
Scan_VB Amostra que demonstra o uso da biblioteca Snowbound .NET
em Visual Basic para funções de digitalização. Consulte ‘‘Scan’’ para
mais informações.
SimpleMultiPages_CSHARP Amostra que demonstra como dividir páginas múltiplas em C#.
Consulte ‘‘Split to Multiple Pages’’ para mais informações.
SimpleMultiPages_VB Amostra que demonstra como dividir páginas múltiplas em Visual
Basic.Consulte ‘‘Split to Multiple Pages’’ para mais informações.
textsearch_CSHARP Amostra que demonstra como pesquisar texto na imagem em C#.
Consulte ‘‘Text Search’’ para mais informações.
textsearch_VB Amostra que demonstra como pesquisar texto na imagem em Visual
Basic.Consulte ‘‘Text Search’’ para mais informações.
TIFFTag_CSHARP Amostra que demonstra o uso da biblioteca Snowbound .NET em C#
Tabela 2-1: Diretório de amostras do SDL para captura de imagens .NET RasterMaster
(continuação)
Como ler e exibir imagens
A seção a seguir descreve como ler e exibir imagens e remover imagens da memória.
Leitura de imagens
Para ler uma imagem, use a função a seguir.
Sintaxe
int SNBDAPI CIMG_decompress_bitmap(String *nome do arquivo); O nome de arquivo de entrada é uma sequência padrão que aponta a um nome de arquivo de imagem. O SDK para captura de imagem .NET RasterMaster sempre detecta o formato de uma imagem (por exemplo: TIF, .PCX, .GIF). O valor de retorno é um código de erro que determina se o objeto .NET Snowbound contém uma imagem válida.
O usuário pode acessar esta função quantas vezes for necessário.
Consulte ‘‘CIMG_decompress_bitmap()’’ para obter mais informações sobre leitura de imagem.
Exibição de imagem
Para exibir uma imagem, use a função a seguir.
Sintaxe
int SNBDAPI CIMG_display_bitmap(Graphics *g, int x, int y, int largura, int altura);
Esta função exibe a imagem indicada pelo objeto de chamada nas coordenadas x, y, largura e altura em pixels.
Consulte ‘‘CIMG_display_bitmap_aspect()’’ para obter mais informações sobre a correção automática da proporção da imagem.
Consulte ‘‘bool repaintBackground()’’ para obter mais informações sobre exibição de imagem.
Valores de retorno e códigos de erro
Os identificadores de arquivo do Snowbound sempre começam com zero (0). O identificador é simplesmente um valor inteiro para referência à imagem.
Todos os valores negativos são erros. Consulte Appendix J para uma lista de códigos e descrições de erro.
Visão geral do sistema
Visão geral do sistema
As especificações técnicas do SDK para captura de imagens .NET RasterMaster são descritas a seguir.
Para determinar os requisitos de sistema
Os requisitos de sistema para instalação do SDK para captura de imagens .NET RasterMaster são:
• Sistemas operacionais suportados: qualquer ambiente .NET tal como:
• Microsoft Windows Vista
• Microsoft Windows XP
• Microsoft Windows XP/64*
• Microsoft Windows Server 2003
• Microsoft Windows 2008 • Microsoft Windows 7 • Plataformas suportadas: • Intel x86 • AMD • AMD x64 • Ambientes de desenvolvimento:
• Microsoft Visual Studio .NET
• SDKs com suporte para .NET
• Os requisitos mínimos de memória estão relacionados ao tamanho da imagem e buffers necessários. Os buffers podem requerer diversos megabytes caso as imagens sejam grandes. Para mais informações, consulte ‘‘Para determinar os requisitos de memória’’.
Para determinar os requisitos de memória
A quantidade de memória necessária para a leitura de documentos pode variar dependendo do tamanho dos documentos e do número de documentos processados em um certo momento. Pode ser necessário aumentar a quantidade de memória nos seguintes casos:
• Ao converter os documentos de preto e branco, para tons de cinza, para coloridos (aumento dos bits por pixel).
• Ao alterar os formatos de documentos compactados para descompactados (compactação com perdas para dados de imagem não processados).
• Ao alterar a resolução dos documentos de baixa para alta resolução (aumento dos pontos por polegada/qualidade).
• Ao alterar o tamanho das imagens de ficha pequena para tamanho de impressão grande (aumento do número de pixels).
Geralmente, documentos com maior qualidade requerem mais memória para processamento. A Snowbound Software não possui um "tamanho único" recomendado para memória, pois os nossos clientes têm uma variedade de documentos e diferentes tolerâncias para o nível de qualidade de impressão. No entanto, é possível duplicar o tamanho da memória disponível para tentar solucionar o problema. Aumente a capacidade da memória até que as mensagens de erro de memória não sejam mais exibidas. Se o problema não for solucionado ao atingir o limite de memória física, proceda da seguinte maneira:
• Diminua o número de documentos abertos ao mesmo tempo.
• Diminua a qualidade das imagens solicitadas ao reduzir os bits por pixel, resolução ou tamanho. Para calcular a quantidade de memória necessária para uma imagem, é preciso saber o tamanho da imagem em pixels e o número de bits por pixel da imagem (preto e branco = 1, tons de cinza = 8, colorida = 24). Se você não souber a altura ou a largura em pixels, mas souber o tamanho em polegadas e o dpi (pontos por polegada) da imagem, calcule o tamanho em pixels como (largura em polegadas*pontos por polegada) = largura em pixels.
Para calcular a quantidade de memória (em bytes), multiplique a largura, altura e o número de bits por pixel. Em seguida, divida por 8 para converter os bits em bytes. Veja o exemplo a seguir: (altura em pixels * largura em pixels * bits por pixel)/ 8 = tamanho da imagem em bytes A Tabela 2-2 contém exemplos de requisitos de memória com base no tamanho das imagens.
Tabela 2-2: Requisitos de memória com base no tamanho da imagem Tamanho da imagem Requisitos de memória
24 bits por pixel, imagem de 640 x 480 640 * 480 * (24 / 8) = 921600 bytes
1 bit por pixel, imagem de 8,5 x 11 pol., 300 dpi (2550 pixels por 3300 pixels)
2550 * 3300 * (1 / 8) = 1051875 bytes
24 bits por pixel, imagem de 8,5 x 11 pol., 300 dpi (2550 pixels por 3300 pixels)
2550 * 3300 * (24 / 8) = 25245000 bytes (25 megabytes)