Você está na página 1de 38

Tutorial Advance Menu Front-end pra

Mame e demais emuladores


Posted by : GEORG HRYCYLOquarta-feira, 1 de janeiro de 2014

Bem vou postar aqui um tutorial sobre a melhor Front-End para Emuladores o
Advance Menu que ao contrario do HyperSpin mais leve e roda em todos os PC
de mesa, rodado numa boa em sistema operacional Windows XP e Seven com

menos de 512 mb de memoria e tem verso pra linux e o legal dele que no site
oficial voc pode est baixado tambm o Advance Mame que um Mame
compilado com um toque a mais pra gravao de vdeo e outras funes.e tem
tambm o Advance CD que um Advance Mame+Advance Menu que da pra voc
colocar as rom no CD e da o boot sem a necessidade do Windows instalado
conforme mostra esse tutorial feito pelo Samuel Mondini como mostra no video:
Download Advance CD 2.6.2

Montar um ARCADE Multi Jogos com Advmame e Advmenu


Advmame: Emulador Mame compilado pra Simular um verdadeiro Arcade
Advmenu: Frontend para Mame e outros emuladores.
Download Advance Mame 1.2
Download Advance Menu 2.6
1 . Descompacte o advmame num diretorio c:\advmame
2 .Descompacte o advmenu no mesmo diretrio... ira dizer que j
existe alguns arquivos... Clique em substituir tudo... Isso faz
com que o front-end j configure o advmame. Duplo clique no
advmame.exe... ele ir criar o advmame.rc, que iremos configurar
+ tarde...
> > de resto s colocar as roms no diretrio de roms...
> > colocar os filminhos das roms no diretrio snaps... E assim por diante... > >
pra rodar as roms de todas as plataformas, voc precisar das bios. (Colocar no
mesmo diretrio das roms)
3- > > duplo clique no advmenu.exe > > ele ir
criar o advmenu.rc que vamos configurar a diante...
Para abrir o advmenu e o advmame na tela inteira.
Dentro do advmenu.rc troque: device_video_output auto por:
device_video_output fullscreen
Fazer o mesmo no advmame.rc
Pronto, o bsico da sua Multi Jogos com advmame e advmenu esta
Pronta... Execute o advmenu.exe para iniciar... E seja feliz
Opcionais
Mensagens que aparecem no incio da emulao
Para no mostrar as mensagens de direitos autorais troca-se a opo:
misc_quiet no por: misc_quiet yes no
advmame.rc
Mesmo assim ainda vai ter jogo que ir mostrar certas menssagens avisando que
a rom no est 100%, etc.... Nesse caso pode ser usado um script dentro do
advmame.rc, o script ir simular um "OK" e com isso a mensagem fechada. No
exemplo abaixo est sendo simulado 2 "OK", essa simulao ocorre justamente
na hora que mostrado a mensagem:
Cdigo: script_video delay(50); simulate_key(key_o,50); delay(50);
simulate_key(key_k,50); delay(50); simulate_key(key_o,50); delay(50);
simulate_key(key_k,50);

Ativar o joystick no advmenu


Para ativar o joystick vc pode colocar a opo abaixo dentro do advmenu.rc:
OBS:Ele no configurvel...
Troque:device_joystick none
Por: device_joystick sdl
Colocar os mng (vdeos das roms) em outros emuladores
No advmenu.rc
Troque: mode_skip Por: mode_skip full_mixed e
indicar o diretrio das snaps.
Ex: c:\Arcade\mame\snap
Sons
No advmenu convencional ( sem mudanas ) as opes que voc
pode configurar para colocar sons so: Cdigo:
sound_foreground_begin none | default | FILE sound_foreground_end none |
default | FILE sound_foreground_key none | default | FILE
sound_foreground_start none | default | FILE sound_foreground_stop none |
default | FILE
Por exemplo: sound_foreground_start MeuArquivoDeSom.mp3 Esse som ser
tocado quando um jogo for selecionado para carregar. Aqui a lista
completa dos sons.
#CONFIGURAES DE SOM PARA OS BOTOES E AFINS
#SE DESEJAR USAR SONS PARA ESSES EVENTOS S DELETAR AS
LINHAS ABAIXO
#PARA COLOCAR SOM PERSONALIZADOS S INFORMAR ONDE ELES SE
ENCONTRAM
#*******************************************************************
sound_foreground_begin none sound_foreground_end none
sound_foreground_key
".utillista.wav" sound_foreground_start ".utilcarrega.wav"
sound_foreground_stop none sound_background_begin ".UTILTRACK60.MP3"
sound_background_end none sound_background_start none
sound_background_stop none sound_background_loop none Aparncia
#aqui toda a configurao da aparencia do menu, altere a seu
gosto.
ui_font .utilcomics.ttf ui_fontsize 36
ui_background .utilFUNDO.png ui_startup
.utilabertura.mng ui_clip singleloop ui_color
help 000000 ffffff ui_color help_tag 247ef0
ffffff ui_color submenu_bar 247ef0 ffffff
ui_color submenu_item 000000 ffffff ui_color
submenu_item_select 000000 bfffff ui_color
menu_item ffffff 008000 ui_color menu_hidden
008000 008000 ui_color menu_tag ffffff 008000
ui_color menu_item_select ffffff 000080
ui_color menu_hidden_select 008000 000080
ui_color menu_tag_select ffffff 000080 ui_color
bar ffffff 0000ff ui_color bar_tag ffffff
0000ff ui_color bar_hidden 000000 0000ff
ui_color backdrop 000000 808080 ui_color icon
ffffff ffffff ui_color cursor 808080 ffffff

ui_skipbottom 0 ui_skipleft 2 ui_skipright 2


ui_skiptop 14
Fonte da lista de games
Coloque um nmero no lugar de auto. Ex:Troque:ui_fontsize
auto Por:ui_fontsize 30
OBS:Quanto menor o nmero, maior fica a fonte e vice-versa
Inserindo mais emuladores
O AdvancedMenu tem suporte para vrios emuladores ao mesmo tempo, por
exemplo voc pode ter jogos de fliperama, super Nintendo, megadrive, etc....
todos funcionando juntos. Para alternar entre eles basta pressionar F6. Para
definir mais emuladores faa o seguinte:
emulator "EMUNAME" "EMULADOR" "EXECUTABLE" "ARGUMENTS"
onde:
"EMUNAME" pode ser qualquer texto que voc deseje (p.ex "Megadrive")
"EMULATOR" deve ser de um destes tipos: (advmame | advmess | mame |
dmame | dmess | raine), se o emulador que vc quer rodar no est na lista defina
como generic.
"EXECUTABLE" o diretrio onde est o executvel do emulador (p.ex
"c:/emu/megadrive")
"ARGUMENTS" alguns emuladores necessitam de parmetros para rodar, podem
ser usados substitutivos como:
%s - substitudo pelo nome do jogo, "simpsons" por exemplo. %p - substituido
pelo diretrio do jogo, "c:/emu/mame/simpsons/". %f - substitudo pelo nome do
arquivo com a extenso, "simpsons.zip" por exemplo
Defina tambm o diretrio das roms:
emulator_roms "Name" "LIST"
"Name" o mesmo nome definido em "EMUNAME"
"LIST" diretrio que contm as roms
Finalmente defina o diretrio das imagens (previews):
emulator_altss "Name" "LIST "Name" o mesmo nome definido em "EMUNAME"
"LIST" diretrio que contm as imagens Exemplos:
#emulador mame
#***********************************************
emulator "ARCADE" generic ".mamemame32fxpp.exe" "%s" emulator_roms
"ARCADE" "..jogosoutros" emulator_altss
"ARCADE" "..snaparcade;..mng"
#***********************************************
#emulador neomame
#***********************************************
emulator "NEOGEO" generic ".mamemame32fxpp.exe" "%s -ctrlr neogeo1"
emulator_roms "NEOGEO" "..jogos eogeo" emulator_altss "NEOGEO"
"..snaparcade;..mng"
#***********************************************
#emulador cpmame
#***********************************************
emulator "CAPCOM" generic ".mamemame32fxpp.exe" "%s" emulator_roms
"CAPCOM" "..jogoscapcom" emulator_altss
"CAPCOM" "..snaparcade;..mng"
#***********************************************
#emulador zinc
#*********************************************** emulator "ZINC3D" generic
".zinczinc3d.exe" "%s" emulator_roms "ZINC3D"

