!Veejay

O Veejay é um software de linha de comando, como o próprio nome já diz, criado para o VJing, ou seja, o ato de manipulação de visualidades em tempo real.

{img src=http://www.estudiolivre.org/tiki-download_file.php?fileId=701
width= height= align=center desc= link= }


Uma peculiaridade desse software é o fato dele sincar com o ((Jack)) um servidor de audio/midi.

{maketoc}

Essa gracinha esta restrita ao sistema operacional GNU/LINUX

---
!!Descrição segundo o manual do programa:
O Veejay é um instrumento visual e um video-sampler que trabalha em tempo-real. Ele permite que se "toque" um vídeo da mesma maneira como se toca um piano e além disso permite gravar os resultados diretamente no disco para disparo imediato (sampler de vídeo)

Dessa maneira, o veejay pode ser operado ao vivo, localmente, usando o teclado comum de computador(que e 100% configuravel) e/ou remotamente através da rede (tanto em unicast como em multicast, i.e. com um ou mais canais) utilizando um sistema de mensagens interno que permite o mapeamento de vários protocolos sobre sobre ele, incluíndo ((OSC)) .

O veejay é desenvolvido na esperança de ser útil para VJs, Performers multimídia e outros usuários interessados que queiram usar Software Livre em performances e/ou vídeo-instalações.
---

!!Interfaces
- ((PD)) + ((SendVims))
- ((Gveejay))
- ((Gveejay-Reloaded))
- ((MIDI))
- ((OSC))

!!Manual do Veejay
!!!Codecs de vídeo suportados
__MJPEG__ (tanto jpeg 4:2:0 como jpeg 4:2:2), __YUV__ 4:2:0 i420/yv12 AVI, __Quasar DV__ codec (apenas I-frames), __MPEG4__ (apenas I-frames)

!!!Drivers de saída suportados
Usuários com Matrox G400/G440/G550 podem especificar (opcionamente) um driver de saída que use a biblioteca DirectFB. Isto permite ao CRTC2 (segundo monitor) disparar vídeos de maneira independente do monitor 1, através da saída de TV da placa.
Veejay foi testado com sucesso em placas ATI e Nvidia com seus respectivos drivers oficiais (proprietários) para linux e saída de TV e driver xorg.

!!!Áudio
O Veejay utiliza o servidor de áudio de baixa latência ((Jack)), para transportar o áudio em sincronismo com o vídeo. Isto te permite pós-processar a saída de áudio do veejay em outro software de áudio, como o ((jack-rack)) por exemplo, podendo controlar algum parametro do som junto com algum outro da imagem.:)

!!!Uso geral (como trabalhar com o Veejay)
O Veejay possui um terminal e uma janela de vídeo, sendo que o terminal é apenas para mostrar mensagens de percursos. Se a janela do vídeo estiver selecionada, é possível usar o teclado como um piano para tocar/manipular o vídeo.
Você pode iniciar o Veejay com diversos arquivos, tanto de vídeo como arquivos EDL (lista de decisão de edição) do MjegTools. Ao iniciar, o veejay cria um arquivo EDL novo contendo todos os vídeo que você carregou. O resultado é que todos os arquivos aparecerão como um só longo vídeo. Em seguida, você pode começar a criar seleções (clipes) da sua lista de vídeos. Estes clipes serão colocados no chamadao "Clip Banks" (i.e. bancos de clipe) e ele podem ser disparados (trigger) precionando uma da teclas F1 F2...F12. Você seleciona os Clip Banks nas teclas de 1 à 9.
Note que se você modificar sua EDL (por ex. deletando alguns trechos), você deve salvar sua lista de vídeos assim como sua lista de clipes.
Você pode selecionar efeitos para colocar em seus clipes, pressionando as teclas para cima e para baixo, achando seu efeito pressione ENTER e ele será adicionado ao clipe corrente. O clipe corrente pode ser modificado com as teclas mais (+) e menos (-) do teclado numérico. Veja a sessão __Caminhos do Teclado__ desse manual para saber mais possibilidades.

!!!Interoperabilidade
O Veejay pode ser usado com o ((PD)) (Pure Data) usando o sendVims, um pequeno utilitário de linha que transmite traduzir os símbolos do ((PD)) par ao Veejay e vice-versa. Veja em __Referências__ onde baixar esse utilitário. Através do OpenSoundControl ((OSC)) o Veejay também pode ser usado com um grande número de programas processadores de áudio e vídeo. Além disso o Veejay pode transmitir ((stream)) de vídeo pela saída padrão STDOUT (-o stdout -03) em formato yuv4mpeg, ou transmitir stream de vídeo nào comprimido pela rede (uni e multicast).

