Infra - Linux

HairCAPTURE – Utilizando captura de vídeo em C++ (sem segredos)

A biblioteca libhairCAPTURE é a minha contribuição em termos de desenvolvimento para a comunidade open-source. O principal objetivo é desmistificar o manuseio de vídeo ao vivo em C++. Críticas e sugestões sempre são benéficas para o crescimento do projeto.

por Alessandro de Oliveira Faria


Introdução

A biblioteca libhairCAPTURE ( http://lhaircapture.sourceforge.net ou http://libhaircapture.codigolivre.org.br ) é uma biblioteca de objetos escrita em C++, criada para facilitar o desenvolvimento de aplicações que manipulam vídeo ao vivo. Os métodos trabalham com chamadas da API V4L (Video for Linux ) versão 1. Os recursos da biblioteca SDL foram utilizados para proporcionar recursos visuais junto à exibição do vídeo ao vivo. Abaixo, alguns recursos:

  • Traçar gráficos primitivos;
  • Exibir imagem com transparência;
  • Escrever texto em tempo real sobre o vídeo ao vivo;
  • Exibição de imagem ZoomOut (efeito picture-to-picture);
  • Exibição em janela ou tela cheia.


Futuras implementações:

  • Transmissão de quadros via TCP/IP;
  • Armazenamento de quadros em discos e/ou em banco de dados;
  • Alternar automaticamente os canais de TV e entradas de vídeo;
  • Geração de arquivos de vídeo em formato MPEG;
  • Filtros de efeitos em tempo real.

Dependências

Agradecimentos

A conclusão deste trabalho somente foi possível graças as documentações enviadas por Alan Cox , ao constante apoio do Fábio e da comunidade Viva o Linux , Lucas do LinuxDicas e parceiro Davidson Paulo (autor do Guia Bozolinux ), que assumiu a coordenação da documentação do projeto.

Para visualizar o resultado, veja o vídeo no link abaixo:

Download e Instalação

Os pacotes estão divididos em 3 partes: a biblioteca, o pacote de desenvolvimento com exemplos e o código-fonte do pacote. Todos estes pacotes podem ser encontrados nas versões .rpm, .deb e .tgz.

O download da sua distribuição pode ser efetuado nos seguintes links:

ATENÇÃO: Este documento parte do princípio que as dependências estão devidamente instaladas.

Instalação da biblioteca

Após o download, se transforme em super usuário ou efetue o login como root e siga abaixo as instruções de instalação da sua distribuição:

Debian:

# dpkg -i haircapture_0.93-2_i386.deb
# dpkg -i haircapture-devel_0.93-2_i386.deb

RedHat, SuSE e outros:

# rpm -ivh hairCAPTURE-0.93-1cl.i586.rpm
# rpm -ivh hairCAPTURE-devel-0.93-1cl.i586.rpm

Slackware:

# tar -zxvf hairCAPTURE-0.93.tgz -C /
# ldconfig
# tar -zxvf hairCAPTURE-devel-0.93.tgz -C /

A partir do código fonte:

$ mkdir -p install/hairCAPTURE/
$ cd install/hairCAPTURE/
$ tar -zxvf hairCAPTURE-0.93.20050728.tar.gz
$ cd lib/
$ make
$ su
# make install

Compilando e testando os exemplos do pacote de desenvolvimento

No pacote hairCAPTURE-devel inseri alguns exemplos de fácil aprendizado. Neste capítulo encontraremos os comandos passo-a-passo para a compilação dos exemplos.

Em primeiro lugar, mudaremos para a pasta onde se encontram os códigos-fonte de exemplo:

# cd /usr/share/hairCAPTURE

Se você estiver utilizando o pacote a partir do código-fonte, entre na pasta abaixo:

$ cd install/hairCAPTURE/example

Agora, com o comando make, compile os exemplos:

$ make
g++ -c example01.cpp
g++ -c example02.cpp
g++ -c example03.cpp
g++ -c example04.cpp
g++ -c example05.cpp
g++ example01.o -o example01 -lSDL -lSDL_ttf -lSDL_gfx -lhairCAPTURE
g++ example02.o -o example02 -lSDL -lSDL_ttf -lSDL_gfx -lhairCAPTURE
g++ example03.o -o example03 -lSDL -lSDL_ttf -lSDL_gfx -lhairCAPTURE
g++ example04.o -o example04 -lSDL -lSDL_ttf -lSDL_gfx -lhairCAPTURE
g++ example05.o -o example05 -lSDL -lSDL_ttf -lSDL_gfx -lhairCAPTURE


Pronto. Agora, basta executar os exemplos:

$ ./example05

Fundamentando conceitos de programação


Abaixo, a listagem do código-fonte que utilizarei para explicar o conceito lógico de funcionamento. Mais uma vez menciono que críticas e sugestões devem ser enviadas por e-mail.

# include <stdio.h>
#include <fstream>
#include <sstream>
#include <string>
#include <unistd.h>

#include <funcoesCAPTURE.h>

using namespace std;
extern char **environ;

int main(int argc, char *argv[])
{
std::string texto;

HAIR::CAPTURE video1;

video1.Open();

video1.InitVideo();

video1.LoadBMP("tux.bmp");

video1.Line(20,215,320,215,0,255,0);

video1.WriteText(20,220,"Use the Force, READS THE SOURCE!");

video1.Show();

std::cout<<"Enter a message:"; std::cin>>texto;

video1.WriteText(20,220,"Press (Q) for exit the video");

video1.WaitForVideo();

return 0;
}

  • HAIR::CAPTURE video1: esta linha instancia a classe de vídeo em memória com o nome de video1;
  • video1.Open(): este método inicializa o dispositivo de vídeo captura, define as características como tamanho do buffer, resolução máxima permitida, número de cores e outras propriedades do hardware;
  • video1.InitVideo(): nesta linha inicializamos uma janela para exibição do vídeo usando as funções da biblioteca SDL;
  • video1.LoadBMP("tux.bmp"): agora carregaremos a imagem tux.bmp. Esta imagem contém o logotipo do tux-jedi. O fundo da imagem de cor rosa é utilizado como transparência da imagem;
  • video1.Line(20,215,320,215,0,255,0): Line é um método que desenha uma linha nas coordenadas inicial e final especificadas. Os três últimos argumentos são as cores no formato RGB;
  • video1.WriteText(20,220,"Use the Force, READS THE SOURCE!"): já o WriteText escreve um texto nas coordenadas especificadas;
  • video1.Show(): o método Show cria uma thread para exibir o vídeo ao vivo;
  • video1.WaitForVideo(): agora esta linha aguarda a thread do vídeo ao vivo ser destruída para finalizar a aplicação.

A minha intenção é tornar fácil do desenvolvimento de aplicações que manipulam vídeo for Linux . O projeto agradece colaborações de todos os tipos: tradução para outros idiomas, testes, layout e outros...

"Conquistas materiais nos proporcionam prazeres momentâneos. Satisfação eterna são para os homens que se tornam o que sonham ser... "

Em vista disto, torne-se um JEDI.

Não use DROGAS, Use LINUX!!!
Alessandro de Oliveira Faria

Alessandro de Oliveira Faria - Sócio-proprietário da empresa NETi TECNOLOGIA fundada em Junho de 1996 (http://www.netitec.com.br), empresa especializada em desenvolvimento de software e soluções biométricas, Consultor Biométrico na tecnologia de reconhecimento facial, atuando na área de tecnologia desde 1986 assim propiciando ao mercado soluções em software nas mais diversas linguagens e plataforma, levando o Linux a sério desde 1998 com desenvolvimento de soluções open-source, membro colaborador da comunidade Viva O Linux, mantenedor da biblioteca open-source de vídeo captura entre outros projetos.