AYUDA EN LÍNEA
 WINDEVWEBDEV Y WINDEV MOBILE

Este contenido se ha traducido automáticamente.  Haga clic aquí  para ver la versión en inglés.
Ayuda / WLanguage / Funciones WLanguage / Funciones estándar / Funciones de Windows / Funciones TWAIN
  • Document procedente del dispositivo Twain
  • Manejar el tipo de Image
  • Dúplex Scanner
  • Modo de funcionamiento en las aplicaciones de 64 bits
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReportes y ConsultasCódigo de Usuario (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Código Navegador
WINDEV Mobile
AndroidWidget Android iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Otros
Procedimientos almacenados
Permite:
  • guardar la Document que viene del dispositivo Twain en un archivo Tiff.
  • ver la Document procedente del dispositivo Twain en la dispositivo UI. El usuario tendrá la posibilidad de realizar una de las acciones propuestas por esta interfaz (por ejemplo: guardar el Document, modificar los parámetros del Default del dispositivo). Las acciones disponibles dependen del dispositivo utilizado.
  • guardar el Document que viene del dispositivo Twain directamente en la memoria en formato Tiff (en un buffer).
Ejemplo
// Acquisition as long as there are pages to load
TwainToTIFF("File.TIF")
// Save the document found in the scanner in memory
// The document will be saved in black and white
IMG_MyImage = TwainToTIFF(inMemory, False, TwainBlackWhite)
Sintaxis

Guardar y mostrar la Document que viene del dispositivo Twain en un archivo Tiff Ocultar los detalles

<Result> = TwainToTIFF([<TIFF file> [, <User interface> [, <Type of image> [, <Number of bits per pixel> [, <Image resolution> [, <Image contrast> [, <Image brightness> [, <Duplex mode> [, <Automatic load>]]]]]]]]])
<Result>: booleano
  • True si se guardó o mostró el documento,
  • False si no se pudo guardar ni mostrar el documento. El mensaje de error correspondiente es devuelto por ErrorInfo.
<TIFF file>: Cadena de caracteres opcional
Nombre y ruta completa (o relativa) del archivo (hasta 260 caracteres). La extensión del archivo es opcional. Se puede utilizar una ruta de tipo UNC.
Si no se especifica este parámetro o si corresponde a una cadena vacía (""), el usuario tendrá que introducir el nombre completo del archivo Tiff en un selector de archivos.
<User interface>: Booleano opcional
  • True si se debe mostrar la interfaz de usuario del dispositivo Twain. Cuando se guarda un Document, el <fichero TIFF> será propuesto por Default.
  • False (valor predeterminado) si no se debe mostrar la interfaz de usuario del dispositivo Twain.
<Type of image>: Constante o combinación de constantes de tipo Integer (opcional)
Tipo de imagen utilizada para guardar el Document (clasificada por orden de la dirección de Color):
Orden para la gestión de los colores
0 (valor de Default)Dispositivo Default Image.
1TwainPaletteImagen cuyos colores son emitidos por un Palette.
2TwainRGBRGB Image.
3TwainGrayScaleEscala de grises Image.
4TwainBlackWhiteBlack y White Image.
-TwainAnyTypeCualquier tipo de Image.

Si se combinan estas constantes, se seleccionará el mejor tipo de imagen soportada por el dispositivo (según el orden de gestión de Color). Para obtener más información, consulte los comentarios.
Se utilizará el tipo de Default de Image:
  • si este parámetro no se especifica o si corresponde a 0.
  • si el tipo especificado de Image no es soportado por el dispositivo.
  • si el valor del parámetro <Interfaz de usuario> es True.
<Number of bits per pixel>: Entero opcional
Cantidad de información sobre los colores (para mostrar o imprimir cada píxel en una Image). Cuanto mayor sea el número de bits por píxel, más nítida será la representación de Color.
Los posibles valores de este parámetro dependen del tipo de Image utilizado:
Tipo de ImageValores posibles
Imagen coloreada emitida desde una paleta (constante TwainPalette).1, 4 u 8
Imagen RGB (constante TwainRGB).8, 10 o 16
Imagen en escala de grises (constante TwainGrayScale).8 o 16
Imagen en blanco y negro (constante TwainBlackWhite).1

Si no se especifica este parámetro, se usará el número de bits por píxel de Default.
<Image resolution>: Real opcional
Número de píxeles por pulgada (los valores posibles dependen del dispositivo utilizado).
Se utilizará la resolución Default Image:
  • si este parámetro no se especifica o si corresponde a 0.
  • si la resolución especificada no es compatible con el dispositivo.
  • si el valor del parámetro <Interfaz de usuario> es True.
<Image contrast>: Real opcional
Contraste de la Image (valor incluido entre -1000 y 1000).
Se usará el contraste Default Image:
  • si este parámetro no se especifica o si corresponde a 0.
  • si el dispositivo no admite el contraste especificado.
  • si el valor del parámetro <Interfaz de usuario> es True.
<Image brightness>: Real opcional
Brillo de la Image (valor incluido entre -1000 y 1000).
Se utilizará el brillo de Default Image:
  • si este parámetro no se especifica o si corresponde a 0.
  • si el dispositivo no soporta el brillo especificado.
  • si el valor del parámetro <Interfaz de usuario> es True.
<Duplex mode>: Booleano opcional
  • True para escanear un documento por lado y lado,
  • False (predeterminado) para escanear el documento por un solo lado.
<Automatic load>: Booleano opcional
  • True para cargar automáticamente las páginas en el dispositivo,
  • False en caso contrario.

Guardar la Document del dispositivo Twain en la memoria en formato Tiff Ocultar los detalles

<Result> = TwainToTIFF(<InMemory> [, <User interface> [, <Type of image> [, <Number of bits per pixel> [, <Image resolution> [, <Image contrast> [, <Image brightness> [, <Duplex mode> [, <Automatic load>]]]]]]]])
<Result>: Buffer
Cadena de bytes que contiene el Document en formato Tiff.
A continuación, esta cadena de bytes puede asignarse a una control Imagen, guardarse en un archivo (fSaveText), enviarse a través de una red (con las funciones de Socket), etc.
<InMemory>: Constante
inMemoryGuarda en la memoria el Document del dispositivo Twain.
<User interface>: Booleano opcional
  • True si se debe mostrar la interfaz de usuario del dispositivo Twain.
  • False (valor predeterminado) si no se debe mostrar la interfaz de usuario del dispositivo Twain.
<Type of image>: Constante o combinación de constantes de tipo Integer (opcional)
Tipo de imagen utilizada para guardar el Document (clasificada por orden de la dirección de Color):
Orden para la gestión de los colores
0 (valor de Default)Dispositivo Default Image.
1TwainPaletteImagen cuyos colores son emitidos por un Palette.
2TwainRGBRGB Image.
3TwainGrayScaleEscala de grises Image.
4TwainBlackWhiteBlack y White Image.
-TwainAnyTypeCualquier tipo de Image.

Si se combinan estas constantes, se seleccionará el mejor tipo de imagen soportada por el dispositivo (según el orden de gestión de Color). Para obtener más información, consulte los comentarios.
Se utilizará el tipo de Default de Image:
  • si este parámetro no se especifica o si corresponde a 0.
  • si el tipo especificado de Image no es soportado por el dispositivo.
  • si el valor del parámetro <Interfaz de usuario> es True.
<Number of bits per pixel>: Entero opcional
Cantidad de información sobre los colores (para mostrar o imprimir cada píxel en una Image). Cuanto mayor sea el número de bits por píxel, más nítida será la representación de Color.
Los posibles valores de este parámetro dependen del tipo de Image utilizado:
Tipo de ImageValores posibles
Imagen coloreada emitida desde una paleta (constante TwainPalette).1, 4 u 8
Imagen RGB (constante TwainRGB).8, 10 o 16
Imagen en escala de grises (constante TwainGrayScale).8 o 16
Imagen en blanco y negro (constante TwainBlackWhite).1

Si no se especifica este parámetro, se usará el número de bits por píxel de Default.
<Image resolution>: Real opcional
Número de píxeles por pulgada (los valores posibles dependen del dispositivo utilizado).
Se utilizará la resolución Default Image:
  • si este parámetro no se especifica o si corresponde a 0.
  • si la resolución especificada no es compatible con el dispositivo.
  • si el valor del parámetro <Interfaz de usuario> es True.
<Image contrast>: Real opcional
Contraste de la Image (valor incluido entre -1000 y 1000).
Se usará el contraste Default Image:
  • si este parámetro no se especifica o si corresponde a 0.
  • si el dispositivo no admite el contraste especificado.
  • si el valor del parámetro <Interfaz de usuario> es True.
<Image brightness>: Real opcional
Brillo de la Image (valor incluido entre -1000 y 1000).
Se utilizará el brillo de Default Image:
  • si este parámetro no se especifica o si corresponde a 0.
  • si el dispositivo no soporta el brillo especificado.
  • si el valor del parámetro <Interfaz de usuario> es True.
<Duplex mode>: Booleano opcional
  • True para escanear un documento por lado y lado,
  • False (predeterminado) para escanear el documento por un solo lado.
<Automatic load>: Booleano opcional
  • True para cargar automáticamente las páginas en el dispositivo,
  • False en caso contrario.
Observaciones

Document procedente del dispositivo Twain

El "Document que viene del dispositivo Twain" corresponde a:
  • el Document en el Scanner cuando se llama al TwainToTIFF. En este caso, se tienen en cuenta los parámetros especificados en TwainScanZone.
  • la Image transmitida por una "cámara web" cuando se llama a TwainToTIFF.
  • la primera foto guardada en una cámara digital.
    Observación: Si se utiliza la interfaz de usuario, la Document recuperada corresponderá a la foto seleccionada por el usuario. Si se seleccionan varias fotos, sólo se recuperará la primera foto seleccionada.

Manejar el tipo de Image

Si se combinan varias constantes en <Tipo de imagen>, se seleccionará el mejor tipo de imagen soportada por el dispositivo (según el orden de gestión de Color).
Por ejemplo: Si este parámetro corresponde a TwainBlackWhite + TwainRGB, el tipo de la imagen será:
  • RGB si este tipo es soportado por el dispositivo.
  • negro y White de otra manera.

Dúplex Scanner

Si el Scanner admite el modo dúplex, tiene la posibilidad de realizar un escaneo a doble cara. El Document generado contiene ambos lados del Document escaneado.
Observación: Dependiendo del hardware utilizado, el controlador Twain puede no ser suficiente para soportar un escaneo de doble cara.. Es posible que tenga que instalar controladores adicionales suministrados por el fabricante.

Modo de funcionamiento en las aplicaciones de 64 bits

En una aplicación de 64 bits, esta función utilizará automáticamente el controlador Twain de 64 bits.. No se puede utilizar el TWAIN si este controlador no está instalado..
Clasificación Lógica de negocio / UI: Lógica de negocio
Componente: wd290std.dll
Versión mínima requerida
  • Versión 19
Esta página también está disponible para…
Comentarios
Haga clic en [Agregar] para publicar un comentario

Última modificación: 27/05/2022

Señalar un error o enviar una sugerencia | Ayuda local