Diversos arquivos de configuração

O MAME tem um poderoso sistema de configuração que permite ajustar as opções de cada jogo, sistema ou até mesmo um tipo de monitor em específico de maneira individual, porém requer um cuidado especial na organização das configurações, para mais detalhes de como o MAME encontra as suas configurações, consulte também o capítulo Como o MAME localiza os seus arquivos?.

A ordem da leitura dos arquivos

O MAME faz a interpretação dos arquivos de configuração na ordem abaixo:

  1. A linha de comando é interpretada primeiro e tem prioridade sobre qualquer outro arquivo .ini.

  1. O arquivo mame.ini (ou qualquer outra plataforma que use um .ini como o mess.ini por exemplo) são interpretados duas vezes. Na primeira passada é feito a leitura de diferentes configurações, a segunda é feita para ver se existe outro arquivo de configuração com um outro tipo de configuração válida (caso exista, altera as configurações com as informações deste segundo arquivo).

  1. O arquivo debug.ini caso esteja em modo de depuração. Este é um arquivo de configuração avançada, a maioria das pessoas não precisam sequer se preocupar com ele.

  1. Os arquivos INI de orientação da tela (seja o horizont.ini ou o vertical.ini). Use o arquivo vertical.ini para aplicar as configurações apenas num sistema com tela vertical como Pac-Man por exemplo. Já para um sistema com tela horizontal, use o arquivo horizont.ini para aplicar as configurações apenas nos sistemas como Street Fighter Alpha.

    Geralmente o arquivo horizont.ini será lido nos sistemas sem monitor, nos monitores com diversas orientações diferentes ou monitores conectados em dispositivos tipo slot.

  1. Os arquivos INI voltados para diferentes tipos de tela como vector.ini para jogos vetoriais, raster.ini para jogos rasterizados, lcd.ini para jogos ou consoles que usem telas de cristal líquido (LCD), EL, plasma, etc. Ambas os sistemas como a Pac-Man e a Street Fighter Alpha são rasterizadas [1] [2], assim o arquivo raster.ini é lido para obter e aplicar as configurações específicas deste tipo de sistema, já o sistema Tempest é um sistema com tela vetorial, assim o arquivo vector.ini é lido e as configurações vetoriais são aplicadas apenas nos sistemas desta categoria.

    Para sistemas que tenham mais de um monitor como a House Mannequin (faça o teste com mame housemnq -numscreens 3) que usa um monitor CRT raster e um par de telas de cristal líquido, os arquivos raster.ini e lcd.ini são lidos e as suas respectivas configurações aplicadas nas suas respectivas telas.

  1. Os arquivos INI voltados para os arquivos de código-fonte (driver). O MAME tentará ler source/<sourcefile>.ini onde <sourcefile> é o nome do arquivo de código-fonte onde o sistema estiver definido. O código-fonte de um driver pode ser encontrado usando o comando mame -listsource <nome_da_rom>, exemplo:

    mame.exe -listsource sfa
sfa             cps2.cpp

    A Banpresto Sailor Moon, a Atlus Dodonpachi e a Nihon System Dangun Feveron por exemplo, todos rodam num hardware semelhante e estão listados no arquivo de código-fonte chamado cave.cpp que chamamos de driver, assim sendo, todos eles usarão o arquivo source/cave.ini para obter as suas configurações.

  1. Os arquivos INI para BIOS (caso seja aplicável). O sistema The Last Soldier por exemplo, usa a BIOS do Neo-Geo MVS, então o arquivo neogeo.ini será lido. Nenhum arquivo INI será lido nos sistemas que não usem uma BIOS.

  1. Arquivo INI da mesma família. O The Last Soldier é um clone do The Last Blade / Bakumatsu Roman - Gekka no Kenshi, assim o arquivo lastblad.ini será lido. Nenhum arquivo INI da mesma família será lido.

  1. Arquivo INI do sistema. Usando o exemplo anterior, o arquivo

    lastsold.ini será lido para o The Last Soldier.

Exemplos da sequência de leitura dos arquivos

  • O Brix que é um clone de Zzyzzyxx. (mame brix)

    1. Linha de comando

    2. mame.ini (global)

    3. Caso o depurador não esteja ativado, nenhum arquivo INI extra será lido.

    4. vertical.ini (orientação da tela)

    5. raster.ini (tipo do monitor)

    6. source/jack.ini (configuração específica para o código fonte do driver)

    7. Nenhuma BIOS definida.

    8. zzyzzyxx.ini (sistema da mesma família)

    9. brix.ini (sistema)

  • Super Street Fighter 2 Turbo (mame ssf2t)

    1. Linha de comando

    2. mame.ini (global)

    3. Caso o depurador não esteja ativado, nenhum arquivo INI extra será lido.

    4. horizont.ini (orientação de tela)

    5. raster.ini (tipo do monitor)

    6. source/cps2.ini (configuração específica para o driver)

    7. Nenhuma BIOS definida.

    8. Nenhum sistema da mesma família.

    9. ssf2t.ini (sistema)

  • Final Arch (mame finlarch)

    1. Command line

    2. mame.ini (global)

    3. Caso o depurador não esteja ativado, nenhum arquivo INI extra será lido.

    4. horizont.ini (orientação de tela)

    5. raster.ini (tipo do monitor)

    6. source/stv.ini (configuração específica para o driver)

    7. stvbios.ini (BIOS definida)

    8. smleague.ini (sistema da mesma família)

    9. finlarch.ini (sistema)

Lembre-se que os parâmetros na linha de comando tem preferência sobre todos os outros arquivos!

Usando diferentes arquivos de configuração

O MAME oferece a possibilidade de criar diferentes tipos de configuração separada por algumas categorias ou pelo nome dos drivers em vez de concentrar todas as configurações num único arquivo como o mame.ini. E para que isso?

O MAME possuí dezenas de opções disponíveis para configurar outra dezena de coisas como áudio, vídeo, controladores diversos, etc. A linha de comando pode ficar bem grande e complexa dependendo do sistema a ser emulado e variar de sistema para sistema. Ao criar diferentes configurações é possível individualizar diferentes definições criar diferentes perfis para diferentes tipos de sistemas, drivers, dispositivos, etc.

Podemos citar como exemplo a opção de vídeo, por predefinição, no Windows o MAME escolhe d3d como a melhor opção, contudo, em sistemas Windows mais recentes como o Windows 10/11, a melhor opção seria bgfx em conjunto com um bgfx_backend apropriado como o d3d12 ou melhor ainda, o vulkan caso a sua placa de vídeo seja compatível. É possível definir essa configuração como um padrão para todos os sistemas dentro do arquivo mame.ini.

O arquivo mame.ini afeta a configuração de forma global, ou seja, tudo o que for configurado nele vale para tudo e isso pode causar diversos problemas. Por exemplo, o sistema Arkanoid usa um controle com um disco giratório (chamado de spinner controller), no MAME é possível usar um joystick, um controle tipo gamepad e o mouse.

Porém ao definir mouse 1 no mame.ini o sistema Arkanoid funcionará perfeitamente com o mouse, mas como o mame.ini serve como um arquivo de configuração global, a opção mouse 1 faz com que todas as outros sistemas, ainda que não usem o mouse, passem a usá-lo. Então ao iniciar o sistema Street Fighter II por exemplo, o seu mouse é sequestrado pelo MAME e assim ficará enquanto o MAME estiver sendo executado ou até que você pressione a tecla P para pausar a emulação e reaver o controle do mouse pelo seu sistema operacional.

No seu desktop talvez isso não seja um problema, contudo, imagine a mesma situação num sistema arcade rodando o MAME aonde você não tenha um acesso fácil ao teclado, ficar "sem mouse" no seu sistema e por não saber deste detalhe ficar quebrando a cabeça sem entender o que está acontecendo perdendo horas alterando as configurações.

É para casos como este que as configurações individuais são importantes e é por isso que é preciso personalizar certas definições em alguns casos. Usando o Arkanoid como exemplo, para que apenas este sistema use a opção mouse 1, crie o arquivo ini\arkanoid.ini e nele coloque a opção desejada, exemplo:

mouse 1

Ao salvar o arquivo e ao iniciar o sistema, repare que é possível usar o mouse como controle. Além desta configuração ser aplicada no sistema Arkanoid, a configuração também será aplicada em todas os sistema onde as suas ROMs comecem com arkanoid, exemplo:

arkanoid          "Arkanoid (World, older)"
arkanoidj         "Arkanoid (Japan, newer)"
arkanoidja        "Arkanoid (Japan, newer w/level select)"
arkanoidjb        "Arkanoid (Japan, older)"
arkanoidjbl       "Arkanoid (bootleg with MCU, set 1)"
arkanoidjbl2      "Arkanoid (bootleg with MCU, set 2)"
arkanoidu         "Arkanoid (US, newer)"
arkanoiduo        "Arkanoid (US, older)"

Fazendo assim nós também evitamos um conflito de configurações cruzadas onde a configuração de um sistema afete o outro e vice versa. Assim podemos ter configurações específicas para sistemas que usem vetores sem que estas configurações afete sistemas rasterizados ou sistemas que sequer usem telas por exemplo.

Criando uma configuração específica para o Super Street Fighter 2

Aqui uma sugestão de configuração onde vamos definir diferentes parâmetros, porém, sem alterar nada no mame.ini, tenha certeza que todas as ROMs estejam na pasta roms. Para o nosso exemplo usaremos a ROM ssf2.zip e qsound_hle.zip.

Super Street Fighter 2

  • Crie um arquivo texto chamado ssf2.ini dentro do diretório ini e cole as configurações abaixo:

video                     bgfx
bgfx_backend              vulkan
snapbilinear              0
refreshspeed              1
filter                    0
bgfx_screen_chains        crt-geom
ctrlr                     sf2

