Znaki wodne

Na nowych zdjęciach zrobionych za pomocą aparatu aplikacji terenowej Survey123 można umieszczać tekstowe i graficzne znaki wodne. Znaków wodnych nie można stosować do zdjęć istniejących na urządzeniu.

Notatka:

Znaków wodnych nie można stosować w aplikacji internetowej Survey123.

Pozycja znaku wodnego

Parametr watermark (znak wodny) wprowadzony w kolumnie bind::esri:parameters wskazuje miejsce, w którym pojawi się znak wodny. Akceptowane są następujące parametry:

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

Na przykład parametr watermark="@[latitude longitude:dms]" spowoduje umieszczenie długości i szerokości geograficznej w prawym dolnym rogu obrazu, natomiast parametr topLeftWatermark="@[latitude longitude:dms]" spowoduje umieszczenie tych samych wartości w lewym górnym rogu.

W jednej instrukcji można użyć wielu parametrów w celu dodania wielu znaków wodnych do tego samego obrazu.

Zawartość i formatowanie znaków wodnych

Parametry znaku wodnego mogą być używane w połączeniu z właściwościami, aby zdefiniować zawartość i formatowanie znaku wodnego.

Wskazówka:

Jeśli kombinacja właściwości zawiera spację w dowolnym miejscu, całą zawartość następującą po parametrze watermark należy umieścić w podwójnym cudzysłowie.

Ponadto nie można odwoływać się do wartości z innego pola, które stanowi część większej instrukcji znaku wodnego. Zamiast tego należy wyodrębnić żądaną wartość w innym pytaniu, a następnie utworzyć zawartość instrukcji znaku wodnego w kolumnie calculation (obliczenie) tego samego pytania, łącznie ze wszystkimi zmiennymi. Umożliwi to odniesienie się do tej wartości w kolumnie bind::esri:parameters pytania typu image (obraz). Zapoznaj się z przykładową ankietą ze znakiem wodnym, która jest dostępna w aplikacji Survey123 Connect. Należy zwrócić uwagę, że obliczona instrukcja znaku wodnego tego typu nie wymaga podwójnych cudzysłowów.

Poniższa tabela zawiera wszystkie właściwości parametrów znaku wodnego:

WłaściwośćOpisPrzykład

tekst

Umożliwia wprowadzenie dowolnego tekstu. Znaki \n oznaczają podział wiersza. Ta właściwość jest domniemana, jeśli tekst jest podany jako pierwszy parametr i nie trzeba jej definiować.

watermark="Example Text"

kolor

Kolor tekstu znaku wodnego. Ta właściwość akceptuje standardową nazwę koloru albo jego szesnastkowy kod. Jeśli wartość nie zostanie podana, domyślnie używany jest kolor niebieski.

watermark="Example Text&color=White"

outlineColor

Kolor obrysu tekstu. Ta właściwość akceptuje standardową nazwę koloru albo jego szesnastkowy kod. Jeśli wartość nie zostanie podana, domyślnie używany jest kolor tekstu.

watermark="Example Text&outlineColor=#FFD700"

outlineWidth

Obrys tekstu w pikselach. Jeśli wartość nie zostanie podana, domyślnie używana jest wartość 1.

watermark="Example Text&outlineWidth=3"

haloColor

Kolor otoczki znaku wodnego. Ta właściwość akceptuje standardową nazwę koloru albo jego szesnastkowy kod. Jeśli wartość nie zostanie podana, domyślnie używany jest kolor kontrastowy.

watermark="Example Text&haloColor=Yellow"

rozmiar

Rozmiar tekstu w pikselach.

watermark="Example Text&size=12"

font

Nazwa czcionki, która ma być używana. Jeśli wartość nie zostanie podana, domyślnie używana jest czcionka aplikacji terenowej.

Notatka:

Należy pamiętać, że nie wszystkie czcionki są dostępne na każdym urządzeniu. Aby upewnić się, że znak wodny ma właściwy wygląd, należy przejrzeć znaki wodne utworzone przez preferowane urządzenia.

watermark="Example Text&font=Arial"

pogrubienie

Wartość logiczna. Skonfigurowanie wartości prawda (true) powoduje pogrubienie czcionki znaku wodnego.

watermark="Example Text&bold=true"

kursywa

Wartość logiczna. Skonfigurowanie wartości prawda (true) powoduje pochylenie czcionki znaku wodnego.

