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
  • Scanner multipágina con cargador
  • 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
Le permite realizar una de las siguientes acciones:
  • guardar el Document proveniente del dispositivo Twain en un archivo Bitmap (extensión "BMP")
  • 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 procedente del dispositivo Twain directamente en la memoria en formato Bitmap (en un buffer).
Ejemplo
// Save the document found in the scanner in the "MyPhoto.BMP" file
// The document will be saved in black and white
IF TwainToBMP("C:\Temp\MyPhoto.BMP", False, TwainBlackWhite) = True THEN
Info("The document was saved")
ELSE
Error("The document was not scanned")
END
// Save the document found in the scanner in memory
// The document will be saved in black and white
IMG_MyImage = TwainToBMP(inMemory, False, TwainBlackWhite)
Sintaxis

Guardar y mostrar el Document que viene del dispositivo Twain en un archivo Bitmap Ocultar los detalles

<Result> = TwainToBMP([<BMP 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 guardó el documento. La función ErrorInfo devuelve el mensaje de error correspondiente.
<BMP 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 UNC.
Si este parámetro no se especifica o si corresponde a una cadena vacía ("""), el usuario deberá introducir el nombre completo del archivo Bitmap en un selector de archivos.
<User interface>: Booleano opcional
  • True (valor predeterminado) si se debe mostrar la interfaz de usuario del dispositivo Twain. Al guardar el Document, el archivo <BMP> será propuesto por Default.
  • False 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 predeterminado)Dispositivo Default Image
1TwainPaletteImagen coloreada emitida desde un Palette.
2TwainRGBRGB Image.
3TwainGrayScaleEscala de grises Image.
4TwainBlackWhiteImagen en blanco y negro.
-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 BMP Ocultar los detalles

<Result> = TwainToBMP(<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 BMP.
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 (valor predeterminado) si se debe mostrar la interfaz de usuario del dispositivo Twain.
  • False 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 predeterminado)Dispositivo Default Image
1TwainPaletteImagen coloreada emitida desde un Palette.
2TwainRGBRGB Image.
3TwainGrayScaleEscala de grises Image.
4TwainBlackWhiteImagen en blanco y negro.
-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 TwainToBMP. 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 TwainToBMP.
  • 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.

Scanner multipágina con cargador

Si el Scanner incluye un cargador y si soporta las multipáginas, tiene la posibilidad de realizar un escaneo de todas las páginas de un fila.
Para obtener más información, consulte TwainState.

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 9
Esta página también está disponible para…
Comentarios
Haga clic en [Agregar] para publicar un comentario

Última modificación: 02/09/2022

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