WIA_IPA_DATATYPE
Die WIA_IPA_DATATYPE-Eigenschaft enthält die aktuelle Datentypeinstellung für ein Gerät. Ein WIA-Minidriver erstellt und verwaltet diese Eigenschaft.
Eigenschaftstyp: VT_I4
Gültige Werte: WIA_PROP_LIST
Zugriffsrechte: Lese-/Schreibzugriff
Hinweise
Eine Anwendung liest die WIA_IPA_DATATYPE-Eigenschaft, um den Datentyp eines Bilds zu bestimmen. Die Anwendung schreibt diese Eigenschaft, um den aktuellen Datentyp des Zu übertragenden Bilds festzulegen.
In der folgenden Tabelle werden die Konstanten beschrieben, die für WIA_IPA_DATATYPE gültig sind, wenn die WIA_IPA_FORMAT-Eigenschaft nicht auf WiaImgFmt_RAW festgelegt ist.
| Datentyp | BESCHREIBUNG |
|---|---|
| WIA_DATA_AUTO | Dieser Wert ist für alle programmierbaren Bilddatenquellenelemente gültig, einschließlich Flatbed und Feeder. Wenn dieser Wert vom WIA-Minitreiber unterstützt wird, kann der WIA-Anwendungsclient Folgendes festlegen: WIA_IPA_DATATYPE , um die automatische Farberkennung auf dem Gerät zu aktivieren. Wenn WIA_DATA_AUTO festgelegt ist, muss der WIA-Minitreiber WIA_IPA_DEPTH für dasselbe Element auf WIA_DEPTH_AUTO aktualisieren (dies muss ein unterstützter Wert sein, wenn das Gerät die automatische Farbe unterstützt). Wenn der WIA_IPA_DEPTH Wert WIA_DEPTH_AUTO unterstützt wird, ist der WIA_IPA_DATATYPE Wert WIA_DATA_AUTO nicht mehr optional und wird zu einem erforderlichen Wert. |
| WIA_DATA_COLOR | Die Scandaten sind rot-grün-blau (RGB). Das vollständige Farbformat wird mithilfe der folgenden WIA-Eigenschaften beschrieben: WIA_IPA_CHANNELS_PER_PIXEL WIA_IPA_BITS_PER_CHANNEL WIA_IPA_PLANAR WIA_IPA_PIXELS_PER_LINE WIA_IPA_BYTES_PER_LINE WIA_IPA_NUMBER_OF_LINES |
| WIA_DATA_COLOR_DITHER | Dasselbe wie WIA_DATA_COLOR, mit dem Unterschied, dass die Daten mithilfe des derzeit ausgewählten Dithermusters ditheriert werden. |
| WIA_DATA_COLOR_THRESHOLD | Farbschwellenwertdaten. |
| WIA_DATA_DITHER | Scandaten werden mithilfe des aktuell ausgewählten Dithermusters ditheriert. |
| WIA_DATA_GRAYSCALE | Scandaten stellen die Intensität dar. Die Palette ist eine feste, gleichmäßig angeordnete Graustufe mit einer Tiefe, die die WIA_IPA_DEPTH-Eigenschaft angibt. |
| WIA_DATA_THRESHOLD | Der Schwellenwert beträgt ein Bit pro Pixel schwarzweißer Daten. Daten über den aktuellen Wert von WIA_IPS_THRESHOLD werden in Weiß konvertiert; Daten unter diesem Wert werden in Schwarz konvertiert. |
Die WIA_IPA_DATATYPE-Eigenschaft wird auch verwendet, um den Typ der RAW-Datenübertragung zu beschreiben, die verwendet werden soll, wenn die Anwendung die WIA_IPA_FORMAT-Eigenschaft auf den Wert WiaImgFmt_RAW festlegt. Der Treiber sollte die WIA_IPA_DATATYPE-Eigenschaft auf eine Liste zulässiger Werte festlegen, aus denen die Anwendung auswählen kann.
In der folgenden Tabelle sind die Konstanten aufgeführt, die für WIA_IPA_DATATYPE gültig sind, wenn WIA_IPA_FORMAT auf WiaImgFmt_RAW festgelegt ist.
| Datentyp | BESCHREIBUNG |
|---|---|
| WIA_DATA_GRAYSCALE | Scandaten stellen die Intensität dar. Die Palette ist eine feste, gleichmäßig angeordnete Graustufe mit einer Tiefe, die die WIA_IPA_DEPTH-Eigenschaft angibt. WIA_IPA_RAW_BITS_PER_CHANNEL Eigenschaft muss auf 1 festgelegt werden. |
| WIA_DATA_RAW_BGR | Scandaten sind im BGR-Farbraum (blau-grün-rot) enthalten. Das vollständige Farbformat wird mithilfe der folgenden WIA-Eigenschaften beschrieben: WIA_IPA_CHANNELS_PER_PIXEL WIA_IPA_BITS_PER_CHANNEL WIA_IPA_PIXELS_PER_LINE WIA_IPA_BYTES_PER_LINE WIA_IPA_NUMBER_OF_LINES WIA_IPA_RAW_BITS_PER_CHANNEL muss auf 3 festgelegt werden. |
| WIA_DATA_RAW_CMY | Scandaten befinden sich im CMY-Farbraum (Cyan-Magenta-Yellow). Das vollständige Farbformat wird mithilfe der gleichen WIA-Eigenschaften beschrieben, die für WIA_DATA_RAW_BGR aufgeführt sind. WIA_IPA_RAW_BITS_PER_CHANNEL muss auf 3 festgelegt werden. |
| WIA_DATA_RAW_CMYK | Die Scandaten befinden sich im CMYK-Farbraum (Cyan-Magenta-Yellow-Black). Das vollständige Farbformat wird mithilfe der gleichen WIA-Eigenschaften beschrieben, die für WIA_DATA_RAW_BGR aufgeführt sind. WIA_IPA_RAW_BITS_PER_CHANNEL muss auf 4 festgelegt werden. |
| WIA_DATA_RAW_RGB | Scandaten sind im Farbraum Rot-Grün-Blau (RGB) enthalten. Das vollständige Farbformat wird mit den gleichen WIA-Eigenschaften wie in WIA_DATA_RAW_BGR beschrieben. WIA_IPA_RAW_BITS_PER_CHANNEL muss auf 3 festgelegt werden. |
| WIA_DATA_RAW_YUV | Die Scandaten sind im YUV-Farbraum (Luminance-Blue Difference-Red Difference) enthalten. Das vollständige Farbformat wird mithilfe der gleichen WIA-Eigenschaften beschrieben, die für WIA_DATA_RAW_BGR aufgeführt sind. WIA_IPA_RAW_BITS_PER_CHANNEL muss auf 3 festgelegt werden. |
| WIA_DATA_RAW_YUVK | Die Scandaten sind im YuVK-Farbraum (Luminance-Blue Difference-Red Difference-Black) enthalten. Das vollständige Farbformat wird mithilfe der gleichen WIA-Eigenschaften beschrieben, die für WIA_DATA_RAW_BGR aufgeführt sind. WIA_IPA_RAW_BITS_PER_CHANNEL muss auf 4 festgelegt werden. |
Wenn Sie das Gerät nur auf einen einzelnen Wert festlegen können, erstellen Sie einen WIA_PROP_LIST-Typ, und platzieren Sie den gültigen Wert darin.
Überprüfen Sie die WIA_IPA_DEPTH-Eigenschaft , um die Bittiefe zu bestimmen.
Die eigenschaft WIA_IPA_DATATYPE enthält in der Regel einen einzelnen Wert für Kameras.
Requirements (Anforderungen)
Header: wiadef.h (include Wiadef.h)