Condividi tramite


Costanti delle proprietà del dispositivo fotocamera

I dispositivi hardware Windows Image Acquisition (WIA) hanno valori di proprietà archiviati nel Registro di sistema di Windows. Per altre informazioni, vedere Costanti comuni delle proprietà del dispositivo.

Le costanti di proprietà del dispositivo seguenti, con le stringhe associate, sono specifiche delle fotocamere digitali. Il prefisso "WIA_DPC_" indica una proprietà del dispositivo per fotocamere ed è la convenzione di denominazione usata in C/C++. Ai fini dello scripting, queste costanti usano il prefisso "CameraDevice" e fanno parte del tipo enumerato WiaItemPropertyId . Il nome del membro corrispondente dell'enumerazione script viene visualizzato tra parentesi accanto al nome della costante C/C++ nell'elenco seguente.

Nota

WIA non supporta fotocamere in Windows Vista o versioni successive. Per queste versioni di Windows, usare l'API WINDOWS Portable Device (WPD) descritta in Windows Driver Development Kit (DDK) per acquisire immagini dalle fotocamere.

 

Costante/valore Descrizione
WIA_DPC_PICTURES_TAKEN
CameraDevicePicturesTaken
Numero di immagini scattate dalla fotocamera. Il minidriver crea e gestisce questa proprietà.
Tipo: VT_I4, Access: Sola lettura, Valori validi: WIA_PROP_NONE
WIA_DPC_PICTURES_REMAINING
CameraDevicePicturesRemaining
Numero di immagini che è possibile scattare, in base alle impostazioni correnti della proprietà. Se queste impostazioni cambiano e le modifiche influiscono sulle dimensioni delle immagini che il dispositivo fotocamera produce, il minidriver WIA deve aggiornare il numero di immagini rimanenti. Il minidriver crea e gestisce questa proprietà.
Tipo: VT_I4, Access: Sola lettura, Valori validi: WIA_PROP_NONE
WIA_DPC_EXPOSURE_MODE
CameraDeviceExposureMode
Indica la modalità di esposizione corrente della fotocamera. Un'applicazione modifica questa proprietà per controllare la modalità di esposizione del dispositivo fotocamera.
Tipo: VT_I4, Access: Lettura/Scrittura, Valori validi: WIA_PROP_LIST
Nella tabella seguente sono presenti le sette costanti valide con questa proprietà.
Modalità di esposizione Descrizione
EXPOSUREMODE_MANUAL La velocità dell'otturatore e l'apertura vengono impostate dall'utente.
EXPOSUREMODE_AUTO La velocità dell'otturatore e l'apertura vengono impostate automaticamente dalla fotocamera.
EXPOSUREMODE_APERTURE_PRIORITY L'apertura viene impostata dall'utente e la fotocamera imposta automaticamente la velocità dell'otturatore.
EXPOSUREMODE_SHUTTER_PRIORITY La velocità dell'otturatore viene impostata dall'utente e la fotocamera imposta automaticamente l'apertura.
EXPOSUREMODE_PROGRAM_CREATIVE La velocità dell'otturatore e l'apertura vengono impostate automaticamente dalla fotocamera, ottimizzata per la materia ancora in questione.
EXPOSUREMODE_PROGRAM_ACTION La velocità dell'otturatore e l'apertura vengono impostate automaticamente dalla fotocamera, ottimizzata per le scene contenenti movimento rapido.
EXPOSUREMODE_PORTRAIT La velocità dell'otturatore e l'apertura vengono impostate automaticamente dalla fotocamera, ottimizzata per la fotografia verticale.

 

WIA_DPC_EXPOSURE_COMP
CameraDeviceExposureComp

