Uso Básico de las API en Power Images

Uso Básico de las API

ESCANEO

C                     CALL 'I@SCN'                               
C                     PARM 'DEMO1'   WPERFI  6        PERFIL     
C                     PARM '00000000'WFILB   8        FILE BASE   
C                     PARM *BLANKS   WRESO   8        RESOLUCION 
C                     PARM *BLANKS   WOPC   40        OPCIONES   
C                     PARM *BLANKS   WRES   50        Reservado/Path

PARAMETROS DE I@SCN de 400
  • Perf6 Perfil a usar (dtaara PIP@xxxxxx) se define con Paso 51 de IMG
  • file8 Fichero. Si blancos o ceros se toma prox num del perfil,
    • si pos1 es 0 se machaca prefijo de 1,2 o 3 pos del perfil.
    • valor *PATH permite indicar path+file completo en r50
  • resol8 Resolucion como 075BN,100COLOR,075GRAY,etc
    • posic 1a3 es resol 075,100,150,200,300,
    • posic 4a8 es BN,GREY,COLOR,C16,G16,C32,G32,C64,G64,C128,G128,C256
      • (si vacio la toma del perfil)
  • opc40 opciones especiales separadas por blanco (explicadas a continuacion)
  • res50 Reservado. usar solo con *PATH en File
    • o bien para usar perfil en otra biblioteca indicando *WL=xxxxxxxxxx
descripcion de opciones (30 pos) SCAN (separadas por blanco)
  • *SC Escaneo automatico sin pulsar boton
  • *SV Save automatico tras escanear sin pulsar boton
  • *EA End-auto (Cerrar Pgm) tras Save (p.e. unir *SC *SV *EA)
  • *OW regrabar file imagen si existe sin preguntar
  • *DL llamar al dialogo del scaner
  • *DB debug - sin uso.
  • *AF Auto Feed (Cargador de Paginas autoalimentador)
  • *UNx usar la unidad x (para cuando hay n scanners. 0 es 1)
  • *QLxx usar calidad xx en jpg. ejemplo *QL80 *QL90 *QL70
  • *G3 para BN comprimir con Group3
  • *G4 para BN comprimir con Group4 (mas compresión menos calidad)
  • *PDFxxx tal como *PDF001 para generar PDF y usar atributos PDFxxx en el powerimg.ini
  • *KW=clave1,clave2* para definir keywords en el pdf (terminarlas con asterisco)
  • *PV usar Preview (escaneo previo para probar)
  • -PV forzar NO Preview
  • tamaño fijo (en decimos de pulgada) a escanear:
    • *SLxxx inicio izqda/left como *SL005 para media pulg
    • *STxxx inicio arriba/top como *ST001 para 1/10 de pulgada
    • *SRxxx fin derecha/right como *SR040 para 4 pulgadas
    • *SBxxx fin abajo/botton como *SB065 para 6 pulgadas y media

uso de programa de escaneo version anterior

