FuhQuake Homepage : http://www.fuhquake.net/
FuhQuake Autor    : A Nourai aka 'fuh' (#fuhquake na Quakenet irc)
FuhQuake Forum    : http://www.fuhquake.net/forum/


----------
INTRODUO
----------
Esse arquivo explica as ferramentas de gravao do FuhQuake. Um sumrio  visto abaixo.

*) Gravao automtica de demos (em servers compatveis).
*) Gravao automtica do log do console.
*) Screenshot automtica no final do jogo mostrando o scoreboard.
*) Customizao dos nomes de todos os arquivos descritos abaixo.


-------------------------------------
SEO 1. GRAVAO AUTOMTICA DE DEMOS
-------------------------------------

1A. SERVERS COMPATVEIS
-----------------------
O sistema de gravao automtica do FuhQuake funciona apenas em servers compatveis.
KTeams, and ktpro servers so totalmente compatveis. OZTF (v1.45 ou mais recente)
tambm so compatveis quando em clan mode.



1B. VARIVEIS
-------------

match_auto_record (Padro: "0")
-------------------------------
Descrio : Quando com os valores 1 e 2, um demo temporrio ser gravado
            assim que o jogo comear (normalmente quando o countdown comea).
            'match_auto_record 2' salva automticamente o demo assim que o jogo
            acaba. 'match_auto_record 1' requer salvamento manual (veja o comando
            "match_save" abaixo).


match_auto_minlength (Padro: "30")
---------------------------------
Descrio : Quando estiver usando 'match_auto_record 2', o demo no ser
            salvo se for menor que o nmero de segundos setado nessa varivel.
            Se o demo for muito curto voc ainda pode salv-lo usando "match_save".


match_auto_spectating (Padro: "0")
-----------------------------------
Descrio : Quando com o valor 1 a gravao ser feita mesmo em modo spectator.


demo_dir (Padro: "")
---------------------
Descrio: Essa varivel define o local onde os demos feitos com easyrecord ou
           com o sistema de gravao sero salvos. Isso  relativo ao seu gamedir.
           Se essa varivel ficar com o valor "" ento os demos sero salvos no
           seu gamedir (comportamento normal do qw).  recomendado usar algo como
           "qw/demos/recording" para que seus demos sejam salvos em
           c:\quake\qw\demos\recording . Note que isso s afeta 'easyrecord' demos
           e demos do sistema de gravao. Isso no afeta demos feitos com 'record'
           que sero salvos no seu gamedir.



1C. COMANDOS
------------

match_save
----------
Descrio : Se voc usa 'match_auto_record 1' ento um demo temporrio
            ser salvo em c:\quake\fuhquake\temp\_!_temp_!_.qwd toda vez
            que o mapa comea. Esse demo ser sobreescrevido quando um novo
            mapa comear. Se voc quiser salvar o demo, voc precisar
            usar esse comando, 'match_save', isso vai mover o demo para
            o mesmo lugar que o easyrecord teria feito.


match_forcestart
----------------
Descrio : Esse comando limula o comeo do jogo (para que o sistema de
            gravao etc seja ativado). Isso  til se voc entrar em um server
            de ktpro depois do comeo do countdown, ou se o modo de jogo no tenha
            countdown (ex. race mode).

            O mais importante  para server de TF, j que voc pode usar um
            msg_trigger para executar  match_forcestart no "MATCH BEGINS NOW".



1E.  PARMETROS PARA A LINHA DE COMANDO
---------------------------------------

-democache <tamanho em KB>
--------------------------
Descrio : Se voc usar esse comando na linha de comando, ento o FuhQuake
            vai gravar os demos na memria em vez de gravar no HD.
            Quando a gravao terminar o FuhQuake vai transferir o demo
            da memria para o disco. Isso pode reduzir o uso do HD e pode
            resultar num jogo mais suave para muitas pessoas, mas no para
            todas. No use isso se voc no tem problemas.

            Voc deve especificar um -democache um pouco maior do que o tamanho
            normal dos demos que voc grava. Ex, se a maioria dos demos qwd que
            voc grava tem 15mb, use "-democache 20000". No use um democache muito
            grande, a no ser que voc tenha RAM suficiente pra isso.

            Importante: Se o tamanho do democache for excedido (por seu demo ser
            maior que o especificado), vai causar um grande lag enquanto o
            FuhQuake esvazia algum espao na memria (mandando parte do demo gravado
            para o disco).

            Importante: Quando usando -democache e o demo termina de ser gravado
            pode haver uma grande pausa enquanto o FuhQuake copia o demo para o
            disco. Quanto maior o demo, maior a pausa.


1E. NOTAS IMPORTANTES
---------------------
A gravao automtica comea sempre que a chave "status" do serverinfo
muda de "standby" para qualquer outra coisa diferente de "standby".
Em servers de KT isso ocorre no comeo do countdown.

A gravao automtica para nas seguintes situaes:
*) A chave "status" do serverinfo muda para alguam coisa diferente de "standby"
para "standby" (ex. alguem vota 'break' durante o countdown".
*) 4 segundos depois que o o scoreboard final  mostrado.
*) Voc digita "stop" para parar a gravao.
*) Voc diconecta, "disconnect", do server (isso inclui conectar em outro server,
comear a ver um demo, etc).
*) Um novo mapa coma no server.

Se voc estiver usando "match_auto_record 1" depois que a gravao automtica
for concluda (FuhQuake vai dizer a voc), voc pode salvar o demo usando
"match_save". O demo ser salvo no mesmo local que o comando "easyrecord" teria
feito (voc pode customizar o nome dos demos..veja a seo MATCH NAME abaixo).

Se voc utilizar "match_auto_record 2", os demos sero salvos automaticamente
a menos que eles sejam menores que o nmero de segundos presente na varivel
match_auto_minlength. Se eles forem muito pequenos para serem salvos, FuhQuake
vai dizer "Autorecording cancelled." mas voc ainda pode salvar esse demo
usando o comando "match_save".


----------------------------------------------
SEO 2. GRAVAO AUTOMTICA DO LOG DO CONSOLE
----------------------------------------------

2A. VARIVEIS
-------------

match_auto_logconsole (Padro: "0")
-----------------------------------
Descrio : Quando com os valores 1 ou 2, um log temporrio ser criado
            automaticamente assim que o jogo comear (normalmente quando o
            countdown comear).
            match_auto_logconsole 2 salva automaticamente o log do console
            ao final do jogo. 'match_auto_logconsole 1' requer salvamento manual
            (usando o comando "match_save" listado acima).


1B. NOTAS IMPORTANTES
---------------------

O FuhQuake pode fazer um .log automaticamente quando o jogo comea.
Isso  til se voc tem um programa de stats que gera o stats atravz do log.
Essa funo funciona exatamente como a gravao de demos, s que voc usa
"match_auto_logconsole" no lugar de "match_auto_logconsole" e "log_dir" no lugar de
"demo_dir". "match_save", "match_auto_minlenght" e "match_auto_spectating" funcionam
do mesmo jeito.

Se voc usa 'match_auto_logconsole 1' e 'match_auto_record 1' ento "match_save" vai
salvar ambos, o log e o demo do jogo.

Se voc usa 'match_auto_logconsole 1' e 'match_auto_record 2' ento "match_save" vai
salvar apenas o log do jogo, e o demo vai ser salvo automaticamente.

Note, a varivel "log_readable" pode ser til aqui. Usando 1 nessa varivel
far com que todos os caracteres no conpreensvies sejam convertidos em
caracteres compreensveis.


--------------------------------------
SEO 3. AUTO SCREENSHOT DO SCOREBOARD
--------------------------------------

3A. VARIVEIS
-------------

match_auto_sshot (Padro: "0")
------------------------------
Descrio : Usando o valor 1 faz com que o FuhQuake tire uma screenshot
            do scoreboard final de cada jogo. Se o seu console estiver
            abaixado ou voc est nos menus o FuhQuake vai remover o
            console/menu por 1 frame para que a screenshot seja perfeita.

