Você está na página 1de 30

AdvanceMENU Frontend 1 Synopsis advmenu [-default] [-remove] [-cfg FILE] [-log]

[-version] [-help] 2 Description AdvanceMENU um front-end para ser usado com Adv
anceMAME, AdvanceMESS, MAME, MESS , xmame, Raine e outros emuladores. Simplement
e abra ele no mesmo diretorio do emulador e pressione `F1' para ver a janela de
help ou `~' para acessar o menu menu de opes. Pressione `Tab' para modificar o for
mato da lista. Pressione `space' para modifi car o tipo de imagem que mostrada.
Para chamar um jogo pressione `Enter'. Pressione `Esc' para sair. As maiores van
tagens so: Simplesmente carregue e jogue. Copie o executvel e jogue! Atualizao autom
atica das informaes dos jogos. Orientao Vertical e horizontal da tela. Suporta para
qualquer Arcade Monitor com AdvanceMAME mas tambm muito bom para ser usado em um
monitor de PC. Mostra imagens Staticas e Animadas (PNG/PCX/ICO/MNG). possivel mo
strar at 192 ima gens ao mesmo tempo! Efeitos sonoros do tipo.(MP3/WAV). Voc pode
adicionar um sons para varios eventos , por exemplo: enquanto percorre um item n
a lista. Sons de fundo(MP3/WAV). Permite tocar musicas continuamente enquanto vo
c selecion a um game. Efeitos de sons (MP3/WAV) para um pressionamento de tecla,
inicio de um programa , inico de jogo , finalizao de um jogo ou menu... Suporte pa
ra arquivos zipados: imagens e sons. Screen-saver. Um slide das imagens dos game
s ou videos mng. Permite adicionar uma imagem de fundo com efeitos de transparen
cia. Essas so as sesses disponiveis nesse documento: 1 Synopsis 2 Description 3 Op
tions 4 Emulators 4.1 generic - Generic emulator 4.2 advmame - AdvanceMAME 4.3 a
dvmess - AdvanceMESS 4.4 mame - Windows MAME 4.5 xmame - xmame 4.6 dmame - DOS M
AME 4.7 dmess - DOS MESS

4.8 draine - DOS Raine 5 Configuration 5.1 Global Configuration Options 5.1.1 co
nfig 5.1.2 emulator 5.1.3 emulator_roms/roms_filter/altss/flyers/cabinets/icons/
titles 5.1.4 mode 5.1.5 sort 5.1.6 preview 5.1.7 mode_skip 5.1.8 preview_expand
5.1.9 preview_default_* 5.1.10 icon_space 5.1.11 merge 5.1.12 game 5.2 Display C
onfiguration Options 5.2.1 device_video_* 5.2.2 display_size 5.2.3 display_resto
reatgame 5.2.4 display_restoreatext 5.2.5 display_orientation 5.2.6 display_brig
htness 5.2.7 display_gamma 5.3 Sound Configuration Options 5.3.1 device_sound_*
5.3.2 sound_volume 5.3.3 sound_latency 5.3.4 sound_buffer 5.3.5 sound_foreground
_EVENT 5.3.6 sound_background_EVENT

5.3.7 sound_background_loop_dir 5.4 Input Configuration Options 5.4.1 device_key


board/joystick/mouse 5.4.2 mouse_delta 5.5 User Interface 5.5.1 ui_font 5.5.2 ui
_fontsize 5.5.3 ui_background 5.5.4 ui_exit 5.5.5 ui_startup 5.5.6 ui_help 5.5.7
ui_gamemsg 5.5.8 ui_game 5.5.9 ui_skiptop/bottom/left/right 5.5.10 ui_topbar/bo
ttombar 5.5.11 ui_color 5.5.12 ui_clip 5.5.13 ui_translucency 5.5.14 ui_command
5.5.15 ui_command_menu 5.5.16 ui_command_error 5.5.17 ui_menukey 5.5.18 ui_conso
le 5.6 Input Configuration Options 5.6.1 device_keyboard/joystick/mouse_* 5.6.2
input_hotkey 5.6.3 lock 5.6.4 event_assign 5.6.5 event_repeat 5.6.6 event_mode