m( seguramente no necesitas esto.

En versiones nuevas se usa la version nueva piScan, pero puede obligarse a usar la version anterior en caso de instalaciones heredadas/antiguas.

El programa-pc anterior de escaneo es imgscn.exe, pero es recomendable usar la versión nueva que se llama piScan.exe.

Se puede indicar en un fichero ini especial que queremos usar ese programa anterior.
El ini debe crearse en la carpeta que se abre con el cpiInfo.exe (el programa amarillo), y crear el ini con nombre I_IMGSCN.INI con el contenido

[program]
path=C:\Program Files (x86)\CPI\     ⇒ carpeta donde exista SCNIMG.exe
name=SCNIMG.exe
esto hace que en lugar de llamar al pgm nuevo se llame al viejo. 

personalización en fichero PowerImg.ini de comportamiento del SCAN

algunos comportamientos del escaneo se pueden cambiar por un fichero ini en cada pc, esto es importante si hay varios pc donde se hacen escaneos, ya que quiza en cada pc-scaner se requiera algo diferente (por ejemplo, la unidad por defecto).

El fichero powerimg.ini se puede editar directamente desde el programa de escaneo, o editarlo en cualquier momento con un editor normal como notepad.exe (atencion, debe salvarse como powerimg.ini y no como .txt o .ini.txt etc).

el valor mas importante seria el de la unidad de escaner preferente, ya que podemos tener definidos varios dispositivos en el pc pero querer usar por omision uno determinado

[config]
DeviceName=HP301

escaneo auto salvando cada pagina

Existe un modo para usar el alimentador automatico salvando cada pagina en un fichero con prefijo y sufijo segun la pagina. Este tipo de necesidades especiales hay que acometerlos solamente en una labor de consultoria dedicada con CPI Software para obtener funciones especificas.

VISOR DE IMAGEN (version básica)

⇒ es recomendable usar la version extendida del visor.

C                     CALL 'I@VER'          
C                     PARM           WPATH   	(path 40 posic)
C                     PARM           NOMBRE    (Texto30 para cabecera)
C                     PARM           OPCIO3 	(opciones 3 pos)

En Path se puede pasar un path completo como \\serv\img\foto37.jpg o pasar una orden especial para usar un PERFIL.

  • ejemplo *PPPPPP*FFFFFFFF.EEE
    • el * en la pos 1
    • perfil 6 pos en pos 2
    • esto permite que se tome el path del perfil
    • file 8 pos en pos 9
    • extension 3 pos en pos 18
      • si viene vacio se toma ext del perfil

Opciones (OPCIO3) para Visualizar Imagen (XYZ)

  • Es un codigo de tres posiciones (XYZ) donde cada posicion significa:
    • p.e. 'F1 ' para Foto o 'D1M' para Documentos
    • (Nota: Una ? significa cualquier caracter p.e. blanco no especificado)
  • X. ? por omision la imagen se visualiza con ventana normal, botones, etc.
    • F Ver imagen sola en su tamaño, sin opciones (pero admite Click-Dcho)
    • D Ver imagen en “Modo Documento” Pantalla Completa y Opciones
  • Y. 1 Menu permite todas las opciones
    • 0 Menu solo permite Imprimir o Salir
    • ? Menu sin Opciones
  • Z. M Se visualiza la Imagen Maximizada.
    • P ver toda la Pagina
    • ? Segun las otras opciones (p.e. D es Maximizada)

VISOR DE IMAGEN (version extendida)

La version extendida del visor de imagen permite mayor control.

C                     CALL 'PIDSP'                    VER IMAGEN EXT
C                     PARM FILE8     IMGFIL 60        fichero          
C                     PARM           IMGTXT 60        descripcion          
C                     PARM 'D1 '     IMGOP3  3        opcion basica          
C                     PARM 'CPIFR1'  IMGPRF  6        Perfil          
C                     PARM           IMGPRL 10        LIB Perfil
C                     PARM           IMGOPX 60        OPCIONES Ext
C                     PARM 'FPE'     IMGFPE  3        RELLENO File
C                     PARM           IMGRES 60        reservado
  • IMGFIL. fichero simple o completo con path. se recomienda fichero simple para usar prefijo y funciones de relleno.
  • IMGTXT. Texto/Descripcion de cabecera para la imagen.
  • IMGOP3. opciones basicas de presentacion, como en el visor basico. se recomienza F1 para fotos medianas o pequeñas y D1 para documentos tipo carta etc.
    • posic1 F para vista “Full”, intenta visualizar imagen completa, o D para “vista Documento”, dejando esta posic1 en blanco se visualiza la imagen dentro de un menu con opciones (que puede cambiarse algo con la pos2)
    • posic2 0 (cero) o 1, cero puede limitar ciertas funciones del menu (si es visible). importante: solo 0 o 1
    • posic3 blanco, o M para vista Maximizada o P para vista Pagina (dependen del contexto, tipo y tamaño de la imagen, etc)
  • IMGPRF. Perfil a usar. Puede estar en blanco si no se usan caracteristicas asociadas al perfil.
  • IMGPRL. Bib del perfil, por omision TEXTCPIU, pero al admitir bib libre se permite mayor flexibilidad.
  • IMGOPX. Opciones avanzadas.
    • *HS para revisualizar pantalla del host si es necesario, p.e. en pantallas de 132p
    • *FI para forzar imagen visible, poco necesario
    • *SB para forzar el uso de scrollbars
    • *PZ1 a *PZ9 visualizar imagen (p.e. foto F1) en una de 9 zonas en que se divide el monitor
    • *PXwwwhhh obligar tamaño imagen en pixels, p.e. *PX400300 para 400 ancho 300 alto.
    • *INwwwhhh obligar tamaño imagen en decimos de pulgada, p.e. *IN040030 para 4 alto 3 ancho, *IN045032 para 4,5 x 3,2 (una pulgada son unos 2,4 cm)
  • IMGFPE. Funciones de relleno auto para el fichero desde el perfil.
    • pos 1. una F indica que la Folder (Path) para el fichero se debe tomar del perfil.
    • pos 2. una P indica que al fichero se le cambia el prefijo de 2 o 3 pos desde el perfil.
    • pos 3. una E indica que al ficharo se le añade la extension desde el perfil
      • por ejemplo, en fichero se puede enviar un simple contador de 8 pos como 00001245 y usar las opciones FPE lo cual toma del perfil el path, el prefijo y la extension dando como resultado \\mi400\img\FAC01245.tif, no teniendo que tener estos atributos abligados sino definidos en un perfil facilmente cambiable.
  • IMGRES. uso reservado.

PERFILES

El uso de perfiles permite simplificar la llamada de funciones API, p.e. no teniendo que indicar path o extension sino tomarlo automaticamente de un perfil externo facil de personalizar.

Cada perfil es una dtaara con el nombre pip@xxxxxx siendo xxxxxx las seis posiciones del perfil. por tanto puede hacerse wrkdtaara lib/pip@* para ver las que hay.

Se puede definir un perfil con esta llamada: CALL PI@PRFCL ('DEMO1A' 'TEXTCPIU' 'miaplic')

  • El primer param de 6x es el nombre del perfil
  • el segundo param de 10x es la bib del perfil
  • el tercer param es un texto sin importancia para verlo en la cabec del pgm editor

para validar las resoluciones que pide el editor de perfiles se puede usar el programa paso 50 del comando IMG, o ejecutar el CALL PI@RE1CL teniendo cpi@pub, cpi@img y textcpiu en la *libl

VISOR DE CARPETA DE IMAGENES

Este visor, en lugar de visualizar UNA imagen, visualiza la primera imagen de una carpeta y el usuario puede ver otras imagenes de la carpeta.

Se usa cuando NO se conoce el nombre de una imagen sino la carpeta que contiene N imagenes. Por ejemplo, cada Trabajador tiene una carpeta con las imagenes relacionadas, que pueden ser muchas y variadas.

C                     CALL 'I@CONS'          
C                     PARM           WPATH   	(path 40 posic)

permite un param de 40x este param puede ser un path completo con file o solo la carpeta, por ejemplo \\Server\Images

Ejemplos

Visor con una imagen en modo menu (sin pasar F o D en pos1 de opcion3)

La misma imagen sin ver el menu, tal como con opcion basica F1 o F0

 
/kunden/homepages/8/d674751560/htdocs/cpies/doc/data/pages/power_images/uso_basico_de_las_api.txt · Última modificación: 4/04/2017 06:31 (editor externo)
[unknown button type]
 
Excepto donde se indique lo contrario, el contenido de este wiki esta bajo la siguiente licencia: CC Attribution-Noncommercial-Share Alike 4.0 International
Recent changes RSS feed Donate Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki