Chapter 2 Guia de referência rápida

Transcrição

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.
31
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.
ASPConversion_VB
Amostra para demonstração de conversão simples em Visual Basic.
Consulte ‘‘ASP Conversion’’ para mais informações.
ASPImageView_CSHARP
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.
ASPImageView_VB
.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.
32
(continuação)
Amostra
Descrição
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
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
e Snowbound .NET em C# para pesquisa de imagens com diversas
páginas. Consulte ‘‘ASP Multiple Pages’’ para mais informações.
ASPMultiPage_VB
.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.
33
(continuação)
Amostra
Descrição
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#
para leitura de extensões .tif. Consulte ‘‘Tiff Tag’’ para mais informações.
TIFFTag_VB
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.
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.
35
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.
36
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)
37

Chapter 2 Guia de referência rápida

Transcrição

Documentos relacionados

Consulte novos sabores com o atendente.

Casa fora de Condomínio em Vargem Grande Paulista Ref. : CA 260

Lançamento Fita 9767 Max Force - Clientes

Hotel Ambassador ***

cat. geral protos08

Mútua dos Pescadores – Mútua de Seguros C.R.L, seguradora

xii descida nocturna rio vouga

SEJAM BEM-VINDO (ª) ao site www.vejoecompro.com.br. O site

Currículo

Sites Bloqueados, saiba como acessa-los.