Guia do AlphaGyro Studio

Instalação

Baixe o instalador na página de download. A página detecta o seu sistema e destaca a opção certa. Antes de instalar, confira se o SHA-256 do arquivo é igual ao publicado na página.

macOS

1. Escolha Apple Silicon (chips M1 ou mais novos), Intel ou Universal (roda nos dois, arquivo maior). Para saber qual é o seu Mac, abra o menu Apple → Sobre Este Mac: se aparecer "Chip", é Apple Silicon; se aparecer "Processador" Intel, é Intel.
2. Abra o .dmg e arraste o AlphaGyro Studio para a pasta Aplicativos.
3. Abra o app pela pasta Aplicativos. Se o macOS mostrar um aviso de segurança na primeira abertura, confirme que o arquivo veio deste site e que o SHA-256 confere antes de continuar.

O instalador .pkg faz a mesma instalação sem arrastar arquivos e é útil para instalar em vários Macs.

Windows

1. Execute o AlphaGyro-Studio-Windows-x64-Setup.exe e siga o assistente.
2. Se o Windows SmartScreen exibir um aviso, confira a origem do arquivo e o SHA-256 antes de continuar.
3. A versão portátil (.zip) não precisa de instalação: descompacte numa pasta onde você tenha permissão de escrita e execute o programa. Ela não cria atalhos e não se atualiza sozinha.

Atualizações

O app verifica se há versão nova enviando somente a versão instalada, o sistema, a arquitetura e o canal (estável, beta ou nightly). O pacote baixado é conferido por SHA-256 e assinatura digital antes da instalação, e a instalação espera terminar qualquer render em andamento.

Importação

Arraste um arquivo MP4 ou MOV gravado pela Air Unit para a janela do app, ou use Arquivo → Importar. Na importação o AlphaGyro Studio analisa o arquivo e mostra contêiner, codec, resolução, taxa de quadros, profundidade de cor e câmera.

Giroscópio detectado automaticamente

As Air Units DJI O3, O4 e O4 Pro gravam o giroscópio numa trilha de metadados dentro do próprio vídeo (djmd). O app lê essa trilha sozinho, identifica a câmera e aplica o profile de lente correspondente. Você não precisa de arquivo de log separado.

Sincronização

No material da DJI o giroscópio já vem alinhado ao vídeo pelo tempo, então normalmente não há nada a fazer. Se notar a imagem "atrasada" em relação ao movimento, use a sincronização automática, que calcula o deslocamento e mostra um índice de confiança, e faça o ajuste fino manual do deslocamento em milissegundos se precisar.

Giroscópio externo

Também é possível importar dados de giroscópio de outra fonte, em .gcsv ou log Blackbox (.csv / .bbl), e associar a um vídeo. Neste caso a sincronização é essencial, porque os relógios dos dois aparelhos não são os mesmos.

Projetos

Os ajustes de cada vídeo ficam num projeto .agproj. Salve o projeto para voltar depois com as mesmas configurações de estabilização, sincronização, lente, recorte, horizonte, LUT e render.

Estabilização

Use a prévia com comparação original / estabilizado (modo split com divisória) para avaliar cada ajuste. A linha do tempo mostra as curvas de rotação do giroscópio, correção aplicada, recorte e horizonte.

Suavização

Controla quanto do movimento é removido. Valores baixos mantêm a energia do voo e só tiram a vibração; valores altos deixam o vídeo com cara de câmera em cabo aéreo, mas exigem mais recorte nas manobras bruscas.

Horizon lock (0–100%)

Define o quanto o horizonte fica nivelado. Em 0% o vídeo segue a inclinação do drone; em 100% o horizonte fica travado mesmo durante rolls. Valores intermediários, como 50–80%, nivelam o horizonte mas ainda deixam perceber as curvas. Horizon lock alto em rolls completos exige mais recorte.

FOV e recorte

Toda estabilização precisa de margem: a imagem é girada e deslocada, e as bordas são recortadas para não aparecer área vazia. Ajuste o FOV e o recorte para equilibrar estabilidade e campo de visão. Recorte dinâmico mais conservador evita bordas pretas em manobras fortes; recorte fixo mantém o enquadramento constante.

LUT

Para material em D-Log M (O4 Pro) você pode importar um LUT .cube e aplicá-lo na prévia e no render. O LUT importado é copiado para a pasta de LUTs do usuário e fica disponível nos próximos projetos.

Render

Presets