"..jogoszinc10" emulator_altss
"ZINC3D" "..snapzinc10;..mng"
#***********************************************
#emulador model2
#*********************************************** emulator
"MODEL2" generic ".model2model2.exe" "%s" emulator_roms
"MODEL2" "..jogosmodel2" emulator_altss
"MODEL2" "..snapmodel2;..mng"
#***********************************************
#emulador cps3
#*********************************************** emulator
"CPS3" generic ".CPS3cps3.exe" "%s"
emulator_roms "CPS3" "..jogoscps3" emulator_altss
"CPS3" "..snaparcade;..mng"
#***********************************************
#emulador mame92 para killer instinct
#*********************************************** emulator
"KILLER" generic ".killermameat.exe" "%s" emulator_roms
"KILLER" "..jogoskiller" emulator_altss
"KILLER" "..snaparcade;..mng"
#***********************************************
#************************** AQUI COMEA A SECESSO DE VIDEO GAMES
******************************
#emulador gameboy
#***********************************************
emulator "GAMEBOY" generic ".GameBoyGameBoy.exe" "%p" emulator_roms
"GAMEBOY" "..jogosGameBoy" emulator_altss
"GAMEBOY" "..snapGameBoy"
#***********************************************
#emulador megadrive
#***********************************************
emulator "MEGADRIVE" generic ".Megahazemd32.exe" "%s" emulator_roms
"MEGADRIVE" "..jogosMega" emulator_altss
"MEGADRIVE" "..snapMega"
#***********************************************
#emulador SUPER NINTENDO
#***********************************************
emulator "SUPERNES" generic "._sneswzsnesw.exe" "%p" emulator_roms
"SUPERNES" "..jogosRomsSnes"
emulator_altss "SUPERNES" "..snapSuperNes"
#***********************************************
#emulador NINTENDO 64
#*********************************************** emulator
"N64" generic ".N64N64.exe" "%s" emulator_roms
"N64" "..jogosRomN64" emulator_altss "N64"
"..snapN64"
#***********************************************
#emulador PLAYSTATION
#***********************************************
emulator "PSX" generic ".PSX13VBPSX.exe" "%s" emulator_roms
"PSX" "..jogosRomPSX" emulator_altss
"PSX" "..snapPSX" emulator_roms_filter "PSX"
"*.mds;*.img;*.cue;*.cdz"
#***********************************************
#JOGOS DE PC

#***********************************************
emulator "PCGAME" generic ".PCGAMEPCGAME.exe" "%s" emulator_roms
"PCGAME" "..jogosPCGAME" emulator_altss
"PCGAME" "..snapPCGAME"
#***********************************************
Mame: emulator "Arcade" mame "c:/jogos/emu/mame/mame.exe" emulator_roms
"Arcade" "c:/jogos/emu/mame/roms/" emulador cps3 emulator "CPS3"
generic ".CPS3cps3.exe" "%s" emulator_roms
"CPS3" "..jogoscps3" emulator_altss
"CPS3" "..snaparcade;..mng" Zinc emulator
"ZINC3D" generic ".zinczinc3d.exe" "%s" emulator_roms "ZINC3D"
"..jogoszinc10" emulator_altss "ZINC3D" "..snapzinc10;..mng" Atari 2600:
emulator "Atari 2600" generic "c:/jogos/emu/stella/stella.exe" "%p"
emulator_roms "Atari 2600" "c:/jogos/emu/stella/roms" emulator_altss
"Atari 2600" "c:/jogos/emu/stella/snaps" Nintendinho emulator "Nintendo 8
bits" generic "c:/jogos/emu/VirtuaNESVirtuaNES.exe"
"%p"
emulator_roms "Nintendo 8 bits" "c:/jogos/emu/VirtuaNES/roms"
emulator_altss "Nintendo 8 bits" "c:/jogos/emu/VirtuaNES/snapshot"
Nintendo 64 emulator "Nintendo 64" generic
"c:/jogos/emu/pj64project64.exe" "%p" emulator_roms "Nintendo 64"
"c:/jogos/emu/pj64/roms" emulator_altss "Nintendo 64"
"c:/jogos/emu/pj64/snaps" Super Nintendo emulator "Super Nintendo" generic
"c:/jogos/emu/zsnes/zsnesw.exe" "%p" emulator_roms "Super Nintendo"
"c:/jogos/emu/zsnes/roms" emulator_altss "Super Nintendo"
"c:/jogos/emu/zsnes/snaps" Mega Drive: emulator "Mega
Drive" generic "c:/jogos/emu/gens/gens.exe" "%p" emulator_roms "Mega
Drive" "c:/jogos/emu/gens/roms" emulator_altss "Mega Drive"
"c:/jogos/emu/gens/snaps" Essa a
configurao abaixo a que eu uso, o basico usar a opo "sort
emulator" com isso a lista s ir conter os nomes do emulador escolhido
usando o "F6", para maiores informaes consulte tambm o arquivo de
ajuda do "advmenu". Cdigo: device_joystick sdl device_video sdl
device_video_interlace no device_video_output fullscreen display_size 1024 No
advmenu.rc
Coloque um pequeno vdeo de introduo para que aparea quando sua Multi
jogos iniciar. TROQUE:ui_startup none POR:ui_startup intro.mng
Coloque o seu vdeo na pasta do advmenu com o nome intro.mng quando o
jogo for iniciado mensagem que ser mostrada no carregamento do jogo
ui_gamemsg "CARREGANDO O JOGO, POR FAVOR AGUARDE..."
TROQUE A OPO: display_restoreatgame yes PARA: display_restoreatgame no
PARA SER MOSTRADO A IMAGEM do jogo ENQUANTO O GAME
CARREGADO
Adio de novos Video
OBS: Para colocar os vdeos das novas roms faa o seguinte:
1: Coloque o jogo pra rodar
2: Quando ele estiver emulando o jogo aperte Ctrl + Enter ir comear gravar o
vdeo
3: Espere uns 12 a 13 segundos e aperte Enter para finalizar o vdeo
Adio de Script pra sai do jogo segurando o Start 2 ou +

