Usare zoom, pan e selezione delle regioni

La scheda PDF / Image di Unified Documents permette di adattare un documento alla finestra, ingrandirlo, spostarne l’anteprima e delimitare una regione precisa. In questa guida utilizziamo un PNG sintetico di 1200 × 780 pixel e un PDF sintetico di due pagine A4, già registrati come Dataset canonici nella Session GX-TXT.

I comandi sono quelli presenti nel Viewer Unified Documents 1.2.0. I nomi inglesi sono mantenuti come appaiono nell’interfaccia. I grafici dell’esempio sono illustrativi, non misure sperimentali.

1. Aprire il documento corretto

Apri GX-TXT nella Session contenente il documento e scegli Viewers → Unified Documents. In Source, seleziona il Dataset immagine u04.synthetic_image e premi Open source.

Schermata originale di GX-TXT Unified Documents: Il PNG di esempio aperto nella scheda PDF / Image, prima delle regolazioni
Figura 1. Il PNG di esempio aperto nella scheda PDF / Image, prima delle regolazioni.

L’anteprima iniziale mostra un’unica immagine, con due curve sintetiche. La barra Opened: conferma il Dataset, page 1/1, la dimensione nativa 1200 × 780 px e il prefisso della sua impronta SHA-256. Questo controllo è essenziale prima di selezionare o spostare una regione.

2. Identificare la palette di navigazione

Nella scheda PDF / Image la palette superiore contiene, fra gli altri comandi, Fit page, Zoom −, Zoom +, Region e Pan. Il menu View mette a disposizione anche Fit width, Clear region e Select page.

Queste funzioni operano sulla rappresentazione o sulla selezione del documento già aperto. Non sostituiscono l’importazione del file né generano automaticamente un nuovo Dataset.

3. Fit page: vedere l’intera immagine

Premi Fit page nella palette. Il Viewer calcola un ingrandimento che permette di mostrare l’intera immagine nella zona disponibile.

Schermata originale di GX-TXT Unified Documents: Fit page mostra l’intera immagine nella zona di anteprima, con Zoom circa 62,44%
Figura 2. Fit page mostra l’intera immagine nella zona di anteprima, con Zoom circa 62,44%.

Nel nostro esempio, il PNG di 1200 × 780 pixel viene visualizzato a circa 62,44%, con un’anteprima di 749 × 487 pixel. Il documento originale conserva comunque 1200 × 780 pixel.

Fit page è particolarmente comodo per controllare il contesto complessivo prima di scegliere una zona del documento.

4. Fit width: adattare la larghezza

Apri View → Fit width. Questo comando occupa la larghezza disponibile con l’immagine, anche se la sua altezza non può essere mostrata tutta insieme.

Schermata originale di GX-TXT Unified Documents: Fit width riempie la larghezza e rende necessario lo scorrimento verticale
Figura 3. Fit width riempie la larghezza e rende necessario lo scorrimento verticale.

Nella prova lo zoom è salito a circa 81,92%, producendo un’immagine visualizzata di 983 × 639 pixel. L’anteprima richiede ora lo scorrimento verticale.

Non confondere Fit width con Fit page: uno privilegia la larghezza, l’altro la visualizzazione completa.

5. Confrontare Fit page e Fit width

I valori osservati sul PNG illustrano la differenza:

Comando Zoom effettivo Dimensioni dell’anteprima
Fit page 62,44% 749 × 487 px
Fit width 81,92% 983 × 639 px

Le dimensioni dipendono anche dallo spazio effettivamente disponibile nel Viewer. L’informazione scientifica presente nel file originale rimane invariata: lo zoom non aggiunge né elimina pixel dal Dataset canonico.

6. Zoom +: aumentare l’ingrandimento

Premi il pulsante Zoom + dopo Fit width.

Schermata originale di GX-TXT Unified Documents: Zoom + ingrandisce l’immagine e rende disponibili entrambi gli scorrimenti
Figura 4. Zoom + ingrandisce l’immagine e rende disponibili entrambi gli scorrimenti.

Nella prova, il valore è passato da 81,92% a circa 102,40%. Il contenuto visualizzato occupa 1229 × 799 pixel, più della zona di anteprima: diventano quindi utilizzabili gli scorrimenti orizzontale e verticale.

Il pulsante non modifica i byte della sorgente. Aumenta soltanto la scala di visualizzazione.

7. Zoom −: tornare a una scala inferiore

Premi Zoom − per ridurre l’ingrandimento.

Schermata originale di GX-TXT Unified Documents: Zoom − riduce l’ingrandimento e riporta la scala al valore precedente
Figura 5. Zoom − riduce l’ingrandimento e riporta la scala al valore precedente.

Partendo da circa 102,40%, il Viewer è tornato a 81,92%. Questo esempio mostra la reversibilità della regolazione: se un ingrandimento non è pratico, puoi riportarti alla scala precedente senza riaprire il file.

8. Zoom al 100%

Il campo Zoom % può essere utilizzato anche direttamente. Imposta 100 e applica la modifica mediante Render page.

Schermata originale di GX-TXT Unified Documents: A Zoom 100% il PNG mantiene la sua dimensione visiva di 1200 × 780 pixel
Figura 6. A Zoom 100% il PNG mantiene la sua dimensione visiva di 1200 × 780 pixel.

A 100%, l’immagine viene visualizzata a 1200 × 780 pixel, corrispondenti alle sue dimensioni raster native. Poiché il Canvas è più piccolo, soltanto una parte è visibile alla volta.

Il valore di Zoom % è una scala di presentazione e non una nuova risoluzione di acquisizione.

9. Quando l’immagine supera il Canvas

Quando l’immagine visualizzata è più grande dell’area disponibile, puoi muoverti al suo interno con le barre di scorrimento oppure con Pan.

La posizione osservata nella finestra si riferisce alla parte attualmente visibile. Non deve essere confusa con le coordinate permanenti dei pixel del documento, né con una selezione di regione.

10. Attivare Pan

Premi Pan nella palette degli strumenti. Il Viewer passa alla modalità di spostamento dell’anteprima.

Schermata originale di GX-TXT Unified Documents: La modalità Pan è selezionata nella palette degli strumenti di pagina
Figura 7. La modalità Pan è selezionata nella palette degli strumenti di pagina.

La riga di stato può indicare Pointer mode: pan. Questa modalità serve a cambiare la parte del documento visualizzata; non definisce un’area destinata alla pubblicazione o all’estrazione.

11. Spostare la pagina con il trascinamento

Con Pan attivo, premi il pulsante sinistro del mouse sull’anteprima e trascina nella direzione desiderata.

Schermata originale di GX-TXT Unified Documents: Il trascinamento con Pan sposta realmente la porzione del PNG visibile
Figura 8. Il trascinamento con Pan sposta realmente la porzione del PNG visibile.

Nel nostro esempio, un trascinamento ha cambiato realmente la posizione dello scorrimento sia in orizzontale sia in verticale. La porzione di grafico mostrata è diversa, ma l’identificativo della sorgente, la sua impronta e le dimensioni originali sono rimasti gli stessi.

12. Utilizzare il pulsante centrale del mouse

Sull’anteprima è disponibile anche il trascinamento con il tasto centrale del mouse, verificato nella finestra del Viewer.

Schermata originale di GX-TXT Unified Documents: Il trascinamento con il tasto centrale del mouse sposta il contenuto del Canvas
Figura 9. Il trascinamento con il tasto centrale del mouse sposta il contenuto del Canvas.

Il movimento agisce sulla posizione del Canvas. È utile quando la pagina è già ingrandita e vuoi esplorarla senza cambiare il valore di Zoom %.

13. Scorrere con la rotellina

La rotellina del mouse consente di scorrere verticalmente nell’anteprima.

Schermata originale di GX-TXT Unified Documents: La rotellina del mouse modifica lo scorrimento verticale nell’anteprima
Figura 10. La rotellina del mouse modifica lo scorrimento verticale nell’anteprima.

Sono stati verificati entrambi i versi dello scorrimento. La rotellina cambia la porzione visibile, non il numero della pagina e non la dimensione originaria del documento.