Depois de escolher um preset você pode ajustar codec, profundidade de cor, resolução, taxa de quadros, taxa de bits, áudio (copiar, recodificar ou remover), intervalo do vídeo e preservação de metadados.

Codecs

• H.264: compatibilidade máxima com players e redes sociais. 8-bit.
• HEVC (H.265): arquivos menores com mais qualidade; aceita 10-bit.
• ProRes: para edição e color grading; arquivos grandes, mantém 10-bit.

Para preservar os 10 bits do O4 Pro, exporte em HEVC 10-bit ou ProRes.

Encoder

Por padrão o encoder é escolhido automaticamente: o encoder nativo do sistema com hardware (VideoToolbox no macOS; NVENC, AMF ou Quick Sync no Windows) e, se não estiver disponível, codificação por software, mais lenta. A combinação de resolução, taxa de quadros e codec precisa ser aceita pelo hardware; se não for, o app avisa antes de iniciar.

Render em lote

Adicione vários vídeos ou projetos à fila de render. Cada item mostra a etapa (preparando, decodificando, processando, codificando), o progresso, a velocidade em quadros por segundo, o tempo restante e o decoder e encoder em uso. É possível pausar, retomar, cancelar e remover itens.

Recuperação de render

Se o computador desligar ou o app fechar no meio de um render, na próxima abertura o AlphaGyro Studio lista as sessões interrompidas e oferece recuperar (continuar de onde parou) ou descartar.

Profiles

Profiles descrevem a câmera e a lente: distorção da grande-angular, orientação do giroscópio e parâmetros padrão. O app já vem com profiles para DJI O3, DJI O4 e DJI O4 Pro e escolhe o certo na importação.

• Os profiles são atualizados separadamente do app. Cada profile baixado é conferido por SHA-256 e assinatura digital antes de ser instalado.
• Cada profile informa a versão mínima do app com que é compatível; profiles incompatíveis não são instalados.
• Se a detecção automática errar (por exemplo, num arquivo editado ou recodificado que perdeu os metadados), escolha o profile manualmente nas configurações de lente do projeto.

Linha de comando

Para automação e servidores de render, o AlphaGyro Studio tem uma interface de linha de comando.

Estabilizar um vídeo:

alphagyro input.mp4 --stabilize --camera dji-o4-pro --output out.mp4

Renderizar todos os vídeos de uma pasta:

alphagyro batch ./videos/

Em --camera, use o identificador do profile da sua câmera, como dji-o4-pro no exemplo acima. Os mesmos presets e profiles do app são usados pela linha de comando, e o processamento continua 100% local.

Solução de problemas

Ajuda → Diagnóstico

A tela Ajuda → Diagnóstico mostra a GPU detectada, decoders e encoders disponíveis, Metal ou DirectX, versão dos drivers, codecs suportados e o caminho dos arquivos de log. Use Exportar diagnóstico para gerar um .zip e enviá-lo ao suporte junto com a descrição do problema. O arquivo contém informações técnicas da máquina e logs; seus vídeos não são incluídos.

Logs

Os logs ficam na pasta de dados do app:

• macOS: ~/Library/Application Support/AlphaGyro Studio/
• Windows: %LOCALAPPDATA%\AlphaGyro Studio\

O caminho exato de cada log (como o Application.log) aparece em Ajuda → Diagnóstico. Toda mensagem de erro do app traz um código, a causa provável, a solução sugerida e a referência ao log.

Problemas comuns

• "Giroscópio não encontrado": o arquivo provavelmente não é o original da Air Unit (foi recodificado, cortado em outro programa ou baixado de uma rede social) ou foi gravado com a estabilização eletrônica ligada. Use o arquivo original do cartão.
• Imagem treme ou "atrasa" em relação ao movimento: rode a sincronização automática e confira o índice de confiança; se estiver baixo, ajuste o deslocamento manualmente.
• Bordas pretas nas manobras: aumente o recorte, reduza o horizon lock ou reduza a suavização.
• Render lento: confira em Ajuda → Diagnóstico se o encoder de hardware está ativo; atualize o driver da GPU; para revisar, use Fast Preview.
• Não exporta 4K/120: o encoder de hardware da sua máquina pode não aceitar essa combinação. Tente HEVC, outra taxa de quadros ou o encoder por software.
• Cores lavadas no O4 Pro: o material está em D-Log M; aplique um LUT .cube de conversão.

Não resolveu? Fale com o suporte e anexe o diagnóstico exportado.