BVH Viewer

Propósito e intenção do usuário: O BVH Viewer resolve o problema de inspecionar dados de captura de movimento BVH sem uma ferramenta 3D completa. Usuários-alvo incluem animadores 3D, desenvolvedores de jogos, técnicos de VFX e pesquisadores que exportam ativos BVH de Maya, Blender ou sistemas de captura. Use quando precisar verificar a integridade da hierarquia, mapear canais para articulações, comparar movimentos entre tomadas ou preparar dados para pipelines.

Lógica central e recursos: a ferramenta analisa um arquivo BVH, constrói uma hierarquia de articulações e decodifica os canais por quadro em transformações de articulações. Funções obrigatórias: análise BVH, extração de hierarquia, mapeamento canal-articulação, cálculo de transforms por quadro. Funções avançadas (opcionales): escalonamento de unidades, conversão de coordenadas, filtragem de intervalo de quadro, normalização de frame-rate, remapeamento de articulações, exportação de esqueleto ou resumos de movimento em JSON/CSV. Suporta variantes BVH comuns e sinaliza discrepâncias estruturais.

Entradas e saídas: Entradas: arquivo BVH (obrigatório), frame_rate (opcional, fps), time_range (opcional, início/fim em segundos), scale (opcional). Saídas: dados do esqueleto e dados de movimento, além de um resumo com frame_count e duração. Validação requer hierarquia válida com pelo menos um canal de movimento; arquivos corrompidos geram erros de parsing e interrompem com segurança.

Algoritmos e cálculos: o parsing constrói uma árvore de articulações, registra a pose de repouso e converte os canais em transforms por frame via composição pai-filho. Transformações globais são obtidas concatenando transforms de pai com offsets locais. Interpolação opcional trata frames ausentes ao fornecer um intervalo; conversão de coordenadas alinha o Up-axis com o eixo de destino; escala multiplica distâncias.

Erros e casos extremos: formatos de arquivo inválidos, raiz ausente ou articulações essenciais ausentes, frames não monotônicos ou nulos, ou alto número de articulações disparam diagnósticos. Arquivos BVH grandes podem exigir parsing em blocos.
Indústria/região & Localização: BVH é um padrão global; unidades tipicamente metros e segundos; frequências de quadro variam; sem tratamento regional específico além da formatação numérica.
Suposições & Exclusões: assume BVH conforme o padrão Biovision com hierarquia e canais definidos. Exclui rendering, edição de UI ou streaming em tempo real; foco em extração de dados, validação e saídas prontas para exportação.