Marcas d'água

Você pode aplicar marcas d'água de texto e imagem a novas fotos tiradas com a câmera do aplicativo de campo Survey123. As marcas d'água não podem ser aplicadas em fotos existentes no dispositivo.

Anotação:

Marcas d'água não podem ser aplicadas no Survey123 web app.

Posição da marca d'água

O parâmetro da marca d'água inserida na coluna bind::esri:parameters controla onde a marca d'água aparecerá. Os parâmetros aceitos são os seguintes:

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

Por exemplo, o watermark="@[latitude longitude:dms]" imprimirá a latitude e longitude no canto direito inferior da imagem, enquanto topLeftWatermark="@[latitude longitude:dms]" imprimirá os mesmos valores no canto esquerdo superior.

Os múltiplos parâmetros podem ser utilizados em uma declaração para adicionar múltiplas marcas d'água à mesma imagem.

Conteúdo e formatação da marca d'água

Os parâmetros da marca d'água podem ser utilizados com uma combinação de propriedades para ajudar a definir o conteúdo e a formatação da marca d'água.

Dica:

Se sua combinação de propriedades inclui um espaço em qualquer lugar dentro dela, inclua tudo depois do parâmetro watermark com aspas duplas.

Adicionalmente, você não pode referenciar o valor de outro campo como um componente de uma declaração de marca d'água maior. Ao invés, você precisa extrair o valor desejado em outra pergunta e construir o corpo da declaração da marca d'água na coluna cálculo da mesma pergunta, incluindo todas as variáveis. Este valor pode então ser referenciado na coluna bind::esri:parameters da pergunta de imagem. Se refira à pesquisa de amostra de marca d'água disponível no Survey123 Connect para um exemplo. Esteja ciente que uma declaração de marca d'água calculada como esta precisa de aspas duplas.

A seguinte tabela lista todos as propriedades de parâmetro da marca d'água:

PropriedadeDescriçãoExemplo

texto

Entrada de texto livre, com \n utilizada para denotar uma quebra de linha. Esta propriedade é implícita se o texto for fornecido como o primeiro parâmetro e não precisa ser definida.

watermark="Example Text"

cor

Cor do texto da marca d'água. Esta propriedade aceita um nome de cor padrão ou um código de cor hexadecimal. Se não fornecido, será padronizado para azul.

watermark="Example Text&color=White"

outlineColor

A cor de contorno do texto. Esta propriedade aceita um nome de cor padrão ou um código de cor hexadecimal. Se não fornecido, será padronizado para a mesma cor que o texto.

watermark="Example Text&outlineColor=#FFD700"

outlineWidth

Contorno do texto em pixels. Se não fornecido, será padronizado para 1.

watermark="Example Text&outlineWidth=3"

haloColor

A cor do halo ao redor da marca d'água. Esta propriedade aceita um nome de cor padrão ou um código de cor hexadecimal. Se não fornecido, será padronizado para cor de contraste.

watermark="Example Text&haloColor=Yellow"

tamanho

Tamanho do texto em pixels.

watermark="Example Text&size=12"

fonte

Nome da fonte para utilizar. Se não fornecido, será padronizado para a fonte do aplicativo de campo.

Anotação:

Esteja ciente que nem todas as fontes estão disponíveis em todos os dispositivos. Revise as marcas d'água produzidas pelos seus dispositivos preferidos para garantir que sua marca d'água apareça como pretendido.

watermark="Example Text&font=Arial"

negrito

Valor booleano. Quando definida para verdadeiro, a fonte da marca d'água é de tipo negrito.

watermark="Example Text&bold=true"

itálico

Valor booleano. Quando definida para verdadeiro, a fonte da marca d'água é de tipo itálica.

watermark="Example Text&italic=true"

margem

Margem de borda da imagem em pixels.

watermark="Example Text&margin=5"

imagem

Uma imagem para atuar como uma marca d'água em vez de texto. Isto exige o nome do arquivo de uma imagem na pasta de mídias da pesquisa.

watermark=&image=example.png

imageSize

Tamanho da imagem de marca d'água em pixels. Se não fornecido, o tamanho da imagem de origem será utilizado.

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

Dica:

Imagens em marcas d'água serão justificadas no espaço fornecido, não importando outros parâmetros ou texto fornecido na declaração da marca d'água.

Considere utilizar as opções de tamanho da imagem no Survey123 Connect na guia Opções para sua pesquisa se você estiver utilizando uma imagem como marca d'água. Isto afetará a qualidade da sua foto e marca d'água.

Localização e tempo

Um caso de uso comum de marcas d'água é exibir a localização que a foto foi tirada. Isto pode ser formatado de várias maneiras.

Dica:

Ao tirar uma foto onde a captura da localização é importante, lembre de esperar pelo ícone de localização no canto superior direito da tela parar de piscar. Isto indica que a localização foi obtida. Se a localização não for obtida, sua localização estará em branco.

Por padrão, a utilização dos espaços reservados @[latitude] e @[longitude] exibe a localização que a foto foi tirada em graus decimais. O exemplo seguinte posiciona estas fotos nas linhas separadas:

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

Você também pode utilizar os espaços reservados @[latitude longitude] ou @[longitude latitude] para exibir ambos os valores de uma vez.

Os formatos diferentes de longitude e latitude podem ser utilizados declarando eles, separado com dois pontos, dentro dos espaços reservados:

  • @[longitude:ddm] para minutos de grau decimal
  • @[latitude:dms] para graus/minutos/segundos

Os espaços reservados podem ser utilizados para exibir informações adicionais ou utilizar um sistema completamente diferente de coordenadas:

  • @[mgrs]—Sistema de Referência da Grade Militar
  • @[usng]—Grade Nacional dos Estados Unidos
  • @[utm]—Universal Transversa de Mercator
  • @[altitude]
  • @[speed]
  • @[direction]—A direção do dispositivo estava viajando quando a foto foi tirada
  • @[accuracy] ou @[horizontalAccuracy]
  • @[compass]—Direção da bússola

As marcas d'água também são capazes de exibir a data e hora que a foto foi tirada da mesma maneira. Os espaços reservados @[date], @[time], e @[dateTime] retornará um valor de tempo a partir do relógio do dispositivo. Além disso, o espaço reservado @[timestamp] pode ser utilizado ao invés para exibir uma hora obtida a partir do sensor de localização; entretanto, lembre-se disso ao utilizar este espaço reservado, você deve assegurar que a foto esteja obtendo uma localização.

Os formatos diferentes podem ser utilizados para data e hora, utilizando a mesma sintaxe que a latitude e longitude. Há dois formatos aceitáveis:

  • @[dateTime] ou @[dateTime:long] retornará um resultado semelhante na segunda-feira, 22 de abril de 2019 5:02:11 PM.
  • @[dateTime:short] retornará um resultado semelhante para 22/04/2019 5:02 PM.

Também é possível implementar sua própria formatação para valores de data e hora ao invés de seguir dois pontos com um formato de dados personalizado. A formatação utilizados por estes formatos de dados é diferente a partir do XForm padrão, ao invés de utilizar Formatação padrão de Qt. Por exemplo, um espaço reservado como @[datetime:d MMM yyyy HH:mm] retornará um resultado semelhante a 22 de Abril de 2019 17:02.

Limitações

As limitações ao utilizar marcas d'água são como seguem:

  • As marcas d'água não são suportadas para imagens utilizando a aparência anotar.
  • A geocodificação reversa não é suportada em marcas d'água.