!!!Opções de invocação (ao chamar o programa pela linha de comando)
__ -p/--portoffset <num>__ Porta TCP para comunicação com clientes como o ((Gveejay)) (padrão 3490)
__ -h/--host__ Inicia como cliente de outra sessão do Veejay (padrão é o servidor)
__ -o/--outstream <nomedoarquivo>__ escreve um vídeo no formato YCbCr (YUV 4:2:0) no arquivo especificado. Use com -03. Se você usar "stdout" aqui, Veejay ficará silencioso e irá transmitir um yuv4mpeg na saída padrão STDOUT.
__ -O/--output ~np~[012345]~/np~__ Especifica uma saída de vídeo: 0 = SDL (padrão), 1 = DirectFB, 2 = SDL e DirectFB, 3 = YUV4MPEG stream, 4 = Sistema V SHM, 5 = Silencioso (sem saída visual).
__ -s/--size NxN__ Vídeo escalonado para saída SDL, por ex: 640x480
__ -a/--audio ~np~[01]~/np~__ toca o áudio 0 = desligado, 1 = ligado (padrão 1)
__ -c/--synchronization ~np~[01]~/np~__ Correção da sincronia ligado/desligado (padrão ligado)
__ -P/--preverse-pathnames__ Não "canonicalisa" nome de pastas no EDL
__ -v/--verbose__ verbosidade ligado/desligado
__ -t/--timer ~np~[012]~/np~__ Temporizador de uso [desligado, ligado, RTC real time]
__ -f/--fps <num>__ Sobrepõe os quadros por segundo do vídeo
__ -x/--geometryx <num>__ Geometria X da janela SDL do vídeo
__ -y/--geometryy <num>__ geometria Y da janela SDL do vídeo
__ -l/--action-file <filename>__ Arquivo de configuração para ser lido durante a inicialização. O arquivo de configuração armazena caminhos do teclado personalizados, pacotes personalizados, eventos VIMS disponíveis, lista de edição, lista de clipes, listas de stream e opções de linha de comando
__ -b/--bezerk__ Modo bizarro, se habilitado permite que você mude canais de entrada sem a necessidade de reiniciar o clipe (on the fly)
__ -g/--gui__ Modo GUI, útil somente para encrustar a janela SDL numa outra janela do X
__ -n/--no-color__ Não usará textos coloridos
__ -m/--sample-mode ~np~[01]~/np~__ Especifica qual tipo de algoritmo usar para super sampling, 0 = Melhor Qualidade (padrão), 1 = Melhor Performance
__ -F/--features__ Mostra as opções de compilação
__ -Y/--ycbcr ~np~[01]~/np~__ Especifica ao Veejay usar YUV 4:2:0 (0) ou YUV 4:2:2 (1). Por padrão o veejay tentará detectar automaticamente qual é o formato de pixel usado
__ -d/--dummy__ Inicia o Veejay sem arquivos de vídeo(dummy mode). Por padrão ele irá tocar um vídeo preto.
__ -W/--width__ Especifica a largura do vídeo dummy
__ -H/--height__ Especifica a altura do vídeo dummy
__ -R/--framerate__ Especifica a frequência de quadros por segundo no vídeo dummy
__ -N ~np~[01]~/np~__ especifica a norma do vídeo dummy (0=PAL, 1=NTSC). Padrão PAL
__ -M/--multicast-osc <endereço>__ Inicía um receptor OSC em modo multicast
__ -V/--multicast-vims <endereço>__ Configura adicionalmente em Multicast um enviador de frame / receptor de comandos. O enviador de frame transmite na porta + 3, receptor de comando na porta + 4.
__ /--map-from-file <num frames>__ Para reduzir as transferências entre a memória e o disco, você pode escolher um número de frames por arquivo para ser guardado na memória cache (válido apenas para rawDv e avi). Use valores menores para melhor uma performance (mapear um grande número de megabytes pode vir a ser um problema)
__ -w/--zoomwidth <0-4096>__ Para uso com -z/--zoom, especifica a largura da saída
__ -h/--zoomheight <0-4096>__ Para uso com -z/--zoom, especifica a altura da saída
__ -C/--zoomcrop top:bottom:left:right__ Para uso com -z/--zoom, Corta a imagem de entrada antes de escalar. Especificar em pixels
__ --lgb=<0-100>__ Para uso com -z/--zoom, usar filtro Gaussian Blur (luma)
__ --cgb=<0-100>__ Para uso com -z/--zoom, usar filtro Gaussian Blur (chroma)
__ --ls=<0-100>__ Para uso com -z/--zoom, usar filtro Afinador (luma)
__ --cs=<0-100>__ Para uso com -z/--zoom, usar filtro Afinador (chroma)
__ --chs=<h>__ Para uso com -z/--zoom, Chroma Horizontal Shifting (trocador horizontal do chroma)
__ --cvs=<v>__ Para uso com -z/--zoom, Chroma Vertical Shifting
__ -z/--zoom <num>__ Usa o software escalonador (isto afeta o vídeo de saída). Veja também __-w__ e __-h__. Modos disponíveis:
__1__ - Bilinear Rápido (padrão)
__2__ - Bilinear
__3__ - Bicúbico (qualidade boa)
__4__ - Experimental
__5__ - Visinhança mais próxima (qualidade ruim)
__6__ - Área
__7__ - Luma Bicúbico/Chroma Bilinear
__8__ - Gauss
__9__ - sincR
__10__ - Lanczos
__11__ - Ranhura Natural bicúbico