14. Pan, Zoom e selezione sono operazioni diverse

È utile mantenere separati i tre concetti:

  • Zoom modifica la scala con cui la pagina viene presentata.
  • Pan modifica la posizione della parte visibile, lasciando invariata la scala.
  • Region delimita un rettangolo riferito al documento, indipendente dalla posizione dell’anteprima.

Quando termini lo spostamento con Pan, utilizza Fit page per tornare alla visione d’insieme prima di disegnare una nuova regione.

15. Attivare Region

Premi Fit page per ripristinare la vista completa, poi seleziona Region nella palette.

Schermata originale di GX-TXT Unified Documents: La modalità Region prepara la selezione di un rettangolo sul documento
Figura 11. La modalità Region prepara la selezione di un rettangolo sul documento.

La riga di stato può indicare Pointer mode: roi. In questa modalità il trascinamento del puntatore non sposta semplicemente l’anteprima: crea o modifica una selezione rettangolare.

16. Disegnare una nuova regione

Con Region attivo, premi il pulsante sinistro del mouse in un punto dell’immagine, trascina verso l’angolo opposto e rilascia.

Schermata originale di GX-TXT Unified Documents: Una regione rettangolare è stata disegnata realmente sul PNG
Figura 12. Una regione rettangolare è stata disegnata realmente sul PNG.

Il Viewer mostra il rettangolo di selezione con i relativi punti di controllo. La selezione può essere spostata o ridimensionata prima di qualsiasi elaborazione successiva.

17. Coordinate del Canvas e coordinate della sorgente

Una regione non viene identificata soltanto dalle coordinate della finestra. Il Viewer conserva i quattro estremi come valori normalizzati da 0 a 1 rispetto alle dimensioni dell’immagine visualizzata.

Nel primo rettangolo della prova, le coordinate normalizzate corrispondevano approssimativamente a X = 0,207–0,628 e Y = 0,177–0,647. Sul PNG originale di 1200 × 780 pixel si ottiene una regione compresa circa fra:

Estremo Pixel della sorgente
X iniziale 248
Y iniziale 138
X finale 753
Y finale 505

Questi valori si riferiscono ai pixel del documento, non alla posizione del mouse sul desktop. La selezione non rappresenta una misura fisica: per attribuirle unità reali occorrerebbe una calibrazione appropriata.

18. Spostare una regione esistente

Posiziona il puntatore all’interno del rettangolo e trascina la regione in una nuova posizione.

Schermata originale di GX-TXT Unified Documents: Trascinando la selezione al suo interno, il rettangolo viene spostato
Figura 13. Trascinando la selezione al suo interno, il rettangolo viene spostato.

La prova ha confermato uno spostamento di 60 pixel orizzontali e 40 verticali nella rappresentazione corrente, mantenendo invariata la larghezza e l’altezza della regione. È quindi un’operazione di traslazione, non di ridimensionamento.

19. Ridimensionare usando le maniglie

Spostando il puntatore su una delle maniglie della selezione, puoi trascinare il bordo o l’angolo corrispondente.

Schermata originale di GX-TXT Unified Documents: La maniglia inferiore destra permette di ridimensionare la regione
Figura 14. La maniglia inferiore destra permette di ridimensionare la regione.

Nel caso verificato, la maniglia inferiore destra ha ampliato la regione mantenendo invariato l’angolo superiore sinistro. Il rettangolo finale corrispondeva approssimativamente ai pixel X = 344–1001 e Y = 202–660 dell’immagine originale.

20. Annullare un trascinamento con Escape

Durante un gesto di selezione, premi Escape prima di completarlo se desideri annullare il movimento in corso.

Schermata originale di GX-TXT Unified Documents: Escape durante il trascinamento annulla il gesto e ripristina la regione precedente
Figura 15. Escape durante il trascinamento annulla il gesto e ripristina la regione precedente.

Il Viewer ha ripristinato esattamente le coordinate della regione precedente, senza perderla. È importante distinguere l’annullamento di un gesto non concluso dalla cancellazione esplicita di una regione già accettata.