Esquema 2 start abra o advance mame rc e ache essa linha de comando


script_start1 se quiser deixa com 1 ou 2 entenda o codigo.
script_start2 se quiser deixa com dois boto de saida copie o codigo
script_start3 se quiser deixa com tres boto de saida copie o codigo
script_start4 se quiser deixa com tres boto de saida copie o codigo
script_start1 delay(3000);if(event(start1)){simulate_event(ui_ca ncel,100);} nessa
linha de comando o est programado para sai com um start1 segurando o boto
por 3 segundo certo.
explicao da linha de comando
Delay=segundo (3000) 3 seg
if=verdadeiro
event= evento ocorrido
ui_cancel= linha de saida onde geramente o esc est programada para volta no
menu.
simulate event=simulado um event, que no caso estaria simulador a tecla esc.
100= codigo hexadecimal numerico da tecla esc
Bem para fazer com 2 start s deixa assim
script_start1 delay(3000);if(event(start2)){simulate_event(ui_ca ncel,100);}
Existe tambm uma outra forma bem simples que ja conhecia
abra o mame ou advance mame selecione o jogo e aperte a tecla tab e vai em
imput general/user interface= e l vai mostra a configurao de todas tecla funo,
e ache a linha ui-cancel e troque a tecla esc assim na hora de aperta enter aperte
os 2 start ao mesmo tempo e pronto. assim quando quiser volta ao menu e s
aperta os 2 start s que no tem segundo.
Tutorial Advmenu (Avanado)
2 Description
AdvanceMENU um front-end para ser usado com AdvanceMAME,
AdvanceMESS,
MAME,
MESS, xmame, Raine e outros

emuladores.
Simplemente abra ele no mesmo diretorio do emuladore pressione `f1' para ver a
janela de help
ou `~' para acessar o menu
menu de opes.
Pressione `tab' para modificar o formato da lista. Pressione `space' para modificar
o
tipo de
imagem que mostrada.
Para chamar um jogo pressione `enter'. Pressione `esc' para sair.
As maiores vantagens so:
l Simplesmente carregue e jogue. Copie o executvel e jogue!
l Atualizao automatica das informaes dos jogos.
l Orientao Vertical e horizontal da tela.
l Suporta para qualquer TV/Arcade Monitor com AdvanceMAME mas tambm
muito
bom
para um monitor de PC.
l Mostra imagens Staticas e Animadas (PNG/PCX/ICO/MNG). possivel mostrar
at
192
imagens ao mesmo tempo!
l Efeitos sonoros do tipo.(MP3/WAV). Voc pode adicionar um sons para varios
eventos, por
exemplo: enquanto percorre
um item na lista.
l Sons de fundo(MP3/WAV). Permite tocar musicas continuamente enquanto voc
seleciona um
game.
l Efeitos de sons (MP3/WAV) para um pressionamento de tecla, inicio de um
programa,
inico
de jogo , finalizao de um
jogo ou menu...
l Suporta para arquivos zipados: imagens e sons.
l Screen-saver. Um slide das imagens dos games ou videos mng.
l Permite adicionar uma imagem de fundo com efeitos de transparencia.
Essas so as sesses disponiveis nesse documento:
3 Options
-default
Adiciona todas as opes padres que estiverem faltando com seus valores
padres
para o
advmenu.rc
-remove
Remove todas as opes que so padro do advmenu.rc, deixando esse arquivo
mais
legivel (
leve ).
-cfg FILE
Seleciona um arquivo de configurao alternativo. No Linux e Mac OS X, voc
pode
prefixar o

nome do arquivo com "./" para


carregar ele a partir do diretrio corrente.
-log
Cria 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
diretrios.
-help
Mostra uma pequena ajuda sobre as linhas de comandos suportados.
No Linux e Mac OS X voc pode usar um `--' antes das opes, no DOS um `-'. e
no
Windows
voc pode usar `/'.
4 Emulators
O advmenu suporta muitos tipos de emuladores. Os emuladores AdvanceMAME,
AdvanceMESS, MAME, xmame, DMAME,
DMESS e DRAINE tem suporte interno, sendo que para usar um desses s
preciso
colocar o
AdvanceMENU no mesmo
diretrio onde se encontra o emulador.
Todos os outros emuladores so suportados com a opo `generic'.
4.1 generic - Generic emulator
Para emuladores que usam a opo 'generic', no necessrio um arquivo XML
que
contenha
todas as informaes, preciso
apenas um arquivo com a exteno '.lst' que contenha as seguintes informaes:
game ( name NomeDaRom description "Nome do Jogo" manufacturer
"Fabricante" year
"Ano" cloneof "RomPai" )
qualquer outra informao descartada, e ainda nesse arquivo as unicas
informaes
obrigatrias so 'game', 'name',
'description', as outras so opcionais.
Um exemplo do conteudo de um arquivo '.lst' :
game ( name sfa2 description "Street Fighter Alpha 2 (USA
960306)"
manufacturer
"Capcom" year 1996 )
game ( name sfz2j description "Street Fighter Zero 2 (Japan
960227)"
manufacturer
"Capcom" year 1996 cloneof sfa2)

game ( name sfz2a description "Street Fighter Zero 2 (Asia


960227)"
manufacturer
"Capcom" year 1996 cloneof sfa2)
game ( name sfz2b description "Street Fighter Zero 2 (Brazil
960531)"
manufacturer
"Capcom" year 1996 cloneof sfa2)
Voc deve especificar todas as informaes e diretrios com as opes 'emulator'
ou
'emulator_*' no advmenu.rc.
Para adicionar um emulador que no seja suportado internamente pelo advmenu,

necessrio
pelo menos o uso dessas 2 opes
`emulator' e `emulator_roms' essas opes informo ao advanceMENU como ele
ir
chamar o
emulador e onde e como ele ir
reconhecer as roms.
Por exemplo:
emulator "snes9x" generic "c:\game\snes9x\snes9x.exe" "%f"
emulator_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
forma como
o advanceMENU ir passar para
o emulador o nome da rom a ser carregada.
Representao das Macros:
%s Passa para o emulador somente o nome da rom. Porexemplo
"pacman".
%f Passa para o emulador o nome da rom com a exteno. Por
examplo
"pacman.zip".
%p Passa para o emulador o caminho completo da rom.Por examplo
"c:\emu\roms\pacman.
zip".
As roms so procuradas atravz da opo 'emulator_roms' Para cada rom
encontrada

adicionado um novo item (nome) no


