Tutorial RealText versão 0.1

Este tutorial pretende dar as informações básicas necessárias para a edição de arquivos RealText, com ênfase na criação de legendas no estilo "closed caption", que permite a legendagem sem alteração do arquivo RealVideo.

Agradeço ao JD, por ter hospedado esta página em seu site durante um bom tempo. Se você quiser assistir episódios de anime em RealVideo, não deixe de visitar seu site. (Espero que ele volte ao ar em breve...)

Envie seus comentários, dúvidas, sugestões e reclamações para Ricardo M. Ferreira no endereço ric@mpcnet.com.br.

Índice

• Introdução (o que é RealText?)
• Ferramentas Necessárias
• Começando com o Básico
• O Formato de um Arquivo RealText
• Tags e Valores Importantes
• A Apresentação SMIL
• Dicas e Macetes
• Links
• Disclaimer

A linguagem de anotação RealText é uma novo elemento do RealPlayer G2, e permite o "streaming" de texto, da mesma forma que RealVideo é um "streaming" de vídeo. Junto com o SMIL (outro novo padrão), você pode criar apresentações que combinam "streams" de audio, vídeo e texto.

Você pode definir atributos do texto (como fonte, tamanho, cor, ...), o momento em que ele aparece e desaparece, e posição na tela (inclusive dentro ou fora da área do vídeo).

A linguagem RealText é bem simples e intuitiva, portanto é muito fácil de se aprender. Você não precisa ter nenhuma experiência com outras linguagens de programação, mas se você já tem algum conhecimento de HTML, então será ainda mais fácil para você "pegar o jeito" da coisa.

Para seguir este tutorial e criar arquivos RealText, você precisa de:

• Um editor de textos *sem formatação*, como Notepad (Bloco de Notas) ou Wordpad (outros programas, como o Word, podem ser usados, desde que os arquivos sejam salvos *sempre* como "text only"/"apenas texto");
• RealPlayer G2 (pegue o seu em http://www.real.com)

A sintaxe da linguagem RealText é bem parecida com a da HTML. Se você sabe escrever páginas em HTML (sem usar um editor pra isso), você já sabe o básico para começar a escrever em RealText.

Um arquivo RealText possui:

• o texto que seu "público" vai ler (como as legendas, por exemplo);
• e "tags", que são como "comandos" a serem interpretados pelo RealPlayer.

Eis um exemplo de apenas uma linha, tirado de um arquivo RealText:

I'm gonna kick your sorry butt <font color="red">right now!!!</font>

A linha acima gera este resultado:

Fig. 01 - Viu como é simples?

Perceba que os textos dentro dos sinais "<" e ">" não são exibidos, mas interpretados pelo player, que o vê como um comando para mudar a cor da fonte para vermelho (red).

Agora que você já viu um pouco como o processo funciona, aqui estão algumas regras importantes que você deve saber:

• todo arquivo RealText deve ter a extensão ".rt";
• não use espaços no nome do arquivo (e esta é uma boa regra para QUALQUER tipo de arquivo);
• tags aparecem sempre entre sinais de "menor que" e "maior que" (<>);
• tags devem ser escritas em minúsculas;
• valores dentro das tags devem aparecer entre aspas ("");
• tags costumam aparecer em pares (uma "tag de início" e uma "tag de término");
• quando uma tag aparece sozinha (sem uma tag de término), coloque uma barra no final da tag, assim: <br/>

Tabela do Certo-e-Errado:

Eis outro exemplo simples:

She is <b> so sexy! </b> Well, at least <br/> as sexy as a cat-girl can be...

Fig. 02 - Um par de tags, e uma tag sozinha em ação.

Todos os seus arquivos RealText devem ter este par de tags:

<window>
</window>

Elas são a primeira e última linhas do arquivo, respectivamente. Todo o resto fica entre essas duas tags.

Aqui está um exemplo de um arquivo RealText completo. Copie e cole-o no seu editor, e salve-o como "example01.rt" (se você usar o Wordpad ou Word, lembre-se sempre de salvá-lo como tipo "Text Document" ou "Documento Texto").

<window width="320" height="60">
I'm gonna kick your sorry butt <font color="red">right now!!!</font>
</window>

Ao reproduzir esse arquivo, você verá o resultado que aparece na fig. 01. Os valores width e height são as dimensões em pixels da janela de texto, na horizontal e na vertical, respectivamente.

Experimente outros valores e veja o que acontece. Tente alterar o arquivo para obter o mesmo resultado que aparece na fig. 02.

Já é hora de saírmos do básico. Salve o texto abaixo no arquivo "example02.rt" e veja como ele roda.

<window width="320" height="140">
Countdown starts in five seconds...<br/>
<time begin="3"/>Get ready!<br/>
<time begin="5"/>Five...<br/>
<time begin="6"/>... four... <br/>
<time begin="7"/>... three...<br/>
<time begin="8"/>... two... <br/>
<time begin="9"/>... one...<br/>
<time begin="10"/>Launching the Battle Squadron!
</window>

Fig. 03 - Um exemplo com a tag <time>.

É claro, você vai ver o texto "animado". :-)

