Você está na página 1de 29

AdvanceMENU Frontend 1 Synopsis advmenu [-default] [-remove] [-cfg FILE] [-log] [-version] [-help] 2 Description AdvanceMENU um front-end para

a ser usado com AdvanceMAME, AdvanceMESS, MAME, MESS , xmame, Raine e outros emuladores. Simplemente 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 formato 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 vantagens so: Simplesmente carregue e jogue. Copie o executvel e jogue! Atualizao automatica 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 mostrar 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 na lista. Sons de fundo(MP3/WAV). Permite tocar musicas continuamente enquanto voc 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 para arquivos zipados: imagens e sons. Screen-saver. Um slide das imagens dos games ou videos mng. Permite adicionar uma imagem de fundo com efeitos de transparencia. Essas so as sesses disponiveis nesse documento: 1 Synopsis 2 Description 3 Options 4 Emulators 4.1 generic - Generic emulator 4.2 advmame - AdvanceMAME 4.3 advmess - AdvanceMESS 4.4 mame - Windows MAME 4.5 xmame - xmame 4.6 dmame - DOS MAME 4.7 dmess - DOS MESS

4.8 draine - DOS Raine 5 Configuration 5.1 Global Configuration Options 5.1.1 config 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 Configuration Options 5.2.1 device_video_* 5.2.2 display_size 5.2.3 display_restoreatgame 5.2.4 display_restoreatext 5.2.5 display_orientation 5.2.6 display_brightness 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_keyboard/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/bottombar 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_console 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_screensaver 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 Copyright

3 Options -default Adiciona todas as opes padres que estiverem faltando com seus valores 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. Exemplo: advmenu.exe -remove -cfg FILE Seleciona um arquivo de configurao alternativo. No Linux e Mac OS X, voc pode prefi xar o nome do arquivo com "./" para carregar ele a partir do diretrio corrente.Exemplo: advmen u.exe -cfg .\meurc.rc -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 d iretrios. -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 Windo ws voc pode usar `/'. 4 Emulators O advmenu suporta muitos tipos de emuladores. Os emuladores AdvanceMAME, Advance MESS, MAME, xmame, DMAME, DMESS e DRAINE tem suporte interno, 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, devido a atualizaes dos me smos. 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 t odas 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 "RomMe" ) qualquer outra informao descartada, e ainda nesse arquivo as unicas informaes obriga trias so 'game', 'name', 'description', as outras so opcionais. Caso no queira criar esse 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 adiciona uma linha no arquivo "advmenu.rc", que posteriormente poder ser editada e ser adicionado um nome para essa rom. Veja um exemplo, da linha adicionada no "advmenu.rc" ao c hamar o jogo 1941: game "1941" "" "" 0 0 "" Para dar um nome a essa rom, 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 arquivo '.lst' : game ( name sfz2j description "Street Fighter Zero 2 (Japan 960227)" manufacture r "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)" 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 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 for ma 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. Por exem plo "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\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 extenes, voc pode usar a opo `emu lator_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 para localizar as roms. No 'DOS ' e 'Windows' o arquivo 'advmame.rc' procurado no mesmo diretrio onde se encontra o 'advmame.exe', no Linux 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 roms 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 especificados na opo 'dir_rom' do arquivo `advmess.rc' so usados para d etectar a lista de bios. Todos os diretrios listados na opo `dir_image' so lidos e todos os arquivos encontra 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\ti99_4a', `c:\software\sms', `c:\software\gameboy'... Os arquivos que estiverem dentro do diretrio raiz de `c:\software' no sero checados. Quando voc seleciona um arquivo 'zip' ele aberto e todos os arquivos contidos nes

