Mapeamento de câmeras
Mapeamento de câmera conecta a imagem da câmera ao mundo da composição. No Toposync, esse conceito de produto é Spatial Camera Mapping: a visão da câmera, a posição da câmera, as áreas mapeadas e os pontos da imagem ficam alinhados no mesmo modelo da casa.
Ele permite que o Toposync entenda onde a câmera está instalada, qual área ela vê e como pontos da imagem se relacionam com o mundo.
Mapeamento também é o que torna a Visão 360 possível: vídeo ao vivo mapeado pode ser projetado sobre a composição.
Smoke de mapeamento com imagem estática
Uma imagem RTSP estática é uma boa fonte controlada para mapeamento de câmera. Ela pode provar que snapshot, calibração, publicação ao vivo, recorte de área e projeção na Visão 360 estão conectados corretamente contra um frame estável.
Ela não prova detecção real de pessoas. Um frame parado pode validar mapeamento e Visão 360 sem gerar detecção, tracking, notificação ou pin. Gates de movimento podem ignorar um frame que nunca muda, e detecção baseada em modelo ainda depende de um artefato preparado no servidor de processamento selecionado.
Use Teste sem uma câmera real para o caminho de streaming com imagem estática. Use Processamento de imagem quando o teste precisa de prontidão de modelo, detecção de pessoa, tracking, notificações ou Spatial Events.
Comece pelo posicionamento
Primeiro posicione o elemento de câmera perto da posição real na composição. O posicionamento não precisa resolver a projeção sozinho. Ele deve deixar a câmera fácil de encontrar e explicar o que ela enxerga.
Depois do posicionamento, calibre a visão usando um snapshot atual da câmera.
Quatro cantos e transformação global
O primeiro passo da calibração usa quatro cantos:
- escolha pontos na imagem da câmera;
- associe esses pontos a posições na composição;
- ajuste a transformação global movendo, girando e arrastando cantos.
Os quatro cantos definem a projeção base. Mantenha esses pontos em referências visuais estáveis e significativas sempre que possível: bordas de piso, portões, paredes, cantos de garagem ou outros pontos fixos.
Pontos internos de refinamento
Algumas lentes e ângulos de câmera não encaixam bem com apenas quatro cantos. Use pontos internos de refinamento para corrigir distorções locais.
Pontos de refinamento:
- ajustam uma parte local da projeção;
- mantêm os quatro cantos como transformação global;
- ajudam em lentes abertas e distorcidas;
- são salvos como parte da visão calibrada.
Use apenas os pontos necessários. Pontos demais podem dificultar o entendimento da calibração.
Vistas PTZ
Câmeras PTZ podem ter várias vistas calibradas. Cada vista pode armazenar referência de preset, pan, tilt e zoom.
Quando a câmera se move:
- uma pose exata pode usar a calibração correspondente;
- uma pose entre calibrações pode ser interpolada;
- uma pose próxima do intervalo calibrado pode ser extrapolada com cuidado;
- uma pose distante pode usar a vista mais próxima com aviso forte;
- com apenas uma vista, o Toposync ainda pode mostrar essa vista, mas deve avisar que a pose atual talvez não esteja bem mapeada.
Avisos de qualidade de pose não significam que o stream está quebrado. Eles significam que a posição projetada pode estar imprecisa.
Recorte de área para Visão 360
Um elemento de câmera pode escolher opcionalmente uma área como recorte para Visão 360. Isso limita o vídeo projetado àquela área.
Use recorte de área quando a câmera enxerga além do espaço que você quer renderizar, por exemplo teto, rua, céu ou outro cômodo.
Recorte de área é um recorte espacial. Ele pode fazer o vídeo projetado parecer cortado ou com zoom mesmo quando o transporte de vídeo está correto.
Correção de letterbox
O snapshot de calibração pode usar a imagem útil da câmera, enquanto a transmissão ao vivo pode ser redimensionada com barras pretas em volta.
O Toposync lida com isso automaticamente por meio de metadados de mídia chamados
content_rect. O renderizador da Visão 360 usa esse retângulo para ignorar
padding preto de letterbox ao projetar vídeo.
Não recalibre só porque uma transmissão tem barras pretas. Primeiro confirme se a Visão 360 está usando o conteúdo útil e se algum recorte de área está cortando a projeção.
O que o mapeamento afeta
Mapeamento de câmera pode afetar:
- projeção na Visão 360 2D e Visão 360 3D;
- marcadores de câmera e contexto espacial;
- Spatial Events produzidos a partir de detecções de câmera mapeadas;
- pipelines que usam coordenadas de câmera para mundo;
- futuros controles e overlays sensíveis a PTZ.
Ele não substitui a transmissão ao vivo. A câmera ainda precisa ter uma transmissão/publicação ativa antes de ser projetada como vídeo ao vivo.
Lista de verificação prática
- Confirme que o snapshot da câmera está atual.
- Confirme que a transmissão ao vivo funciona para a fonte que você quer mapear.
- Posicione o elemento de câmera na composição.
- Adicione quatro pares de cantos confiáveis.
- Use a transformação global antes de adicionar pontos internos de refinamento.
- Adicione vistas PTZ apenas para posições ou presets significativos.
- Use recorte de área apenas quando quiser um recorte espacial na Visão 360.
- Abra a Visão 360 e confira se vídeo, marcador e avisos fazem sentido.