menu. Para que o advanceMENU ignore determinadas extenes, voc pode usar
a
opo
`emulator_roms_filter', com isso s
as roms que tiverem as extenes informadas nessa opo sero adicionadas no
menu.
As imagens ou videos so procuradas no diretrio especificado na opo
'emulator_altss', e
devem ter o mesmo nome das roms.

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 automaticamente usando a linha de comando 'advmame
-listxml'
Os diretrios especificados no 'advmame.rc', usado paralocalizar as roms. No
'DOS'
e
'Windows' o arquivo 'advmame.rc'
procurado no mesmo diretrio onde se encontra o 'advmame.exe', no Linux o
advanceMEMU
ir procurar esse arquivo no
diretrio `HOME/.advance'.
O diretrio especificado na opo 'dir_snap' do 'advmame.rc' usado para
localizar as
imagens
e os videos.
4.3 advmess - AdvanceMESS
Para o emulador `advmess' as informaes das roms so retiradas do arquivo
`advmess.xml'. Se
o arquivo no existir ele ser
criado automaticamente com a linha de comando `advmess -listxml'.
Os diretrios especificados na opo 'dir_rom' do arquivo `advmess.rc' so usados
para detectar
a lista de bios.
Todos os diretrios listados na opo `dir_image' so lidos e todos os arquivos
encontrados 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\ti99_4a', `c:\software
\sms', `c:\software\gameboy'... Os arquivos que estiveremdentro do diretrio raiz
de
`c:\software' no sero checados.
Quando voc seleciona um arquivo 'zip' ele aberto e todos os arquivos contidos
nesse 'zip' que
forem vlidos e que tenham
uma exeteno de arquivo conhecida, so adicionado para a linha de comando do
AdvanceMESS. Um arquivo considerado
como um nome vlido caso tenha o mesmo nome do arquivo'zip' ou caso tenha o
mesmo nome
com um caracter adicional. Por
exemplo se dentro do arquivo `alpiner.zip' conter os arquivos `alpiner.bin',
`alpinerc.bin'

e
`alpinerg.bin' ele considerado um
nome vlido. Esta caracteristica pode ser usada para agrupar todos as roms
requeridas para
rodar os jogos em um unico arquivo
'zip'.
A exteno dos arquivos so usadas para selecionar o dispositivo correto quando
o
advanceMENU for chamar o emulador
advanceMESS.
O diretrio especificado na opo `dir_snap' usado para localizar as imagens
dos
jogos que
sero exibidas. Quando o
AdvanceMESS fechado o advanceMENU ir verificar se foicriado algum novo
snapshot
(imagem) e em caso positivo esse
arquivo ser 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
pressionar a tecla 'F12' durante a
emulao, o arquivo `snap\ti99_4a.png' ser criado. E quando voc retornar para o
AdvanceMENU o arquivo ser movido
automaticamente para o diretrio `snap\ti99_4a\alpiner.png'.
4.4 mame - Windows MAME
Para o emulador 'mame' as informaes sobre as roms so retiradas atravz do
arquivo
'mame.xml', se o arquivo no existir ele
ser automaticamente criado usando a linha de comando 'mame -listxml'.
Os diretrios especificados na opo 'rompath' do arquivo 'mame.ini' ser usado
localizar as
roms.
O diretrio especificado na opo 'snap_directory' ser usado para localizar 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 ser
criado automaticamente usando a linha de comando 'xmame-listxml'.
Os diretrios espeficficados na opo 'rompath' no arquivo
`HOME/.xmame/mamerc'
ser
usado para localizar as roms.
O diretrio especificado na opo 'screenshotdir' ser usado para localizar as
imagens
dos
jogos.

4.6 dmame - DOS MAME


Para o emulador 'dmame' as informaes das roms seroextraidas do arquivo
'dmame.xml', se
este arquivo no existir ele ser
criado automaticamente usando a linha de comando 'xmame-listxml'.
Os diretrios espeficficados na opo 'rompath' no arquivo `mame.cfg' ser usado
para
localizar
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 comando 'dmess -listxml'.
Os diretrios especificados na opo`biospath' no arquivo `mess.cfg' so usados
para
localizar
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
diretrios
`c:\software\ti99_4a', `c:\software
\sms', `c:\software\gameboy'... Observao: Arquivos que estiverem no diretrio
raiz
'c:\software' no sero usados.
Quan voc seleciona uma destas entradas o arquivo 'zip'e aberto e ento
procurado
o primeiro
arquivo com o mesmo nome
que o arquivo 'zip' porem com exetenes diferentes. Estes arquivos so usados
como
argumento para a opo '-cart' quando o
dmess for chamado. Observao: O AdvanceMENU no tem suporte para usar
outras
opes
como por exemplo `-flop'.
Todos os pseudnimos presentes no arquivo 'mess.cfg' so inseridos como
entradas
de
software. Quando voc seleciona uma
destas entradas em 'mess' a opo `-alias' usada para inicializar o jogo.
Voc pode atribuir uma descrio arbitraria dentro de uma espeficicao de 'alias'
adicionando
isso dentro da mesma linha do
'alias' antes do caracter de comentrio '#' o formato a ser usado esse:
ALIAS = ALIAS_DEF # Description | YEAR | MANUFACTURER
Por exemplo:

[ti99_4a]
ti-inva = -cart ti-invac.bin -cart ti-invag.bin \
# Invaders | 1982 | Texas Instrument
Quando se sai do emulador, o advanceMENU verifica se foicriado um novo
snapshot
(imagem
), caso tenha essa imagem ser
movida para o diretrio `snap\system'.
Por exemplo, vamos supor que voc chame um jogo do sistema `ti99_4a' com o
software
`alpiner'. Se voc pressionar a tecla
'F12'durante a emulao, o arquivo 'snap\ti99_4a.png'ser criado.Ento qundo
voc
retornar
para o AdvanceMENU o arquivo
ser movido automaticament para 'snap\ti99_4a\alpiner.png'.
4.8 draine - DOS Raine
Para o emulador `draine' as informaes sobre as roms soretiradas do arquivo
`draine.lst'.Se
esse arquivo no existir ele ser
criado automaticamente usando a linha de comando `draine -gameinfo'.
Todos os diretrios especificados na opo `rom_dir_*' sero usados para localizar
as
roms.
O diretrio especificado na opo `screenshots' ser usado para localizar os
snapshots (imagem
) dos jogos.
5 Configuration
O arquivo `advmenu.rc' usado para salvar as configuraes correntes do frontend.
Ele
verificado a cada vez que o que o
programa executado e salvo a cada saida. Mas isso pode ser alterado usandose as
opes
disponiveis que sero apresentadas.
No 'DOS' e 'Windows' as opes de configuraes so carregadas a partir do
arquivo
`advmenu.rc' no mesmo diretrio onde se
encontra o 'advanceMENU'.
No 'Linux' e 'Mac OS X' as configuraes so carregadas a partir do arquivo
`advmame.rc' e
`advmess.rc' nos diretrios $host,
$data eo $home. O $host diretrio `$SYSCONFDIR', onde o $SYSCONFDIR o
diretrio
`sysconfdir' configurado com o
script 'configure'. O padro `/usr/local/etc'. O diretrio $data
`$DATADIR/advance',
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 ambiente no for
encontrada o diretrio '$home' ser `$HOME/.advance' onde $HOME o valor da
vriavel de
ambiente HOME. Se as duas
vriaveis no forem localizadas ento o diretrio '$data' se tornar o diretrio
$home.
A prioridade dessas opes esto na seguinte ordem: $host, $home and $data.
O diretrio $home tanm usado para gravar todos as informaes pelo
programa. Os
arquivos
dentro dos diretrios $host e
$data so somente para leitura.
Voc pode inckuir arquivos de configuraes adicionais coma opo `include' . No
'DOS' e no
'Windows' os arquivos so
pesquisados no diretrio corrente. No 'Linux' e no 'Mac OS X' so pesquisados no
disretrio
$home, se se eles so expressados
como um caminho relativo. Voc pode forar a procura no diretrio corrente
prefixando
o
arquivo com um './'. Para incluir mais
que um arquivo voc pode dividir os nomes com um ';' seestiver 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 opes
padres usando
a opo de linha de comando 'default'.
No 'DOS' ou 'Windows' usado uma '\' para separar os nome de diretrios e o ';'
para
separar
multiplos diretrios. No 'Linux ' e
'Mac OS X' os nomes de diretrios so separados usando '/' e multiplos diretrios
com
o ':'.
5.1 Global Configuration Options
Essa sesso descreve as opes globais usadas para personalizar o programa.
Um conjunto de opoes de configurao so salvas para cada emulador
permitindo
assim que
se tenha diferentes configuraes
para diferentes emuladores. Observao: Esse conjunto de configuraes no
estar
disponivel
caso seja selecionado mais que
um emulador ao mesmo tempo. Neste caso somente as configuraes padres
sero
usadas.

