Criação do Gource

Pessoal, boa tarde.

Recentemente publicamos o nosso vídeo do andamento do projeto no mês de abril, informando que geramos o Gource a partir de batches (arquivos .bat). Criamos as batches com intuito de agilizar o processo. Enquanto o Gource é gerado automaticamente, podemos iniciar outras tarefas.

Procurando no Google algumas informações do Gource, achamos dicas do Projeto Colombo Explorer (https://colomboexplorer.wordpress.com), desenvolvido pelos alunos Johnata Souza Santicioli, Letícia Isis Vaz, Priscila Guerreiro (pelo menos esta criou alguns posts no blog), Rafael Delanhese, Rosana Yuriko Sato e Tiago Naoto Kamegasawa e conta com algoritmo para pesquisa de arquivos mais rápida e eficiente. As dicas foram muito úteis para desenvolvermos o nosso comando.

As exigências da página do Prof. Ivan (http://dicas.ivanfm.com/aulas/pratica-de-gerenciamento-de-projetos) deste semestre era criar o Gource com: alteração das userids dos usuários pelo nome, uma imagem distinta para cada usuário, utilizar a opção –key (que mostrará o formato dos arquivos), utilizar as opções do caption (que mostrará uma legenda das principais mudanças) e gerar aproximadamente 1 minuto de vídeo. Com base na atividade, montamos quatro arquivos .bat.

A seguir, não mostraremos o que é o Gource ou como obtê-lo, mas daremos dicas de utilização das opções, conforme está sendo útil para nós.

1. Estrutura de Pastas

Na raiz do nosso repositório, criamos a pasta Gource para agrupar todas as ferramentas, imagens e comandos desta ferramenta. Dentro da pasta Gource colocamos a pasta Avatar, responsável por armazenar as imagens de todos os integrantes, e inserimos as batches e o arquivo de caption (chamado caption.txt).

2. Geração de Log

cd..
call gource –output-custom-log “.\Gource\girar.log” | svn log -r 1:HEAD –xml –verbose –quiet > “.\Gource\girar_temp.xml”
exit

O comando cd.. voltará um diretório, onde estará o executável do Gource; –output-custom-log do fará a geração do log no diretório \Gource\girar.log; svn log –xml fará a criação do log em XML no diretório \Gource\girar_temp.xml. Vocês podem até perguntar por que gerar dois logs. O log girar.log é gerado apenas para registro, enquanto o girar_temp.xml será utilizado nos próximos comandos, pois só é possível atender às exigências do Prof. Ivan se o log for XML.

3. Substituir UserIDs

Adaptamos um código bat do site http://www.dostips.com, alterando as variáveis para substituir os prontuários de todos integrantes da equipe pelo respectivo nome.

4. Gerar Gource PPM

cd..
gource “.\Gource\girar.xml” –user-image-dir “.\Gource\Avatar” –key –stop-at-end -f –seconds-per-day 1 -b 6B8E23 –disable-progress –title “Gource do Sistema GIRAR” –hide filenames -o “.\Gource\gource.ppm” –caption-file “.\Gource\caption.txt” –caption-offset -1 –caption-colour FF8C00 –caption-size 20 –caption-duration 10

O comando cd.. voltará um diretório, onde estará o executável do Gource; a opção “.\Gource\girar.xml” carrega o log XML; –user-image-dir carregará as imagens de todos os integrantes do diretório \Gource\Avatar; –key exibe o formato dos arquivos; –stop-at-end encerra o vídeo quando finaliza o carregamento total do log; -f exibe ou grava o vídeo em full-screen; –seconds-per-day é a duração da exibição do dia; -b carrega a cor de fundo; –disable-progress desabilita a barra de progresso; –title fixa um texto no canto esquerdo inferior; –hide filenames oculta o nome dos arquivos; -o faz a saída do vídeo; –caption-file carrega o arquivo caption presente no diretório \Gource\caption.txt; –caption-offset define a localização da legenda; –caption-colour define a cor do texto da legenda; –caption-size é o tamanho da fonte; –caption-duration é o tempo (em segundos) da duração da legenda.

5. Gerar AVI

cd..
ffmpeg -y -r 60 -f image2pipe -vcodec ppm -i “.\Gource\gource.ppm” -vcodec libx264 -preset ultrafast -pix_fmt yuv420p -crf 1 -threads 0 -bf 0 “.\Gource\GourceGerado.avi”
cd Gource
del /F /Q gource.ppm

O FFMPEG é a ferramenta para converter o arquivo .PPM em .AVI. Basicamente, esta batch volta no diretório raiz e gera o vídeo, obtendo o PPM da pasta do Gource e gerando na mesma pasta o vídeo GourceGerado.avi. Depois de gerado, a nossa batch também deleta o arquivo Gource.ppm do diretório do Gource.

Para curiosidade, segue o nosso vídeo do Gource: