Analisi di base per scanner di film

Un'applicazione WIA enumera gli elementi di primo livello nell'albero degli elementi dello scanner per determinare le funzionalità supportate dello scanner. L'applicazione usa quindi l'elemento di primo livello come origine di analisi. Ad esempio, gli elementi dello scanner a superficie piana vengono usati per la scansione dalla superficie piana e gli elementi dell'alimentatore vengono usati per la scansione dall'alimentatore di documenti.

I comportamenti di programmazione e scansione dell'elemento film sono quasi identici a quelli dell'elemento piatto.

Un'applicazione esegue in genere le operazioni seguenti quando programma l'elemento film dello scanner, ma non necessariamente in questo ordine:

• Enumerare gli elementi WIA di primo livello, cercando elementi WIA contrassegnati con il flag di elemento WiaItemTypeProgrammableDataSource e l'impostazione WIA_IPA_ITEM_CATEGORY di WIA_CATEGORY_FILM.

• Leggere i valori validi per WIA_IPS_FILM_SCAN_MODE per verificare le impostazioni di scansione del film. Questa impostazione indicherà il supporto per la scansione di un'immagine positiva o un'immagine negativa (vale a dire un negativo fotografico).

• Scegliere la sorgente di luce positiva o negativa impostando la proprietà WIA_IPS_FILM_SCAN_MODE.

• Leggere le impostazioni correnti per la lampada dello scanner e accendere la lampada, se necessario usando la proprietà WIA_IPS_LAMP (se supportata).

• Leggere i valori validi per WIA_IPA_TYMED e WIA_IPA_FORMAT.

• Scegliere il formato finale dei dati impostando la proprietà WIA_IPA_FORMAT.

• Scegliere le impostazioni dell'immagine, ad esempio WIA_IPA_DEPTH, WIA_IPA_DATATYPE e WIA_IPA_BITS_PER_CHANNEL.

• Scegliere un trasferimento di file a pagina singola o multipla (se supportato) impostando la proprietà WIA_IPA_TYMED.

• Enumerare gli elementi figlio per cercare frame esistenti.

• Leggere l'elemento WIA_IPS_SUPPORTS_CHILD_ITEM_CREATION per determinare se lo scanner supporta la creazione di nuovi fotogrammi.

• Regolare i fotogrammi degli elementi del film esistenti o creare nuovi fotogrammi (a seconda del supporto per la creazione di fotogrammi).

• Leggi la proprietà WIA_IPS_SUPPORTS_CHILD_ITEM_CREATION per determinare se l'elemento scanner per pellicole supporta la funzione speciale di acquisizione di cartelle.

• Eseguire una delle operazioni seguenti:

  • Trasferire i dati usando l'elemento dello scanner per pellicole WIA (non usando la funzione di acquisizione delle cartelle). L'area di scansione del film completa verrà restituita come singola immagine.
  • Trasferire i dati usando l'elemento scanner di film WIA (usando la funzionalità di acquisizione delle cartelle). All'applicazione vengono trasferiti solo gli elementi figlio dello scanner di film WIA, cioè i fotogrammi.
  • Vai a ogni elemento del frame e trasferisci l'elemento WIA.

Il driver esegue normalmente le operazioni seguenti quando usa l'unità di scansione del film dello scanner per eseguire l'analisi:

1. Chiama IWiaMiniDrv::drvValidateItemProperties e IWiaMiniDrv::drvReadItemProperties. Il driver WIA deve convalidare le impostazioni delle proprietà durante la fase di impostazione della proprietà dell'applicazione.

2. Chiama IWiaMiniDrv::drvWriteItemProperties. Il contesto dell'elemento WIA passato appartiene all'elemento scanner di pellicola o a un fotogramma di un elemento di scansione della pellicola in modo che il driver sappia che l'applicazione intende utilizzare l'unità di scansione di pellicola dello scanner per la scansione. Alcuni scanner utilizzano i piatti per la scansione delle pellicole. Lo scanner deve essere configurato per l'illuminazione corretta (in base alla proprietà WIA_IPS_FILM_SCAN_MODE) e le modifiche dell'estensione per la scansione della pellicola.

3. Chiama IWiaMiniDrv::drvAcquireItemData. Il contesto dell'elemento WIA passato appartiene all'elemento scanner per pellicole o a un fotogramma di un elemento di scansione per pellicole. Il driver può facilmente determinare che l'applicazione intende eseguire la scansione utilizzando l'unità di scansione del film.

4. Programmare il dispositivo e effettuare la scansione dall'unità di scansione della pellicola utilizzando le proprietà dell'elemento pellicola corrente (includendo le proprietà di qualsiasi fotogramma figlio). Se il driver WIA non è in modalità di scansione film, tenta di passare a questa modalità per l'analisi. L'applicazione può alternare solo la luce negativa e positiva. L'uso di un elemento scanner di film per la scansione è un contratto tra l'applicazione e il conducente; accettano che la funzionalità di scansione del film dello scanner verrà utilizzata per il trasferimento dei dati.

Le proprietà WIA che si trovano sull'elemento scanner di pellicola devono essere utilizzate dal driver come impostazioni da applicare alla parte di scansione del film prima della scansione. L'applicazione WIA deve sempre considerare attendibili le intestazioni dei dati restituiti dal driver WIA. Ad esempio, lo scanner ha determinato che non può analizzare la larghezza dell'immagine specificata e deve arrotondare il valore. Il driver deve aggiornare le intestazioni dell'immagine con le informazioni aggiornate sulla larghezza in modo che l'applicazione disponga dei dati appropriati. Il driver WIA deve sempre aggiornare la proprietà WIA impostata con le informazioni effettive sui dati restituiti dal dispositivo.