O Pupil é um projeto de rastreamento ocular de código aberto, compatível com Windows, macOS e Linux. Este guia oferece um método rápido e prático para instalação e configuração, permitindo que você comece a usar esta ferramenta poderosa de rastreamento ocular.

Requisitos e Dependências

Antes de iniciar a instalação, certifique-se de que seu sistema atende aos seguintes pré-requisitos:

• Sistema Operacional: Windows 10/11, macOS 10.15 ou superior, ou Linux (Ubuntu 20.04+ recomendado).
• Hardware: Computador com suporte a USB 3.0 e no mínimo 4GB de RAM.
• Software: Git e Python 3.8 ou superior.

Obtenção do Código-Fonte

Primeiro, clone o repositório do projeto Pupil:

git clone https://github.com/pupil-labs/pupil.git
cd pupil

Instalação no Windows

1. Instalação de Dependências

Usuários de Windows precisam instalar as dependências de Python:

pip install -r requirements.txt

2. Empacotamento da Aplicação

Utilize o script de build fornecido para gerar o executável:

cd .\deployment\
.\reproducible_build.ps1

Após a conclusão do build, o executável estará no diretório dist.

Instalação no macOS

1. Instalação de Dependências do Sistema

Utilize o Homebrew para instalar componentes necessários:

brew install python3 opencv

2. Instalação de Dependências Python

pip3 install -r requirements.txt

3. Empacotamento e Assinatura

Usuários de macOS podem usar o seguinte script para empacotar a aplicação:

cd deployment
./reproducible_build.sh

Após o empacotamento, a aplicação pode precisar de assinatura:

./notarize_macos.sh

Instalação no Linux

1. Instalação de Dependências do Sistema

Para usuários de Ubuntu/Debian:

sudo apt-get update
sudo apt-get install -y python3 python3-pip libopencv-dev

2. Instalação de Dependências Python

pip3 install -r requirements.txt

3. Execução da Aplicação

No Linux, a aplicação pode ser executada diretamente a partir do código-fonte:

python3 pupil_src/main.py

Configuração do Pupil

Configuração Básica

Ao executar o Pupil pela primeira vez, você precisará realizar:

1. Conectar o dispositivo de rastreamento ocular.
2. Realizar a calibração.
3. Ajustar os parâmetros de rastreamento.

Configuração Avançada

Usuários avançados podem personalizar configurações modificando arquivos:

• Arquivos de configuração: Localizados em pupil_src/shared_modules/.
• Configurações de calibração: Dentro do diretório calibration_choreography/.
• Algoritmos de rastreamento ocular: Encontradso em gaze_mapping/.

Solução de Problemas Comuns

Falha na Instalação de Dependências

Se encontrar problemas durante a instalação de dependências, tente:

pip install --upgrade pip
pip install -r requirements-dev.txt

Dispositivo Não Reconhecido

Verifique se o dispositivo de rastreamento ocular está conectado corretamente e se as portas USB estão funcionando. Consulte o módulo video_capture/ para configurações de driver.

Otimização de Desempenho

Para melhorar o desempenho e evitar travamentos:

• Reduza a resolução do vídeo.
• Desabilite plugins desnecessários.
• Ajuste a prioridade das tarefas no diretório tasklib/.