Como você pode notar, a tag <time> determina quando um texto aparece na janela RealText. O valor é expresso em segundos, e toda informação de tempo é relativa ao início da apresentação.

Você pode digitar o valor em segundos, ou no formato "dd:hh:mm:ss.xyz". Dessa forma, se você quiser que um texto apareça 60 segundos depois do início do arquivo, você pode usar qualquer uma das três linhas abaixo:

<time begin="60">60 seconds have been passed...
<time begin="1:00">60 seconds have been passed...
<time begin="00:01:00.0">60 seconds have been passed...

A próxima seção é só sobre tags.

Os atributos da sua janela, e do texto que aparece nela, são controlados por tags. Com os valores certos, seu texto pode rolar da direita pra esquerda, de baixo pra cima, ou fazer coisas que você ainda nem imagina! :-) Mas vamos olhar apenas aquelas tags que são do nosso interesse.

Eis um trecho de um arquivo RealText, que você pode usar como referência:

<window type="generic"
 duration="13:20.9"
 height="30"
 width="320" 
 bgcolor="#808080"
 wordwrap="true" />

<font color="black" face="arial" size="2">
<center>

<time begin="00:00.0"/><clear/>Tradução e legenda em português: 08/1999<br/>
Ricardo M. Ferreira - ric@bestway.com.br
<time begin="00:04.0"/><clear/> 

<!-- the opening subtitles -->
<time begin="00:13.7"/><clear/>Kodomo no Omocha<br/>(Brinquedo de Criança)
<time begin="00:16.7"/><clear/><font color="#008040"><b>O boato sobre eu te amar é verdade, é sim.
<time begin="00:22.6"/><clear/> 
<time begin="00:23.8"/><clear/>Você não consegue ignorar também.
<time begin="00:26.1"/><clear/> 

</b>
</font>
</center>
</font>
</window>

<window> ... </window>

Já falei que esta tag aparece em todo arquivo RealText? Ela define o tamanho, tipo e cor da janela, duração da apresentação RealText e algumas outras coisas.

Todos os valores são auto-explicativos:

• duration é a duração de toda a apresentação.
• width e height são as dimensões da janela, em pixels.
• bgcolor é o nome da cor de fundo da janela RealText. Você também pode usar um valor decimal, no formato #RRGGBB.
• wordwrap "quebra" linhas de texto muito longas, para que nao ultrapassem a largura da janela.

<font> ... </font>

A tag <font> muda os atributos da fonte.

• color pode ser o nome da cor ou qualquer valor #RRGGBB.
• face é o nome da fonte, como Times, System, Courier, etc. (nota: não utilize o nome de uma fonte TrueType aqui. Use algum destes exemplos para que o RealPlayer ache a fonte equivalente no sistema onde vai ser reproduzido. Veja o RealText Authoring Guide para uma lista completa dos possíveis nomes de fontes).
• size pode ser um valor absoluto ou relativo, assim como em HTML. Ex.: para que a fonte cresca uma unidade, use o valor size="+1".

<center> ... </center>

Advinhe? Texto entre este par de tags é centralizado horizontalmente.

<clear/>

Ao se encontrar esta tag, todo texto dentro da janela é apagado, e qualquer novo texto aparece na posição default (canto superior esquerdo da janela, se ela for do tipo "generic").

<br/>

Forca uma quebra de linha. O próximo texto irá aparecer na linha a seguir.

<b> ... </b>

Deixa o texto em negrito.

<i> ... </i>

Deixa o texto itálico.

<u> ... </u>

Sublinha o texto.

<!-- ... -->

Se quiser inserir um comentário no seu arquivo, coloque-os entre estas tags. Ele será ignorado pelo RealPlayer.

Para exibir em sua legenda os caracteres "<", ">" e "&", você deve usar um "character entity".

Por exemplo, a linha abaixo...

Calling <Mr. Shinji & Mrs. Rei>

... aparecerá assim na janela RealText:

Calling <Mr. Shinji & Mrs. Rei>

Até agora vimos apenas o RealText isolado. Mas como fazemos para juntá-lo com o vídeo?

Para fazer isso, você deve criar um arquivo SMIL que contenha as informações sobre sua apresentação, como o nome dos arquivos que serão reproduzidos, e a posição e tamanho de suas janelas.

Todas as regras básicas para arquivos RealText valem para arquivos SMIL (exceto que a extensão destes deve ser ".smi" or ".smil"). Eis um exemplo completo:

<smil>

   <head>
      <meta name="title" content="Ep. 01 - Kodomo no Omocha (Brinquedo de Criança)" />
      <meta name="author" content="Ricardo M. Ferreira - ric@bestway.com.br" />
      <meta name="copyright" content="(c) 1999" />
      <layout>
         <root-layout width="320" height="270" />
         <region id="video_region" width="320" height="240" left="0" top="0" />
         <region id="text_region" width="320" height="30" left="0" top="240" />
      </layout>
   </head>

   <body>
      <par>
         <textstream src="kodomo_ep1part1.rt" region="text_region" fill="freeze" />
         <video src="kodomo_ep1part1.rm" region="video_region" fill="freeze" />
      </par>
   </body>

