Documentação técnica sobre a malha facial (MediaPipe) e o algoritmo de análise ocular.
O projeto utiliza exclusivamente o Google MediaPipe Face Mesh, uma solução de visão computacional de última geração que mapeia 478 pontos tridimensionais na face humana.
Mapeamento detalhado de sobrancelhas, lábios e, crucialmente, a geometria complexa dos olhos e íris.
Funciona bem sob variações de iluminação e rotação da cabeça, superando métodos antigos baseados em 68 pontos.
Inclui pontos específicos para o centro e contorno da íris, permitindo métricas de direção do olhar.

Visualização da malha de 468/478 pontos
Para detectar piscadas de forma confiável e independente da distância da câmera, utilizamos a métrica EAR (Eye Aspect Ratio). Esta fórmula matemática relaciona a altura e a largura do olho para determinar seu grau de abertura.
Onde ||Px-Py|| é a distância Euclidiana entre dois pontos.
Nossos scripts atuais geram arquivos CSV contendo todos os 478 pontos (x, y, z) para cada frame. Isso garante que, mesmo que mudemos a fórmula do EAR no futuro, não será necessário reprocessar os vídeos originais, pois temos a geometria facial completa salva.