gpt-engineer-app[bot]
3f5d8e1d9d
Co-authored-by: Reifonas <211114984+Reifonas@users.noreply.github.com>
97 lines
4.3 KiB
Markdown
97 lines
4.3 KiB
Markdown
## Objetivo
|
|
|
|
Adicionar um botão **"Escala"** com presets de redução (1:2, 1:4, 1:8, 1:10, 1:20, 1:33, 1:50, 1:100, 1:200) e ampliação (2:1, 4:1, 10:1), disponível tanto no Viewer 2D quanto no XR. Ao mudar a escala, o app ajusta automaticamente as ferramentas que dependem de tamanho real (medições, sensibilidade do ajuste fino, snap, hover auto-detect), mantendo todos os números exibidos em **mm reais da peça**.
|
|
|
|
## Conceito chave
|
|
|
|
- "1:N" significa: o modelo é renderizado **N vezes menor** que o real (renderScale = 1/N).
|
|
- "N:1" significa: renderizado N vezes maior (renderScale = N).
|
|
- Os dados do modelo continuam em mm reais. Só o `scale` aplicado ao `<group>` muda.
|
|
- **Medições, sensibilidades, indicadores e relatório PDF continuam exibindo mm REAIS** — o app multiplica/divide pelo fator quando necessário.
|
|
|
|
## Mudanças
|
|
|
|
### 1. Store (`useModelStore.ts`)
|
|
|
|
Adicionar:
|
|
```ts
|
|
scaleRatio: { label: '1:1', factor: 1 } // factor = renderScale
|
|
setScaleRatio: (r) => void
|
|
```
|
|
Lista de presets exportada (label + factor).
|
|
|
|
`fineTuning.scale` continua existindo para o gesto two-hand do XR; o novo `scaleRatio` é aplicado **por cima** (multiplicado) no grupo do modelo.
|
|
|
|
### 2. Cálculo de medições (`addMeasurePoint`)
|
|
|
|
Pontos A/B vêm em coordenadas world já escaladas. Para reportar mm reais:
|
|
```
|
|
distanceMM_real = distanciaWorld_mm / scaleRatio.factor
|
|
```
|
|
Atualizar a função `addMeasurePoint` para dividir pela escala atual antes de salvar `distanceMM`. Tooltips e PDF continuam usando o valor salvo (sem mudança).
|
|
|
|
### 3. Ajuste fino (`FineTuningControls` + XRHud joystick)
|
|
|
|
`POSITION_STEP` deve representar **1 mm real**. Aplicar:
|
|
```
|
|
worldStep = POSITION_STEP * scaleRatio.factor
|
|
```
|
|
Isso garante que clicar "+" desloca visualmente proporcional à escala (em escala 1:100, mexer "1 mm real" desloca 0,01 mm na cena — coerente).
|
|
|
|
Mesmo tratamento para o joystick no XR (incremento por frame multiplicado por `scaleRatio.factor`).
|
|
|
|
### 4. Auto-detect (hover hole/edge) e snap
|
|
|
|
Os limiares de detecção de furo/aresta e raio de snap são em metros world. Multiplicar pelo `scaleRatio.factor` para que continuem capturando os mesmos elementos físicos da peça.
|
|
|
|
### 5. ModelViewer
|
|
|
|
No `<group>` do modelo, multiplicar o scale final:
|
|
```
|
|
finalScale = fineTuning.scale * scaleRatio.factor
|
|
```
|
|
|
|
### 6. UI — novo componente `ScaleSelector`
|
|
|
|
Botão com ícone de régua + label atual ("1:1", "1:50"…). Ao clicar abre um Popover/Sheet com grid:
|
|
|
|
```text
|
|
Reduzir Ampliar
|
|
[1:1*] [1:2] [1:4] [1:8] [2:1]
|
|
[1:10] [1:20] [1:33] [1:50] [4:1]
|
|
[1:100] [1:200] [10:1]
|
|
```
|
|
|
|
Toast ao trocar: *"Escala 1:50 — medições e controles ajustados para mm reais"*.
|
|
|
|
Inserir o componente em:
|
|
- **`ViewerControls`** (canto dos controles flutuantes do Viewer 2D)
|
|
- **`XRHud`** (linha de ferramentas, próximo ao toggle "Escala ON/OFF" two-hand)
|
|
|
|
### 7. MeasurementsList & FineTuningControls
|
|
|
|
Adicionar pequeno badge "Escala atual: 1:50" no topo dos painéis de Medições e Ajuste Fino para o usuário lembrar que os valores exibidos são mm reais.
|
|
|
|
## O que NÃO muda
|
|
|
|
- Gesto two-hand de escala (`allowScale`) continua funcionando para ajuste livre — mas se o usuário usar o preset, o gesto reseta para 1.0 e o preset assume.
|
|
- Relatório PDF: registra a escala atual no cabeçalho.
|
|
- Grid e checklist: sem alteração.
|
|
|
|
## Arquivos tocados
|
|
|
|
- `src/stores/useModelStore.ts` — novo estado + ajuste em `addMeasurePoint`
|
|
- `src/components/ScaleSelector.tsx` — novo (popover com presets)
|
|
- `src/components/ViewerControls.tsx` — incluir `<ScaleSelector />`
|
|
- `src/components/XRHud.tsx` — incluir `<ScaleSelector />` + multiplicar passos do joystick
|
|
- `src/components/FineTuningControls.tsx` — multiplicar passos pela escala + badge
|
|
- `src/components/MeasurementsList.tsx` — badge da escala
|
|
- `src/components/three/ModelViewer.tsx` — aplicar `scaleRatio.factor` no group + ajustar threshold de snap/hover
|
|
- `src/lib/generateReport.ts` — incluir escala no cabeçalho do PDF
|
|
|
|
## Validação
|
|
|
|
- Carregar viga demo, medir uma aresta conhecida em 1:1 → trocar para 1:10 → remedir mesma aresta → valor em mm deve permanecer igual.
|
|
- Em 1:50, clicar "+" no ajuste fino X uma vez → modelo desloca visualmente pouquíssimo (esperado), mas valor exibido sobe 1 mm.
|
|
- No XR, joystick em 1:100 não "voa" o modelo a metros de distância.
|