Filigranes

Vous pouvez apposer du texte et une image en filigrane sur de nouvelles photos prises avec la caméra de l’application de terrain Survey123. Les filigranes ne peuvent pas être appliqués aux photos déjà présentes sur l’appareil.

Remarque :

Les filigranes ne peuvent pas être appliqués dans l'application Web Survey123.

Position du filigrane

Le paramètre de filigrane indiqué dans la colonne bind::esri:parameters détermine l’endroit où le filigrane apparaît. Les paramètres acceptés sont les suivants :

• watermark
• topLeftWatermark
• topCenterWatermark
• topRightWatermark
• leftCenterWatermark
• centerWatermark
• rightCenterWatermark
• bottomLeftWatermark
• bottomCenterWatermark
• bottomRightWatermark

Par exemple, watermark="@[latitude longitude:dms]" imprime la latitude et la longitude dans l’angle inférieur droit de l’image, tandis que topLeftWatermark="@[latitude longitude:dms]" imprime les mêmes valeurs dans l’angle supérieur gauche.

Il est possible d’utiliser plusieurs paramètres dans une seule et même instruction pour ajouter plusieurs filigranes dans la même image.

Contenu et mise en forme du filigrane

Il est possible d’associer des propriétés aux paramètres de filigrane pour définir le contenu et la mise en forme du filigrane.

Conseil :

Si un espace figure dans votre combinaison de propriétés, veillez à placer tout ce qui suit le paramètre watermark entre guillemets doubles.

Qui plus est, vous ne pouvez pas référencer la valeur d’un autre champ comme composant d’une plus grande instruction de filigrane. À la place, vous devez extraire la valeur souhaitée dans une autre question et construire le corps de l’instruction de filigrane dans la colonne calculation (calcul) de la même question, y compris toutes les variables. Cette valeur peut ensuite être référencée dans la colonne bind::esri:parameters de la question de type image. Consultez l’exemple d’enquête sur les filigranes, disponible dans Survey123 Connect. Notez qu’il est inutile d’utiliser des guillemets doubles dans une instruction de filigrane calculée de ce type.

Le tableau suivant répertorie toutes les propriétés du paramètre de filigrane :

Propriété	Description	Exemple
Texte	Saisie de texte libre, avec représentation du saut de ligne par \n. Cette propriété est implicite si le texte constitue le premier paramètre et s’il n’est pas nécessaire de le définir.	watermark="Example Text"
couleur	Couleur du texte en filigrane. Cette propriété accepte un nom de couleur standard ou un code couleur hexadécimal. Si la propriété n’est pas renseignée, la couleur utilisée par défaut est le bleu.	watermark="Example Text&color=White"
outlineColor	Couleur du contour du texte. Cette propriété accepte un nom de couleur standard ou un code couleur hexadécimal. Si la propriété n’est pas renseignée, la couleur utilisée par défaut est la même que celle du texte.	watermark="Example Text&outlineColor=#FFD700"
outlineWidth	Contour du texte, en pixels. Si la propriété n’est pas renseignée, elle prend la valeur 1 par défaut.	watermark="Example Text&outlineWidth=3"
haloColor	Couleur du halo autour du filigrane. Cette propriété accepte un nom de couleur standard ou un code couleur hexadécimal. Si la propriété n’est pas renseignée, une couleur contrastante est utilisée par défaut.	watermark="Example Text&haloColor=Yellow"
taille	Taille du texte en pixels.	watermark="Example Text&size=12"
police	Nom de la police à utiliser. Si la propriété n’est pas renseignée, la police de l’application de terrain est utilisée par défaut. Remarque : Gardez à l’esprit que toutes les polices ne sont pas disponibles sur tous les appareils. Vérifiez le filigrane généré par vos appareils favoris pour vous assurer que sont apparence correspond à vos attentes.	watermark="Example Text&font=Arial"
gras	Valeur booléenne. Lorsque la propriété est définie sur True (Vrai), la police du filigrane est en gras.	watermark="Example Text&bold=true"
italique	Valeur booléenne. Lorsque la propriété est définie sur True (Vrai), la police du filigrane est en italique.	watermark="Example Text&italic=true"
margin	Marge du bord de l’image, en pixels.	watermark="Example Text&margin=5"
image	Image à utiliser comme filigrane à la place du texte. Pour cette propriété, il convient d’indiquer le nom d’une image du dossier de média de l’enquête.	watermark=&image=example.png
imageSize	Taille de l’image en filigrane, en pixels. Si la propriété n’est pas renseignée, la taille de l’image source est utilisée.	watermark=&image=example.png&imageSize=50

