Este documento apresenta um procedimento passo a passo para a instalação da biblioteca OpenCV em distribuições Linux baseadas no Ubuntu. O processo abrange desde a preparação do ambiente de compilação até a configuração final da biblioteca.

Pré-requisitos do Sistema

Antes de iniciar a instalação, é necessário garantir que o sistema possui os pacotes essenciais para desenvolvimento. Execute os seguintes comandos para atualizar o cache de pacotes e instalar as ferramentas básicas:

sudo apt update
sudo apt install -y build-essential pkg-config

Instalação do CMake e Dependências

O CMake é utilizado para gerar os arquivos de compilação. Para instalar a versão com interface gráfica e outras dependências necessárias, utilize:

sudo apt install cmake-qt-gui libgtk2.0-dev libavcodec-dev libavformat-dev libswscale-dev

Essas bibliotecas adicionais são necessárias para o suporte a vídeo e interface gráfica.

Obtendo e Compilando o OpenCV

Baixe o código fonte do OpenCV a partir do repositório oficial. Crie um diretório de trabalho e navegue até ele:

mkdir opencv_build && cd opencv_build
wget -O opencv.zip https://github.com/opencv/opencv/archive/refs/tags/4.8.0.zip
unzip opencv.zip

Dentro do diretório descompactado, crie um diretório para a compilação:

cd opencv-4.8.0
mkdir build && cd build

Inicie a configuração do projeto com o CMake. As flags a seguir desativam componentes não essenciais para reduzir o tamanho da compilação:

cmake -D CMAKE_BUILD_TYPE=RELEASE \
      -D CMAKE_INSTALL_PREFIX=/usr/local \
      -D BUILD_EXAMPLES=OFF \
      -D BUILD_TESTS=OFF \
      -D BUILD_PERF_TESTS=OFF \
      ..

Prossiga com a compilação e instalação. O parâmetro -j especifica o número de processos paralelos, acelerando a compilação em máquinas com múltiplos núcleos:

make -j$(nproc)
sudo make install

Verificação da Instalação

Para confirmar que a biblioteca foi instalada corretamente, crie um pequeno programa de teste. Salve o código abaixo como check_version.c:

#include <stdio.h>
#include <opencv2/core.hpp>

int main() {
    printf("Versão do OpenCV: %s\n", CV_VERSION);
    return 0;
}

Compile e execute o programa utilizando o pkg-config para obter as flags de compilação corretas:

gcc check_version.c -o check_version $(pkg-config --cflags --libs opencv4)
./check_version

Uma saída bem-sucedida mostrará o número da versão instalada do OpenCV.

Observações Importantes

Este procedimento configrua uma instalação base do OpenCV. Para funcionalidades adicionais como suporte a CUDA para processamento em GPU, é necessário fornecer flags adicionais durante a etapa de configuração do CMake e ter os drivers e toolkit da NVIDIA previamente instalados.

Para desinstalar o OpenCV compilado a partir do código fonte, navegue até o diretório build e execute sudo make uninstall.