!!!Exemplos
__veejay -u |less__
Inicia o Veejay e lista todos os eventos (VIMS/OSC) e descrições de efeitos

__veejay -p 4000 ~/my_video1.avi__
Inicia o Veejay ouvindo a porta 4000, útil para ter vááários Veejay

__veejay -d -W 352 -H 288 -R 25 -N 0__
Inicia o Veejay usando vídeo dummy a 25 fps, numa dimensào 352x288 em PAL

__veejay movie1.avi -V 224.0.0.50 -p 5000 -n -v -L__
inicia o Veejay, usando protocolo multicast na porta 5000, com loop automático e sem texto de verbosidade colorido.

!!!Comandos de Interface (STDIN)
Ao rodar o veejay numa janela SDL você pode usar Caminhos do Teclado para interagir em tempo real. Veja __Caminhos do Teclado__ para detalhes.

!!!Caminhos do Teclado
__~np~[teclado numérico *]~/np~__ tipo de loop do clipe

__~np~[teclado numérico -]~/np~__ Decresce o clipe corrente na lista
__~np~[teclado numérico +]~/np~__ Acresce o clipe corrente na lista
__~np~[teclado numérico 1]~/np~__ Vai par ao começo do clipe
__~np~[teclado numérico 2]~/np~__ Volta 25 frames
__~np~[teclado numérico 3]~/np~__ Vai pro final do clipe
__~np~[teclado numérico 4]~/np~__ Toca no reverso
__~np~[teclado numérico 5]~/np~__ Pause
__~np~[teclado numérico 6]~/np~__ Toca pra frente
__~np~[teclado numérico 7]~/np~__ Vai pro quadro anterior
__~np~[teclado numérico 8]~/np~__ Adianta 25 frames
__~np~[teclado numérico 9]~/np~__ Vai pro próximo frame
__~np~[teclado numérico /]~/np~__ Retira os efeitos do clipe

Colchete direito __~np~[~/np~__ marca o começo do clipe
Colchete esquerdo __~np~]~/np~__ marca o final do clipe e cria um novo sample(clipe)

__Alt+~np~[~/np~__ Especifica o marcador inicial
__Alt+~np~]~/np~__ Especifica o final do marcador e ativa o marcador

__BACKSPACE__ Apaga a marca atual

__~np~[a,s,d,f,g,h,j,k,l]~/np~__ velocidade do vídeo 1,2,3,4,5,6,7,8 ou 9
__Alt+ ~np~[a,s,d,f,g,h,j,k,l]~/np~__ Especifica o duplicador de quadros 1,2,3,4,5,6,7,8 ou 9


__~np~[1..9]~/np~__ Seleciona o banco de clipes 0-12, 12-24, 24-36 etc.
__Alt + ~np~[1..9]~/np~__ Especifica o ID do canal ? nao testado... alguem conseguiu? repota na lista por favor!

__~np~[F1..F12]~/np~__ Seleciona e toca o clipe 1..12

__~np~[Delete]~/np~__ Apaga o efeito selecionado

__~np~[HOME]~/np~__ Mostra informações do clipe

__~np~[ESC]~/np~__ Muda entre modo plano e com efeitos

__~np~[CURSOR direita]~/np~__ Anda 5 posições na lista de efeitos
__~np~[CURSOR esquerda]~/np~__ Volta 5 posições na lista de efeitos
__~np~[Pra cima]~/np~__ Anda 1 posição na lista de efeitos
__~np~[Pra baixo]~/np~__ Volta 1 posição na lista de efeitos