se '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 t enha o mesmo nome com um caracter adicional. Por exemplo se dentro do arquivo `alpiner.zip' conter os arquivos `al piner.bin', `alpinerc.bin' e `alpinerg.bin' ele considerado um nome vlido. Esta caracteristica pode ser usada para agrupar to dos 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 adva nceMENU 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 foi criado algum novo snapsho t (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 par a 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 'ma me.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 localiza r 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 usa do para localizar as roms. O diretrio especificado na opo 'screenshotdir' ser usado para localizar as imagens d os jogos. 4.6 dmame - DOS MAME Para o emulador 'dmame' as informaes das roms sero extraidas 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 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 comando '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:\software\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 '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 co mo argumento para a opo '-cart' quando o dmess for chamado. Observao: O AdvanceMENU no tem suporte para usa 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 destas entradas em 'mess' a opo `-alias' usada para inicializar o jogo. Voc pode atribuir uma descrio arbitraria dentro de uma espeficicao de 'alias' adicion ando 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 foi criado 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 softwar e `alpiner'. Se voc pressionar a tecla 'F12'durante a emulao, o arquivo 'snap\ti99_4a.png' ser criado.E nto qundo voc retornar para o AdvanceMENU o arquivo ser movido automaticament para 'snap\ti99_4 a\alpiner.png'. 4.8 draine - DOS Raine Para o emulador `draine' as informaes sobre as roms so retiradas do arquivo `draine .lst'.Se esse arquivo no existir ele ser criado automaticamente usando a linha de comando `draine -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 snapshots ( imagem ) dos jogos. 5 Configuration O arquivo `advmenu.rc' usado para salvar as configuraes correntes do front-end. El e verificado a cada vez que o que o programa 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 so 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 arquivo `advmame.r c' e `advmess.rc' nos diretrios $host, $data eo $home. O $host diretrio `$SYSCONFDIR', onde o $SYSCO NFDIR o diretrio `sysconfdir' configurado com o script 'configure'. O padro `/usr/local/etc'. O di retrio $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 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 diretrio '$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 informaes pelo programa. Os arquiv os dentro dos diretrios $host e $data so somente para leitura. 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 um caminho relativo. Voc pode forar a procura no diretrio corrente prefixando o arquivo 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 opes 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 '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 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 opes 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 for modifican do 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 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 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 emula 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 emulador 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 ada emulador adicionado. generic Essa opo informa ao advanceMENU que ser usado um emulador 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. 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 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 arquivos '.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 erro 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 advanceMENU automaticamente adiciona os argumentos necessarios. A menos que voc precise adicionar 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 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', 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" advmame "advmam e\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 "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 arquivos de configurao d os 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 quand

o 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 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. 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 ser o me smo usado na definio do emulador, por exemplo [advmame, dmame, mame, etc..], Quanto se usa a palavra 'ge neric', 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:\gam e\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_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_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 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 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 type group size resolution info manufacturer

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 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 veze s. timeperplay Organiza a lista de jogos usando como base os que foram jogados po r 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 dese nvolvedora 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 e xemplo 'Favoritos', 'Adultos', etc... size Organiza a lista de jogos usando como base o tamanho da rom. resolution Organiza a lista de jogos usando como base a resoluo do jogo, por exe mplo '320x240', '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 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 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'. 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

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 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 verti cais 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 (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_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 no possuem 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 ` mulator_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. Essa opo s usada para emulador s reconhecidos internamente pelo advanceMENU, isso porque usado as informaes conti das nos arquivos ".xml", exemplo: advmame.xml 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 perte ncem, 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. 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 mo icada automaticamente no advmenu.rc a cada vez que um novo game encontrado ou jogado, essa opo usada ara 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_i mport', `type_import' e `desc_import'. Os valores 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 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 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 video. display_size WIDTH Options: WIDTH Largura em pixel, o modo mais perto do informado ser usado. O va lor 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 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 tempo 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) 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 o evento, 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 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 que contenha vrias msicas ou sons, que sero tocados aleatriamne

te enquanto voc estiver no advanceMENU os formatos suportados so ( .MP3 E .WAV ) Voc 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 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 ace ssar 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 `adv dev.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 f icar 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, 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 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 redimencionad a. 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 auto maticamente. 5.5.3 ui_background Define uma imagem de fundo 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_exit Define uma imagem ou video que ser exibido ao sair do advanceMENU os formatos sup ortados 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 o advanceMENU 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 linh a, 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 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 uma imagem dos 4 tipos possiveis, o valo r 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 definida ento ser usa do a resoluo atual. Usando essas opes voc pode posicionar 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 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 dess e parametro RRGGBB. Esse formado deve ser expresso na forma hexadecimal. Por exemplo: vermelho = FF0 000, 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 'FORE GROUND'. 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 que estiver s elecionado, e ao termino ir para o proximo item da lista, e assim sucessivamente at o final da 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 sons no so reprod uzidos 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 de fundo. 5.5.14 ui_command Define um ( comando ou script ou programa ) definido pelo usuario. O video no alt erado quando o script executado. ui_command "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 script 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 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 menssa gem 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 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_command_error Seleciona a menssagens que ser mostrada caso o ( comando, script ou programa ) re torne 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 se fosse um menu de um vide o 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 `adv dev.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 perm isso de selecionar um game e jogar, todas as opes do menu no ficaro disponiveis 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 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. 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 o s 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 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, backspace, tab, openbrace, closebrace, enter, semicolon, quote, backslash, less, comma, per iod, slash, space, insert, del, home, end, pgup, pgdn, left, right, up, down, slash_pad, asterisk_p ad, 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 event_assign command 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_repeat FIRST_TIME NEXT_TIME Options: FIRST_TIME Tempo da primeira repetio, o valor deve ser exepresso em mile segundos. NEXT_TIME Tempo da proxima repetio, o valor deve ser exepresso em milesegundos. 5.6.6 event_mode Seleciona se o evento deve aguardar 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 evento. 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 pelo 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. event_alpha yes no

Options: yes Habilita (esse o valor padro). no Desabilita. 5.7 Other Configuration Options 5.7.1 idle_start Inicia um game automaticamente caso o menu fique ocioso pelo periodo especificad o. Com essa opo voc pode criar uma apresentao usando em conjunto com a opo `input_idleexit' do advanceMA ME. idle_start START_TIMEOUT REPEAT_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 advanceMENU no ir chamar um game aut omaticamente. ( esse o valor padro ). REPEAT_TIMEOUT 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_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 sl ide. 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 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 criar o slide.

idle_screensaver_preview none cabinets titles

play

snap

flyers

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 ). Som ente 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 'emu ator', 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 out ras 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 li dos 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: 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 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 formato que no usa tran sparency e alpha channel, ou o sub-formato que gerado pelo advanceMAME ou pelo utilitario d e 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. 8 Copyright Esse arquivo Copyright (C) 2003, 2004, 2005 Andrea Mazzoleni, Randy Schnedler.