Conseil :

Les images en filigrane sont justifiées suivant l’espace prévu, indépendamment des autres paramètres ou du texte figurant dans l’instruction de filigrane.

Envisagez d’utiliser les options de taille d’image dans l’onglet Options Survey123 Connect de votre enquête si vous utilisez une image en filigrane. Cela affecte la qualité de la photo et du filigrane.

Localisation et données temporelles

Il est pratique courante de faire figurer sur les filigranes l’endroit où le cliché a été pris. Il est possible de formater cet affichage de plusieurs manières.

Conseil :

Lorsque vous prenez une photo, sachant que la capture de la localisation est importante, veillez à attendre que l’icône de localisation située dans l’angle supérieur droit de l’écran cesse de clignoter. Cela indique que la localisation a été récupérée. Si ce n’est pas le cas, vos relevés de localisation sont vierges.

Par défaut, lorsqu’ils sont utilisés, les emplacements réservés @[latitude] et @[longitude] affichent la localisation de la prise de vue en degrés décimaux. Dans l’exemple suivant, les emplacements réservés sont placés sur des lignes distinctes :

watermark="Lat @[latitude]\nLon @[longitude]"

Vous pouvez également utiliser les emplacements réservés @[latitude longitude] ou @[longitude latitude] pour afficher les deux valeurs à la fois.

Différents formats sont disponibles pour déclarer la longitude et la latitude, séparées par un signe deux points, dans les emplacements réservés :

• @[longitude:ddm] pour degrés minutes décimales
• @[latitude:dms] pour degrés/minutes/secondes

Il est possible d’utiliser des emplacements réservés supplémentaires pour afficher d’autres informations, ou d’utiliser un système de coordonnées entièrement différent :

• @[mgrs] : système de référence de carroyage militaire
• @[usng] : United States National Grid (USNG)
• @[utm] : Universal Transverse Mercator (UTM)
• @[altitude]
• @[speed]
• @[direction] : direction de déplacement de l’appareil au moment de la prise de vue
• @[accuracy] ou @[horizontalAccuracy]
• @[compass] : relèvement au compas

Les filigranes permettent également d’afficher la date et l’heure de la prise de vue de la même façon. Les emplacements réservés @[date], @[time] et @[dateTime] renvoient une valeur temporelle de l’horloge de l’appareil. De plus, l’emplacement réservé @[timestamp] peut être utilisé pour afficher plutôt une heure relevée par le capteur de localisation. Il convient toutefois de veiller à obtenir la localisation de la photo en cas d’utilisation de cet emplacement réservé.

Différents formats sont disponibles pour déclarer la date et l’heure, suivant la même syntaxe que celle de la latitude et de la longitude. Deux formats sont admis :

• @[dateTime] ou @[dateTime:long] renvoie un résultat du type Lundi, 22 avril 2019 17:02:11.
• @[dateTime:short] renvoie un résultat du type 22/04/2019 17:02.

Par ailleurs, vous pouvez mettre au point votre propre formatage de valeurs de date et d’heure en faisant suivre le signe deux points d’un format de date personnalisé. Le formatage utilisé pour ces formats de date diffère de celui de la norme XForms, qui a recours au formatage standard Qt. Ainsi, un emplacement réservé tel que @[datetime:d MMM yyyy HH:mm] renvoie un résultat du type 22 avril 2019 17:02.

Limitations

Les limitations suivantes s’appliquent à l’utilisation des filigranes :

• Les filigranes ne sont pas pris en charge avec les images qui utilisent l’apparence annotate (annoter).
• Le géocodage inverse n’est pas pris en charge dans les filigranes.