</smil>

Vejamos o significado de cada tag:

<smil> ... </smil>

Todo arquivo SMIL deve comecar e terminar com este par de tags.

<head> ... </head>

Nesta seção, algumas informações importantes são definidas, mas em outras tags.

<meta name/>

Estas tags não são obrigatórias, e são usadas para colocar comentários sobre sua apresentação. Este texto aparece quando você seleciona a opção "About this Presentation" no menu "Help" do RealPlayer.

<layout> ... </layout>

Tags nesta seção definem as dimensões de toda a apresentação e de cada uma das janelas.

<root-layout/>

Esta tag aparece apenas uma única vez. Os valores <width> e <height> representam, respectivamente, as dimensões horizontal e vertical em pixels, de toda a apresentação. Todas as outras janelas irão aparecer dentro desta área.

<region id/>

Para cada janela/arquivo de sua apresentação, você deve inserir uma tag deste tipo. Ela descreve o id (ou nome) da região, sua posição e tamanho. Os valores são em pixels, o canto superior esquerdo é a posição 0,0 e o valor da posição aumenta indo da esquerda para a direita, e de cima para baixo.

Lembre-se de sempre usar aqui, para a região RealText, os mesmos valores <width> and <height> que você usou na tag <window> do arquivo .rt.

<body> .. </body>

Esta seção descreve os arquivos que fazem parte de sua apresentação.

<par> .. </par>

Você pode ter mais do que um par destas tags em seu arquivo, mas no nosso caso, haverá quase sempre apenas um. Os arquivos que aparecem entre estas tags serão reproduzidos simultaneamente.

<textstream/>  <video/>

Estas tags contém o nome do arquivo a ser reproduzido em cada região definida com a tag <region>.

O valor fill="freeze" manterá o último frame visível na tela quando a apresentação acabar.

Agora que você tem seus arquivos de vídeo (.rm), RealText (.rt) and SMIL (.smi), você pode "tocar" o arquivo SMIL para iniciar sua apresentação.

• Os arquivos .rm, .rt and .smi podem ter nomes diferentes, mas deixá-los com o mesmo nome facilita muito as coisas...

• É melhor e mais fácil deixar todos os arquivos no mesmo diretório. Se seu stream de vídeo já estiver gravado em CD-ROM, ou você não puder (ou quiser) deixar os arquivos juntos, altere o path dentro do arquivo .smi para que ele possa encontrar os arquivos de vídeo e texto, da seguinte forma:

  <video src="file://e:/animes/kodomo_ep1part1.rm" region="video_region" fill="freeze" />

• Parece que versões antigas do RealPlayer (anteriores a r32ppg20_3* ?) "ampliam" corretamente o vídeo em modo full-screen (tela cheia) apenas quando a proporção entre as resoluções da tela e do .rm é um número inteiro, ex.: a tela é 640x480, o .rm é 320x240 (2:1). Quando você acrescenta a região de texto e toca a apresentação em tela cheia, ele não vai ampliar o vídeo. Novas versões do player parecem corrigir este problema, além de fornecer uma imagem melhor em tela cheia.

• Você pode usar a tag <time end/> para "limpar" o texto de um modo semelhante ao modo como a tag <time begin/> o exibe. Você pode usar ambos os valores numa mesma tag: <time begin="3" end="6"/>. Mas se quiser fazer deste modo, talvez acabe sendo mais trabalhoso editar o timing de todas as legendas manualmente...

• Percebi que a tag <clear/> não funciona se não for seguida por algum texto. Se quiser apagar o texto anterior sem escrever nada em seguida, voce pode deixar após a tag um espaço em branco, ou um "espaço-sem-quebra" (&nbsp).

• Para calcular as dimensões de sua apresentação e respectivas janelas, você deve conhecer as dimensões do seu vídeo. E como você fica sabendo isso? É o que eu gostaria de saber também! Como não encontrei nenhuma solução para esse problema, acabei fazendo um programa apenas para isso. Você pode pegá-lo gratuitamente na seção Notas/Dicas (arquivo Info_RM.zip).

• Para definir a altura de sua janela de texto, você deve saber a altura da fonte a ser usada e quantas linhas de texto pretende usar. Eu também não sei lhe dizer como descobrir isto, exceto fazendo como eu: chutando! :-)

  Tenho usado <font face="arial" size="2"> com uma altura (height) de 15 pixels por linha. Como uso apenas duas linha de legenda na maioria dos vídeos, deixo minha região de texto com altura de 30 pixels.

Uma descrição muito maior e mais detalhada sobre a linguagem RealText (o "RealText Authoring Guide") pode ser encontrada em http://service.real.com/help/library/guides/realtext/realtext.htm ou http://service.real.com/help/library/encoders.html (procure por RealText e escolha entre ler on-line ou fazer o download).

Acessos desde 01/2002: