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ê. Manual de referência do programador de plataforma.net do SDK para captura de imagens Snowbound RasterMaster 30
Guia de referência rápida com a amostra de conversão 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. Manual de referência do programador de plataforma.net do SDK para captura de imagens Snowbound RasterMaster 31
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 Alpha_csharp Alpha_VB Animate_CSHARP Animate_VB annaction_csharp annaction_vb Annotation_CSHARP Annotation_VB ASPConversion_CSHARP ASPConversion_VB ASPImageView_CSHARP ASPImageView_VB Descrição 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. 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. Amostra para exibição de uma imagem de GIF animado em C#. Consulte Animate para mais informações. Amostra para exibição de uma imagem de GIF animado em Visual Basic. Consulte Animate para mais informações. 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. 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. Amostra da biblioteca.net em C# para adição de anotações. Consulte Annotation para mais informações. Amostra da biblioteca.net em Visual Basic para adição de anotações. Consulte Annotation para mais informações. Amostra para demonstração de conversão simples em C#. Consulte ASP Conversion para mais informações. Amostra para demonstração de conversão simples em Visual Basic. Consulte ASP Conversion para mais informações. Amostra para demonstrar o uso das bibliotecas ASP.NET e Snowbound.NET em C# para carregar, exibir a imagem e utilizar operações básicas da biblioteca.net como zoom e girar, para manipulação da imagem. Consulte ASP Image View para mais informações. Amostra para demonstrar o uso das bibliotecas ASP.NET e Snowbound.NET em Visual Basic para carregar, exibir a imagem e utilizar operações básicas da biblioteca.net como zoom e girar, para manipulação da imagem. Consulte ASP Image View para mais informações. Manual de referência do programador de plataforma.net do SDK para captura de imagens Snowbound RasterMaster 32
Exibir amostras contidas na biblioteca Tabela 2-1: Diretório de amostras do SDL para captura de imagens.net RasterMaster (continuação) Amostra ASPMemCopy_CSHARP ASPMemCopy_VB ASPMultiPage_CSHARP ASPMultiPage_VB Contrast_CSHARP Contrast_VB Conversion_CSHARP Conversion_VB ddbeffect_csharp ddbeffect_vb 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. 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. 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. 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. Amostra para comparar uma imagem com brilho e o contraste alterado com a imagem original/inalterada em C#. Consulte Contrast para mais informações. 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. Amostra para demonstração de conversão simples em C#. Consulte Conversion para mais informações. Amostra para demonstração de conversão simples em Visual Basic. Consulte Conversion para mais informações. Amostra para exibir como obter o efeito de exibição DDB de uma imagem em C#. Consulte DDB Effect para mais informações. 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 FileMem_CSHARP ImageProcessing_CSHARP ImageProcessing_VB memcopy_csharp Descrição 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. 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. Amostra para demonstrar a aplicação do operador de processamento de imagem em C#. Consulte Image Processing para mais informações. Amostra para demonstrar a aplicação do operador de processamento de imagem em Visual Basic. Consulte Image Processing para mais informações. 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. Manual de referência do programador de plataforma.net do SDK para captura de imagens Snowbound RasterMaster 33
Exibir amostras contidas na biblioteca Tabela 2-1: Diretório de amostras do SDL para captura de imagens.net RasterMaster (continuação) Amostra Memcopy_VB mergeimage_csharp page_csharp Page_VB panning_csharp panning_vb Print_CSHARP Print_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. Amostra para demonstrar como mesclar duas imagens. Consulte Merge Image para mais informações. Amostra para visualização de qualquer página com suavização de contornos, se necessário, em C#. Consulte Page para mais informações. 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. Amostra que demonstra o efeito panning em C#. Consulte Panning para mais informações. Amostra que demonstra o efeito panning em Visual Basic. Consulte Panning para mais informações. Amostra para demonstrar a impressão e visualização em C# com o produto Snowbound. Consulte Print para mais informações. 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 SimpleMultiPages_CSHARP SimpleMultiPages_VB textsearch_csharp textsearch_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. Amostra que demonstra como dividir páginas múltiplas em C#. Consulte Split to Multiple Pages para mais informações. Amostra que demonstra como dividir páginas múltiplas em Visual Basic. Consulte Split to Multiple Pages para mais informações. Amostra que demonstra como pesquisar texto na imagem em C#. Consulte Text Search para mais informações. 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# para leitura de extensões.tif. Consulte Tiff Tag para mais informações. TIFFTag_VB Descrição Amostra que demonstra o uso da biblioteca Snowbound.NET em Visual Basic para leitura de extensões.tif. Consulte Tiff Tag para mais informações. Manual de referência do programador de plataforma.net do SDK para captura de imagens Snowbound RasterMaster 34
Como ler e exibir imagens 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. Manual de referência do programador de plataforma.net do SDK para captura de imagens Snowbound RasterMaster 35
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. *AMD 64 é um SDK separado. Manual de referência do programador de plataforma.net do SDK para captura de imagens Snowbound RasterMaster 36
Visão geral do sistema 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) 24 bits por pixel, imagem de 8,5 x 11 pol., 300 dpi (2550 pixels por 3300 pixels) 2550 * 3300 * (1 / 8) = 1051875 bytes 2550 * 3300 * (24 / 8) = 25245000 bytes (25 megabytes) Manual de referência do programador de plataforma.net do SDK para captura de imagens Snowbound RasterMaster 37