__~np~[Enter/Return]~/np~__ Aciona o efeito selecionado

__~np~[v]~/np~__ nao fez nada..

__~np~[-]~/np~__ Decresce o canal do mixer (mais pra vídeo 1)
__~np~[=]~/np~__ Acresce o canal do mixer (mais pro vídeo 2)

__~np~[/]~/np~__ Troca os canais do mixer entre Clipes e Stream

__~np~[z]~/np~__ Diminui o tempo de áudio entrando
__~np~[x]~/np~__ Aumenta o tempo de áudio entrando

__~np~[b]~/np~__ Liga e desliga o efeito selecionado (nao rolo)

__~np~[END]~/np~__ habilita e desabilita os efeitos no canal
__~np~[ALT esquerdo]~/np~+~np~[END]~/np~__Habilita ou desabilita o vídeo na entrada selecionada
__~np~[ALT direito]~/np~+~np~[END]~/np~__ Habilita ou desabilita o áudio na entrada selecionada

__~np~[CTRL esquerdo]~/np~+~np~[END]~/np~__ Habilita ou desabilita o vídeo na entrada selecionada
__~np~[CTRL direito]~/np~+~np~[END]~/np~__ Habilita ou desabilita o áudio na entrada selecionada

__~np~[NUMLOCK]~/np~__ Automatiza parâmentros dos efeitos

__~np~[n]~/np~__ Diminui o valor do ajustador do efeito selecionado
__~np~[m]~/np~__ Aumenta o valor do ajustador do efeito selecionado

__~np~[x]~/np~__ Diminui o volume do áudio (não funcional)
__~np~[c]~/np~__ Aumenta o volume do áudio (não funcional)

__~np~[0]~/np~__ Captura um quadro num arquivo de imagem .jpeg

__~np~[PgUp]~/np~__ Aumenta o valor do parametro 0 do efeito selecionado
__~np~[PgDn]~/np~__ Diminui o valor do parametro 0 do efeito selecionado

__~np~[teclado numérico 0]~/np~__ Diminui o valor do parametro 1 do efeito selecionado
__~np~[teclado numérico .]~/np~__ Aumenta o valor do parametro 1 do efeito selecionado

__~np~[.]~/np~__ Aumenta o valor do parametro 2 do efeito selecionado
__~np~[,]~/np~__ Diminui o valor do parametro 2 do efeito selecionado

__~np~[']~/np~__ Aumenta o valor do parametro 3 do efeito selecionado
__~np~[;]~/np~__ Diminui o valor do parametro 3 do efeito selecionado

__~np~[q]~/np~__ Diminui o valor do parametro 4 do efeito selecionado
__~np~[w]~/np~__ Aumenta o valor do parametro 4 do efeito selecionado

__~np~[e]~/np~__ Diminui o valor do parametro 5 do efeito selecionado
__~np~[r]~/np~__ Aumenta o valor do parametro 5 do efeito selecionado

__~np~[t]~/np~__ Diminui o valor do parametro 6 do efeito selecionado
__~np~[y]~/np~__ Aumenta o valor do parametro 6 do efeito selecionado

__~np~[u]~/np~__ Diminui o valor do parametro 7 do efeito selecionado
__~np~[i]~/np~__ Aumenta o valor do parametro 7 do efeito selecionado

__ALT + B__ Tira uma foto e coloca num buffer separado (usado por alguns efeitos como o Difference Overlay)

__CTRL direito + CTRL esquerdo + Qualquer tecla__ Tira uma foto do canal de efeitos e guarda o efeito como um padrão. Use Shit + Qualquer tecla para aplicar o padrão

!!! Referências
sendVIMS para PD: http://zwizwa.fartit.com/pd/sendVIMS/
Repositório SVN : http://veejay.dyne.org

!!! Autoria
O original em inglês desse manual foi escrito por Niels Elburg. A tradução em pt-br foi feita por ((Usuário_habib|Jean Habib))
Se voce tiver alguma dúvida ou retificação envie um email para a lista do [estudiolivre@lists.riseup.net|EstudioLivre]. Se quiser falar com os desenvolvedores do veejay, pode usar a lista de discussão do próprio Veejay para isso. veejay-users@lists.sourceforge.net


!!Visite o [http://veejay.dyne.org|link do desenvolvedor] no Dyne.org ou no SourceForge.net http://veejay.sourceforge.net

!!Softwares Relacionados:
((jack))
((qjackctl))
((Gveejay))
((Gveejay-Reloaded))
((PD)) + ((SendVims))