21. Una regione conserva la sua posizione con Zoom +

Con la regione ancora presente, premi Zoom +.

Schermata originale di GX-TXT Unified Documents: Dopo Zoom +, la regione mantiene le coordinate normalizzate del documento
Figura 16. Dopo Zoom +, la regione mantiene le coordinate normalizzate del documento.

Il rettangolo cambia dimensione sullo schermo, ma i suoi quattro estremi normalizzati rimangono identici. Questa proprietà consente di ingrandire il documento per leggere meglio una zona senza perdere la selezione riferita alla sorgente.

22. Ripristinare Fit page senza perdere la regione

Premi nuovamente Fit page.

Schermata originale di GX-TXT Unified Documents: Fit page ripristina la scala senza cambiare la regione selezionata
Figura 17. Fit page ripristina la scala senza cambiare la regione selezionata.

L’intera immagine torna visibile, ma il rettangolo rimane associato alla stessa zona del documento. La prova ha confermato la perfetta conservazione delle coordinate normalizzate dopo Zoom + e successivo Fit page.

23. Eliminare una regione con Clear region

Per rimuovere una selezione completa, apri View → Clear region.

Schermata originale di GX-TXT Unified Documents: View → Clear region elimina il rettangolo e tutte le maniglie
Figura 18. View → Clear region elimina il rettangolo e tutte le maniglie.

Il rettangolo e le sue maniglie scompaiono. Il documento originale non viene cancellato: l’operazione riguarda esclusivamente la selezione corrente del Viewer.

24. Selezionare l’intera pagina con Select page

Il menu View → Select page consente di selezionare l’intera pagina come regione.

Schermata originale di GX-TXT Unified Documents: View → Select page seleziona l’intera pagina come regione
Figura 19. View → Select page seleziona l’intera pagina come regione.

Il Viewer assegna al rettangolo gli estremi normalizzati (0, 0) – (1, 1). È una selezione che copre l’intero documento visualizzato, da distinguere da un’area ristretta ottenuta trascinando il mouse.

25. Nascondere la palette con Tools

Nella barra superiore è presente Tools, un controllo che permette di nascondere temporaneamente la palette degli strumenti.

Schermata originale di GX-TXT Unified Documents: Disabilitando Tools la palette scompare ma il documento resta aperto
Figura 20. Disabilitando Tools la palette scompare ma il documento resta aperto.

Quando Tools è disabilitato, il pannello dei pulsanti scompare ma la pagina rimane aperta e consultabile. La funzione non elimina i Dataset e non modifica il file sorgente.

26. Ripristinare la palette Tools

Riattiva Tools per mostrare nuovamente la palette.

Schermata originale di GX-TXT Unified Documents: Riattivando Tools la palette ricompare nella scheda PDF / Image
Figura 21. Riattivando Tools la palette ricompare nella scheda PDF / Image.

Se i pulsanti Fit, Zoom, Region e Pan sembrano assenti, controlla prima questo elemento. Non occorre chiudere e riaprire il Viewer per recuperarli.

27. Utilizzare gli stessi strumenti su un PDF

Le funzioni di Region e adattamento sono disponibili anche quando la sorgente è un PDF. Nell’esempio abbiamo selezionato un Dataset document.pdf di due pagine A4 e aperto la prima pagina con Zoom % impostato a 0.

Schermata originale di GX-TXT Unified Documents: La prima pagina A4 del PDF si adatta al Canvas con lo zoom automatico
Figura 22. La prima pagina A4 del PDF si adatta al Canvas con lo zoom automatico.

Il rendering a 300 DPI produce una pagina di 2481 × 3508 pixel, adattata alla zona disponibile con uno zoom di circa 13,88%. Le dimensioni del raster visualizzato e quelle della pagina PDF originale non devono essere confuse.

28. Disegnare una regione sulla pagina PDF

Con Region attivo, traccia un rettangolo sulla prima pagina del PDF.

Schermata originale di GX-TXT Unified Documents: Anche sul PDF è possibile selezionare una regione sulla pagina renderizzata
Figura 23. Anche sul PDF è possibile selezionare una regione sulla pagina renderizzata.

