WIA_IPS_YEXTENT

Articolo
06/15/2023

La proprietà WIA_IPS_YEXTENT contiene l'altezza corrente, in pixel, di un'immagine selezionata da acquisire.

Tipo di proprietà: VT_I4

Valori validi: WIA_PROP_RANGE

Diritti di accesso: lettura/scrittura

Commenti

Un'applicazione imposta la proprietà WIA_IPS_YEXTENT per contrassegnare l'angolo superiore sinistro (ovvero l'altezza) di un'area di selezione da acquisire. Il minidriver WIA crea e gestisce questa proprietà.

WIA_IPS_YEXTENT è necessario per tutti gli elementi abilitati per l'acquisizione di immagini e gli elementi figlio di questi elementi; questa proprietà non è disponibile per gli elementi di archiviazione o per gli elementi di immagine archiviati.

Quando viene impostata una dimensione di pagina fissa, il driver deve impostare le proprietà WIA_IPS_XEXTENT, WIA_IPS_XPOS, WIA_IPS_YEXTENT e WIA_IPS_YPOS in modo che corrispondano alle dimensioni della pagina e a un'origine "0". Per l'allineamento al centro del documento, il driver deve impostare WIA_IPS_XPOS su ((larghezza area di analisi - larghezza documento) / 2) * risoluzione [DPI]) e WIA_IPS_YPOS su ((altezza dell'area di analisi - altezza documento) / 2) * risoluzione [DPI]).

Quando l'origine o un extent viene modificato, il driver deve aggiornare il WIA_IPS_PAGE_SIZE in CUSTOM_SIZE e le proprietà WIA_IPS_PAGE_WIDTH e WIA_IPS_PAGE_HEIGHT in modo che corrispondano agli extent dell'area di analisi. L'orientamento e la rotazione non devono influire su queste proprietà, a meno che una modifica dell'orientamento (non una modifica di rotazione) esegua il rendering dell'origine o di un extent all'esterno dell'area di analisi documento disponibile.

Un driver deve inoltre aggiornare le proprietà WIA_IPS_XEXTENT, WIA_IPS_XPOS, WIA_IPS_YEXTENT e WIA_IPS_YPOS quando vengono modificate le proprietà WIA_IPS_XRES e WIA_IPS_YRES .

Nota

Gli elementi figlio Flatbed e Film sono necessari per supportare solo le proprietà WIA_IPS_XEXTENT, WIA_IPS_XPOS, WIA_IPS_XRES, WIA_IPS_YEXTENT, WIA_IPS_YPOS e WIA_IPS_YRES. Tutte le altre proprietà, obbligatorie o facoltative per il padre (gli elementi Flatbed o Film di base) sono facoltative solo per questi elementi. Le uniche eccezioni sono le proprietà WIA_IPA_ITEM_Xxx , necessarie per tutti gli elementi.