Ajustar posicionamento 3D — referência funcional
Conheça controles, alcance, persistência e limites de recuperação do recurso experimental.
Ajustar posicionamento pode mover conjuntos e gravar ou restaurar muitos registros. O código foi inspecionado, mas os procedimentos não foram ensaiados nesta etapa. Não use como correção rotineira sem supervisão e ambiente isolado; não presuma reversão completa. O treinamento de vias e passeios não protege este recurso.
O que pode mudar
A planta é uma referência visual cuja exibição, contraste e opacidade são separados da geometria editada. O ajuste de posicionamento atua sobre alvos da cena, não altera automaticamente a composição lógica de Core/Portal. Uma posição horizontal usa coordenadas geográficas do mapa; em estruturas há também referencial local vinculado à unidade. Não confunda essas coordenadas com cota vertical ou pé-direito em Andares.
Translação desloca horizontalmente; rotação muda orientação; escala mudaria o tamanho. A barra analisada não oferece controle de escala nem campo numérico de deslocamento, altura, pontos de ancoragem ou coordenadas. A existência de funções de escala em outros editores não comprova escala neste modo.
Prévia altera a cena em memória; aplicação na cena, gravação remota e publicação são coisas diferentes. Desfazer da sessão, ponto local e restauração de versão no servidor têm escopos diferentes. Nenhuma delas é garantia de recuperação integral de relações ou de alterações posteriores.
Alvos e elementos associados
| Elemento | O que o código permite concluir | Conferência necessária |
|---|---|---|
| POI poligonal ou pontual | Alvo selecionável no fluxo; contorno e coordenadas podem ser transformados. Localização, volumes externos e áreas de cobertura integradas entram em caminhos específicos. | Confirmar seleção, ponto e contorno, dados remotos e rótulos; não presumir que todo POI ligado acompanhe. |
| Forma / Space | Alvo selecionável no piso de trabalho; forma correspondente ao POI e outros elementos associados podem ser incluídos por regras de identidade/geometria. Chaves de posição podem ser reindexadas. | Confirmar contagem e lista “serão movidos”; forma de outro piso pode ser bloqueada. |
| Edifício / unidade | POI ligado pode levar contorno do edifício e referencial estrutural; há caminho específico de gravação da unidade e verificação de suporte do servidor. | Vínculos e contexto multi-piso variam; não presumir que todos os andares sejam regravados ou que toda unidade seja selecionável diretamente. |
| Telhados e volumes externos | Geometrias integradas ao alvo podem acompanhar; lista de associados pode indicar volume integrado, telhado integrado e volume no telhado. | Pré-verificação tenta detectar perda ou dessincronização; revisar cada face e relação. |
| Planta | Mostrar planta ajusta visualização; não se identificou nesta barra operação para mover ou redimensionar a imagem cadastrada. | Verificar associação e alinhamento da planta antes de atribuir erro ao edifício. |
| Pisos e cotas | O ajuste trabalha horizontalmente; altura e base das geometrias tratadas não são alteradas pela translação analisada. O piso de trabalho e referenciais locais condicionam o salvamento. | Conferir cada piso e cota; mudanças de elevação não fazem parte do controle examinado. |
| Paredes, portas e aberturas | Podem integrar dados de geometria ou vínculos de um alvo; o preflight e caminho estrutural tratam algumas relações. | Não se comprovou que todas as portas, aberturas e offsets acompanhem em todos os casos; revisar e ensaiar. |
| GLBs, Paramétricos, rotas e transições | Não foi comprovada seleção ou transformação geral dessas entidades no fluxo inspecionado. | Tratar acompanhamento como desconhecido; conferir cada instância, rota e transição antes e depois. |
Os indicadores são evidência do conjunto calculado naquela cena, não inventário comprovadamente completo de todas as dependências remotas. Duplicatas, gêmeos ambíguos, pisos incompatíveis ou suporte incompleto podem bloquear a operação.
Controles identificados no código
| Controle e identificador | Função e limites | Escopo e persistência |
|---|---|---|
Mostrar planta / Contraste / Opacidade fieldAdminPositionAdjustShowBlueprint | Caixas e faixa visual; opacidade 0,10–1,00 em passos 0,05, inicial técnico 0,70. A planta pode estar ausente. | Apresentação da referência na sessão; não comprova reposicionamento da planta. |
Selecionados / serão movidos fieldAdminPositionAdjustWillMove | Contagem e lista de alvos e associados calculados, inclusive representação do Portal e volumes/telhados quando reconhecidos. | Revisar o conjunto antes de qualquer operação; regras condicionais não garantem todas as dependências. |
| Arraste | Move seleção horizontalmente a partir dos pontos projetados no mapa; não há distância numérica exibida na barra examinada. | Prévia e geometria da cena em memória; não comprova gravação nem preservação de vínculos. |
Girar fieldAdminPositionAdjustRotate | Botões −1° anti-horário / +1° horário e entrada decimal em graus, aplicada ao sair do campo ou Enter. O código não declara máximo explícito no campo. | Exige seleção girável; pivô é centro calculado do grupo de alvos fixados. Visualização local até Salvar. |
| Desfazer / Cancelar | Desfazer retorna snapshot anterior da sessão; Cancelar tenta restaurar o estado inicial da sessão e sai. | Operações de cena; não garantem reverter gravação remota já realizada ou parcial. |
| Salvar | Disponível com mudanças; executa verificações, ponto local e caminhos de gravação. | Pode envolver chamada estrutural e gravações por registro; mensagens indicam sucesso, falha ou resultado parcial. Não há confirmação separada identificada para Salvar na barra. |
| Alinhar portal / Remover leftovers | Ações de reparo e limpeza, quando disponíveis; não são ferramentas de consulta. | Podem regravar ou remover registros; execução supervisionada e ensaio isolado obrigatórios. |
| Histórico | Abre pontos locais e versões do servidor; criar, importar, exportar e restaurar conforme escopo. | Restauração grava; ponto no servidor afeta rascunho completo ao restaurar. Veja seção abaixo. |
Durante preparação, bloqueio, salvamento ou reparo, certos controles ficam indisponíveis. A barra apresenta estado de preparação, salvamento, falhas e resultado; não se identificou nela progresso numérico garantido por entidade. Consulte FieldAdminPositionAdjustBar.tsx e traduções.
Transformação e validações
O arraste converte pontos do mapa em diferenças de longitude/latitude e aplica a geometria horizontal aos alvos fixados. A rotação usa um centro calculado do conjunto e transformação horizontal em torno dele; na interface +1° é horário. Aproximações geográficas e conversões podem produzir diferenças; não se identificou garantia de precisão topográfica ou arredondamento universal. Compare referências antes e depois.
O código distingue pisos em coordenadas globais e structural-local. Para movimento estrutural, lê pisos de autoria e pode recusar piso de trabalho local, referencial desconhecido, falta de suporte no servidor ou vínculo inconsistente. Não é seguro inferir que todos os elementos de todos os pisos sejam transformados diretamente: alguns podem depender do referencial estrutural, outros permanecer fora do conjunto.
Antes de gravar, o código verifica presença e contagem de contornos, rigidez, gêmeos, texturas, volumes/tetos integrados, mudanças concorrentes e outras condições. Essas barreiras não comprovam segurança integral nem substituem inspeção de portas, objetos, rotas e vínculos. Em conflito, geometria ambígua, destino ocupado ou informação incompleta, interrompa e solicite supervisão.
Prévia, gravação e resultado parcial
O arraste e a rotação aplicam prévia e histórico de sessão; o caminho inspecionado grava quando Salvar é acionado. A entrada no modo também atualiza dados da cena e pode substituir snapshots locais: preserve trabalho pendente. As ações Alinhar portal e Remover leftovers são caminhos próprios de escrita e não dependem necessariamente desse Salvar.
O salvamento monta verificações e um ponto local anterior. Uma unidade estrutural pode usar chamada coordenada ao servidor; outros registros podem ser gravados separadamente e confirmados. Na falha, o código tenta restauração em alguns caminhos e pode relatar confirmação incompleta. Não interprete uma mensagem de cena revertida como prova de que todos os dados remotos e relações voltaram. Interrompa, registre o resultado e confira o estado armazenado com responsável; não repita às cegas.
Histórico, pontos e restauração
Desfazer usa snapshots em memória da sessão; não é histórico remoto nem rollback de publicação. Pontos locais são snapshots no navegador, associados ao local e piso, com identificador, data, origem e estado; incluem dados de POIs, formas e alguns dados de edifícios. O código mantém até 10 pontos por local e um teto aproximado de 24 MiB, com descarte de registros antigos conforme a política. Limpeza do navegador ou falta de armazenamento pode eliminá-los. Exportar/Importar JSON transfere pontos locais, sem comprovar restauração.
Um ponto local pode ser criado manualmente ou antes de certos salvamentos, alinhamento e limpeza. Restaurar exige confirmação e regrava dados capturados; o serviço pode restaurar edifícios de autoria, POIs e formas e remover certas formas atuais fora do snapshot. Pode falhar após algumas gravações. Captura antiga de edifício sem dados remotos apropriados pode não ser restaurável; pontos não cobrem comprovadamente todos os módulos.
Pontos no servidor são versões de rascunho; criar ponto é escrita. Restaurar uma versão exige confirmação, substitui o rascunho inteiro do local e recarrega a página segundo o código. Isso pode apagar alterações posteriores de outras pessoas e não equivale a desfazer uma publicação. Não se identificou neste cliente um prazo ou quantidade universal de retenção no servidor. Antes de qualquer recuperação, supervisor deve conferir escopo, dados atuais, dependências e consequências; ensaio e política do servidor permanecem pendentes.
Fontes e relações
Código local: FieldAdminPositionAdjustBar.tsx, FieldAdminPositionAdjustLayer.tsx, positionAdjustApply.ts, positionAdjustGeometry.ts, positionAdjustAuthoringScope.ts, positionAdjustPreflight.ts, positionAdjustSave.ts, positionAdjustStructuralSave.ts, positionCheckpointService.ts, positionCheckpointStore.ts e draftRestorePointApi.ts. Controles são evidência de código, não de disponibilidade implantada nem de ensaio.
Jornada supervisionada · Ferramentas básicas · Composição · Andares · Volumes de edifícios · Formas · Paredes · Aberturas · Portas · GLBs · Paramétricos · POIs · Rotas.