watermark="Example Text&italic=true"

margin

Margines od krawędzi obrazu w pikselach.

watermark="Example Text&margin=5"

obraz

Obraz, który zostanie użyty jako znak wodny zamiast tekstu. Wymaga podania nazwy pliku obrazu w folderze multimediów ankiety.

watermark=&image=example.png

imageSize

Rozmiar obrazu znaku wodnego w pikselach. Jeśli wartość nie zostanie podana, używany jest rozmiar obrazu źródłowego.

watermark=&image=example.png&imageSize=50

Wskazówka:

Obrazy w znakach wodnych można wyjustować do podanego miejsca, niezależnie od innych parametrów lub tekstu w instrukcji znaku wodnego.

Jeśli obraz będzie używany jako znak wodny, warto rozważyć użycie opcji rozmiaru obrazu w aplikacji Survey123 Connect na karcie Opcje związanej z daną ankietą. Będzie to miało wpływ na jakość zarówno zdjęć, jak i znaku wodnego.

Lokalizacja i czas

Znaki wodne są często używane do przedstawiania lokalizacji, w której zrobiono zdjęcie. Funkcję tę można sformatować na wiele sposobów.

Wskazówka:

Gdy lokalizacja jest istotna, podczas robienia zdjęcia należy poczekać, aż ikona lokalizacji w prawym górnym rogu ekranu przestanie migać. Wskazuje to, że lokalizacja została uzyskana. Jeśli lokalizacja nie została uzyskana, odczyty lokalizacji będą puste.

Domyślnie użycie elementów zastępczych @[latitude] i @[longitude] spowoduje wyświetlenie lokalizacji zrobionego zdjęcia w stopniach dziesiętnych. W poniższym przykładzie te informacje zostaną umieszczone w osobnych wierszach:

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

Elementów zastępczych @[latitude longitude] lub @[longitude latitude] można również użyć do wyświetlenia obu wartości jednocześnie.

Istnieje możliwość użycia różnych formatów długości i szerokości geograficznej poprzez zadeklarowanie ich w elementach zastępczych, rozdzielając je dwukropkami:

  • @[longitude:ddm] dla stopni i minut dziesiętnych
  • @[latitude:dms] dla stopni/minut/sekund

Istnieje możliwość użycia dodatkowych elementów zastępczych w celu wyświetlenia dodatkowych informacji, jak również użycie zupełnie innego układu współrzędnych:

  • @[mgrs] — Military Grid Reference System
  • @[usng] — United States National Grid
  • @[utm] — Universal Transverse Mercator
  • @[altitude]
  • @[speed]
  • @[direction] — kierunek ruchu urządzenia podczas robienia zdjęcia
  • @[accuracy] lub @[horizontalAccuracy]
  • @[compass] — kąt kierunkowy

W ten sam sposób znaki wodne umożliwiają również wyświetlanie daty i czasu zrobienia zdjęcia. Elementy zastępcze @[date], @[time] i @[dateTime] zwracają wartość czasu z zegara urządzenia. Ponadto można użyć elementu zastępczego @[timestamp] w celu wyświetlenia czasu uzyskanego z czujnika lokalizacji. Jednak w przypadku użycia tego elementu zastępczego należy upewnić się, że zdjęcie uzyskuje lokalizację.

Korzystając z tej samej składni co w przypadku długości i szerokości geograficznej, można użyć różnych formatów daty i czasu. Akceptowane są dwa formaty:

  • @[dateTime] lub @[dateTime:long] zwraca wynik podobny do następującego: Poniedziałek, 22 kwietnia 2019 5:02:11 PM.
  • @[dateTime:short] zwraca wynik podobny do następującego: 22/04/2019 5:02 PM.

Można również zaimplementować własne formatowanie wartości daty i czasu, wprowadzając dwukropek, a po nim niestandardowy format daty. Formatowanie używane dla tych formatów daty różni się od standardu XForm, ponieważ używane jest standardowe formatowanie Qt. Na przykład symbol zastępczy @[datetime:d MMM yyyy HH:mm] zwraca wynik podobny do następującego: 22 kwietnia 2019 17:02.

Ograniczenia

Poniżej przedstawiono ograniczenia dotyczące użycia znaków wodnych:

  • Znaki wodne nie są obsługiwane w przypadku obrazów, które używają wyglądu annotate (notatka).
  • Geokodowanie odwrotne nie jest obsługiwane w znakach wodnych.