La regione viene conservata in coordinate normalizzate. Nella prova gli estremi erano circa X = 0,189–0,698 e Y = 0,175–0,749. Sul raster della pagina prodotto a 300 DPI corrispondono approssimativamente a X = 469–1731 e Y = 612–2629 pixel.

Queste coordinate si riferiscono all’immagine della pagina renderizzata, non direttamente alle unità tipografiche del file PDF.

29. Che cosa succede cambiando pagina

Con la regione ancora presente sulla prima pagina del PDF, premi Next per visualizzare la seconda pagina.

Schermata originale di GX-TXT Unified Documents: Passando alla seconda pagina del PDF, la regione della prima pagina viene cancellata
Figura 24. Passando alla seconda pagina del PDF, la regione della prima pagina viene cancellata.

Il Viewer cancella la selezione appartenente alla pagina precedente. L’anteprima passa correttamente a page 2/2 senza trasferire il rettangolo sulla nuova pagina.

Questa protezione è importante: una regione selezionata su una pagina non deve essere considerata automaticamente valida per un’altra pagina del medesimo documento.

30. Focus della tastiera e annullamento

Le interazioni del mouse possono portare il focus sul Canvas dell’anteprima. Nella prova, il click iniziale della selezione ha portato il focus al Canvas e il tasto Escape, premuto durante il trascinamento, ha annullato il gesto e recuperato la regione precedente.

Il significato di Escape dipende quindi dal contesto. Non è corretto considerarlo un comando generale per cancellare tutte le selezioni o tutti i dati: per eliminare una regione completata si utilizza Clear region.

31. Selezione, History e pubblicazione non sono la stessa cosa

Il rettangolo Region rappresenta una scelta della zona di lavoro nel Viewer. Non è automaticamente un’immagine derivata, una tabella estratta o un risultato OCR.

GX-TXT dispone di funzioni condivise History e Workspace, ma questa guida non sostituisce una prova di salvataggio e ripristino. Per produrre un risultato derivato dalla regione è necessario un successivo comando di pubblicazione e una verifica della provenienza del nuovo Dataset.

32. Controllare l’integrità dei documenti originali

Dopo tutte le prove — Zoom, Pan, rotellina, Region, spostamento, ridimensionamento, annullamento e cambio pagina — i due Dataset originali della Session sono rimasti invariati.

Per il PNG e per il PDF, i byte del documento sorgente, della copia RAW gestita da GX-TXT e del payload canonico sono risultati identici. Nessuna operazione di navigazione ha generato un nuovo Dataset di testo, tabella, immagine derivata o PDF ricercabile.

Questa verifica è distinta dalla qualità di un’eventuale futura elaborazione scientifica: i documenti utilizzati qui sono esempi sintetici.

33. Errori da evitare

Prima di ritagliare o elaborare una regione, verifica Source, Opened: e il numero di pagina. Non basarti soltanto sulla presenza di una curva o di una tabella nell’anteprima.

Se l’immagine è troppo ingrandita, usa Fit page per ritrovare il contesto. Se desideri spostare la visualizzazione utilizza Pan, mentre per definire un’area usa Region. Se una selezione non è più adatta, correggila mediante trascinamento o maniglie, oppure cancellala con View → Clear region.

Ricorda infine che, cambiando pagina di un PDF, la selezione precedente può essere rimossa: verifica sempre il rettangolo sulla pagina effettivamente aperta.

34. Riepilogo e prossimo passo

Fit page adatta l’intero documento, Fit width adatta la larghezza, Zoom +/− varia l’ingrandimento e Pan consente di esplorare la pagina. Region crea una selezione associata al documento; Escape annulla un gesto in corso, Clear region elimina la selezione, Select page seleziona l’intera pagina.

La regione è espressa con coordinate normalizzate e rimane coerente quando cambia lo zoom. Nel PDF, passando a un’altra pagina, la regione precedente viene cancellata.

La prossima guida riguarda Recognition settings e le opzioni OCR: lingua, modalità di riconoscimento e parametri disponibili prima di avviare un’estrazione.