Texto e imagens em modelos 3D
Um modelo 3D pode ter superfícies: áreas planas como o letreiro de destino de um ônibus, a placa com o nome de um abrigo, um painel publicitário ou a plaqueta de identificação de um equipamento. O Icon Map desenha os seus dados nessas superfícies, de modo que cada modelo no mapa mostra os próprios valores: o ônibus da linha 25 mostra "25 Ilford", o abrigo mostra o nome do ponto, o painel publicitário mostra o cartaz daquele local.
As superfícies funcionam na camada Modelos 3D e no Rastreador de veículos quando os marcadores dele são modelos 3D. Uma superfície pode mostrar texto, uma imagem ou imagens rotativas, e o conteúdo pode vir de uma coluna dos seus dados.
Onde encontrar
Abra as configurações da camada e escolha um modelo. Se o modelo tiver superfícies, uma seção Texto e imagens no modelo aparece abaixo do seletor Modelo, com uma linha por superfície.
Se a seção não aparecer, o modelo não tem superfícies. Veja Como adicionar superfícies ao seu próprio modelo.
Quando uma camada usa um modelo diferente por categoria, cada linha mostra quantos dos modelos têm aquela superfície (por exemplo, 2 de 3 modelos). As linhas dos outros modelos simplesmente não têm nada a desenhar.
Escolha do que a superfície mostra
Cada superfície tem uma configuração de conteúdo:
| Configuração | O que mostra | Exemplo |
|---|---|---|
| Campo | O valor de uma coluna, para cada linha | stop_name |
| Modelo de texto | Texto montado a partir de várias colunas. Coloque os nomes das colunas entre chaves. Um valor ausente aparece em branco. | {route} {destination} |
| Texto fixo | O mesmo texto em todos os modelos | Not in service |
| Imagem | Uma imagem: um endereço fixo, ou {column} para obtê-la dos seus dados |
https://cdn.example.com/poster.png ou {advert} |
| Imagens rotativas | Uma lista de imagens mostradas em sequência, alguns segundos cada, ou uma escolhida aleatoriamente por modelo | três URLs de cartazes |
| Desativado | Nada. A configuração é mantida, então você pode reativá-la. |
As imagens rotativas ficam paradas para quem configurou o dispositivo para reduzir o movimento: cada modelo continua mostrando uma das suas imagens, em vez de trocar a cada poucos segundos.
Alguns modelos sugerem um vínculo para uma superfície, por exemplo um letreiro de destino que espera {route} {destination}. Na primeira vez que você escolhe um modelo assim e os seus dados têm essas colunas, a sugestão é aplicada automaticamente; caso contrário, a linha oferece a opção Usar sugestão. Abrir uma camada existente nunca altera as suas configurações.
Superfícies destinadas a imagens, como painéis publicitários, oferecem apenas Imagem, Imagens rotativas e Desativado.
Texto, imagens ou SVG de uma coluna
Com Campo, escolha o que a coluna contém em A coluna contém:
- Texto (o padrão): o valor é desenhado como texto.
- Uma imagem (URL, caminho do OneLake ou SVG): cada valor é uma imagem.
- Texto ou imagem, por linha: o Icon Map decide para cada linha. Um valor é tratado como imagem quando é marcação SVG, um URI
data:image/...ou um endereço que começa comhttps://,http://ouonelake://. Todo o resto é desenhado como texto. Um nome de arquivo simples, comoposter.png, continua sendo texto, porque não há de onde carregá-lo.
O valor de uma imagem pode ser qualquer um destes:
| Valor | Exemplo | Observações |
|---|---|---|
| Uma URL de imagem | https://cdn.example.com/ads/gym.png |
O servidor precisa permitir solicitações entre origens (CORS). O armazenamento de Blobs do Azure com CORS habilitado e a maioria das CDNs permitem. Sem isso, a superfície fica em branco. O navegador de cada visualizador solicita a imagem diretamente a esse servidor, inclusive os leitores de um mapa incorporado, então use apenas servidores confiáveis. O Icon Map não envia qual mapa está sendo visto. |
| Um arquivo do OneLake | onelake://<workspace-id>/<item-id>/Files/ads/coffee.png |
Endereços https://…onelake.dfs.fabric.microsoft.com/… do OneLake também funcionam. Lido com as permissões do próprio visualizador. Não aparece em mapas incorporados. |
| Um URI de dados | data:image/png;base64,iVBORw0… |
A imagem viaja dentro da linha. |
| Marcação SVG | <svg viewBox="0 0 400 200">…</svg> |
Começa com <svg. Bom para placas, selos e gráficos simples gerados. |
Observações sobre SVG:
- Dê ao SVG um
viewBox. O tamanho é tirado dele, para que seja desenhado com nitidez e no formato certo. - Scripts em um SVG nunca são executados: ele é desenhado como uma imagem.
- SVGs que contêm
<foreignObject>(HTML incorporado) não são desenhados. Os navegadores proíbem usá-los como texturas em um modelo 3D.
Estilo
Selecione Estilo (o botão de pincel) na linha de uma superfície.
- Texto: cor do texto, um painel atrás do texto e a cor dele, alinhamento e maiúsculas.
- Imagens: Ajuste (Preencher a superfície recorta para preencher, Mostrar tudo adiciona barras, Esticar distorce para caber) e Espelhar da esquerda para a direita.
- Letreiro iluminado / Retroiluminado: ativados por padrão, para que a superfície brilhe à noite e não seja escurecida pelo sol, como um letreiro de LED ou um painel luminoso de verdade. Desative-os para uma placa pintada.
Uma coluna definida como Texto ou imagem, por linha mostra os dois conjuntos de opções.
O estilo de texto padrão é âmbar sobre um painel escuro, a aparência de um letreiro de destino de LED.
Quando as superfícies aparecem
Texto e imagens só são legíveis de perto, então ficam ocultos abaixo de um nível de zoom. Defina-o em Mostrar superfícies a partir do zoom, abaixo das linhas das superfícies. O padrão é 16, aproximadamente o nível da rua.
As superfícies são desenhadas no tamanho real do letreiro, então o tamanho do modelo precisa estar em metros. Uma camada Modelos 3D dimensionada em pixels não mostra superfícies.
Mapas incorporados
Quando você incorpora um mapa, as superfícies funcionam como no Fabric, com uma exceção: imagens do OneLake vindas dos seus dados (um caminho onelake:// em uma coluna, ou {column} em uma configuração Imagem ou Imagens rotativas) ficam em branco no mapa incorporado.
Isso acontece porque um mapa incorporado só pode ler arquivos que foram copiados para a pasta de publicação quando você publicou. Uma imagem do OneLake fixa, digitada nas configurações da superfície, é copiada e aparece. Um caminho que está nos seus dados só é conhecido linha a linha, então não é copiado.
Para imagens baseadas em dados em um mapa incorporado, coloque na coluna uma URL https://, um URI data:image/... ou marcação SVG.
Como adicionar superfícies ao seu próprio modelo
Nenhum dos modelos integrados tem superfícies. Para adicioná-las ao seu próprio modelo glTF/GLB, no Blender ou em qualquer outra ferramenta 3D:
- Adicione um retângulo plano (um plano) onde o conteúdo deve ficar, deitado sobre a face do modelo. O Icon Map afasta o conteúdo levemente dele, para que nunca fique piscando contra o modelo.
- Dê ao objeto o nome
surface:<name>, por exemplosurface:blindousurface:advert. A parte depois dos dois-pontos é o nome mostrado no Icon Map. (text:<name>também funciona.) - Verifique se o plano está voltado para fora. O conteúdo é desenhado no lado para o qual aponta a normal da face; se uma superfície continuar em branco, inverta a normal.
- Exporte como GLB sem compressão Draco. Malhas compactadas são ignoradas quando o Icon Map procura superfícies.
O texto é desenhado na vertical em relação à direção "para cima" do modelo.
Opcional, para autores de modelos: os extras do glTF de um nó de superfície podem trazer um objeto iconmap:text que dá à superfície um label amigável, um vínculo sugerido (suggest, por exemplo "{route} {destination}") e um estilo padrão (color, background, align, uppercase, emissive e, para superfícies de imagem, fit e mirror). Definir fit marca a superfície como uma superfície de imagem.
Com o Icon Map AI
O Icon Map AI está no roteiro da Icon Map Platform. Esta seção descreve como ele vai funcionar; o recurso ainda não está disponível de forma geral na versão prévia privada.
Em vez de montar um modelo e vincular cada superfície à mão, você poderá descrever o que deseja ao seu assistente de IA pelo Icon Map AI. Por exemplo:
"Crie um abrigo de ônibus de Londres com uma placa de nome acima da abertura e um painel publicitário na parede lateral. Coloque um em cada ponto da minha tabela de pontos, mostre o nome do ponto na placa e alterne nossos três cartazes de campanha nos painéis."
Geração de um modelo com superfícies
O Icon Map AI inclui o model forge, que cria modelos 3D low-poly a partir de uma descrição. Quando o objeto real tem texto ou imagens que mudam, o model forge adiciona cada letreiro ao modelo como uma superfície:
- No tamanho e na posição reais, voltada para o lado de onde as pessoas a leem, então não há nada para medir ou inverter por conta própria.
- Nomeada pelo que é (
blind,route_number,advert). Quando há muitas, elas são numeradas na ordem de leitura: etiquetas de prateleiralabel_b1_s1_p1,label_b1_s1_p2e assim por diante, da esquerda para a direita e de cima para baixo. - Com um vínculo sugerido e um estilo padrão: um letreiro de LED âmbar, um cabeçalho de corredor branco sobre azul, um painel publicitário retroiluminado.
O assistente mostra uma imagem de visualização do modelo e o altera conforme os seus comentários ("aumente a largura do letreiro", "coloque o anúncio na outra ponta").
Configuração da camada
Quando o modelo estiver como você quer, o assistente:
- Salva o modelo no OneLake do seu workspace.
- Adiciona uma camada Modelos 3D ou Rastreador de veículos que o usa, ou atualiza uma existente.
- Vincula cada superfície aos seus dados: uma coluna, um modelo de texto como
{route} {destination}, uma imagem fixa ou um conjunto rotativo. Ele também define o zoom a partir do qual as superfícies aparecem. - Renderiza uma visualização do mapa, para que você confira se o texto aparece corretamente antes de salvar o mapa.
O resultado é uma camada comum do Icon Map. Abra-a no editor e a seção Texto e imagens no modelo mostra todos os vínculos, prontos para serem alterados à mão.
Preparação dos dados
Uma superfície lê a linha do modelo em que está: uma linha por ônibus, por abrigo, por unidade de prateleira. Quando um modelo tem muitas etiquetas, como uma estante com 40 etiquetas de preço, cada etiqueta precisa da sua própria coluna, com o nome da sua superfície. Se os seus dados tiverem uma linha por etiqueta, o assistente pode escrever a consulta que os reorganiza. Como as superfícies do modelo sugerem exatamente esses nomes de coluna, todas as etiquetas são vinculadas sem configuração adicional.
O que o assistente vai informar
- O tamanho é real. Um letreiro de ônibus é legível a partir do zoom do nível da rua; uma etiqueta de prateleira com poucos centímetros de altura só é legível em visualizações bem próximas, na altura dos olhos. O assistente não aumenta um letreiro para que ele seja legível de mais longe.
- Mapas incorporados precisam de imagens da web ou SVG. Para um mapa que você pretende incorporar, ele coloca nos seus dados URLs da web ou SVG em vez de caminhos do OneLake (veja Mapas incorporados).
Próximas etapas
- Modelos 3D: posicione um modelo em cada ponto dos seus dados.
- Rastreador de veículos: frotas ao vivo, com letreiros de destino que se atualizam junto com os dados.
- Incorporação de mapas: coloque um mapa publicado na sua própria página.