Principalmente estas opes em


especiais `mode', `sort',`preview', `group_include' and `type_include'.
5.1.1 config
Seleciona a forma como as configuraes sero salvas, conforme o usuario for
modificando as
opes enquando o programa
estiver em uso.
config save_at_exit | restore_at_exit | restore_at_idle
Options:
save_at_exit Salva todas as modificao antes de sair ( esse o valorpadro).
restore_at_exit No salva as modificaes. Na proxima vez que o programafor
executado os
valores anteriores sero
restaurados.
restore_at_idle Restaura as modificaes, assim que o programa ficar um tempo
ocioso (screen
saver)
Voc pode salvar as configuraes manualmente quando o programa est
rodando,
acessando o
'menu principal'.
5.1.2 emulator
Seleciona uma lista de emuladores no menu. Voc pode especificar mais que um
emulador.
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 emulador removido so perdidas.
emulator "EMULATOR" (generic | advmame | advmess | mame | dmame
| dmess | draine) "[-]EXECUTABLE" "ARGUMENTS"
Options:
EMULATOR O nome para o emulador. Os nomes devem ser diferentespara cada
emulador
adicionado.
generic Essa opo informa ao advanceMENU que ser usado um emulador que
ele
no tem
um suporte nativo.
Por exemplo: para adicionar o emulador 'zinc.exe', necessario o uso dessa
opo.
advmame Este o emuldor AdvanceMAME.
advmess Este o emulador AdvanceMESS.
mame Este o emulador MAME verso 'Windows'.
dmame Este o emulador MAME verso 'DOS'.
dmess Este o emulador MESS verso 'DOS'.
draine Este o emulador Raine verso 'DOS'.
[-]
EXECUTABLE
Essa a opo onde devemos informar o caminho (path) e o nome do arquivo
executvel '.exe'.
No
'DOS' e no 'Windows' pode ser usado um arquivo de lote'.bat' porm o

advanceMENU
no ter
como
gerar os arquivos '.xml' que contm as informaoes sobre as roms, esse arquivo
ter
que ser
criado
manualmente. Voc pode usar um sinal '-' nessa opo, para ignorar qualquer tipo
de
erro
retornado pelo
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 advanceMENU
automaticamente
adiciona os
argumentos necessarios. A menos que voc precise adicionarum argumento extra.
Na opo 'arguments' varias 'macros' so subistituidas porvrios valores especiais
(pr
definidos) que so:
%s Somente o nome da rom sem a exteno. 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 "pacman.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
opes o emulador AdvanceMAME ser corretamente rotacionado.
Para o tipo emulator 'generic', voc precisa usar uma das macros '%s, %f, %p',
para
informar ao
emulador o nome do jogo
selecionado, para os outros, o advanceMENU automaticamente adiciona essa
macro.
Exemplos para os sistemas DOS e Windows:
emulator "AdvanceMAME" advmame "advmame\advmame.exe" \
"%o[,-ror,-flipx,-rol] %o[,,-flipy,]"
emulator "MAME" mame "mame\mame.exe" "-nohws"
emulator "MESS" dmess "mess\mess.exe" ""
emulator "Raine" draine "raine\raine.exe" ""
emulator "Custom Raine" draine "raine\raine2.bat" ""
emulator "SNes9x" generic "c:\game\snes9x\snes9x.exe" "%f"
emulator "ZSNes" generic "c:\game\zsnes\zsnes.exe" "-e -m
roms\%f"
Exemplos para os sistemas Linux e Mac OS X:

emulator "AdvanceMAME" advmame "advmame" \


"%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
serem usados na pesquisas de roms,
snaps, sounds, etc... que no esto listados dentro dos arquivos de configurao
dos
emuladores.
emulator_roms "EMULATOR" "LIST"
emulator_roms_filter "EMULATOR" "LIST"
emulator_altss "EMULATOR" "LIST"
emulator_flyers "EMULATOR" "LIST"
emulator_cabinets "EMULATOR" "LIST"
emulator_marquees "EMULATOR" "LIST"
emulator_icons "EMULATOR" "LIST"
emulator_titles "EMULATOR" "LIST"
Commands:
roms Lista de diretrios usados para as roms. Est opo usada somente
quando se
usa a
palavra 'generic'. Para
todos os outros emuladores, so usados as configuraes existentes nos arquivos
de
configurao dos
emuladores.
roms_filter Lista de extenes que o advanceMAME deva considerar como
vlidas,
caso essa
opo no seja informada
todos os arquivos presentes na opo 'emulator_roms', sero adicionados na lista
do
menu.
file:///D|/ARCADE_DVD/doc/advmenu.html (10 of 33)2/24/2008 2:13:59 PM
AdvanceMENU Frontend
altss Lista de diretrios onde se encontram os screenshots (imagens), videos
(mng),
sons. Caso
essa opo esteja
em branco o advanceMENU ir tentar localizar essas imagens atravz dos
diretrios
listados
nos arquivos de
configurao dos emuladores.
flyers Flyers diretrios.
cabinets Cabinets diretrios.
marquees Marquees diretrios.
icons Icons diretrios.
titles Titles diretrios.
Options:

"EMULATOR" O nome para o emulador adicionado. Este nome deve sero mesmo
usado na
definio do emulador, por
exemplo [advmame, dmame, mame, etc..], Quanto se usa apalavra 'generic', voc
pode atribuir
qualquer
nome que desejar, por exemplo:[ emulator "Jogos3D" generic "zinc.exe" "%s" ].
LIST Lista de diretrios ou extenes de arquivos. No DOS ou Windows 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:\game\zsnes\roms2"
emulator_roms_filter "SNes9x" "*.smc;*.sfc;*.fig;*.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 full | full_mixed | text | list | list_mixed |
tile_small
| tile_normal | tile_big | tile_enormous | tile_giant
| tile_icon | tile_marquee
Options:
EMULATOR/ Se for usar um emulador padro essa opo no necessaria. E
caso
use um
emulador com a opo
'generic', ento essa opo pode ser usada para atribuiro valor ao emulador
especifico.
full mostrado somente uma imagem em tela cheia.
full_mixed 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 mostrado a lista de jogos e mais 4 imagens do jogo selecionado.
tile_small Mostra 12 imagens de uma s vez, sendo 4 na horizontalpor 3 na
vertical.
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 Mostra 108 imagens, sendo 12 na horizontal e 9 na vertical.
tile_giant Mostra 112 imagens, 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 formato de titulos.
5.1.5 sort
Seleciona como a lista de jogos ser organizada.
[EMULATOR/]sort parent | name | time | play | year |
manufacturer
| type | group | size | resolution | info
Options:

EMULATOR/ Se for usar um emulador padro essa opo no necessaria. E


caso
use um
emulador com a opo
'generic', ento essa opo pode ser usada para atribuiro valor ao emulador
especifico.
parent Organiza a lista agrupando os jogos pelo parentesco.
emulator Organiza a lista de jogos pelo nome do emulador.
name Organiza a lista 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 base os que foram jogados mais
vezes.
timeperplay Organiza a lista de jogos usando como base os que foram jogados por
mais temo e
mais vezes. Time per
play.
year Organiza a lista de jogos usando como base o ano de lanamento do jogo.
manufacturer Organiza a lista de jogos usando como base o nome da empresa
desenvolvedora
do jogo.
type Organiza a lista de jogos usando como base o tipo atribuido ao jogo, por
exemplo
'ao',
'aventura', 'tiro',
etc...
group Organiza a lista de jogos usando como base o grupo a que pertence, por
exemplo
'Favoritos', 'Adultos',
etc...
size Organiza a lista de jogos usando como base o tamanho darom.
resolution Organiza a lista de jogos usando como base a resoluo do jogo, por
exemplo
'320x240', '304x224', etc...
info Organiza a lista de jogos usando um arquivo externo que contm informaes
que
so
importadas com a
opo 'info_import'.
5.1.6 preview
Seleciona o tipo de imagens a serem mostradas.
[EMULATOR/]preview snap | titles | flyers | cabinets
Options:
EMULATOR/ Se for usar um emulador padro essa opo no necessaria. E
caso
use um
emulador com a opo
'generic', ento essa opo pode ser usada para atribuiro valor ao emulador
especifico.
snap Os arquivos contidos nas opes `snap' e ou `altss'.
flyers 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
das opoes `tile_icon' e
`tile_marquee'.
5.1.7 mode_skip
Desabilita varios modos no menu principal, quando acessadopela tecla 'tab'.
mode_skip (full | full_mixed | list | list_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 vazia 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 verticais e
horizontais preencham rea
disponivel para a imagem por completo.
preview_expand FACTOR
Options:
FACTOR O fator de expanso de ponto flutuante que vai de 1.0 at 3.0 (esse o
valor padro
1.15)
Exemplos:
preview_expand 1.15
5.1.9 preview_default_*
Seleciona uma imagem padro que ser mostrada, para osjogos que no tenham
uma imagem
(snapshots).
preview_default "FILE"
preview_default_snap "FILE"
preview_default_flyer "FILE"
preview_default_cabinet "FILE"
preview_default_icon "FILE"
preview_default_marquee "FILE"
preview_default_title "FILE"
Commands:
default Seleciona uma imagem padro para todas as opes que nopossuem
uma
imagem
definida.
default_TAG Seleciona a imagem padro para a opo 'preview mode'.
Options:

FILE O caminho completo onde se encontra a imagem a ser usada.


Exemplos:
preview_default "C:\MAME\DEFAULT.PNG"
preview_default_marquee "C:\MAME\DEFMAR.PNG"
preview_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
`emulator_icons' existir no arquivo
de configurao do emulador.
icon_space SPACE
Options:
SPACE O numero de pixel entre cada icons ( o valor padro 43 ).
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 para
testar se os
arquivos 'zips' contm todos os
arquivos necessrios para rodar o jogo.
merge none | differential | parent | any | disable
Options:
none Cada rom clone contm todos os arquivos necessarios para rodar.
differential Cada rom clone contm somente os arquivos os arquivos que lhe
pertencem, e para
rodar necessario que a
rom "principal" esteja no mesmo diretrio. Esse o valor padro que o
advanceMENU
usa.
parent Todas as roms ( principal e clones ) esto em um unico arquivo.
file:///D|/ARCADE_DVD/doc/advmenu.html (14 of 33)2/24/2008 2:13:59 PM
AdvanceMENU Frontend
any As roms podem estar em qualquer um dos formatos j mencionados. Somente
use essa
opo caso suas roms
estejam desorganizadas, o tempo de pesquisa 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'
adicionada ou
modificada automaticamente no
advmenu.rc a cada vez que um novo game encontrado ou jogado, essa opo
usada para
manter algumas informaes uteis:

tempo jogado, quantas vezes foi jogado, etc...


game "EMULATOR/GAME" "GROUP" "TYPE" TIME PLAY "DESC"
Options:
EMULATOR O nome do emulador que essa rom pertence.
GAME O nome da rom ( arquivo zip, sem a exeteno ).
GROUP O nome do grupo que a roms pertence, ou vazio "".
TYPE O nome do tipo que a rom pertence, ou vazio ""
TIME O tempo que o jogo 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 valores importados das
opes
`group_import', `type_import' e
`desc_import'. Os valores importados s tem efeitos se os argumentos GROUP,
TYPE
e DESC
estiverem vazios.
Examples:
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 personalizar 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
ignoradas.
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 video.
display_size WIDTH
Options:
WIDTH Largura em pixel, o modo mais perto do informado ser usado. O valor
padro
dessa
opo 1024.
5.2.3 display_restoreatgame
Seleciona como o video deve se comportar quando um emulador executado.
[EMULATOR/]display_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.
display_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_orientation (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
Options:
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
Options:
FACTOR Gamma, numero de ponto flutuante ( valor padro 1.0)
Exemplos:
display_gamma 0.9
5.3 Sound Configuration Options
Essa sesso descreve como personalizar as opes de audio.
5.3.1 device_sound_*
Essas opes so para personalizar o drive de audio.
Todas as opes `device_sound_*' so definidas no arquivo`advdev.txt'.
5.3.2 sound_volume
Atribui o volume de audio geral.
sound_volume VOLUME
Options:
VOLUME A atenuao ( altura ) 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.

Exemplos:
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 at2.0. (o valor
padro
0.1)
Increase the value if your hear a choppy audio.
5.3.4 sound_buffer
Define o tempo em buffer que ser usado para alocar o audio.
sound_buffer TIME
Options:
TIME O tamanho do buffer estabelecido em segundos de 0.05at 2.0. (o valor
padro 0.1)
Aumente esse valor caso o audio apresente tremulaes.
5.3.5 sound_foreground_EVENT
Seleciona os sons que sero tocados em varios eventos.
sound_foreground_begin none | default | FILE
sound_foreground_end none | default | FILE
sound_foreground_key none | default | FILE
sound_foreground_start none | default | FILE
sound_foreground_stop none | default | FILE
Commands:
begin O som ser tocado toda vez que o advanceMENU for iniciado.
end O som ser tocado toda vez que o advanceMENU for encerrado.
start O som ser tocado toda vez que um jogo for chamado.
stop O som ser tocado assim que o emulador fechar.
key O som ser tocado a cada pressionamento de uma tecla.
Options:
none Sem som.
default Usa os sons padres do advanceMENU.
FILE O caminho completo onde se encontra o som desejado para oevento, os
sons
podem ser
nos formatos (.wav ou .
mp3).
5.3.6 sound_background_EVENT
Seleciona os sons que sero tocados ao fundo.
sound_background_begin none | FILE
sound_background_end none | FILE
sound_background_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 emulador carrega o jogo.
stop O som tocado enquanto o emulador est sendo fechado. Sound played at
emulator 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
suportados so
(.wav or .mp3).
5.3.7 sound_background_loop_dir
Seleciona um diretrio que contenha vrias msicas ou sons,que sero tocados
aleatriamnete
enquanto voc estiver no
advanceMENU os formatos suportados so ( .MP3 E .WAV )
Voc pode especificar multiplos diretrios, use um ';' casoesteja usando DOS ou
Windows, e
um `:' no Linux ou Mac OS X.
Note: esses diretrios sero usados somente para musicas, os sons e os videos
( mng
), devem
ficar no diretrio 'snap' ou no
diretrio especificado com a opo 'emulator_altss'.
sound_background_loop_dir "DIR"
Options:
DIR Diretrio para os arquivos de .mp3 ou .wav.
Exemplos:
sound_background_loop_dir C:\MP3\POP;C:\MP3\ROCK
5.4 Input Configuration Options
Esta sesso descreve as opes para pernonalizar o teclado ou joystick usados
para
acessar o
menu.
5.4.1 device_keyboard/joystick/mouse
Essas opes so usadas para personalizar drivers de entrada.
Todas as opes 'device_keyboard/joystick/mouse_*' que esto definidas no
arquivo
`advdev.txt' podem ser usadas.
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/trackball. Aumentando o valor o movimento ir
ficar mais

lento, e diminuindo o
movimento ser mais rpido.
mouse_delta STEP
Options:
STEP sensibilidade do Mouse/trackball (valor padro 100).
5.5 User Interface
Essa sesso descreve as opes usadas para personalizar a interface do menu.
5.5.1 ui_font
Seleciona um arquivo de fonte. os formatos suportados so'TrueType (TTF), GRX,
PSF 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 fonte 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 fonte especificada permitir ser
redimencionada. O
tamanho
expressado pelo numero de
linha e colunas de textos na tela.
ui_fontsize auto | ROWS [COLS]
Options:
auto Automticamente calcula o tamanho ( esse o valor padro).
ROWS O numero de linhas de texto.
COLS O numero de colunas de texto. Se essa opo for omitida ela ser calculada
automaticamente.
5.5.3 ui_background
Define uma imagem de fundo no formato .PNG ou MNG. A imagem informada ser
ampliada
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_exit
Define uma imagem ou video que ser exibido ao sair do advanceMENU os

formatos
suportados so .PNG ou .MNG.
ui_exit FILE | none
Options:
none Sem imagem ( esse o valor padro ).
FILE Arquivo no formato .PNG ou .MNG para ser exibido.
5.5.5 ui_startup
Define uma imagem ou video que ser mostrado quando oadvanceMENU for
iniciado,
os
formatos suportados so .PNG ou .
MNG e a imagem ser redimencionada para preencher 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
Define uma imagem que ser mostrada ao pressionar a tecla F1, formatos vlidos
.PNG ou
.MNG, 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 linha, e
s ser exibida caso a opo
`display_restoreatgame' estiver definida como 'no'.
ui_gamemsg "MESSAGE"
Options:
MESSAGE Menssagem a ser mostrada ( o valor padro "Run 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
apresentao s
ser
mostrada 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 uma imagem dos 4 tipos possiveis, o valor padro 'snap'.
5.5.9 ui_skiptop/bottom/left/right
Define a area que o menu ir ocupar, essa area obitida usando a imagem de
fundo (
caso ela
tenha sido definida na opo
`ui_background'). se nenhuma imagem tiver sido definidaento ser usado a
resoluo atual.
Usando essas opes voc pode
posicionar e redimencinar o menu para qualquer posio etamanho 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 desabilita as informaes mostradas nas barras, superior e inferior Por
exemplo:
nome do jogo, 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 BACKGROUND
Tags:
help Help.
help_tag Help highlight.
submenu_bar Submenu title.
submenu_item Submenu entry.
submenu_item_select Submenu selected entry.
submenu_hidden Submenu hidden entry.
submenu_hidden_select Submenu selected hidden entry.
menu_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 marker and generic background color.
backdrop Backdrop outline and missing backdrop.
icon Icon outline and missing icon.
cursor Flashing cursor.
Options:

FOREGROUND A cor de frente ( dos textos ) a ser usada, o formato desse


parametro

RRGGBB. Esse formado deve


ser expresso na forma hexadecimal. Por exemplo: vermelho = FF0000, verde =
00FF00, azul =
0000FF,
com esse formato voc poder obter qualquer cor que desejar.
BACKGROUND Para a cor de fundo se aplica as memas regras informadas na
opo
'FOREGROUND'.
5.5.12 ui_clip
Seleciona como os videos devem ser exibidos.
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 os video clips.
multiloop Reproduz todos os video clips, usando como base o jogo queestiver
selecionado, e
ao termino ir para o
proximo item da lista, e assim sucessivamente at o finalda lista e quando
alcanado
volta para
o primeiro
item. Usando essa opo os sons no so reproduzidos.
multiloopall Reproduz todos os video clips de forma aleatria. O sonsno so
reproduzidos
com essa opo.
5.5.13 ui_translucency
Seleciona 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 usado uma imagem defundo.
5.5.14 ui_command
Define um ( comando ou script ou programa ) definido pelo usuario. O video no
alterado
quando o script executado.
ui_command "MENU" SCRIPT
Options:
MENU O nome do menu a ser inserido.
SCRIPT Um ( comando, script ou programa ) para ser executado. Caso o script ou
comando
seja muito grande ele pode

ser dividido em varias linhas para isso use uma '\' no final de cada linha.
Os ( comando, scripts, programas ) podem usar as macros disponiveis no
advanceMENU, isso
quando se tem um game
selecionado.
%s O nome da rom sem a exteno. por exemplo "pacman"
%p O caminho completo da roms. Por exemplo "c:\emu\roms\pacman.zip".
%f O nome da rom com a exteno. Por exemplo "pacman.zip".
Se o game no estiver selecionado as macros no podem ser usadas.
Se um ( comando, script, programa ) terminar com um erro, ser mostrado uma
menssagem de
alerta.
Exemplos:
ui_command "Delete Hiscore" \
del .\advance\hi\%s.hi
ui_command "Delete Snapshot" \
del .\advance\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 no menu principal
os
comando
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_command_error
Seleciona a menssagens que ser mostrada caso o ( comando,script ou
programa )
retorne um
erro.
ui_command_error MSG
Options:
MSG Menssagem a ser mostrada. 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 atalho do menu. Por exemplo F5, F6,
ESPACEBAR, etc...
ui_menukey yes | no
5.5.18 ui_console

Modifica o comportamento do menu para trabalhar como sefosse um menu de um


video game.
Essa opo geralmente pra ser
usada com o advanceCD.
ui_console yes | no
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 teclas.
5.6.1 device_keyboard/joystick/mouse_*
Estas opes so usadas para personalizar os drivers.
Todos as opes `device_keyboard/joystick/mouse_*' que esto definidas no
arquivo
`advdev.txt' podem ser usadas.
5.6.2 input_hotkey
Habilita ou desabilita o reconhecimento 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 geralmente 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
permisso
de selecionar um game e jogar,
todas as opes do menu no ficaro disponiveis e no podero ser modificadas,
eo
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 menu.
event_assign EVENT EXPRESSION
Events:
up,
down,
left,
right
Movement.
home,
end,
pgup,
pgdn
Movement.
enter Main action, start.
esc Back action, exit & cancel.
space Change action, select & deselect.
ins Select all.
del Deselect all.
menu The main menu.
sort Changes the sort mode.
mode Change the display mode.
file:///D|/ARCADE_DVD/doc/advmenu.html (27 of 33)2/24/2008 2:13:59 PM
AdvanceMENU Frontend
preview 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 screen of 90.
lock Lock/unlock the user interface.
mute Mute/unmute the audio.
Options:
EXPRESSION Definio das expresses que representam as teclas e que geram
os
eventos.
Essas combinao podem ser
nomes das teclas ou scan-code ( cdigo da tecla ), e podem ser usados com os
operadores `not',
`or'. O
operador `and' pode ser usado somente com os scan-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, backspace, tab, openbrace,
closebrace,
enter,
semicolon, quote, backslash, less, comma, period, slash, space, insert, del, home,
end,
pgup,
pgdn, left,
right, up, down, slash_pad, asterisk_pad, minus_pad, plus_pad, period_pad,
enter_pad, prtscr,
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
Voc pode utilizar o utilitrio `advk.exe' para ver os 'scancodes' de uma
determinada
tecla.
5.6.5 event_repeat
Seleciona a taxa de repetio de vrios eventos.
event_repeat FIRST_TIME NEXT_TIME
Options:
FIRST_TIME Tempo da primeira repetio, o valor deve ser exepresso em
milesegundos.
NEXT_TIME Tempo da proxima repetio, o valor deve ser exepressoem
milesegundos.
5.6.6 event_mode
Seleciona se o evento deve aguardar a atualizao da tela antes de gerar um novo
evento.
event_mode wait | fast
Options:
wait A tela ser completamente redesenhada antes de processar oproximo evento.
fast Se um evento estiver aguardando, o redesenho da tela ser interrompido
( esse
o valor
padro ).
5.6.7 event_alpha
Desabilita as teclas alpha numericas, para uma movimentao rpida pelo menu.
Se
voc
estiver usando um 'encoder' ou um

'hack de teclado' com varios botes remapeados para umatecla alpha numerica,
essa
opo ser
de grande utilidade.
event_alpha yes | no
Options:
yes Habilita (esse o valor padro).
no Desabilita.
5.7 Other Configuration Options
5.7.1 idle_start
I
nicia um game automaticamente caso o menu fique ocioso pelo periodo
especificado.
Com
essa opo voc pode criar uma
apresentao usando em conjunto com a opo `input_idleexit' do advanceMAME.
idle_start START_TIMEOUT REPEAT_TIMEOUT
Options:
START_TIMEOUT O tempo expresso em segundos que o advanceMENU ir
aguardar
antes de
iniciar um game. Se for
definido com um '0' (zero), o advanceMENU no ir chamar um game
automaticamente. ( esse
o
valor padro ).
REPEAT_TIMEOUT O tempo expresso em segundos que o advanceMENU ir
chamar
o
proximo game. Se um '0' (zero)
for usado o advanceMENU no ir chamar o proximo game.
Exemplos:
idle_start 400 60
5.7.2 idle_screensaver
Seleciona o tempo que o advanceMENU ir aguardar antes de iniciar 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 segundos para aguardar entes de iniciar o slide.
Se
um '0' for
definido o slide no ser
iniciado ( o valor padro 60 ).
REPEAT_TIMEOUT O tempo em segundos que ele ir aguardar para mostrar a
proxima
imagem. 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 criar o slide.
idle_screensaver_preview none | play | snap | flyers
| cabinets | titles
Options:
none Desliga o monitor usando o servio VESA/PM se estiver disponivel. Caso
contrrio
mostra uma imagem
escura.
snap,
flyers,
cabinets,
titles
Inicia o slide 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 ). Somente
os
videos e
sons sero
mostrados, qualquer outra imagem ser ignorada.
5.7.4 group/type
Seleciona e mostra as categorias `group' e `type'.
group "STRING"
type "STRING"
[EMULATOR/]group_include "STRING"
[EMULATOR/]type_include "STRING"
Commands:
group, type define uma categoria.
group_include,
type_include
Mostra a categoria selecionada.
Options:
EMULATOR/ No necessario ser informado caso use um emulador reconhecido
pelo
advanceMENU. Caso use a opo
'generic' ento voc deve informar o nome usado na opo 'emulator', para aplicar
a
altero no
emulador
especificado.
STRING Nome da categoria.
5.7.5 group/type/desc/info_import
Seleciona importa automaticamente as informaes 'groups, types, descriptions' e
outras
informaes de um arquivo externo.
As informaes adicionais so mostradas para cada game.
Os formatos dos arquivos suportados so: CATINI, MacMAME e NMS. Os arquivos

sero
lidos a partir do diretrio corrente
caso 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'.
desc_import (ini | mac | nms) "EMULATOR" "FILE" ["SECTION"]
info_import (ini | mac | nms) "EMULATOR" "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 adicionais 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 emulador informado na opo 'emulator'.
FILE O nome do arquivo.
SECTION O nome da sesso ( somente para o formato `ini').
Exemplos:
group_import ini "advmame" "catver.ini" "Category"
type_import mac "advmame" "Genre 37b14.txt"
desc_import nms "raine" "raine.nms"
info_import ini "advmame" "catver.ini" "VerAdded"
Os arquivos 'CATLIST'podem ser baixados de:
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 autorais na inicializao do advanceMENU.
misc_quiet yes | no
6 Formatos suportados.
Essa a lista de arquivos que o advanceMENU suporta.
Images:
PNG Formato PNG.
PCX Formato PCX.
ICO Formato ICO.
Clips:
MNG O MNG-VLC (Very Low Complexity), esse um sub formatoque no usa

transparency
e alpha channel, ou o subformato
que gerado pelo advanceMAME ou pelo utilitario de compresso 'advmng'.
Sounds:
MP3 Formato MP3.
WAV O formato WAV com 16 bits.
Fonts:
TTF o formato 'TrueType'. Caso o advanceMENU tenha sido compilado com a
biblioteca
'FreeType2'.
RAW O formato RAW.
PSF O formato PSF.
GRX O formato GRX.
Archives:
ZIP o formato ZIP.
7 Signals
O advanceMENU intercepta os seguintes sinais:
SIGQUIT Saida normal.
SIGTERM,
SIGINT,
SIGALRM
Sai e restaura somente os dispositivos de saida.
SIGHUP Reinicia o programa.
Bem isso espero que tenha gostado esse tutorial foi feito pelo Robustter que ta
com novo site e ja tem uma multijogos pronta pra uso pra voc baixa no
site:Robuster Multi Games 2014 e pra adio de novos emuladores complexo
entre no frum Arcade Br: Aqui que l ja um forum voltado pra esse e demais
sistema arcade.