Consente la regolazione del punto impostato del controllo di esposizione automatica della fotocamera digitale. Ad esempio, un'impostazione pari a zero non modifica il livello di esposizione automatica del set di factory. Le unità sono in "stop" ridimensionate da un fattore pari a 1000, per consentire valori di interruzione frazionari. Un'impostazione di 2000 corrisponde a due arresti dell'esposizione (quattro volte più energia sul sensore), producendo immagini più luminose. Un'impostazione di -1000 corrisponde a una sola interruzione di esposizione (metà dell'energia sul sensore) che produce immagini più scure. I valori delle impostazioni si trovano in unità additive system di esposizione fotografica (APEX). Questa proprietà può essere espressa come elenco o intervallo di valori. Questa proprietà viene in genere utilizzata solo quando il dispositivo ha la proprietà WIA_DPC_EXPOSURE_MODE impostata su EXPOSUREMODE_MANUAL.

Tipo: VT_I4, Access: Lettura/Scrittura, Valori validi: WIA_PROP_RANGE o WIA_PROP_LIST

WIA_DPC_EXPOSURE_TIME
CameraDeviceExposureTime

Corrisponde alla velocità dell'otturatore, in secondi ridimensionati di 10.000. In genere, il dispositivo usa questa proprietà solo quando la proprietà WIA_DPC_EXPOSURE_MODE è impostata su EXPOSUREMODE_MANUAL o EXPOSUREMODE_SHUTTER_PRIORITY.

Tipo: VT_I4, Access: Lettura/Scrittura, Valori validi: WIA_PROP_RANGE o WIA_PROP_LIST

WIA_DPC_FNUMBER
CameraDeviceFNumber

Corrisponde all'apertura dell'obiettivo, in unità del numero f-stop scalato di 100. L'impostazione di questa proprietà è in genere valida solo quando la proprietà WIA_DPC_EXPOSURE_MODE è impostata su EXPOSUREMODE_MANUAL o EXPOSUREMODE_APERTURE_PRIORITY.

Tipo: VT_I4, Access: Lettura/Scrittura, Valori validi: WIA_PROP_LIST

WIA_DPC_FLASH_MODE
CameraDeviceFlashMode

Definisce l'impostazione corrente della modalità flash per il dispositivo fotocamera. Il driver di dispositivo enumera i valori supportati di questa proprietà. Un'applicazione scrive questa proprietà per impostare la modalità flash per il dispositivo fotocamera.

Tipo: VT_I4, Access: Lettura/Scrittura, Valori validi: WIA_PROP_LIST

Nella tabella seguente sono presenti le sei costanti valide con questa proprietà.

Modalità flash Definizione
FLASHMODE_AUTO Il dispositivo fotocamera determina le impostazioni flash appropriate.
FLASHMODE_FILL Il dispositivo fotocamera è configurato per eseguire il flashing indipendentemente dalle condizioni di illuminazione correnti.
FLASHMODE_OFF Il dispositivo fotocamera è configurato per non lampeggiare per nessuna immagine scattata.
FLASHMODE_REDEYE_AUTO Il dispositivo fotocamera determina le impostazioni del flash appropriate utilizzando la riduzione degli occhi rossi, indipendentemente dalle condizioni di illuminazione correnti.
FLASHMODE_REDEYE_FILL Il dispositivo fotocamera è configurato per l'uso della riduzione degli occhi rossi e del flash indipendentemente dalle condizioni di illuminazione correnti.
FLASHMODE_EXTERNALSYNC Il dispositivo fotocamera è configurato per la sincronizzazione con unità flash esterne.

 

WIA_DPC_FOCUS_MODE
CameraDeviceFocusMode

Definisce l'impostazione della modalità messa a fuoco corrente per il dispositivo fotocamera. Il driver di dispositivo enumera i valori supportati di questa proprietà. Un'applicazione scrive questa proprietà per impostare la modalità messa a fuoco per il dispositivo fotocamera.

Tipo: VT_I4, Access: Lettura/Scrittura, Valori validi: WIA_PROP_LIST

La tabella seguente include le tre costanti valide con questa proprietà.

Modalità messa a fuoco Descrizione
FOCUSMODE_MANUAL Il dispositivo fotocamera è configurato per consentire all'utente di concentrarsi manualmente.
FOCUSMODE_AUTO Il dispositivo fotocamera è configurato per lo stato attivo automaticamente.
FOCUSMODE_MACROAUTO Il dispositivo fotocamera è configurato per lo stato attivo automaticamente usando le impostazioni macro a breve intervallo.

 

WIA_DPC_FOCUS_MANUAL_DIST

Riservato, non usare.

Tipo: VT_I4, Access: Sola lettura, Valori validi: WIA_PROP_NONE

WIA_DPC_ZOOM_POSITION

Riservato, non usare.

Tipo: VT_I4, Access: Sola lettura, Valori validi: WIA_PROP_NONE

WIA_DPC_PAN_POSITION
CameraDevicePanPosition

Riservato, non usare.

Tipo: VT_I4, Access: Sola lettura, Valori validi: WIA_PROP_NONE

WIA_DPC_TILT_POSITION
CameraDeviceTiltPosition

Riservato, non usare.

Tipo: VT_I4, Access: Sola lettura, Valori validi: WIA_PROP_NONE

WIA_DPC_TIMER_MODE
CameraDeviceTimerMode

Riservato, non usare.

Tipo: VT_I4, Access: Sola lettura, Valori validi: WIA_PROP_NONE

WIA_DPC_TIMER_VALUE
CameraDeviceTimerValue

Riservato, non usare.

Tipo: VT_I4, Access: Sola lettura, Valori validi: WIA_PROP_NONE

WIA_DPC_POWER_MODE
CameraDevicePowerMode

Definisce la fonte di alimentazione corrente per il dispositivo fotocamera. Un'applicazione legge questa proprietà per determinare la fonte di alimentazione usata dalla fotocamera.

Tipo: VT_I4, Access: Sola lettura, Valori validi: WIA_PROP_NONE

Nella tabella seguente sono presenti le due costanti valide con questa proprietà.

Modalità risparmio di energia Descrizione
POWERMODE_LINE Il dispositivo fotocamera funziona su una scheda di alimentazione.
POWERMODE_BATTERY Il dispositivo fotocamera funziona con l'alimentazione a batteria.

 

WIA_DPC_BATTERY_STATUS
CameraDeviceBatteryStatus

Percentuale di alimentazione della batteria lasciata per operare il dispositivo fotocamera. Questo valore deve essere un numero intero compreso tra 0 e 100. Un'applicazione legge questa proprietà per determinare la durata rimanente della batteria del dispositivo fotocamera.

Tipo: VT_I4, Access: Sola lettura, Valori validi: WIA_PROP_NONE

WIA_DPC_THUMB_WIDTH
CameraDeviceThumbWidth

Larghezza, in pixel, di un'immagine di anteprima da usare per le immagini appena acquisite. Un'applicazione legge questo valore per ottenere una dimensione stimata per la visualizzazione delle anteprime nell'interfaccia utente.

Tipo: VT_I4, Access: lettura/scrittura (WIA_PROP_LIST) o sola lettura (WIA_PROP_NONE), valori validi: WIA_PROP_LIST o WIA_PROP_NONE

WIA_DPC_THUMB_HEIGHT
CameraDeviceThumbHeight

Larghezza, in pixel, di un'immagine di anteprima da usare per le immagini appena acquisite. Un'applicazione legge questo valore per ottenere una dimensione stimata per la visualizzazione delle anteprime nell'interfaccia utente.

Tipo: VT_I4, Access: lettura/scrittura (WIA_PROP_LIST) o sola lettura (WIA_PROP_NONE), valori validi: WIA_PROP_LIST o WIA_PROP_NONE

WIA_DPC_PICT_WIDTH
CameraDevicePictWidth

Larghezza in pixel da usare per le immagini appena acquisite. L'elenco di valori validi per questa proprietà ha una corrispondenza uno-a-uno all'elenco di valori validi per la proprietà WIA_DPC_PICT_HEIGHT . Se la larghezza e l'altezza individuali sono impostate in modo lineare e ortogonale tra loro, possono essere espresse come intervallo.

Tipo: VT_I4, Access: Lettura/Scrittura, Valori validi: WIA_PROP_LIST o WIA_PROP_RANGE

WIA_DPC_PICT_HEIGHT
CameraDevicePictHeight

Altezza in pixel da usare per le immagini appena acquisite. L'elenco di valori validi per questa proprietà ha una corrispondenza uno-a-uno con l'elenco di valori validi per la proprietà WIA_DPC_PICT_WIDTH . Se la larghezza e l'altezza individuali sono impostate in modo lineare e ortogonale tra loro, possono essere espresse come intervallo.

Tipo: VT_I4, Access: Lettura/Scrittura, Valori validi: WIA_PROP_LIST o WIA_PROP_RANGE

WIA_DPC_DIMENSION

Riservato, non usare.

Tipo: VT_I4, Access: Sola lettura, Valori validi: WIA_PROP_NONE

WIA_DPC_COMPRESSION_SETTING
CameraDeviceCompressionSetting

Destinato a essere approssimativamente lineare rispetto alla qualità percepita delle immagini su un'ampia gamma di contenuti della scena e contiene un intervallo o un elenco di numeri interi. I numeri interi più piccoli vengono usati per rappresentare una qualità inferiore (ovvero la compressione massima), mentre i numeri interi più grandi vengono usati per rappresentare una qualità più elevata ,ovvero la compressione minima. Le impostazioni disponibili in un dispositivo sono relative solo a tale dispositivo e sono quindi specifiche del dispositivo.

Tipo: VT_I4, Access: Lettura/Scrittura, Valori validi: WIA_PROP_LIST o WIA_PROP_RANGE

WIA_DPC_FOCUS_METERING

Riservato, non usare.

Tipo: VT_I4, Access: Sola lettura, Valori validi: WIA_PROP_NONE

WIA_DPC_TIMELAPSE_INTERVAL
CameraDeviceTimelapseInterval

Tempo, in millisecondi, tra acquisizioni di immagini in un'operazione di acquisizione time-lapse.

Tipo: VT_I4, Access: lettura/scrittura, valori validi: WIA_PROP_NONE, WIA_PROP_LIST o WIA_PROP_RANGE

WIA_DPC_TIMELAPSE_NUMBER
CameraDeviceTimelapseNumber

Numero di immagini che il dispositivo tenta di acquisire durante un'acquisizione time-lapse.

Tipo: VT_I4, Access: lettura/scrittura, valori validi: WIA_PROP_NONE, WIA_PROP_LIST o WIA_PROP_RANGE

WIA_DPC_BURST_INTERVAL
CameraDeviceBurstInterval

Tempo, in millisecondi, tra acquisizioni di immagini durante un'operazione burst.

Tipo: VT_I4, Access: lettura/scrittura, valori validi: WIA_PROP_NONE, WIA_PROP_LIST o WIA_PROP_RANGE

WIA_DPC_BURST_NUMBER
CameraDeviceBurstNumber

Numero di immagini che il dispositivo tenta di acquisire durante un'operazione burst.

Tipo: VT_I4, Access: lettura/scrittura, valori validi: WIA_PROP_NONE, WIA_PROP_LIST o WIA_PROP_RANGE

WIA_DPC_EFFECT_MODE
CameraDeviceEffectMode

Specifica la modalità speciale di acquisizione dell'immagine della fotocamera.

Tipo: VT_I4, Access: Lettura/Scrittura, Valori validi: WIA_PROP_LIST

La tabella seguente include le tre costanti valide con questa proprietà.

Modalità effetto Descrizione
EFFECTMODE_STANDARD Acquisire un'immagine in modalità standard per la fotocamera.
EFFECTMODE_BW Acquisire un'immagine in scala di grigi.
EFFECTMODE_SEPIA Acquisire un'immagine sepia.

 

WIA_DPC_DIGITAL_ZOOM
CameraDeviceDigitalZoom

Il rapporto di zoom effettivo dell'immagine acquisita dalla fotocamera digitale, ridimensionato da un fattore pari a 10. Il valore 10 corrisponde all'assenza di zoom digitale (1X), ovvero la dimensione standard della scena acquisita dalla fotocamera. Il valore 20 corrisponde a uno zoom 2X, in cui un quarto delle dimensioni standard della scena viene acquisito dalla fotocamera.

Tipo: VT_I4, Access: Lettura/Scrittura, Valori validi: WIA_PROP_LIST o WIA_PROP_RANGE

WIA_DPC_SHARPNESS
CameraDeviceSharpness

La nitidezza percepita di un'immagine acquisita. Questa proprietà può utilizzare un elenco di valori o un intervallo di valori. Il valore minimo rappresenta la quantità minima di nitidezza, mentre il valore massimo rappresenta la nitidezza massima. In genere, un valore al centro dell'intervallo rappresenta la nitidezza normale o predefinita.

Tipo: VT_I4, Access: Lettura/Scrittura, Valori validi: WIA_PROP_LIST o WIA_PROP_RANGE

WIA_DPC_CONTRAST
CameraDeviceContrast

Contrasto percepito di un'immagine acquisita. Questa proprietà può contenere un elenco di valori o un intervallo di valori. Il valore minimo supportato rappresenta la quantità minima di contrasto, mentre il valore massimo rappresenta il contrasto maggiore. In genere, un valore al centro dell'intervallo rappresenta il contrasto normale o predefinito.

Tipo: VT_I4, Access: Lettura/Scrittura, Valori validi: WIA_PROP_LIST o WIA_PROP_RANGE

WIA_DPC_CAPTURE_MODE
CameraDeviceCaptureMode

Imposta la modalità di acquisizione delle immagini.

Tipo: VT_I4, Access: Lettura/Scrittura, Valori validi: WIA_PROP_LIST

La tabella seguente include le tre costanti valide con questa proprietà.

Modalità acquisizione Descrizione
CAPTUREMODE_NORMAL Modalità normale per la fotocamera.
CAPTUREMODE_BURST Acquisire più di un'immagine in rapida successione, come definito dai valori delle proprietà WIA_DPC_BURST_NUMBER e WIA_DPC_BURST_INTERVAL .
CAPTUREMODE_TIMELAPSE Acquisire più di un'immagine in successione come definito dalle proprietà WIA_DPC_TIMELAPSE_NUMBER e WIA_DPC_TIMELAPSE_INTERVAL .

 

WIA_DPC_CAPTURE_DELAY
CameraDeviceCaptureDelay

Valore che rappresenta la quantità di ritardo, in millisecondi, che deve essere inserita tra il trigger di acquisizione e l'avvio effettivo dell'acquisizione dati. Questa proprietà non deve essere usata per descrivere il tempo tra i fotogrammi per l'avvio singolo, più acquisizioni, ad esempio burst o time lapse, con proprietà intervallo separate WIA_DPC_BURST_INTERVAL e WIA_DPC_TIMELAPSE_INTERVAL. In questi casi, viene comunque usato come ritardo iniziale prima che venga acquisita la prima immagine della serie, indipendentemente dal tempo tra i fotogrammi. Per nessun ritardo di precapture, questa proprietà deve essere impostata su zero.

Tipo: VT_I4, Access: Lettura/Scrittura, Valori validi: WIA_PROP_LIST o WIA_PROP_RANGE

WIA_DPC_EXPOSURE_INDEX
CameraDeviceExposureIndex

Consente l'emulazione delle impostazioni di velocità del film su una fotocamera digitale. Le impostazioni corrispondono alle designazioni ISO (ASA/DIN). In genere, un dispositivo supporta valori enumerati discreti, ma è possibile il controllo continuo su un intervallo di valori. Il valore 0xFFFF corrisponde all'impostazione ISO automatica.

Tipo: VT_I4, Access: Lettura/Scrittura, Valori validi: WIA_PROP_LIST o WIA_PROP_RANGE

WIA_DPC_EXPOSURE_METERING_MODE
CameraDeviceExposureMeteringMode

Specifica la modalità utilizzata dalla fotocamera per regolare automaticamente l'impostazione dell'esposizione.

Tipo: VT_I4, Access: Lettura/Scrittura, Valori validi: WIA_PROP_LIST

Modalità di misurazione dell'esposizione Descrizione
EXPOSUREMETERING_AVERAGE Impostare l'esposizione in base a una media dell'intera scena.
EXPOSUREMETERING_CENTERWEIGHT Impostare l'esposizione in base a una media ponderata al centro.
EXPOSUREMETERING_MULTISPOT Impostare l'esposizione in base a un modello multispota.
EXPOSUREMETERING_CENTERSPOT Impostare l'esposizione in base a un punto centrale.

 

WIA_DPC_FOCUS_METERING_MODE
CameraDeviceFocusMeteringMode

Specifica la modalità utilizzata dalla fotocamera per regolare automaticamente lo stato attivo.

Tipo: VT_I4, Access: Lettura/Scrittura, Valori validi: WIA_PROP_LIST

Nella tabella seguente sono presenti le due costanti valide con questa proprietà.

Modalità di misurazione dello stato attivo Descrizione
FOCUSMETERING_CENTERSPOT Regolare lo stato attivo in base a un punto centrale.
FOCUSMETERING_MULTISPOT Regolare lo stato attivo in base a un modello multispota.

 

WIA_DPC_FOCUS_DISTANCE
CameraDeviceFocusDistance

Distanza, in millimetri, tra il piano di acquisizione delle immagini della fotocamera digitale e il punto di messa a fuoco. Un valore di 0xFFFF corrisponde a un'impostazione maggiore di 655 metri.

Tipo: VT_I4, Access: Lettura/Scrittura, Valori validi: WIA_PROP_LIST o WIA_PROP_RANGE

WIA_DPC_FOCAL_LENGTH
CameraDeviceFocalLength

Lunghezza focale equivalente a 35 mm. I valori di questa proprietà corrispondono alla lunghezza focale in millimetri moltiplicati per 100. La lunghezza focale determina lo zoom ottico.

Tipo: VT_I4, Access: Lettura/Scrittura, Valori validi: WIA_PROP_NONE

WIA_DPC_RGB_GAIN
CameraDeviceRGBGain

Stringa Unicode con terminazione Null che rappresenta rispettivamente il guadagno rosso, verde e blu applicato ai dati dell'immagine. Ad esempio, "4:25:50" rappresenta un guadagno rosso pari a 4, un guadagno verde pari a 25 e un guadagno blu pari a 50.

Tipo: VT_BSTR, Access: Lettura/Scrittura, Valori validi: WIA_PROP_NONE

WIA_DPC_WHITE_BALANCE
CameraDeviceWhiteBalance

Specifica il modo in cui la fotocamera digitale pesa i canali di colore.

Tipo: VT_I4, Access: Lettura/Scrittura, Valori validi: WIA_PROP_LIST

Di seguito è riportato un elenco di valori possibili per questa proprietà.

Bilanciamento del bianco Descrizione
WHITEBALANCE_MANUAL Il bilanciamento del bianco viene impostato direttamente usando la proprietà WIA_DPC_RGB_GAIN .
WHITEBALANCE_AUTO La fotocamera usa un meccanismo automatico per impostare il bilanciamento del bianco.
WHITEBALANCE_ONEPUSH_AUTO La fotocamera determina l'impostazione di bilanciamento del bianco quando un utente preme il pulsante di acquisizione mentre punta la fotocamera su una superficie bianca.
WHITEBALANCE_DAYLIGHT La fotocamera imposta il bilanciamento del bianco su un valore appropriato per l'uso in condizioni di luce legale.
WHITEBALANCE_FLORESCENT La fotocamera imposta il bilanciamento del bianco su un valore appropriato per l'uso con una fonte di luce fluorescente.
WHITEBALANCE_TUNGSTEN La fotocamera imposta il bilanciamento del bianco su un valore appropriato per l'uso con una fonte di luce del tungsteno.
WHITEBALANCE_FLASH La fotocamera imposta il bilanciamento del bianco su un valore appropriato per l'uso con un flash elettronico.

 

WIA_DPC_UPLOAD_URL
CameraDeviceUploadURL

Descrive un URL. L'URL descritto da questa proroperty è uno che le immagini o gli oggetti, dopo essere stati acquisiti dal dispositivo, possono essere caricati in, in base a uno degli scenari seguenti.

  • Un'applicazione WIA legge questa proprietà e consente all'utente di caricare automaticamente immagini nell'URL.
  • Un'applicazione imposta l'URL e altri dispositivi (chioschi e così via) usano questa proprietà.

Microsoft Windows non carica le immagini da solo.

Tipo: VT_BSTR, Accesso: Lettura/Scrittura, Valori validi: WIA_PROP_NONE

WIA_DPC_ARTIST
CameraDeviceArtist

Nome del proprietario ( ovvero l'utente corrente) del dispositivo. Il dispositivo usa questa proprietà per popolare il campo Artist in ogni immagine EXIF acquisita.

Tipo: VT_BSTR, Accesso: Lettura/Scrittura, Valori validi: WIA_PROP_NONE

WIA_DPC_COPYRIGHT_INFO
CameraDeviceCopyrightInfo

Notifica del copyright. Il dispositivo usa questa proprietà per popolare il campo Copyright in ogni immagine EXIF acquisita.

Tipo: VT_BSTR, Accesso: Lettura/Scrittura, Valori validi: WIA_PROP_NONE

Requisiti

Requisito Valore
Client minimo supportato
Windows 2000 Professional, Windows XP [solo app desktop]
Server minimo supportato
Windows Server 2003 [solo app desktop]
Intestazione
Wiadef.h