5.6.7 event_alpha 5.7 Other Configuration Options 5.7.1 idle_start 5.7.2 idle_sc
reensaver 5.7.3 idle_screensaver_preview 5.7.4 group/type 5.7.5 group/type/desc/
info_import 5.7.6 misc_exit 5.7.7 misc_quiet 6 Formats Supported 7 Signals 8 Cop
yright
3 Options -default Adiciona todas as opes padres que estiverem faltando com seus va
lores padres para o advmenu.rc Exemplo: advmenu.exe -default -remove Remove todas
as opes que so padro do advmenu.rc, deixando apenas as opes que foram mo ificadas. Ex
emplo: advmenu.exe -remove -cfg FILE Seleciona um arquivo de configurao alternativ
o. No Linux e Mac OS X, voc pode prefi xar o nome do arquivo com "./" para carreg
ar ele a partir do diretrio corrente.Exemplo: advmen u.exe -cfg .\meurc.rc -log C
ria um arquivo `advmenu.log' com varias informaes uteis que facilita a localizao de
bug ( erros ). -verbose Mostra vrias informaes de inicializao. -version Mostra a verso
do advmenu, os drivers que tem suporte interno e as configuraes de d iretrios. -he
lp Mostra uma pequena ajuda sobre as linhas de comandos suportados. No Linux e M
ac OS X voc pode usar um `--' antes das opes, no DOS um `-'. e no Windo ws voc pode
usar `/'. 4 Emulators O advmenu suporta muitos tipos de emuladores. Os emuladore
s AdvanceMAME, Advance MESS, MAME, xmame, DMAME, DMESS e DRAINE tem suporte inte
rno, sendo que para usar um desses s preciso coloc ar o AdvanceMENU no

mesmo diretrio onde se encontra o emulador. Observao: como o advanceMENU foi descon
tinuado alguns dos emuladores citados acima pode no funcionar corretamente, devi
do a atualizaes dos me smos. Todos os outros emuladores so suportados com a opo `gene
ric'. 4.1 generic - Generic emulator Para emuladores que usam a opo 'generic', no n
ecessrio um arquivo XML que contenha t odas as informaes, preciso apenas um arquivo
com a exteno '.lst' que contenha as seguintes informaes: game ( name NomeDaRom desc
ription "Nome do Jogo" manufacturer "Fabricante" year "Ano" cloneof "RomMe" ) qua
lquer outra informao descartada, e ainda nesse arquivo as unicas informaes obriga tri
as so 'game', 'name', 'description', as outras so opcionais. Caso no queira criar e
sse arquivo, mesmo assim o advanceMAME ainda ir mostrar seus jogos usando o nome
das "roms". Dica: quando voc chama um jo go pela primeira vz o advanceMAME adicion
a uma linha no arquivo "advmenu.rc", que posteriormente poder ser editada e ser a
dicionado um nome para essa rom. Veja um exemplo, da linha adicionada no "advmen
u.rc" ao c hamar o jogo 1941: game "1941" "" "" 0 0 "" Para dar um nome a essa r
om, ento poderemos coloc-lo entre as duas aspas finais, v eja como poderia ficar:
game "1941" "" "" 0 0 "1941 Counter Striker" Um exemplo do conteudo de um arquiv
o '.lst' : game ( name sfz2j description "Street Fighter Zero 2 (Japan 960227)" m
anufacture r "Capcom" year 1996 cloneof sfa2) game ( name sfz2a description "Str
eet Fighter Zero 2 (Asia 960227)" manufacturer "Capcom" year 1996 cloneof sfa2)
game ( name sfz2b description "Street Fighter Zero 2 (Brazil 960531)" manufactur
er "Capcom" year 1996 cloneof sfa2)
Voc deve especificar todas as informaes e diretrios com as opes 'emulator' ou 'emulat
r_*' no advmenu.rc.
Para adicionar um emulador que no seja suportado internamente pelo advmenu, neces
srio pelo menos o uso dessas 2 opes `emulator' e `emulator_roms' essas opes informaro
ao advanceMENU como ele ir cha ar o emulador e onde e como ele ir reconhecer as r
oms. Por exemplo: emulator "snes9x" generic "c:\game\snes9x\snes9x.exe" "%f" emu
lator_roms "snes9x" "c:\game\snes9x\roms" emulator_roms_filter "snes9x" "*.smc;*
.sfc;*.fig;*.1"
emulator "zsnes" generic "c:\game\zsnes\zsnes.exe" "-e -m roms\%f" emulator_roms
"zsnes" "c:\game\zsnes\roms"

emulator_roms_filter "zsnes" "*.smc;*.sfc;*.fig;*.1"


Esses simbolos %s, %f, %p, ... so chamados de macros, cada macro representa a for
ma como o advanceMENU ir passar para o emulador o nome da rom a ser carregada. R
epresentao das Macros: %s Passa para o emulador somente o nome da rom. Por exem pl
o "pacman". %f Passa para o emulador o nome da rom com a exteno. Por examplo "pacm
an.zip". %p Passa para o emulador o caminho completo da rom. Por examplo "c:\emu
\roms\pa cman.zip".
As roms so procuradas atravz da opo 'emulator_roms' Para cada rom encontrada adicion
ado um novo item (nome) no menu. Para que o advanceMENU ignore determinadas ext
enes, voc pode usar a opo `emu lator_roms_filter', com isso s as roms que tiverem as e
xtenes informadas nessa opo sero adicionadas no menu. As imagens ou videos so procurad
as no diretrio especificado na opo 'emulator_altss', e devem ter o mesmo nome das r
oms. 4.2 advmame - AdvanceMAME Quando usado a opo 'advmame' ao invz de 'generic' o
advanceMENU procura o arquivo ' advmame.xml', caso ele no exista ele criado autom
aticamente usando a linha de comando 'advmame -listxml' Os diretrios especificado
s no 'advmame.rc', usado para localizar as roms. No 'DOS ' e 'Windows' o arquivo
'advmame.rc' procurado no mesmo diretrio onde se encontra o 'advmame.exe', no Li
nux o advanceM EMU ir procurar esse arquivo no diretrio `HOME/.advance'. O diretrio
especificado na opo 'dir_snap' do 'advmame.rc' usado para localizar as i magens e
os videos. 4.3 advmess - AdvanceMESS Para o emulador `advmess' as informaes das r
oms so retiradas do arquivo `advmess.xm l'. Se o arquivo no existir ele ser criado
automaticamente com a linha de comando `advmess -listxml'. Os diretrios especific
ados na opo 'dir_rom' do arquivo `advmess.rc' so usados para d etectar a lista de b
ios. Todos os diretrios listados na opo `dir_image' so lidos e todos os arquivos enc
ontra dos no diretrio `machine' so inseridos como software, caso a exteno do arquivo
for reconhecida como uma exteno vlida ou se for um arquivo 'zip' . Por exemplo se
a opo `dir_image' `c:\software', o AdvanceMENU ir procura o diretrio `c:\software\ti
99_4a', `c:\software\sms', `c:\software\gameboy'... Os arquivos que estiverem de
ntro do diretrio raiz de `c:\software' no sero checados. Quando voc seleciona um arq
uivo 'zip' ele aberto e todos os arquivos contidos nes

se 'zip' que forem vlidos e que tenham uma exeteno de arquivo conhecida, so adiciona
do para a linha de comando do AdvanceMESS. Um arquivo considerado como um nome vl
ido caso tenha o mesmo nome do arquivo 'zip' ou caso t enha o mesmo nome com um
caracter adicional. Por exemplo se dentro do arquivo `alpiner.zip' conter os arq
uivos `al piner.bin', `alpinerc.bin' e `alpinerg.bin' ele considerado um nome vli
do. Esta caracteristica pode ser usada para agrupar to dos as roms requeridas pa
ra rodar os jogos em um unico arquivo 'zip'. A exteno dos arquivos so usadas para s
elecionar o dispositivo correto quando o adva nceMENU for chamar o emulador adva
nceMESS. O diretrio especificado na opo `dir_snap' usado para localizar as imagens
dos jogos que sero exibidas. Quando o AdvanceMESS fechado o advanceMENU ir verific
ar se foi criado algum novo snapsho t (imagem) e em caso positivo esse arquivo s
er movido automaticamente para o diretrio correto que `snap\system'. Por exemplo,
vamos supor que voc rode o sistema `ti99_4a' com o software`alpiner' . s voc pressi
onar a tecla 'F12' durante a emulao, o arquivo `snap\ti99_4a.png' ser criado. E qua
ndo voc retornar par a o AdvanceMENU o arquivo ser movido automaticamente para o d
iretrio `snap\ti99_4a\alpiner.png'. 4.4 mame - Windows MAME Para o emulador 'mame
' as informaes sobre as roms so retiradas atravz do arquivo 'ma me.xml', se o arquiv
o no existir ele ser automaticamente criado usando a linha de comando 'mame -listx
ml'. Os diretrios especificados na opo 'rompath' do arquivo 'mame.ini' ser usado loc
aliza r as roms. O diretrio especificado na opo 'snap_directory' ser usado para loca
lizar as imagens dos jogos. 4.5 xmame - xmame Para o emulador 'xmame' as informaes
das roms sero extraidas do arquivo 'xmame.xml' , se este arquivo no existir ele s
er criado automaticamente usando a linha de comando 'xmame -listxml'. Os diretrios
espeficficados na opo 'rompath' no arquivo `HOME/.xmame/mamerc' ser usa do para lo
calizar as roms. O diretrio especificado na opo 'screenshotdir' ser usado para local
izar as imagens d os jogos. 4.6 dmame - DOS MAME Para o emulador 'dmame' as info
rmaes das roms sero extraidas do arquivo 'dmame.xml' , se este arquivo no existir el
e ser criado automaticamente usando a linha de comando 'xmame -listxml'. Os diretr
ios espeficficados na opo 'rompath' no arquivo `mame.cfg' ser usado para lo calizar
as roms. O diretrio especificado na opo 'snap' ser usado para localizar as imagens
dos jogos. 4.7 dmess - DOS MESS

Para o emulador 'dmess' as informaes das roms sero extraidas do arquivo 'dmess.xml'
, se este arquivo no existir ele ser criado automaticamente usando a linha de com
ando 'dmess -listxml'. Os diretrios especificados na opo`biospath' no arquivo `mess
.cfg' so usados para loc alizar as bios avaliadas. Todos os diretrios listados na
opo 'softwarepath' so pesquisados e todos os arquivos 'zip' encontrados no diretrio
'subsystem' sero inseridos como 'software'. Por exemplo se a opo `softwarepath' `c:
\software', AdvanceMENU procura nos diretrio s `c:\software\ti99_4a', `c:\softwar
e\sms', `c:\software\gameboy'... Observao: Arquivos que estiverem no di retrio raiz
'c:\software' no sero usados. Quan voc seleciona uma destas entradas o arquivo 'zi
p' e aberto e ento procurado o primeiro arquivo com o mesmo nome que o arquivo 'z
ip' porem com exetenes diferentes. Estes arquivos so usados co mo argumento para a
opo '-cart' quando o dmess for chamado. Observao: O AdvanceMENU no tem suporte para u
sa r outras opes como por exemplo `-flop'. Todos os pseudnimos presentes no arquivo
'mess.cfg' so inseridos como entradas de software. Quando voc seleciona uma desta
s entradas em 'mess' a opo `-alias' usada para inicializar o jogo. Voc pode atribui
r uma descrio arbitraria dentro de uma espeficicao de 'alias' adicion ando isso dent
ro da mesma linha do 'alias' antes do caracter de comentrio '#' o formato a ser u
sado esse: ALIAS = ALIAS_DEF # Description YEAR MANUFACTURER
Por exemplo: [ti99_4a] ti-inva = -cart ti-invac.bin -cart ti-invag.bin \ # Invad
ers 1982 Texas Instrument
Quando se sai do emulador, o advanceMENU verifica se foi criado um novo snapshot
(imagem ), caso tenha essa imagem ser movida para o diretrio `snap\system'. Por e
xemplo, vamos supor que voc chame um jogo do sistema `ti99_4a' com o softwar e `a
lpiner'. Se voc pressionar a tecla 'F12'durante a emulao, o arquivo 'snap\ti99_4a.p
ng' ser criado.E nto qundo voc retornar para o AdvanceMENU o arquivo ser movido auto
maticament para 'snap\ti99_4 a\alpiner.png'. 4.8 draine - DOS Raine Para o emula
dor `draine' as informaes sobre as roms so retiradas do arquivo `draine .lst'.Se es
se arquivo no existir ele ser criado automaticamente usando a linha de comando `dr
aine -gamei nfo'.

Todos os diretrios especificados na opo `rom_dir_*' sero usados para localizar as ro


ms. O diretrio especificado na opo `screenshots' ser usado para localizar os snapsh
ots ( imagem ) dos jogos. 5 Configuration O arquivo `advmenu.rc' usado para salv
ar as configuraes correntes do front-end. El e verificado a cada vez que o que o p
rograma executado e salvo a cada saida. Mas isso pode ser alter ado usando-se as
opes disponiveis que sero apresentadas. No 'DOS' e 'Windows' as opes de configuraes s
carregadas a partir do arquivo `advmen u.rc' no mesmo diretrio onde se encontra o
'advanceMENU'. No 'Linux' e 'Mac OS X' as configuraes so carregadas a partir do ar
quivo `advmame.r c' e `advmess.rc' nos diretrios $host, $data eo $home. O $host d
iretrio `$SYSCONFDIR', onde o $SYSCO NFDIR o diretrio `sysconfdir' configurado com
o script 'configure'. O padro `/usr/local/etc'. O di retrio $data `$DATADIR/advan
ce', onde o $DATADIR o diretrio `datadir' configurado com o script `configure'. O
padro `/usr/local/share'. O diretrio $home o `$ADVANCE', onde $ADVANCE o valor da
variavel de ambiente ADVANCE quando o programa est rodando. Se a variavel de amb
iente no for e ncontrada o diretrio '$home' ser `$HOME/.advance' onde $HOME o valor
da vriavel de ambiente HOME. Se as duas vriaveis no forem localizadas ento o diretri
o '$data' se tornar o diretrio $home. A prioridade dessas opes esto na seguinte ordem
: $host, $home and $data. O diretrio $home tambm usado para gravar todos as inform
aes pelo programa. Os arquiv os dentro dos diretrios $host e $data so somente para l
eitura. Voc pode incluir arquivos de configuraes adicionais com a opo `include' . No
'DOS' e no 'Windows' os arquivos so pesquisados no diretrio corrente. No 'Linux' e
no 'Mac OS X' so pesq uisados no disretrio $home, se se eles so expressados como u
m caminho relativo. Voc pode forar a procura no diretrio corrente prefixando o arqu
ivo com um './'. Para incluir mais que um arquivo voc pode divid ir os nomes com
um ';' se estiver usando 'DOS' ou 'Windows', ou com um ':' se estiver usando o '
Linux' ou 'Mac OS X'. Voc pode forar a criao de um arquivo de configuro com todas as o
pes padres usando linha de comando '-default'. No 'DOS' ou 'Windows' usado uma '\'
para separar os nome de diretrios e o ';' par a separar multiplos diretrios. No 'L
inux ' e 'Mac OS X' os nomes de diretrios so separados usando '/' e multiplos dire
trios com o ':'. 5.1 Global Configuration Options Essa sesso descreve as opes globai
s usadas para personalizar o programa.

Um conjunto de opes de configurao so salvas para cada emulador permitindo assim que s
e tenha diferentes configuraes para diferentes emuladores. Observao: Esse conjunto
de configuraes no es disponivel caso seja selecionado mais que um emulador ao mesmo
tempo. Neste caso somente as configuraes padres sero usadas. Principalmente estas o
pes em especiais `mode', `sort',`preview', `group_in clude' and `type_include'. 5.
1.1 config Seleciona a forma como as configuraes sero salvas, conforme o usuario fo
r modifican do as opes enquando o programa estiver em uso. config save_at_exit res
tore_at_exit restore_at_idle

Options: save_at_exit Salva todas as modificao antes de sair ( esse o valor padro )
. restore_at_exit No salva as modificaes. As modificaes relizadas s tero efeito enqu o
o advanceMENU estiver rodando. restore_at_idle Restaura as modificaes, assim que o
programa ficar um tempo ocio so (screen saver) Voc pode salvar as configuraes manu
almente quando o programa est rodando, acessando o 'menu principal'. 5.1.2 emulat
or Seleciona uma lista de emuladores no menu. Voc pode especificar mais que um em
ula dor. CUIDADO! Antes de jogar com essa opo, voc deve fazer um backup do arquivo
'advmenu. rc', isso porque quando se remove um emulador, as informaes para o emula
dor removido so perdidas. emulator "EMULATOR" (generic advmame advmess mame dmess
draine) "[-]EXECUTABLE" "ARGUMENTS" dmame
Options: EMULATOR O nome para o emulador. Os nomes devem ser diferentes para c a
da emulador adicionado. generic Essa opo informa ao advanceMENU que ser usado um em
ulador que ele no tem u m suporte nativo. Por exemplo: para adicionar o emulador
'zinc.exe', necessario o uso dessa opo. advmame Este o emuldor AdvanceMAME. advmes
s Este o emulador AdvanceMESS. mame Este o emulador MAME verso 'Windows'. dmame E
ste o emulador MAME verso 'DOS'. dmess Este o emulador MESS verso 'DOS'. draine Es
te o emulador Raine verso 'DOS'. [-]EXECUTABLE Essa a opo onde devemos informar o c
aminho (path) e o nome do arqu ivo executvel '.exe'. No 'DOS' e no 'Windows' pode
ser usado um arquivo de lote '.bat' porm o advanceME NU no ter como gerar os arqui
vos '.xml' que contm as informaoes sobre as roms, esse arquivo ter que ser cri ado
manualmente. Voc pode usar um sinal '-' nessa opo, para ignorar qualquer tipo de er
ro retornado pel o executvel. Exemplo:emulator "Zinc" generic "-c:\zinc\zinc.exe"
. ARGUMENTS Esse os argumentos que sero passados para o emulador. Os argumentos s

so requeridos quando se usa a opo 'generic'. Para os outros emuladores o advanceMEN


U automaticamente adiciona os argumentos necessarios. A menos que voc precise adi
cionar um argumento extra. Na opo 'arguments' varias 'macros' so subistituidas por
vrios valores especiais (pr d efinidos) que so: %s Somente o nome da rom sem a exte
no. Por exemplo "pacman". %p Caminho completo onde se encontra a rom Por exemplo "
c:\emu\roms\pacman.zip ". %f Nome da roms com a exteno do arquivo. Por exemplo "pa
cman.zip". %o[R0,R90,R180,R270] Espande uma das seguintes strings R*, dependendo
de como o menu est posicionado. Note que voc no pode usar espaos em branco nessa opo.
Exemplo de uso correto: "%o[,-ror,-flipx ,-rol]" ou "%o[,,-flipy,]" com essas o
pes o emulador AdvanceMAME ser corretamente rotacionado. Para o tipo emulator 'gene
ric', voc precisa usar uma das macros '%s, %f, %p', par a informar ao emulador o
nome do jogo selecionado, para os outros, o advanceMENU automaticamente adiciona
essa ma cro. Exemplos para os sistemas DOS e Windows: emulator "AdvanceMAME" ad
vmame "advmam e\advmame.exe" \ "%o[,-ror,-flipx,-rol] %o[,,-flipy,]" emulator "M
AME" mame "mame\mame.exe" "-nohws" emulator "MESS" dmess "mess\mess.exe" "" emul
ator "Raine" draine "raine\raine.exe" "" emulator "Custom Raine" draine "raine\r
aine2.bat" "" emulator "SNes9x" generic "c:\game\snes9x\snes9x.exe" "%f" emulato
r "ZSNes" generic "c:\game\zsnes\zsnes.exe" "-e -m roms\%f"
Exemplos para os sistemas Linux e Mac OS X: emulator "AdvanceMAME" advmame "adv
mame" \ "%o[,-ror,-flipx,-rol] %o[,,-flipy,]"
5.1.3 emulator_roms/roms_filter/altss/flyers/cabinets/icons/titles Usando as opes
abaixo, voc pode informar ao advanceMENU diretrios adicionais, para s erem usados
na pesquisas de roms, snaps, sounds, etc... que no esto listados dentro dos arquiv
os de configurao d os emuladores. emulator_roms "EMULATOR" "LIST" emulator_roms_fi
lter "EMULATOR" "LIST" emulator_altss "EMULATOR" "LIST" emulator_flyers "EMULATO
R" "LIST" emulator_cabinets "EMULATOR" "LIST" emulator_marquees "EMULATOR" "LIST
" emulator_icons "EMULATOR" "LIST" emulator_titles "EMULATOR" "LIST" Commands: r
oms Lista de diretrios usados para as roms. Est opo usada somente quand

o se usa a palavra 'generic'. Para todos os outros emuladores, so usados as confi


guraes existentes nos arquivos de configurao dos emuladores. roms_filter Lista de ex
tenes que o advanceMAME deva considerar como vlidas, caso essa opo no seja informada t
odos os arquivos presentes na opo 'emulator_roms', sero adicionados na lista do me
nu. altss Lista de diretrios onde se encontram os screenshots (imagens), videos (
mn g), sons. Caso essa opo esteja em branco o advanceMENU ir tentar localizar essas
imagens atravz dos diretrios list ados nos arquivos de configurao dos emuladores. f
lyers Flyers diretrios. cabinets Cabinets diretrios. marquees Marquees diretrios. i
cons Icons diretrios. titles Titles diretrios. Options: "EMULATOR" O nome para o e
mulador adicionado. Este nome deve ser o me smo usado na definio do emulador, por
exemplo [advmame, dmame, mame, etc..], Quanto se usa a palavra 'ge neric', voc po
de atribuir qualquer nome que desejar, por exemplo:[ emulator "Jogos3D" generic
"zinc.exe" " %s" ]. LIST Lista de diretrios ou extenes de arquivos. No DOS ou Windo
ws voc deve usar um ';' como separador, e no Linux ou Mac OS X, voc deve usar um '
:' como separador. Exemplos para DOS e Windows: emulator_roms "SNes9x" "c:\game\
snes9x\roms;c:\gam e\zsnes\roms2" emulator_roms_filter "SNes9x" "*.smc;*.sfc;*.f
ig;*.1" emulator_flyers "SNes9x" "c:\game\zsnes\fly" emulator_cabinets "SNes9x"
"c:\game\zsnes\cab" emulator_marquees "SNes9x" "c:\game\zsnes\mar" emulator_roms
"ZSNes" "c:\game\zsnes\roms" emulator_roms_filter "ZSNes" "*.smc;*.sfc;*.fig;*.
1"
5.1.4 mode Seleciona os modos como o menu poder ser mostrado. [EMULATOR/]mode ful
l full_mixed text list list_mixed tile_normal tile_big tile_enormous tile_giant
tile_icon tile_marquee tile_small
Options: EMULATOR/ Se for usar um emulador padro essa opo no necessaria. E caso us e
um emulador com a opo 'generic', ento essa opo pode ser usada para atribuir o valor
ao emulador e specifico. full mostrado somente uma imagem em tela cheia. full_mi
xed So mostrados 4 imagens em tela cheia text mostrado somente a lista dos jogos.
list mostrado a lista de jogos e sua imagem ( esse o valor padro ). list_mixed m
ostrado a lista de jogos e mais 4 imagens do jogo selecionado. tile_small Mostra
12 imagens de uma s vez, sendo 4 na horizontal por 3 na verti

cal. tile_normal Mostra 30 imagens, sendo 5 nahorizontal por 6 na vertical. tile


_big Mostar 48 imagens, sendo 8 na horizontal e 6 na vertical tile_enormous Most
ra 108 imagens, sendo 12 na horizontal e 9 na vertical. tile_giant Mostra 112 im
agens, sendo 16 na horizontal e 12 na vertical. tile_icon Modo especial para ser
mostrado em forma de icones. tile_marquee Modo especial, mostra as imagens em f
ormato de titulos. 5.1.5 sort Seleciona como a lista de jogos ser organizada. [EM
ULATOR/]sort parent name time play year type group size resolution info manufact
urer
Options: EMULATOR/ Se for usar um emulador padro essa opo no necessaria. E caso us e
um emulador com a opo 'generic', ento essa opo pode ser usada para atribuir o valor
ao emulador e specifico. parent Organiza a lista agrupando os jogos pelo parente
sco. emulator Organiza a lista de jogos pelo nome do emulador. name Organiza a l
ista de jogos pelo nome. time Organiza a lista de jogos usando como base os mais
que foram jogados por mais tempo. play Organiza a lista de jogos usando como ba
se os que foram jogados mais veze s. timeperplay Organiza a lista de jogos usand
o como base os que foram jogados po r mais temo e mais vezes. Time per play. yea
r Organiza a lista de jogos usando como base o ano de lanamento do jogo. manufact
urer Organiza a lista de jogos usando como base o nome da empresa dese nvolvedor
a do jogo. type Organiza a lista de jogos usando como base o tipo atribuido ao j
ogo, por exemplo 'ao', 'aventura', 'tiro', etc... group Organiza a lista de jogos
usando como base o grupo a que pertence, por e xemplo 'Favoritos', 'Adultos', et
c... size Organiza a lista de jogos usando como base o tamanho da rom. resolutio
n Organiza a lista de jogos usando como base a resoluo do jogo, por exe mplo '320x
240', '304x224', etc... info Organiza a lista de jogos usando um arquivo externo
que contm informaes que so i mportadas com a opo 'info_import'. 5.1.6 preview Selecio
na o tipo de imagens a serem mostradas. [EMULATOR/]preview snap titles flyers ca
binets
Options: EMULATOR/ Se for usar um emulador padro essa opo no necessaria. E caso us e
um emulador com a opo 'generic', ento essa opo pode ser usada para atribuir o valor
ao e mulador especifico. snap Os arquivos contidos nas opes `snap' e ou `altss'. f
lyers Os arquivos contidos no diretrio `flyers'. cabinets Os arquivos contidos no
diretrio `cabinets'. titles Os arquivos contidos no diretrio `titles'. Os `icons'
e os `marquees' imagens podem ser selecionadas com a opo especial 'mode ' e uma d
as

opes `tile_icon' e `tile_marquee'. 5.1.7 mode_skip Desabilita varios modos no menu


principal, quando acessado pela tecla 'tab'. mode_skip (full full_mixed list li
st_mixed tile_small tile_normal tile_big tile_enormous tile_giant tile_icon tile
_marquee)* Options: SKIP Multiplas selees podem ser desabilitadas. Use uma lista v
azia para abilitar todos os modos. Exemplos: mode_skip tile_giant mode_skip full
full_mixed list tile_small tile_giant mode_skip
5.1.8 preview_expand Essa opo expande a rea usada pelas imagens dos jogos, fazendo
com que imagens verti cais e horizontais preencham rea disponivel para a imagem p
or completo. preview_expand FACTOR Options: FACTOR O fator de expanso de ponto fl
utuante que vai de 1.0 at 3.0 (ess e o valor padro 1.15) Exemplos: preview_expand
1.15
5.1.9 preview_default_* Seleciona uma imagem padro que ser mostrada, para os jogos
que no tenham uma imagem (snapshots). preview_default "FILE" preview_default_sna
p "FILE" preview_default_flyer "FILE" preview_default_cabinet "FILE" preview_def
ault_icon "FILE" preview_default_marquee "FILE" preview_default_title "FILE" Com
mands: default Seleciona uma imagem padro para todas as opes que no possuem uma imag
em definida. default_TAG Seleciona a imagem padro para a opo 'preview mode'. Option
s: FILE O caminho completo onde se encontra a imagem a ser usada. Exemplos: prev
iew_default "C:\MAME\DEFAULT.PNG" preview_default_marquee "C:\MAME\DEFMAR.PNG" p
review_default_icon "C:\MAME\DEFMAR.PNG"

5.1.10 icon_space Seleciona o tamanho dos espaos entre cada icons. o modo `icon'
s ser vlido se a opo ` mulator_icons' existir no arquivo de configurao do emulador. ic
n_space SPACE Options: SPACE O numero de pixel entre cada icons ( o valor padro 4
3 ). No modo 'icons' o titulo do jogo mostrado em multiplas linhas isso se tiver
espao sulficiente.
5.1.11 merge Seleciona como o advanceMENU ir verificar suas roms. Essa opo usada pa
ra testar se os arquivos 'zips' contm todos os arquivos necessrios para rodar o jo
go. Essa opo s usada para emulador s reconhecidos internamente pelo advanceMENU, is
so porque usado as informaes conti das nos arquivos ".xml", exemplo: advmame.xml m
erge none differential parent any disable
Options: none Cada rom clone contm todos os arquivos necessarios para rodar. diff
erential Cada rom clone contm somente os arquivos os arquivos que lhe perte ncem,
e para rodar necessario que a rom "principal" esteja no mesmo diretrio. Esse o v
alor padro que o advanceMENU usa. parent Todas as roms ( principal e clones ) esto
em um unico arquivo. any As roms podem estar em qualquer um dos formatos j menci
onados. Somente use essa opo caso suas roms estejam desorganizadas, o tempo de pes
quisa ir influenciar no desempenho. disable No verifica o conteudo das roms, essa
a opo que ter melhor desempenho, mas estar mais sujeito a erros.

5.1.12 game Contm varias informaes sobre os jogos j conhecidos. Uma opo 'game' adicio
ada ou mo icada automaticamente no advmenu.rc a cada vez que um novo game encont
rado ou jogado, essa opo usada ara manter algumas informaes uteis: tempo jogado, qua
ntas vezes foi jogado, etc... game "EMULATOR/GAME" "GROUP" "TYPE" TIME PLAY "DES
C" Options: EMULATOR O nome do emulador que essa rom pertence. GAME O nome da ro
m ( arquivo zip, sem a exeteno ). GROUP O nome do grupo que a roms pertence, ou va
zio "". TYPE O nome do tipo que a rom pertence, ou vazio "" TIME O tempo que o j
ogo ficou aberto ( jogando ). PLAY A quantidade de vezes que o game foi jogado.
DESC Descrio do game ou vazio "". Os argumentos GROUP, TYPE e DESC sobrepoem os va
lores importados das opes `group_i mport', `type_import' e `desc_import'. Os valor
es importados s tem efeitos se os argumentos GROUP, TYPE

e DESC estiverem vazios. Exemplos: game "advmame/puckman" "Very Good" "Arcade" \


1231 21 "Pac-Man Japanese" game "advmame/1943" "" "" 121 4 "1943 !!"
5.2 Display Configuration Options Esta sesso descreve as opes usadas para personali
zar o modo de video. 5.2.1 device_video_* Esta opo usada para personalizar o drive
de video. Todos as opes `device_video_*' esto definidas no arquivo `advdev.txt'.
Se voc usa um drive de video, no preciso modificar essas opes, pois elas sero ignora
as. A opo 'Generate', usada para selecionar e criar um correto modo de video. Sem
essa opo o modo SVGA usado 5.2.2 display_size Seleciona a resoluo desejada para o vi
deo. display_size WIDTH Options: WIDTH Largura em pixel, o modo mais perto do in
formado ser usado. O va lor padro dessa opo 1024. 5.2.3 display_restoreatgame Seleci
ona como o video deve se comportar quando um emulador executado. [EMULATOR/]disp
lay_restoreatgame yes no
Options: EMULATOR/ O nome o emulador que ir usar a opo. yes Reseta o video antes de
chamar o emulador ( esse o valor padro ). no No reseta o video antes de chamar o
emulador. 5.2.4 display_restoreatext Restaura a resoluo anterior antes de sair. di
splay_restoreatexit yes no
Options: yes Reseta o modo de video ( esse o valor padro ). no Mantm o modo grfico
atual. 5.2.5 display_orientation Seleciona o posicionamento da tela. display_ori
entation (flip_xy mirror_x mirror_y)*
Options: mirror_x Inverte a imagem na direo horizontal. mirror_y Inverte a imagem
na direo vertical. flip_xy troca o eixo x e y. Exemplos: display_orientation flip_
xy mirror_x

5.2.6 display_brightness Altera o brilho da imagem. display_brightness FACTOR Op


tions: FACTOR O brilho deve ser um numero de ponto flutuante ( o valor padro 1.0
). Exemplos: display_brightness 0.9
5.2.7 display_gamma Seleciona o fator de correo 'gamma'. display_gamma FACTOR Opti
ons: FACTOR Gamma, numero de ponto flutuante ( valor padro 1.0 ) Exemplos: displa
y_gamma 0.9
5.3 Sound Configuration Options Essa sesso descreve como personalizar as opes de au
dio. 5.3.1 device_sound_* Essas opes so para personalizar o drive de audio. Todas a
s opes `device_sound_*' so definidas no arquivo`advdev.txt'. 5.3.2 sound_volume Atr
ibui o volume de audio geral. sound_volume VOLUME Options: VOLUME A atenuao ( altu
ra ) do volume definida em dB ( o valor padro -3) . The volume attenuation in dB
(default -3). O volume definido com um numero negativo que vai de -40 at 0. Exemp
los: sound_volume -5 5.3.3 sound_latency Atribui o tempo necessrio para carregar
o audio. sound_latency TIME Options: TIME O tempo expresso em segundos pode ser
de 0.01 at 2.0. (o valor pa dro 0.1)

Increase the value if your hear a choppy audio. 5.3.4 sound_buffer Define o temp
o em buffer que ser usado para alocar o audio. sound_buffer TIME Options: TIME O
tamanho do buffer estabelecido em segundos de 0.05 at 2.0. (o v alor padro 0.1) Au
mente esse valor caso o audio apresente tremulaes. 5.3.5 sound_foreground_EVENT Se
leciona os sons que sero tocados em varios eventos. sound_foreground_begin none d
efault FILE sound_foreground_end none default FILE sound_foreground_key none def
ault FILE sound_foreground_start none default FILE sound_foreground_stop none de
fault FILE Commands: begin O som ser tocado toda vez que o advanceMENU for inicia
do. end O som ser tocado toda vez que o advanceMENU for encerrado. start O som se
r tocado toda vez que um jogo for chamado. stop O som ser tocado assim que o emula
dor fechar. key O som ser tocado a cada pressionamento de uma tecla. Options: non
e Sem som. default Usa os sons padres do advanceMENU. FILE O caminho completo ond
e se encontra o som desejado para o evento, os sons podem ser nos formatos (.wav
ou .mp3). 5.3.6 sound_background_EVENT Seleciona os sons que sero tocados ao fun
do. sound_background_begin none FILE sound_background_end none FILE sound_backgr
ound_start none FILE sound_background_stop none FILE sound_background_loop none
default
FILE
Commands: begin O som ser tocado ao fundo enquanto o advanceMENU carregado. end O
som tocado enquanto o advanceMENU encerrado. start O som tocado enquanto o emul
ador carrega o jogo. stop O som tocado enquanto o emulador est sendo fechado. Sou
nd played at emulat or exit. loop O som constantemente ( loop ), se nenhum outro
som estiver ativo. Options: none Sem som. default Usa o som padro do advanceMENU
. FILE O caminho completo onde o arquivo de som est localizado, os formatos supor
tados so (.wav or .mp3). 5.3.7 sound_background_loop_dir Seleciona um diretrio qu
e contenha vrias msicas ou sons, que sero tocados aleatriamne

te enquanto voc estiver no advanceMENU os formatos suportados so ( .MP3 E .WAV ) V


oc pode especificar multiplos diretrios, use um ';' caso esteja usando DOS ou Win
dows, e um `:' no Linux ou Mac OS X. Note: esses diretrios sero usados somente par
a musicas, os sons e os videos ( mng ), devem ficar no diretrio 'snap' ou no dire
trio especificado com a opo 'emulator_altss'. sound_background_loop_dir "DIR" Optio
ns: DIR Diretrio para os arquivos de .mp3 ou .wav. Exemplos: sound_background_loo
p_dir C:\MP3\POP;C:\MP3\ROCK
5.4 Input Configuration Options Esta sesso descreve as opes para pernonalizar o tec
lado ou joystick usados para ace ssar o menu. 5.4.1 device_keyboard/joystick/mou
se Essas opes so usadas para personalizar drivers de entrada. Todas as opes 'device_k
eyboard/joystick/mouse_*' que esto definidas no arquivo `adv dev.txt' podem ser u
sadas. Por padro o mouse e o joystick so desabilitados. Para habilitar adicione as
opes. device_mouse auto device_joystick auto
No arquivo advmenu.rc. 5.4.2 mouse_delta Selecione a sensibilidade do mouse/trac
kball. Aumentando o valor o movimento ir f icar mais lento, e diminuindo o movime
nto ser mais rpido. mouse_delta STEP Options: STEP sensibilidade do Mouse/trackbal
l (valor padro 100). 5.5 User Interface Essa sesso descreve as opes usadas para pers
onalizar a interface do menu. 5.5.1 ui_font Seleciona um arquivo de fonte. os fo
rmatos suportados so 'TrueType (TTF), GRX, PS F e RAW'. Voc ir encontrar uma coleo de
fontes, no diretrio 'contrib'. ui_font auto "FILE"
Options: auto Usa as fontes padres. FILE O caminho e o nome de um arquivo de font
e a ser usada.

O formato TrueType (TTF) somente reconhecido se o advanceMAME for compilado com


a biblioteca FreeType2. 5.5.2 ui_fontsize Seleciona o tamanho da fonte, se a fon
te especificada permitir ser redimencionad a. O tamanho expressado pelo numero d
e linha e colunas de textos na tela. ui_fontsize auto ROWS [COLS]
Options: auto Automticamente calcula o tamanho ( esse o valor padro ). ROWS O num
ero de linhas de texto. COLS O numero de colunas de texto. Se essa opo for omitida
ela ser calculada auto maticamente. 5.5.3 ui_background Define uma imagem de fun
do no formato .PNG ou MNG. A imagem informada ser ampliad a para ocupar o tamanho
da tela. ui_background FILE none Options: none Sem imagem ( esse o valor padro )
FILE Arquivo no formato .PNG ou .MNG a ser usado. Caso seja usado um video .MNG
, somente a primeira imagem do video ser usada como imagem de fundo. 5.5.4 ui_exi
t Define uma imagem ou video que ser exibido ao sair do advanceMENU os formatos s
up ortados so .PNG ou .MNG. ui_exit FILE none Options: none Sem imagem ( esse o v
alor padro ). FILE Arquivo no formato .PNG ou .MNG para ser exibido. 5.5.5 ui_sta
rtup Define uma imagem ou video que ser mostrado quando o advanceMENU for iniciad
o, os formatos suportados so .PNG ou .MNG e a imagem ser redimencionada para preen
cher a tela. ui_startup FILE none Options: none Sem imagem (esse o valor padro).
FILE Caminho e o nome do arquivo .PNG or .MNG a ser exibido. 5.5.6 ui_help Defin
e uma imagem que ser mostrada ao pressionar a tecla F1, formatos vlidos .PNG ou .M
NG, a imagem ser redimencionada para preencher a tela. ui_help FILE none Options:
none Sem imagem (esse o valor padro). FILE Caminho e o nome do arquivo .PNG or .
MNG a ser exibido. 5.5.7 ui_gamemsg

Mostra uma menssagem quando um jogo escolhido, essa menssagem ter apenas uma linh
a, e s ser exibida caso a opo `display_restoreatgame' estiver definida como 'no'. u
i_gamemsg "MESSAGE" Options: MESSAGE Menssagem a ser mostrada ( o valor padro "Ru
n Game"). Para que est menssagem no seja mostra use uma string vazia "". Exemplos:
ui_gamemsg "Aguarde o carregamento do jogo..."
5.5.8 ui_game Seleciona um mode de apresentao quando o game for escolhido. A apres
entao s ser mostr da caso a opo `display_restoreatgame' esteja definida como `no'. ui_
game none snap flyers cabinets titles

Options: none No mostra nenhuma apresento. snap, flyers, cabinets, titles Mostra u
ma imagem dos 4 tipos possiveis, o valo r padro 'snap'. 5.5.9 ui_skiptop/bottom/l
eft/right Define a area que o menu ir ocupar, essa area obitida usando a imagem d
e fundo ( caso ela tenha sido definida na opo `ui_background'). se nenhuma imagem
tiver sido definida ento ser usa do a resoluo atual. Usando essas opes voc pode posici
nar e redimencinar o menu para qualquer posio e tam anho que desejar. ui_skiptop N
, ui_skipbottom N, ui_skipleft N, ui_skipright N Options: N O numero de pixel a
ser deslocado ( o valor padro 0). 5.5.10 ui_topbar/bottombar Habilita ou desabili
ta as informaes mostradas nas barras, superior e inferior Por exemplo: nome do jog
o, tamanho do jogo, tempo jogado, etc... ui_topbar yes no ui_bottombar yes no 5.
5.11 ui_color Seleciona a cor a ser usada pelo menu. ui_color TAG FOREGROUND BAC
KGROUND Tags: help Help. help_tag Help highlight. submenu_bar Submenu title. sub
menu_item Submenu entry. submenu_item_select Submenu selected entry. submenu_hid
den Submenu hidden entry. submenu_hidden_select Submenu selected hidden entry. m
enu_item Menu entry. menu_hidden Menu hidden entry.

menu_tag Menu highlight entry. menu_item_select Menu selected entry. menu_hidden


_select Menu hidden selected entry. menu_tag_select Menu selected highlight. bar
Title. bar_tag Title highlight. bar_hidden Title hidden text. grid Scrollbar ma
rker and generic background color. backdrop Backdrop outline and missing backdro
p. icon Icon outline and missing icon. cursor Flashing cursor. Options: FOREGROU
ND A cor de frente ( dos textos ) a ser usada, o formato dess e parametro RRGGBB
. Esse formado deve ser expresso na forma hexadecimal. Por exemplo: vermelho = F
F0 000, verde = 00FF00, azul = 0000FF, com esse formato voc poder obter qualquer c
or que desejar. BACKGROUND Para a cor de fundo se aplica as memas regras informa
das na opo 'FORE GROUND'. 5.5.12 ui_clip Seleciona como os videos devem ser exibid
os. ui_clip none single singleloop multi multiloop multiloopall
Options: none No deve reproduzir nenhum video clip. single Reproduz o video clip
somente uma vez ( esse o valor padro ). singleloop Reproduz somente um video clip
e continuamente ( loop ), o som s ser reproduzido uma vez. multi Reproduz todos o
s video clips. multiloop Reproduz todos os video clips, usando como base o jogo
que estiver s elecionado, e ao termino ir para o proximo item da lista, e assim s
ucessivamente at o final da lista e quando alcanado volta para o primeiro item. Us
ando essa opo os sons no so reproduzidos. multiloopall Reproduz todos os video clips
de forma aleatria. O sons no so reprod uzidos com essa opo. 5.5.13 ui_translucency S
eleciona a transparencia do menu. ui_translucency FACTOR Options: FACTOR O valor
pode ser de 0 at 1. ( o valor padro 0.6 ). A transparencia s tem efeito se for usa
do uma imagem de fundo. 5.5.14 ui_command Define um ( comando ou script ou progr
ama ) definido pelo usuario. O video no alt erado quando o script executado. ui_c
ommand "MENU" SCRIPT Options: SCRIPT comando ele pode nha. MENU O nome do menu a
ser inserido. Um ( comando, script ou programa ) para ser executado. Caso o scr
ipt ou seja muito grande ser dividido em varias linhas para isso use uma '\' no
final de cada li

Os ( comando, scripts, programas ) podem usar as macros disponiveis no advanceME


NU, isso quando se tem um game selecionado. %s O nome da rom sem a exteno. por ex
emplo "pacman" %p O caminho completo da roms. Por exemplo "c:\emu\roms\pacman.zi
p". %f O nome da rom com a exteno. Por exemplo "pacman.zip". Se o game no estiver s
elecionado as macros no podem ser usadas. Se um ( comando, script, programa ) ter
minar com um erro, ser mostrado uma menssa gem de alerta. Exemplos: ui_command "D
elete Hiscore" \ del .\advance\hi\%s.hi ui_command "Delete Snapshot" \ del .\adv
ance\snap\%s.png ui_command "Enable GamePad" \ rmmod analog \ sleep 1 \ modprobe
analog js=gamepad

5.5.15 ui_command_menu Seleciona o nome que o menu ir ter, esse nome ir aparecer n
o menu principal os com ando como submenu. ui_command_menu MENU Options: MENU O
nome do menu. caso no seja espeficicado um o nome "Command" ser usado 5.5.16 ui_co
mmand_error Seleciona a menssagens que ser mostrada caso o ( comando, script ou p
rograma ) re torne um erro. ui_command_error MSG Options: MSG Menssagem a ser mo
strada. Caso no seja definida a opo padro ser usada (o valor padro "Error running the
command"). 5.5.17 ui_menukey Habilita ou desabilita os nomes das teclas de atalh
o do menu. Por exemplo F5, F6 , ESPACEBAR, etc... ui_menukey yes no 5.5.18 ui_co
nsole Modifica o comportamento do menu para trabalhar como se fosse um menu de u
m vide o game. Essa opo geralmente pra ser usada com o advanceCD. ui_console yes n
o No modo console o menu reduzido para conter somente as funes minimas. 5.6 Input
Configuration Options Essa sesso descreve as opes usadas para personalizar as tecla
s.

5.6.1 device_keyboard/joystick/mouse_* Estas opes so usadas para personalizar os dr


ivers. Todos as opes `device_keyboard/joystick/mouse_*' que esto definidas no arqui
vo `adv dev.txt' podem ser usadas. 5.6.2 input_hotkey Habilita ou desabilita o r
econhecimento de teclas especiais. input_hotkey yes no
Options: no As teclas no devem ser reconhecidas. yes As teclas sero reconhecidas (
essa a opo padro ). No 'MSDOS' as hotkeys reconhecidas so: CTRL+ALT+DEL Reset. CTRL
+ALT+END Quit. CTRL+BREAK (Pause) Break. No Linux as hotkeys reconhecidas geralm
ente so: CTRL+C Break. ALT+Fx Change virtual console.
5.6.3 lock Bloqueia ou desbloqueia o menu. Quando o menu est bloqueado o usuario
s tem a perm isso de selecionar um game e jogar, todas as opes do menu no ficaro dispo
niveis e no podero ser modifica as, e o usuario no poder fechar o menu. lock yes no
Options: yes O bloqueio ativado. no O bloqueio desativado ( esse o valor padro ).
5.6.4 event_assign Personaliza as teclas que sero usadas para ativar as opes do me
nu. event_assign EVENT EXPRESSION Events: up, down, left, right Movement. home,
end, pgup, pgdn Movement. enter Main action, start. esc Back action, exit & canc
el. space Change action, select & deselect. ins Select all. del Deselect all. me
nu The main menu. sort Changes the sort mode. mode Change the display mode. prev
iew Change the preview mode. emulator The emulator menu. help Show a little help
. group Select a game group. type Select a game type. exclude Exclude some games
with filters. setgroup Select the group of the current game settype Select the
type of the current game runclone Run a game clone.

shutdown Exit and shutdown. command The file command menu. rotate Rotate the scr
een of 90. lock Lock/unlock the user interface. mute Mute/unmute the audio. Optio
ns: EXPRESSION Definio das expresses que representam as teclas e que geram o s even
tos. Essas combinao podem ser nomes das teclas ou scan-code ( cdigo da tecla ), e p
odem ser usados com os operadores `not', `or'. O operador `and' pode ser usado s
omente com os sc an-code. KEY The available key names are: a, b, c, d, e, f, g,
h, i, j, k, l, m, n, o, p, q, r, s, t, u, v, w, x, y, z, 0, 1, 2, 3, 4, 5, 6, 7,
8, 9, 0_pad, 1_pad, 2_pad, 3_pad, 4_pad, 5_pad, 6_pad, 7_pad, 8_pad, 9_pad, f1,
f2, f3, f4, f5, f6, f7, f8, f9, f10, f11, f12, esc, backquote, minus, equals, b
ackspace, tab, openbrace, closebrace, enter, semicolon, quote, backslash, less,
comma, per iod, slash, space, insert, del, home, end, pgup, pgdn, left, right, u
p, down, slash_pad, asterisk_p ad, minus_pad, plus_pad, period_pad, enter_pad, p
rtscr, pause, lshift, rshift, lcontrol, rcontrol, lalt, ralt, lwin, rwin, menu,
scrlock, numlock, capslock. Exemplos: event_assign enter lcontrol or enter event
_assign menu 90 or 35 event_assign emulator 91 23 or not 21 33 event_assign comm
and 6
Voc pode utilizar o utilitrio `advk.exe' para ver os 'scancodes' de uma determinad
a tecla. 5.6.5 event_repeat Seleciona a taxa de repetio de vrios eventos. event_re
peat FIRST_TIME NEXT_TIME Options: FIRST_TIME Tempo da primeira repetio, o valor d
eve ser exepresso em mile segundos. NEXT_TIME Tempo da proxima repetio, o valor dev
e ser exepresso em milesegundos. 5.6.6 event_mode Seleciona se o evento deve agua
rdar a atualizao da tela antes de gerar um novo eve nto. event_mode wait fast
Options: wait A tela ser completamente redesenhada antes de processar o proximo e
vento. fast Se um evento estiver aguardando, o redesenho da tela ser interrompido
( es se o valor padro ).

5.6.7 event_alpha Desabilita as teclas alpha numericas, para uma movimentao rpida p
elo menu. Se voc es tiver usando um 'encoder' ou um 'hack de teclado' com varios
botes remapeados para uma tecla alph a numerica, essa opo ser de grande utilidade. e
vent_alpha yes no
Options: yes Habilita (esse o valor padro). no Desabilita. 5.7 Other Configuratio
n Options 5.7.1 idle_start Inicia um game automaticamente caso o menu fique ocio
so pelo periodo especificad o. Com essa opo voc pode criar uma apresentao usando em c
onjunto com a opo `input_idleexit' do advanceMA ME. idle_start START_TIMEOUT REPEA
T_TIMEOUT Options: START_TIMEOUT O tempo expresso em segundos que o advanceMENU
ir aguard ar antes de iniciar um game. Se for definido com um '0' (zero), o advan
ceMENU no ir chamar um game aut omaticamente. ( esse o valor padro ). REPEAT_TIMEOU
T O tempo expresso em segundos que o advanceMENU ir chamar o proxi mo game. Se um
'0' (zero) for usado o advanceMENU no ir chamar o proximo game. Exemplos: idle_st
art 400 60
5.7.2 idle_screensaver Seleciona o tempo que o advanceMENU ir aguardar antes de i
niciar a proteo de tela. As imagens dos jogos sero usadas para criar um slide. idle
_screensaver START_TIMEOUT REPEAT_TIMEOUT Options: START_TIMEOUT O tempo em segu
ndos para aguardar entes de iniciar o sl ide. Se um '0' for definido o slide no s
er iniciado ( o valor padro 60 ). REPEAT_TIMEOUT O tempo em segundos que ele ir agu
ardar para mostrar a proxima i magem. Se um '0' for definido a proxima imagem no
ser mostrada ( o valor padro 10 ). Examples: idle_screensaver 40 5
5.7.3 idle_screensaver_preview Seleciona o tipo de imagem que ser usada para cria
r o slide.

idle_screensaver_preview none cabinets titles


play
snap
flyers
Options: none Desliga o monitor usando o servio VESA/PM se estiver disponivel. Ca
so contrrio mostra uma imagem escura. snap, flyers, cabinets, titles Inicia o sli
de usando as imagens especificadas na opo 'screensaver_preview'. A opo padro 'snap'.
play Inicia o slide usando os arquivos de video ( mng ) e os sons ( mp3 ). Som e
nte os videos e sons sero mostrados, qualquer outra imagem ser ignorada. 5.7.4 gro
up/type Seleciona e mostra as categorias `group' e `type'. group "STRING" type "
STRING" [EMULATOR/]group_include "STRING" [EMULATOR/]type_include "STRING" Comma
nds: group, type define uma categoria. group_include, type_include Mostra a cate
goria selecionada.
Options: EMULATOR/ No necessario ser informado caso use um emulador reconhecido p
elo advanceMENU. Caso use a opo 'generic' ento voc deve informar o nome usado na opo '
emu ator', para aplicar a altero no emulador especificado. STRING Nome da categori
a. 5.7.5 group/type/desc/info_import Seleciona importa automaticamente as inform
aes 'groups, types, descriptions' e out ras informaes de um arquivo externo. As info
rmaes adicionais so mostradas para cada game. Os formatos dos arquivos suportados so
: CATINI, MacMAME e NMS. Os arquivos sero li dos a partir do diretrio corrente cas
o esteja usando o 'MSDOS' ou 'WINDOWS', no 'Linux' e 'Mac OS X' o $home.

Ateno! Essas opes no tem prioridade maior que as opes informadas com a opo 'game'. d
mport (ini mac nms) "EMULATOR" "FILE" ["SECTION"] info_import (ini mac nms) "EMU
LATOR" "FILE" ["SECTION"] group_import (ini mac nms) "EMULATOR" "FILE" ["SECTION
"] type_import (ini mac nms) "EMULATOR" "FILE" ["SECTION"] Commands: desc_import
Importa o nome do game que ser mostrado no menu. info_import Importa informaes adi
cionais que sero mostradas na barra de baixo do advanceMENU. group_import Importa
os nomes dos grupos dos games. type_import Importa os nomes dos tipos dos games
. Options: none No importa. ini Importa no formato CATLIST.

mac Importa no formato MacMAME. nms Importa no formato NMS. EMULATOR O nome do e
mulador informado na opo 'emulator'. FILE O nome do arquivo. SECTION O nome da ses
so ( somente para o formato `ini'). Exemplos: group_import ini "advmame" "catver.
ini" "Category" type_import mac "advmame" "Genre 37b14.txt" desc_import nms "rai
ne" "raine.nms" info_import ini "advmame" "catver.ini" "VerAdded"
Os arquivos 'CATLIST'podem ser baixados de: http://www.mameworld.net/catlist/
5.7.6 misc_exit Seleciona a forma de saida do advanceMENU. misc_exit none normal
shutdown all
Options: none A saida no permitida. normal Sai ao ser pressionado a tecla 'ESC'.
shutdown Sai somente se pressionado as teclas 'CTRL-ESC'. all Todos os modos de
saida so permitidos. 5.7.7 misc_quiet Desabilita a menssagens de direitos autorai
s na inicializao do advanceMENU. misc_quiet yes no
6 Formatos suportados. Essa a lista de arquivos que o advanceMENU suporta. Image
s: PNG Formato PNG. PCX Formato PCX. ICO Formato ICO. Clips: MNG O MNG-VLC (Very
Low Complexity), esse um sub formato que no usa tran sparency e alpha channel, o
u o sub-formato que gerado pelo advanceMAME ou pelo utilitario d e compresso 'adv
mng'. Sounds: MP3 Formato MP3. WAV O formato WAV com 16 bits. Fonts: TTF o forma
to 'TrueType'. Caso o advanceMENU tenha sido compilado com a biblioteca 'FreeTyp
e2'. RAW O formato RAW. PSF O formato PSF. GRX O formato GRX.

Archives: ZIP o formato ZIP. 7 Signals O advanceMENU intercepta os seguintes sin


ais: SIGQUIT Saida normal. SIGTERM, SIGINT, SIGALRM Sai e restaura somente os di
spositivos de saida. SIGHUP Reinicia o programa. 8 Copyright Esse arquivo Copyri
ght (C) 2003, 2004, 2005 Andrea Mazzoleni, Randy Schnedler.