scr_sshot_dir (Padro: "")
--------------------------
Descrio: Essa varivel define o diretrio onde as screenshots saro salvas.
           Isso  relativo ao seu gamedir. Se essa varivel ficar com o valor
           "" ento as screenshots sero salvas no seu gamedir (comportamento
           normal do qw).  recomendado usar algo como "qw/sshots" para que suas
           screenshots sejam salvas em c:\quake\qw\sshots . Note que isso afeta
           todas as screenshots, aquelas tiradas com o comando "screenshot" e
           as tiradas automaticamente com 'match_auto_sshot 1'.

scr_sshot_type (Padro: "tga" para GL, "pcx" para software)
-----------------------------------------------------------
Descrio: Essa varivel define o formato da imagem das screenshots.
           FuhQuake software suporta apenas "pcx". OpenGL pode usar os formatos
           "tga", "png" ou "jpg" (recomendado). Note que se voc especificar
           o formato no nome do arquivo ele vai usar o formato que voc definiu.
           Ex. "screenshot blah.jpg", vai tirar uma screenshot no formato "jpg"
           mesmo que no 'scr_sshot_type' tenha outro padro. Mas se voc utilizar
           "screenshot blah" o FuhQuake vai salvar no formta indicado em 'scr_sshot_type'.

scr_sshot_apply_palette (Padro: "1")
-------------------------------------
Descrio: Se com o valor 1 suas configuraes de gamma/contraste sero aplicadas
           em todas as screenshots.


3B. NOTAS IMPORTANTES
---------------------

O FuhQuake pode tirar automaticamente um screenshot do scoreboard final de
cada jogo. Para isso basta usar 'match_auto_sshot 1'. Diferente da gravao de
demos e logs, no h como tirar uma screenshot temporria e salvaer separadamente.
As fotos tiradas sero sempre salvas.

O nome das screenshots tiradas com 'match_auto_sshot 1'  o mesmo que o
comando easyrecord usaria para o demo (mas com a extenso apropriada ex. ".tga",
".pcx" etc). Voc pode customizar os nomes das screenshots (veja a seo
MATCH NAME abaixo).

Ex. Se voc usa "sshot_dir qw/sshots" ento uma screenshot de um jogo 4on4
ser posta em
"c:/quake/qw/sshots/4on4/[clan]quaker - [4on4_myclan_vs_someclan] - [dm3].tga"
presumindo que o seu quakedir  c:\quake e voc no customizou a varivel
'match_format_4on4' (veja a seo 4 abaixo).


---------------------------
SEO 4. NOMES DOS ARQUIVOS
---------------------------

Cada tipo de jogo tem um nome customizvel que  usado para easyrecord,
pelo sistema de gravao, screenshots automticas, log automticos e assim
por diante. H tambm uma macro chamada $matchname que voc pode usar para
ver o nome do jogo manualmente (echo $matchname).

Por exemplo, um jogo pode ser,
"[clan]quaker - [4on4_meuclan_vs_algumclan] - [dm3]" ou outra coisa.


4A. TIPOS DE JOGO
-----------------
O jogos so classificados em diferentes categorias. A lista a seguir
mostra as categorias suportadas pelo FuhQuake. Se voc acha que deveria
haver mais por favor, noticie isso no forum.

O critrio para cada categoria est mostrada junto com as mesmas.

*) duel : (gamedir = "qw", 2 jogadores)
*) ffa  : (gamedir = "qw", mais de 2 jogadores, teamplay off)
*) race : (gamedir = qw, chave de serverinfo "race" ativa e igual ao nome do mapa)

*) 2on2 : (gamedir = "qw", 2 times com pelo menos 1 time tendo 2 jogadores)
*) 3on3 : (gamedir = "qw", 2 times com pelo menos 1 time tendo 3 jogadores)
*) 4on4 : (gamedir = "qw", 2 times com pelo menos 1 time tendo 4 jogadores)
*) tdm  : (gamedir = "qw", 2 times, 1 time tendo pelo menos 5 jogadores)
*) multiteam  : (gamedir = "qw", 3 ou mais times)

*) arena : (gamedir = "arena")
*) carena : (gamedir = "carena")

*) tf_duel : (gamedir = "fortress", 2 jogadores)
*) tf_clanwar : (gamedir = "fortress", pelo menos 2 times)

*) solo : (qualquer gamedir, 1 jogador no server, exceto em modo race)
*) coop : (gamedir = "qw", pelo menos 2 jogadores, deathmatch off)

Notes:
*) A categoria race  basicamente para o modo race do ktpro.


4B. CUSTOMIZANDO OS NOMES DOS JOGOS
-----------------------------------
Cada categoria de jogo tem um nome com uma varivel associada a ele.
Essa varivel  chamada match_format_<categoria> .

Por exemplo: match_format_duel, match_format_2on2, etc, etc.

Todas essa variveis contm macros que se caracterizam de acordo com a lista
abaixo. Voc pode usar "match_format_macrolist" dentro do FuhQuake para ver
a lista completa das macros e seus significados.


4C. MACROS
----------
O que estiver entre colchetes [] se plica em modo spectator.

Note que o seu nick  o mesmo do seu name, a menos que voc o altere
usando match_nama_nick. Isso  til se voc joga com nomes diferentes
e quer que os demos fiquem todos com o mesmo nick.

Voc pode usar "match_format_macrolist" dentro do jogo para ver a lista abaixo.

%n - seu nick [seu nick seguido de "(SPEC)"]

%p - seu name [nome do player 1]
%t - seu time [nome do time 1]
%e - nome do seu inimigo em duels, nome do time inimigo em tp [player2/team2]

%k - nomes dos jogadores do seu time [team1]    (separados por match_name_and)
%l - nomes dos jogadores do time inimigo [team2](separados por match_name_and)

%O - nmero de jogadores do seu time [nmero de jogadores do team1]
%E - nmero de jogadores do time inimigo [nmero de jogadores do team2]
%C - nmero de jogadores no server

%a - quantidade se jogadores separado por match_name_on (ex 4on3on4)
%b - nomes dos times separados por match_name_versus (ex sr _vs_ cmf _vs_ fs)

%v - atalho para o que estiver em match_name_versus

%T - timelimit do server server
%F - fraglimit n do server
%N - teamplay setado no server
%D - deathmatch mode ativo no server

%M - nome do mapa
%G - gamedir (ex. qw, fortress, arena, etc)

%d - dia
%m - ms
%y - ano


4D. COMANDOS
------------

match_format_macrolist
----------------------
Descrio: Mostra a lista completa das macro e seu significado. til se voc
           esqueceu para que serve uma certa macro durante  jogo e no quer
           se incomodar e abrir a documentao.


4E. VARIVIES
-------------

match_name_and (Padro: "_&_")
-------------------------------
Descrio: Usada para separar nomes em %k e %l .

match_name_versus (Padro: "_vs_")
-----------------------------------
Descrio: Usada para separar nomes em %b .

match_name_on (Padro: "on")
-----------------------------
Descrio: Usada para separar os nmeros em %a .

match_name_nick (Padro: "")
-------------------------------
Descrio: %n usa isso se no estiver vazio "", seno usa o seu name no jogo.

match_name_spec (Padro: "(SPEC)")
-----------------------------------
Descrio: Isso  colocado aps o seu nick quando usando %n e voc est em modo
           spectator. Ex. se voc usa "match_name_nick fuh" e dexa match_name_spec
           com o valor padro, ento %n ser "fuh(SPEC)" em modo spectator e "fuh"
           em modo normal.


match_format_solo       (Padro: "solo/%n - [%M]")
match_format_coop       (Padro: "coop/%n - [%C_player_coop] - [%M]")

match_format_duel       (Padro: "duel/%n - %p%v%e - [dmm%D] - [%M]")
match_format_ffa        (Padro: "ffa/%n - [%C_player_ffa] - [%M]")
match_format_race       (Padro: "race/%n - [race] - [%M]")

match_format_2on2       (Padro: "2on2/%n - [%k%v%l] - [%M]")
match_format_3on3       (Padro: "tdm/%n - [%Oon%E_%t%v%e] - [%M]")
match_format_4on4       (Padro: "tdm/%n - [%Oon%E_%t%v%e] - [%M]")
match_format_tdm        (Padro: "tdm/%n - [%Oon%E_%t%v%e] - [%M]")
match_format_multiteam  (Padro: "tdm/%n - [%a_%b] - [%M]")

match_format_arena      (Padro: "arena/%n - %p%v%e - [%F_frags] - [%M]")
match_format_carena     (Padro: "carena/%n - [%a_%b] - [%M]")

match_format_tf_duel    (Padro: "tfduel/%n - %p%v%e [%M]")
match_format_tf_clanwar (Padro: "tfwar/%n - [%Oon%E_%t%v%e] - [%M]")


4F. MACROS
----------
$matchname
----------
Descrio: funciona como "match_format_<bleh>" com todas as macros expandidas.
<bleh> sendo a categoria do jogo.


------------
SEO 5. FAQ
------------

Q1. Porque meu auto recording/logging/screenshots no funciona em modo spectator?
A1. Voc precisa usar "match_auto_spectating 1" apra que eles funcionem em spectator.

Q2.  possvel gravar automaticamente jogos em 4on4 e no gravar os duels (etc) ?
A2. Na verdade no. A nica soluo  gravar um demo temporrio e salvar manualmente
    os jogos 4on4 com o comando match_save.

Q3. Como eu gravo automaticamente em teamfortress?
A3. Se voc estiver jogando teamfortress 2.9 ou anterior (incluindo MTF CuTF que
    so baseados no tf 2.5) ento voc precisa usar 'match_auto_record 1'
    e os seguintes msg_triggers:

            alias tfstart "match_forcestart"
            msg_trigger tfstart "MATCH BEGINS NOW"

    O msg_trigger acima funciona tambm em todas as verses do OZTF. No entando
    o OZTF 1.45 em diante, voc no *precisa* dos msg_triggers j que o FuhQuake
    vai comear a gravao quando o countdown do OZTF comear (quando em clan mode).
    Mas  claro que voc precisa do 'match_auto_record 1' para isso.

    Se voc usar o msg_trigger acima no OZTF 1.45, um demo vai comear a ser gravado
    quando o countdown comear, e recomear quando o countdown terminar e "MATCH
    BEGINS NOW"  mostrado. Vai funcionar, mas voc pode simplismente no usar o
    msg_trigger.

Q4. Qual a diferena entre 'match_auto_sshot 1' e
    "alias f_mapend screenshot $matchname" ?
A4. A diferena bsica  que se voc estiver com o console baixo ou nos
    menus quando o jogo acabar, o FuhQuake vai retirar isso da frente por
    1 frame para que a screenhot seja tirada com perfeio.

    Outra coisa, quando voc usa o comando screenshot no alias f_mapend
    (que  executado automticamente quando o jogo acaba),  importante
    que voc use um wait antes, ex alias f_mapend "wait; screenshot <name>".
    Sem o wait a sceenshot provevelmente no mostrar o scroeboard quando jogando
    em OpenGL fullscreen. Voc no precisa se preocupar com isso se voc estiver
    usando 'match_auto_sshot 1' .

Q5.  possvel comprimir meus demos automaticamente?
A5. No houve tempo para adicionar isso no FuhQuake v0.30. No entando,
    em verses futuras voc poder comprimir seus demos para .qwz (quando
    usando o qizmo) e/ou .zip . Ter tembm uma opo para converter seus
    demos para o formato .mvd .

    Ter tambm a opo de comprimir seus demos e screenshots juntas no mesmo
    arquivo .zip . Eu (fuh :D) planejo m menu onde voc poder ver os demos
    dentro dos .zip's e um thumnail da screenshot do scoreboard perto de cada
    demo.

Traduzido por:
//  jediknight  \\