È possibile applicare filigrane di testo e immagine alle nuove foto scattate con la fotocamera della field app Survey123. Le filigrane non possono essere applicate a foto esistenti sul dispositivo.
Nota:
Non è possibile applicare filigrane nell'app Web Survey123.
Posizione della filigrana
Il parametro della filigrana inserito nella colonna bind::esri:parameters controlla la posizione in cui la filigrana apparirà. I parametri accettati sono:
- watermark
- topLeftWatermark
- topCenterWatermark
- topRightWatermark
- leftCenterWatermark
- centerWatermark
- rightCenterWatermark
- bottomLeftWatermark
- bottomCenterWatermark
- bottomRightWatermark
Per esempio, watermark="@[latitude longitude:dms]" stamperà la latitudine e la longitudine nell'angolo inferiore destro dell'immagine, mentre topLeftWatermark="@[latitude longitude:dms]" stamperà gli stessi valori nell'angolo superiore sinistro.
È possibile usare più parametri in un'unica istruzione per aggiungere più filigrane alla stessa immagine.
Contenuto e formattazione delle filigrane
I parametri delle filigrane possono essere usati con una combinazione di proprietà che consentono di definire il contenuto e la formattazione della filigrana.
Suggerimento:
Se la tua combinazione di proprietà include uno spazio da qualche parte al suo interno, racchiudi tutto dopo il parametro watermark con le doppie virgolette.
Non è possibile fare riferimento al valore di un altro campo come componente di una più ampia istruzione di filigrana. In questo caso, è necessario estrarre il valore desiderato in un’altra domanda e costruire la parte centrale dell’istruzione della filigrana nella colonna calcolo della stessa domanda, includendo tutte le variabili. Successivamente, sarà possibile fare riferimento a tale valore nella colonna bind::esri:parameters della domanda immagine. Fai riferimento all'indagine campione in filigrana disponibile in Survey123 Connect per un esempio. Questo tipo di istruzione di filigrana calcolata non necessita di virgolette doppie.
La tabella seguente elenca tutte le proprietà dei parametri della filigrana:
| Proprietà | Descrizione | Esempio |
|---|---|---|
| testo | Inserimento di testo libero, con \n utilizzato per indicare un'interruzione di riga. Questa proprietà è implicita se il testo è fornito come primo parametro, e non ha bisogno di essere definita. | watermark="Example Text" |
| color | Colore del testo della filigrana. Questa proprietà accetta un nome di colore standard o un codice colore esadecimale. Se non specificato, l’impostazione predefinita è il blu. | watermark="Example Text&color=White" |
| outlineColor | Colore del bordo del testo. Questa proprietà accetta un nome di colore standard o un codice colore esadecimale. Se non specificato, l’impostazione predefinita è lo stesso colore del testo. | watermark="Example Text&outlineColor=#FFD700" |
| outlineWidth | Bordo del testo in pixel. Se non specificato, l’impostazione predefinita è 1. | watermark="Example Text&outlineWidth=3" |
| haloColor | Colore dell'alone che circonda la filigrana. Questa proprietà accetta un nome di colore standard o un codice colore esadecimale. Se non specificato, l’impostazione predefinita è un colore a contrasto. | watermark="Example Text&haloColor=Yellow" |
| dimensioni | Dimensione del testo in pixel. | watermark="Example Text&size=12" |
| carattere | Nome del font da usare. Se non specificato, l’impostazione predefinita è il font dell’app. Nota:Tenere presente che non tutti i caratteri sono disponibili su tutti i dispositivi. Analizzare le filigrane prodotte dai propri dispositivi preferiti per verificare che appaia come desiderato. | watermark="Example Text&font=Arial" |
| grassetto | Valore booleano. Se impostato su true, il font della filigrana è in grassetto. | watermark="Example Text&bold=true" |
| corsivo | Valore booleano. Se impostato su true, il font della filigrana è in corsivo. | watermark="Example Text&italic=true" |
| margin | Margine dei bordi dell’immagine in pixel. | watermark="Example Text&margin=5" |
| immagine | Immagine che funge da filigrana al posto del testo. È necessario il nome del file di un'immagine contenuta nella cartella dei file multimediali del rilevamento. | watermark=&image=example.png |
| imageSize | Dimensioni dell’immagine della filigrana in pixel. Se non specificato, vengono usate le dimensioni dell’immagine originale. | watermark=&image=example.png&imageSize=50 |
Suggerimento:
Le immagini nelle filigrane saranno adattate allo spazio a disposizione, indipendentemente dagli altri parametri o dal testo fornito nelle istruzioni di filigrana.
Considera di usare le opzioni di dimensione dell'immagine nella scheda Survey123 Connect opzioni per la tua indagine se stai usando un'immagine come filigrana. Ciò inciderà sulla qualità sia della foto sia della filigrana.
Luogo e ora
È frequente che la filigrana mostri il luogo in cui è stata scattata la foto. Questo tipo di filigrana può essere formattata in vari modi.
Suggerimento:
Quando si scatta una foto e si desidera registrarne la posizione, attendere che l'icona della posizione nell'angolo in alto a destra dello schermo smetta di lampeggiare. Quando ciò accade, significa che la posizione è stata ottenuta. Se la posizione non viene ottenuta, le letture della posizione risulteranno vuote.
Per impostazione predefinita, usando i tasti @[latitude] e @[longitude] mostra la posizione in cui la foto è stata scattata in gradi decimali. Nell’esempio seguente colloca questi segnaposto su due righe separate:
watermark="Lat @[latitude]\nLon @[longitude]"
Puoi anche usare i segnaposto @[latitude longitude] o @[longitude latitude] per visualizzare entrambi i valori in una volta sola.
È possibile usare diversi formati per latitudine e longitudine inserendoli, separati da due punti, nei segnaposto:
- @[longitude:ddm] per i minuti decimali di grado
- @[latitude:dms] per gradi/minuti/secondi
È possibile usare segnaposto aggiuntivi per visualizzare ulteriori informazioni o usare un sistema di coordinate del tutto diverso:
- @[mgrs]—Sistema di riferimento della griglia militare
- @[usng]—United States National Grid
- @[utm]—Universal Transverse Mercator
- @[altitude]
- @[speed]
- @[direction]—La direzione in cui viaggiava il dispositivo quando è stata scattata la foto
- @[accuracy] o @[horizontalAccuracy]
- @[compass]—Bussola
Allo stesso modo, le filigrane possono contenere anche la data e l’ora in cui la foto è stata scattata. I segnaposto @[date], @[time], e @[dateTime] restituiranno un valore temporale dall'orologio del dispositivo. Inoltre, il segnaposto @[timestamp] può essere usato per visualizzare invece un'ora ottenuta dal sensore di posizione; tuttavia, ricorda che quando usi questo segnaposto, devi assicurarti che la foto stia ottenendo una posizione.
È possibile usare vari formati per la data e l’ora, utilizzando la stessa sintassi di longitudine e latitudine. Sono accettati due formati:
- @[dateTime] o @[dateTime:long] restituirà un risultato simile a Monday, 22 April 2019 5:02:11 PM.
- @[dateTime:short] restituirà un risultato simile a 22/04/2019 5:02 PM.
È anche possibile implementare la propria formattazione per i valori di data e ora, inserendo dopo i due punti un formato di data personalizzato. La formattazione utilizzata per questi formati di data è diversa dallo standard XForm e usa la formattazione Qt standard. Per esempio, un segnaposto come @[datetime:d MMM yyyy HH:mm] restituirà un risultato simile a 22 aprile 2019 17:02.
Limitazioni
L’uso delle filigrane è soggetto alle seguenti limitazioni:
- Le filigrane non sono supportate per le immagini che usano l'aspetto annotate.
- La geocodifica inversa non è supportata nelle filigrane.