Observe que as opções sugeridas aqui são as mais genéricas possíveis para que funcionem com a maioria dos computadores mais recentes cobrindo o mínimo necessário.

Criando uma configuração específica para um sistema/driver

Aqui em vez de criar várias configurações individuais, nós criaremos uma única configuração que será aplicada a todos os sistemas listados dentro do driver capcom/cps2.cpp (use o comando -ls para indentificar o driver do sistema).

CPS-2

  • Crie o arquivo texto cps2.ini dentro do diretório ini\source, com as seguintes opções:

video                     bgfx
bgfx_backend              vulkan
snapbilinear              0
refreshspeed              1
filter                    0
bgfx_screen_chains        crt-geom
ctrlr                     sf2

Agora todos os sistemas dentro de capcom/cps2.cpp (veja quais são eles com o comando mame ssf2 -lb), usarão as configurações acima. Caso utilize esta configuração, você pode apagar o arquivo ssf2.ini, a não ser que você use ou queira usar uma configuração muito específica para ele, neste caso, não é preciso clonar a configuração, basta adicionar a opção que deseja. Então o seu arquivo ssf2.ini teria apenas a seguinte configuração:

samplerate                44100
window                    1

Neste caso, somado a configuração anterior, o sistema e todos os relacionados a ele, serão configurados a usar uma taxa de amostragem de 44.1 kHz e rodar em modo janela, enquanto todos os outros rodarão com tela inteira e com uma taxa de amostragem padrão de 48 kHz.

Aplicando efeitos na tela

Jogos como Street Fighter e tantos outros na época utilizavam raster graphics, onde a imagem na tela é formada por pixels, no Brasil estes gráficos são também conhecidos como mapa de bits ou bitmap. Diferente de hoje, as imagens eram desenhadas em linhas de escaneamento para formar uma imagem nas antigas tela de tubo de raios catódicos ou CRT. Tal efeito assim como seus defeitos, podem ser reproduzidas. Abordaremos aqui apenas a configuração básica porém o assunto já foi abordado nos capítulos sobre BGFX, GLSL e HLSL.

Para aplicar um simples efeito de scanlines nos sistemas com raster graphics, crie o arquivo raster.ini dentro do diretório ini:

prescale                  3
effect                    scanlines

Agora ao rodar o sistema Street Fighter II: The World Warrior (mame sf2) note que há algumas linhas na tela, outros efeitos podem ser baixados do MameWorld. Apesar dos efeitos de sobreposição darem apenas uma aparência muito simplificada de uma tela CRT, a sua vantagem é consumir poucos recursos, porém há muito tempo que não se utiliza mais a opção effect já que nos dias de hoje há opções mais modernas. Para quem tem um hardware um pouco mais sofisticado, use a simulação as opções do BGFX, GLSL e HLSL.

Baixe os shaders GLSL do mameau, extraia o diretório osd no diretório raiz do MAME e experimente esta configuração no seu arquivo ini\raster.ini:

raster.ini

filter                  0
gl_glsl                 1
gl_glsl_filter          1
glsl_shader_mame0       osd\shader\glsl_plain
glsl_shader_mame1       osd\CRT-geom

Rode novamente o sistema Street Fighter II: The World Warrior e repare que a tela já possuí curvatura, linhas de escaneamento, distorções e outras características semelhantes a uma tela CRT, incluindo os seus defeitos.

Particularmente prefiro apenas manter as características das linhas de escaneamento do CRT sem os defeitos, as distorções, a saturação, nada. Gosto de usar o pix que é um filtro que evita distorções de pixels (integer scaling) quando você aumenta a resolução da tela junto com o efeito ApertureMRES:

Minha Configuração

filter                  1
gl_glsl                 1
gl_glsl_filter          1
glsl_shader_mame0       glsl\pix\pixellate
effect                  ApertureMRES

Repare que ao usar o arquivo raster.ini para armazenar as configurações dos efeitos da tela, ela também será aplicada em qualquer outro sistema que seja definido como "raster" como consoles de video-game, computadores pessoais, etc.

Criando configurações específicas para consoles

Da mesma maneira que estas configurações funcionam com arcades é possível também fazer o mesmo para consoles como o Sega Genesis/Mega Drive, Super Nintendo dentre outros, aqui alguns exemplos.

Sega Genesis / Mega Drive

  • Crie um arquivo mdconsole.ini dentro do diretório ini\source com as seguintes opções:

romapath                  mame_rom_dir;caminho_completo_roms
samplerate                32000
ctrlr                     megadrive

Super Nintendo

  • Crie um arquivo snes.ini dentro do diretório ini\source com as seguintes opções:

romapath                  mame_rom_dir;caminho_completo_roms
samplerate                32000
ctrlr                     snes

Neo Geo

  • Crie o arquivo neogeo.ini dentro do diretório ini\source com as seguintes opções:

romapath                  mame_rom_dir;caminho_completo_roms
bios                      unibios40
ctrlr                     neogeo
filter                    1
prescale                  2
keepaspect                1