Opções Universais de linha de comando
Comandos opções e parâmetros
Os comandos incluem o próprio executável do MAME, bem como as várias ferramentas incluídas no MAME.
As opções (chamadas de "verbos" na documentação original) são ações que serão executadas em conjunto com o comando, e qualquer outra ação auxiliar a opção (quando existir) é chamada de parâmetro da opção. No português brasileiro, subentende-se que, quando falamos em comando, estamos nos referindo ao comando junto com a opção (quando for o caso). Por exemplo, no comando mame -validate pacman, mame é o comando em si, -validate é a opção e pacman é o parâmetro que desejamos usar com a opção -validate.
Conjunto de instruções
Muitos comandos são compatíveis com o uso de um conjunto de instruções ou um padrão [1], que pode ser um sistema ou um nome abreviado do dispositivo (como por exemplo, a2600, zorba_kbd) ou um conjunto de instruções globais que correspondam a um dos dois como zorba_* por exemplo.
Dependendo do comando combinado com esse conjunto de instruções, a correspondência dessas combinações pode equivaler a um sistema (ou vários deles), assim como a dispositivos. É aconselhável colocar aspas em torno dos parâmetros para evitar que o seu ambiente tente interpretá-los de forma independente em relação aos nomes dos arquivos desejados (por exemplo, mame -validate "pac*").
A Nomenclatura dos arquivos e a localização das pastas
O MAME aceita a utilização de mais de um caminho em suas configurações, como, por exemplo, as configurações que permitam a procura de ROMs em diferentes locais, desde que tais configurações utilizem o símbolo ; para separar cada caminho.
O MAME também consegue identificar o caminho dos locais das pastas usando as variáveis de ambiente já existentes no seu sistema operacional e sua sintaxe irá depender do sistema utilizado. No Windows, por exemplo, se a configuração %APPDATA%\mame\cfg for definida, o MAME conseguirá ler a variável %APPDATA% e resolver o caminho completo para a pasta com os dados de aplicativos do usuário.
Em sistemas do tipo UNIX, como o macOS e o Linux, que utilizam o interpretador de comandos Bourne Shell, o mesmo aconteceria caso o caminho fosse definido nas configurações como /home/${USER}/.mame/cfg. Assim como o sinal de porcentagem % é usado numa palavra para se definir uma variável no ambiente do Windows, o sinal de til ~ serve como um redirecionador para a pasta home do usuário. Dessa forma, em vez de digitar o caminho completo /home/${USER}/.mame/cfg é possível simplificar usando ~/.mame/cfg.
Note porém que o MAME só aceita interpretações de variáveis simples. Ele MAME não reconhece expressões mais complexas compatíveis com bash, ksh, ou zsh.
Os caminhos relativos são resolvidos a partir da pasta de trabalho atual. Ao iniciar o MAME com um clique duplo, a pasta de trabalho atual será aquele onde o executável do MAME estiver localizado. Se você fizer o mesmo usando um macOS, será aberta uma janela de terminal onde o diretório home será o seu diretório de trabalho.
Para obter um comportamento semelhante ao Windows Explorer no macOS, crie um script contendo as linhas do exemplo abaixo no mesmo diretório onde se encontra o executável do MAME. No exemplo abaixo, está sendo usada a versão 64-bit do MAME; mude conforme necessário.
#!/bin/sh
cd "`dirname "$0"`"
exec ./mame
Salve o script com um nome qualquer, como "meumame", por exemplo, na mesma pasta do executável do MAME. Abra o terminal e torne o script executável com o comando chmod u+x meumame. Ao executar o script, uma janela do terminal será aberta e o MAME será executado, com diretório de trabalho definido no mesmo local do script.
Opções de ajuda e verificação
-help / -h / -?
A opção exibe a versão atual do MAME e o aviso de direitos autorais.
mame -help
-validate / -valid <palavra-chave>
Executa uma validação interna em um ou mais drivers e dispositivos no sistema. Execute essa validação antes de enviar qualquer alteração para nós, visando garantir o comprimento de todas as regras do sistema principal.
Se um padrão for definido, ele validará a correspondência predefinida do sistema em questão; caso contrário, validará todos os sistemas e dispositivos. Note que caso um padrão seja definido, ele será comparado apenas com sistemas e não com outros dispositivos. Não será realizada nenhuma validação com dispositivos.
- Exemplo:
-verifyroms <palavra-chave>
Verifica a condição dos arquivos da imagem ROM em um determinado sistema. Serão verificados todos os sistemas e diretórios válidos que estejam dentro do rompath (caminho da ROM):
- Exemplo:
É possível usar um asterisco ao final do nome do sistema para que uma lista com todos os outros sistemas relacionados ao nome do sistema principal e sua condição atual seja exibida, por exemplo:
- Exemplo:
Todos os sistemas e arquivos da imagem ROM serão verificados caso nenhum nome seja informado.
-verifysamples <palavra-chave>
Verifica a condição dos arquivos de amostra (samples) informados. Todos os arquivos ou diretórios que forem válidos serão verificados, desde que estejam configurados em samplepath:
- Exemplo:
É possível usar um asterisco ao final do nome do sample para que seja exibida uma lista com todos os outros samples relacionados ao nome do sample principal e sua condição atual, por exemplo:
- Exemplo:
Todas os samples serão listados caso nenhum nome seja informado.
-verifysoftware / -vsoft <palavra-chave>
Verifica se há imagens ROM inválidas ou ausentes na lista de software. É predefinido que todos os drivers que possuem arquivos .zip ou diretórios válidos no rompath (caminho da ROM) serão verificados. No entanto, é possível limitar essa lista definindo um nome de driver específico ou combinações após o comando -verifysoftware.
- Exemplo:
-verifysoftlist / -vlist <nome do catálogo de programas>
Verifica ROMs ausentes com base em uma lista de software predeterminado na pasta hash. É predefinido que a busca e a verificação serão feitas em todos os drivers e arquivos .zip em diretórios válidos no rompath (caminho da rom), no entanto, é possível filtrar essa lista usando uma palavra-chave ou coringa em "softwarelistname" após o comando -verifysoftlist. As listas estão na pasta hash e devem ser informadas sem a extensão .xml.
O resultado é exatamente igual ao comando -verifysoftware, porém usando uma lista de software.
- Exemplo:
Opções de configuração
-createconfig / -cc
Cria um arquivo mame.ini pré-configurado. Todas as opções de configuração (não verbos) descritos abaixo podem ser permanentemente alterados ao editar este arquivo. Consulte também o capítulo sobre como criar apenas um mame.ini com as configurações de fábrica.
- Exemplo:
mame -cc
-showconfig / -sc
Exibe as configurações atualmente usadas. É possível direcionar essa saída para um arquivo ou também é possível utilizá-lo como um arquivo .ini, como mostra o exemplo abaixo:
- Exemplo:
É o mesmo que -createconfig.
-showusage / -su
Exibe todas as opções disponíveis no MAME que sejam compatíveis com o seu sistema operacional ou a versão do MAME que estiver usando. Cada opção é acompanhada de uma breve descrição em inglês.
As configurações nativas do Windows, como hlsl, por exemplo, não estarão disponíveis, nem serão listadas nas versões SDL do MAME que rodam em Linux, macOS e assim por diante.
Todas as opções aparecem comentadas.
- Exemplo:
Opções para listagem
É predefinido que todos os comandos -list abaixo exibam informações na saída predefinida do sistema, que geralmente é a tela do terminal onde o comando foi digitado. Para gravar a informação num arquivo texto, adicione o exemplo abaixo ao final do seu comando:
> nome do arquivo
Onde 'nome do arquivo' é o nome do arquivo de texto que será criado para registrar toda a saída do terminal (por exemplo, lista.txt). Note que qualquer conteúdo prévio existente nesse arquivo será apagado sem aviso prévio. Exemplo:
Isso cria (ou substitui, se já existir) o arquivo lista.txt e o completa com os resultados de -listcrc puckman. Em outras palavras, a lista de cada ROM usada em Puckman e o CRC para essa ROM são gravados nesse arquivo.
-listxml / -lx < dispositivo | driver | sistema >
Gera uma lista detalhada e completa de toda a informação mantida pelo MAME em seu banco de dados interno sobre os seus dispositivos, sistemas, drivers e nomes dos drivers, assim como muitas outras informações em formato XML. É possível limitar a saída informando um nome de dispositivo (ym2203 por exemplo), um driver (megadriv, por exemplo) ou sistema (sf2, por exemplo).
Geralmente, a saída deste comando é usada para redirecionar a um arquivo de texto que posteriormente é utilizado por outras ferramentas como gerenciadores de ROMs e interfaces intermediárias front-ends.
Caso utilize o MAME com o PowerShell da Microsoft, leia também Redirecionamento com o PowerShell da Microsoft.
- Exemplo
-listfull / -ll <palavra-chave>
Exibe uma lista com o nome do sistema pesquisado e a sua descrição:
- Exemplo:
É possível usar um asterisco ao final do nome do sistema para que seja exibida uma lista com todos os outros sistemas relacionados ao o nome do driver principal e suas respectivas descrições, exemplo:
- Exemplo:
Também é possível listar a descrição de sistemas. Infelizmente, nem todos os sistemas possuem descrições disponíveis ainda, exemplo:
- Exemplo:
Todos os sistemas ou drivers serão listados caso nenhum seja informado.
-listsource / -ls <palavra-chave>
Exibe uma lista de drivers/dispositivos dos sistemas e o nome dos seus respectivos arquivos fonte. Essa função é útil para identificar qual driver o sistema roda, o que é muito útil para o relatório de bugs. É predefinido que todos os sistemas e os dispositivos sejam listados; contudo, é possível limitar a lista por meio de um nome ou texto qualquer após a opção -listsource.
- Exemplo:
Também é possível utilizar um curinga (asterisco) ao final do nome do sistema para que seja exibido uma lista com todos os outros sistemas relacionados ao nome do sistema principal, por exemplo:
- Exemplo:
Todos os sistemas serão listados caso nenhuma palavra-chave seja informada.
-listclones / -lc <palavra-chave>
Exibe uma lista de clones de um determinado sistema. O MAME listará todos os clones existentes em seu banco de dados, mas é possível filtrar a lista com o uso de uma palavra-chave após o comando.
- Exemplo:
Dica
Consulte o capítulo A organização do conjunto das ROMs para saber o que significa os termos usado pelo MAME como "clone"e "parent".
-listbrothers / -lb <palavra-chave>
Exibe uma lista com o nome do driver, da ROM principal e dos parentes que compartilhem do mesmo driver do sistema que foi pesquisado.
- Exemplo:
-listcrc <palavra-chave>
Exibe uma lista completa com CRCs de todas as imagens ROM que compõem um sistema, exibindo os nomes do sistema ou do dispositivo em um formato simples que pode ser facilmente filtrado por comandos como grep, awk e sed no Linux e macOS ou o find e o findstr no Windows. Se nenhuma palavra-chave for usada como filtro após o comando, o MAME listará tudo que estiver em seu banco de dados interno.
- Exemplo:
-listroms / -lr <palavra-chave>
Exibe uma lista com todos os arquivos ROM que fazem parte de um sistema ou dispositivo. A lista mostra o nome dos arquivos ROM, os valores CRC e SHA1, além de indicar se uma das ROMs contidas no arquivo está sinalizada como BAD_DUMP. Isso significa que o conteúdo extraído dessa ROM não é válido, pode conter erros, não foi extraído corretamente ou de maneira apropriada, não pode ser validado por algum motivo, etc. Se nenhuma palavra-chave for usada como filtro após o comando, o MAME listará tudo que estiver em seu banco de dados interno.
- Exemplo:
-listsamples <palavra-chave>
Exibe uma lista das amostras que fazem parte de um determinado sistema, seus nomes ou os nomes dos dispositivos. Se nenhuma palavra-chave for usada como filtro após o comando, o MAME listará tudo que estiver em seu banco de dados interno.
- Exemplo:
-romident <caminho\completo\para\a\rom\desconhecida>
Tenta identificar os arquivos ROM desconhecidos comparando-os com os arquivos cadastrados no banco de dados interno do MAME que sejam utilizados por apenas um sistema ou que também sejam compartilhados por mais de um arquivo .zip específico. Este comando também pode ser usado para tentar identificar conjuntos de ROMs retirados de placas desconhecidas. A opção identificará os arquivos que estiverem compactados ou não.
- Exemplo:
Ao finalizar, o comando retorna um nível de erro (errorlevel):
0: Isso significa que todos os arquivos foram identificados;
7: Isso significa que todos os arquivos foram identificados, exceto um ou mais arquivos não qualificados como "não-ROM";
8: Isso significa que alguns arquivos foram identificados;
9: Isso significa que nenhum arquivo foi identificado;
Nota
Apesar de o "errorlevel" constar na documentação oficial, o comando não retorna nenhum desses valores, pelo menos não é possível visualizá-los no terminal ou no prompt de comando. Ele retorna apenas a listagem mostrada no exemplo e nada mais.
-listdevices / -ld <palavra-chave>
Exibe as especificações técnicas e todos os dispositivos conhecidos e conectados no sistema. Se os slots forem ocupados por dispositivos, todos os slots adicionais fornecidos por esses dispositivos ficarão visíveis com o comando -listdevices.
- Exemplo:
-listslots / -lslot <sistema>
Exibe uma lista com todos os slots disponíveis para o sistema e suas respectivas opções, se estiverem disponíveis.
- Exemplo:
Nem todos os itens opcionais acima estão conectados quando o sistema é iniciado, sendo necessário utilizar o item descrito em SLOT NAME em conjunto com o SLOT OPTIONS, como, por exemplo, para utilizar o dispositivo MIDI do seu computador. Teste com o exemplo abaixo:
- Exemplo:
Para saber qual o dispositivo MIDI disponível no seu sistema, consulte o comando -listmidi.
-listbios <palavra-chave>
Exibe uma lista das BIOS disponíveis para um determinado sistema. As opções da BIOS podem estar disponíveis para um sistema ou para quaisquer dispositivos selecionáveis via slot.
Todas as BIOS de todos os sistemas compatíveis serão listadas caso nenhuma palavra-chave seja informada.
- Exemplo:
Para sistemas Neo Geo AES.
- Exemplo:
-listmedia / -lm <sistema>
Exibe uma lista de mídias ou formatos compatíveis com o sistema, como cartucho, cassete, disquete etc. O comando também exibe as extensões compatíveis com cada sistema, caso existam. Na dúvida, execute o comando mame -lm sistema para saber quais tipos de mídia o MAME aceita e quais delas são compatíveis com o sistema em questão.
- Exemplo:
Caso queira carregar uma ROM em um sistema como o Megadrive, por exemplo, use o comando mame genesis -cart caminho_completo_para_a_rom. Outros sistemas podem aceitar outros formatos. No caso dos sistemas que rodam CD-ROM, por exemplo, as opções podem ser -cdrom caminho_completo_para_a_imagem ou -cdrm caminho_completo_para_a_imagem. Se o sistema também aceitar cartões de memória, é possível combinar a opção -cdrom caminho_completo_ para_a_imagem com -memc1 caminho_completo_para_a_imagem_do_seu_cartao_de_memoria.
-listsoftware / -lsoft <sistema>
Exibe o conteúdo de todas as listas de software que podem ser utilizadas pelo sistema ou pelos sistemas (praticamente são todos os arquivos XML encontrados dentro da pasta hash).
- Exemplo:
-getsoftlist / -glist <catálogo de programas>
Exibe o conteúdo de uma lista de software em formato XML, a mesma coisa que a opção -listsoftware acima, porém em vez do sistema, utiliza-se o nome existente no catálogo de programas.
- Exemplo:
Opções relacionadas ao que é exibido na tela (OSD)
-uimodekey <tecla>
Tecla usada para ativar ou desativar a interface de usuário (abreviada como IU), e assim poder usar os controles via teclado e mouse o teclado na IU do MAME. A configuração predefinida é a tecla SCRLOCK (Scroll Lock) no Windows e Linux, Forward Delete no macOS ou SCRLOCK em outros sistemas. Use FN-Delete em computadores/notebooks/laptops Macintosh que utilizem teclados compactos.
- Exemplo:
-controller_map / -ctrlmap <nome_do_arquivo>
O caminho para um arquivo de texto contendo os mapeamentos do controle, dos botões e do direcional no formato usado pelo SDL2 e pelo Steam, ou none, para usar apenas o mapeamento nativo do MAME. O arquivo deve usar um formato de texto compatível com ASCII e com terminações de linha nativas (CRLF no Windows, por exemplo). Atualmente é compatível apenas ao usar a opção -joystickprovider sdljoy.
É possível encontrar uma lista de controles mapeados pela comunidade pode ser encontrada no GitHub. Além de usar um editor de texto, várias ferramentas estão disponíveis para criar os mapeamentos dos controles, incluindo o SDL2 Gamepad Mapper e o SDL2 ControllerMap, que são fornecidos com o SDL. Também é possível configurar o seu controle no modo "Big Picture" do Steam e copiar os mapeamentos a partir das entradas do SDL_GamepadBind no arquivo config.vdf encontrado na pasta config dentro da pasta de instalação do Steam.
- Exemplo:
-[no]background_input
Define se a entrada será aceita ou se será ignorada quando o MAME não tiver com o foco na interface. No Windows, o RawInput é atualmente compatível com entrada de mouse e teclado. No DirectInput é compatível com entrada de mouse, teclado e joystick, e o XInput apenas com joystick. Já no SDL, o XInput é compatível com controle de jogos e joysticks. Essa configuração é ignorada enquanto o depurador estiver ativo.
O valor predefinido é
desligado. (-nobackground_input).
- Examplo:
-uifontprovider <módulo>
Define a fonte que será utilizada na interface do usuário.
O valor predefinido é
auto.
- Exemplo:
Microsoft Windows |
win |
dwrite |
auto |
sdl [9] |
none |
|
macOS |
auto |
osx |
sdl |
none |
||
Linux |
auto |
sdl |
none |
-keyboardprovider <módulo>
Escolhe como o MAME lidará com a entrada do teclado.
O valor predefinido é
auto.
- Exemplo:
Microsoft Windows |
auto [10] |
rawinput |
dinput |
win32 |
sdl [11] |
none |
SDL (macOS e Linux) |
auto [12] |
sdl |
none |
Dica
Observe que as ferramentas de emulação de teclado do modo de
usuário, como o joy2key, quase certamente exigirão o uso
da opção -keyboardprovider win32 nas máquinas Windows.
-mouseprovider <módulo>
Escolhe como o MAME lidará com a entrada do mouse. No Windows,
autotentará orawinput; caso contrário, retornará para odinput. Nas versões SDL a opçãoautoserásdl. O binário oficial do MAME para Windows não é compilado com SDL, sendo necessário compilar uma versão compatível para que a opçãosdlfuncione.O valor predefinido é
auto.
- Exemplo:
Microsoft Windows |
auto [13] |
rawinput |
dinput |
win32 |
sdl [14] |
none |
SDL (macOS and Linux) |
auto [15] |
sdl |
none |
Example:
mame indy_4610 -mouseprovider win32
-lightgunprovider <módulo>
Escolhe como o MAME lidará com a arma de luz (light gun).
O valor predefinido é
auto.
- Exemplo:
Microsoft Windows |
auto [16] |
rawinput |
win32 |
sdl [17] |
none |
|
macOS |
auto [18] |
sdl |
none |
|||
Linux |
auto [18] |
sdl |
x11 |
none |
-joystickprovider <módulo>
Escolhe como o MAME lidará com a entrada do joystick ou de um outro controle.
O valor predefinido é
auto.
- Exemplo:
Microsoft Windows |
auto [19] |
winhybrid |
dinput |
xinput |
sdlgame [20] |
sdljoy [20] |
none |
SDL |
auto [21] |
sdlgame |
sdljoy |
none |
winhybrid
Usa o
XInputpara os controles compatíveis e retornando paraDirectInputpara outros controles. Geralmente, essa configuração oferece uma melhor experiência no Windows.
dinput
Usa o
DirectInputpara todos os controles. Isso pode ser útil caso você queira usar mais de quatro controlesXInputao mesmo tempo. Observe que os controles LT e RT são combinados com o uso de controlesXInputviaDirectInput.
xinput
É compatível com até quatro controles
XInput.
sdlgame
Usa a API do controle SDL para controles com o mapeamento de botão/eixo disponíveis e retorna à API do joystick SDL nos outros controles. Fornece uma atribuição consistente dos botões, dos eixos e dos nomes dos controles mais populares. Use a opção controller_map para fornecer mapeamentos para os controles adicionais ou substituir os mapeamentos já incluídos.
sdljoy
Usa a API dos joystick em todos os controles de jogos.
none
Ignora todos os controles de jogos.
Opções de MIDI e rede
-midiprovider <módulo>
Escolhe como o MAME se comunicará com os dispositivos e aplicações MIDI (teclados musicais e sintetizadores, por exemplo). As opções compatíveis são
pmpara utilizar a biblioteca PortMidi ounonepara desativar a entrada e a saída MIDI (também é possível reprodizir arquivos MIDI).O padrão é
auto(utilizará o PortMidi se estiver disponível).
- Exemplo:
-listmidi
Exibe uma lista dos nomes dos dispositivos MIDI disponíveis para serem utilizados durante a emulação.
- Exemplo:
-midiin <nome do dispositivo>
Informe manualmente o dispositivo MIDI de entrada de sua preferência caso o seu computador ou sistema utilize mais de um. O comando apenas funciona em sistemas compatíveis e que estejam operando com uma entrada MIDI. Consulte também a opção -listslot para identificar o nome do slot. Use aspas se o nome do dispositivo contiver espaços.
- Exemplo:
-midiout <nome do dispositivo>
Informe manualmente o dispositivo MIDI de saída de sua preferência caso o seu computador ou sistema utilize mais de um. O comando apenas funciona nos sistemas compatíveis e que estejam operando com uma saída MIDI. Consulte também a opção -listslot para identificar o nome do slot. Use aspas se o nome do dispositivo contiver espaços.
- Exemplo:
-listnetwork
Lista os adaptadores de rede disponíveis para serem utilizados com a emulação.
- Exemplo:
Dica
No Windows, é necessário instalar o OpenVPN mais recente para que o MAME possa ver os adaptadores de rede.
-networkprovider <módulo>
Escolhe como o MAME oferecerá comunicação de pacotes para as interfaces de rede emuladas (placas Ethernet, por exemplo). As opções suportadas são:
taptunpara usar "TUN/TAP", TAP-Windows ou similar,pcap(biblioteca pcap) ounone(para desativar a comunicação nas interfaces emuladas de rede). As opções disponíveis dependem do seu sistema operacional. No Windows e no Linux as opções disponíveis sãotaptunenone; no macOS as opções disponíveis sãopcapenone.O padrão é
autoque usará a opçãotaptuncaso esteja disponível ou retorna parapcap.
- Exemplo:
Opções de saída das notificações de tela
-output
Escolhe como o MAME lidará com o processamento das notificações da saída. É utilizado para conectar saídas externas, como uma luz de LED nos botões iluminados de start para os jogadores 1 e 2 em determinados sistemas de arcade, assim como qualquer outro tipo de iluminação externa, caso esteja disponível.
- Exemplo:
Assim que um crédito é inserido e, se for o caso, o botão do Jogador 1 (1P) começar a piscar e os valores começam a alternar na tela. Veja como fica na máquina "Breakers":
- Exemplo:
Cada sistema terá a sua própria característica.
É possível escolher entre:
auto,none,consoleounetwork.O valor predefinido para a porta de rede é 8000.
Opções para a configuração
-[no]readconfig / -[no]rc
Ativa ou não a leitura dos arquivos de configuração, é predefinido que todos eles sejam lidos em sequência e na ordem mostrada abaixo:
mame.ini
<meumame>.ini
Caso o arquivo binário do MAME seja renomeado para mame060.exe, então o MAME carregará o aquivo mame060.ini.
debug.ini
Caso o depurador esteja ativado.
<driver>.ini
Com base no nome do arquivo fonte ou driver.
vertical.ini
Para sistemas com orientação vertical do monitor.
horizont.ini
Para sistemas com orientação horizontal do monitor.
vector.ini
Para sistemas com vetores apenas.
<parent>.ini
Para clones apenas, poderá ser chamado de forma recursiva.
<nome-do-driver-do-sistema>.ini
Para aplicar as opções apenas no driver do sistema, use o comando abaixo para saber qual o nome do driver de um determinado sistema:
- Exemplo:
mame -ls sf2 sf2 capcom/cps1.cpp
O nome do driver é cps1 (sem a extensão .cpp), portanto, o nome do arquivo de configuração deve ser cps1.ini.
Consulte o capítulo Ordem de carregamento dos arquivos de configuração para obter mais informações.
- Exemplo:
mame sf2ce -norc -ctrlr sf2
As configurações nos INIs posteriores substituem aquelas dos INIs anteriores. Então, por exemplo, caso queira desativar os efeitos de sobreposição nos sistemas vetoriais, é possível criar um arquivo vector.ini com a linha
effect nonenele, que irá sobrescrever qualquer valor de efeito existente no seu mame.ini.O valor predefinido é
ligado(-readconfig).
-[no]writeconfig / -[no]wc
Grava as configurações feitas no driver do sistema num arquivo (driver).ini ao encerrar da emulação. O valor predefinido é
desativado(-nowriteconfig).
- Exemplo:
Opções para a configuração das principais pastas
-homepath <caminho>
Define o caminho para onde os plugins Lua armazenarão os dados. O valor predefinido é '.' (na pasta raiz do MAME).
- Exemplo:
-rompath / -rp / -biospath / -bp <caminho>
Define o caminho completo para encontrar imagens ROM, disco rígido, fita cassete, etc. É possível definir mais de um caminho, desde que estejam separados por ponto e vírgula(;). O valor predefinido é roms (ou seja, uma pasta chamada roms na pasta raiz do MAME).
- Exemplo:
-hashpath / -hash_directory / -hash <caminho>
Define o caminho completo para a pasta com os arquivos hash utilizados pelo catálogo de programas no gerenciador de arquivos. É possível definir mais de um caminho, desde que estejam separados por ponto e vírgula(;). O valor predefinido é hash (ou seja, uma pasta chamada hash na pasta raiz do MAME).
- Exemplo:
-samplepath / -sp <caminho>
Define o caminho completo para os arquivos de amostras (samples). É possível definir mais de um caminho, desde que estejam separados por ponto e vírgula(;). O valor predefinido é samples (ou seja, uma pasta chamada samples na pasta raiz do MAME).
- Exemplo:
-artpath <caminho>
Define o caminho completo para os arquivos com as ilustrações gráficas (artworks) dos sistemas. Essas ilustrações são imagens que cobrem o fundo da tela e oferecem alguns efeitos interessantes. É possível definir mais de um caminho, desde que estejam separados por ponto e vírgula(;). O valor predefinido é artwork (ou seja, uma pasta chamada artwork na pasta raiz do MAME).
- Exemplo:
-ctrlrpath <caminho>
Define um ou mais caminhos para os arquivos de configuração dos controles. É possível definir mais de um caminho, desde que estejam separados por ponto e vírgula(;). É usado em conjunto com a opção ctrlr.
O valor predefinido é ctrlr (ou seja, uma pasta chamada ctrlr na pasta raiz do MAME).
- Exemplo:
-inipath <caminho>
Define um ou mais caminhos onde os arquivos .ini podem ser encontrados. É possível definir mais de um caminho, desde que estejam separados por ponto e vírgula(;).
No Windows a predefinição é .;ini;ini/presets, ou seja, a primeira procura é feita na pasta atual, a segunda na pasta ini e, por fim, na pasta presets dentro da pasta ini.
No macOS a predefinição é $HOME/Library/Application Support/mame;$HOME/.mame;.;ini, ou seja, a primeira procura é feita na pasta mame dentro da pasta Application Support do usuário atual, a segunda na pasta .mame dentro da pasta home do usuário atual, então na pasta raiz e, por fim, na pasta ini.
Em outras plataformas, como o Linux, a predefinição é $HOME/.mame;.;ini, ou seja, a primeira procura é feita na pasta .mame dentro da pasta home do usuário atual, seguida pela pasta raiz, e por fim, pela pasta ini.
mame -inipath D:\mameini
-fontpath <caminho>
Define um ou mais caminhos onde os arquivos de fonte .bdf (Adobe Glyph Bitmap Distribution Format ou formato de distribuição de mapa de bits da Adobe) possam ser encontrados. É possível definir mais de um caminho, desde que estejam separados por ponto e vírgula(;). O valor predefinido é . (ou seja, na pasta raiz do MAME).
- Exemplo:
-cheatpath <caminho>
Define o caminho completo para os arquivos de trapaça em formato .xml, .zip ou .7z. Quando mais de um caminho ou arquivo é informado, as trapaças são combinadas. É possível definir mais de um caminho, desde que estejam separados por ponto e vírgula(;). O valor predefinido é cheat (ou seja, uma pasta chamada cheat, na pasta raiz do MAME).
- Exemplo:
-crosshairpath <caminho>
Define um ou mais caminhos onde os arquivos de mira (crosshair) possam ser encontrados. É possível definir mais de um caminho, desde que estejam separados por ponto e vírgula(;). O valor predefinido é crosshair (ou seja, uma pasta chamada crosshair na pasta raiz do MAME). Se uma mira for definida no menu, o MAME procurará por nomedosistema\cross#.png, depois em crosshairpath especificado. O símbolo # indica o número do jogador.
Caso nenhuma mira seja definida, o MAME usará a sua própria.
- Exemplo:
-pluginspath <caminho>
Define um ou mais caminhos onde possam ser encontrados os plug-ins do Lua para o MAME. O valor predefinido é plugins (ou seja, uma pasta chamada chamado plugins na pasta raiz do MAME).
- Exemplo:
-languagepath <caminho>
Define um ou mais caminhos onde os arquivos de tradução usados pela interface do usuário do MAME podem ser encontrados. O valor predefinido é language (ou seja, uma pasta chamada language na pasta raiz do MAME).
- Exemplo:
-swpath <caminho>
Define um ou mais caminhos onde os arquivos avulsos dos programas (ROM, ISO, etc.) possam ser encontrados. O valor predefinido é software (ou seja, uma pasta chamada software na pasta raiz do MAME).
- Exemplo:
-cfg_directory <caminho>
Define a pasta onde os arquivos de configuração são armazenados. Os arquivos de configuração armazenam as customizações feitas pelo usuário e são lidos na inicialização do MAME ou de um sistema emulado. Ao encerrar o MAME, quaisquer alterações são salvas.
Os arquivos de configuração preservam a ordem dos botões do seu controle ou joystick, as configurações das chaves DIP, as informações da contabilidade do sistema e a organização das janelas do depurador.
O valor predefinido é cfg (ou seja, uma pasta chamada cfg na pasta raiz do MAME). Se não existir, esta pasta será criada automaticamente..
- Exemplo:
-nvram_directory <caminho>
Define a pasta onde os arquivos NVRAM serão armazenados. Os arquivos NVRAM armazenam o conteúdo da EEPROM, memória RAM não volátil (NVRAM) e informações de outros dispositivos programáveis que utilizam esse tipo de memória. As informações são lidas no início da emulação e gravadas no término.
O valor predefinido é nvram (ou seja, uma pasta chamada "nvram" na pasta raiz do MAME). Se não existir, esta pasta será criada automaticamente..
- Exemplo:
-input_directory <caminho>
Define a pasta onde os arquivos de gravação da entrada serão armazenados. As gravações de entrada são criadas pela opção -record e reproduzidas pela opção -playback. A opção grava todos os comandos e os acionamentos de botões que forem feitos durante a operação do sistema.
O valor predefinido é inp (ou seja, uma pasta chamada inp na pasta raiz do MAME). Se não existir, esta pasta será criada automaticamente..
- Exemplo:
-state_directory <caminho>
Define a pasta onde os arquivos de gravação de estado serão armazenados. Os arquivos de estado são lidos e gravados quando solicitados pelo usuário ou ao usar a opção -autosave.
O valor predefinido é sta (ou seja, uma pasta chamada sta na pasta raiz do MAME). Se não existir, esta pasta será criada automaticamente..
- Exemplo:
-snapshot_directory <caminho>
Define a pasta onde os arquivos de instantâneos da tela são armazenados quando solicitados pelo usuário.
O valor predefinido é snap (ou seja, uma pasta chamada snap na pasta raiz do MAME). Se não existir, esta pasta será criada automaticamente..
- Exemplo:
-diff_directory <caminho>
Define a pasta onde os arquivos de diferencial do disco rígido serão armazenados. Os arquivos de diferencial armazenam qualquer dado que escrito de volta na imagem do disco. Isso serve para preservar a imagem original do disco. Esses arquivos são criados no início da emulação com uma imagem compactada do disco rígido.
O valor predefinido é diff (ou seja, uma pasta chamada diff na pasta raiz do MAME). Se não existir, esta pasta será criada automaticamente..
- Exemplo:
-comment_directory <caminho>
Define a pasta onde os arquivos de comentário do depurador serão armazenados. Os arquivos de comentário do depurador são escritos pelo próprio depurador quando comentários são adicionados a um sistema descompilado (disassembly).
O valor predefinido é comments (ou seja, uma pasta chamada comments na pasta raiz do MAME). Se não existir, esta pasta será criada automaticamente..
- Exemplo:
Define a pasta que será compartilhada com o sistema ou o driver emulado. Por exemplo, no caso de um sistema operacional compatível, os arquivos colocados neste diretório serão compartilhados com o host emulado.
- Exemplo:
Opções para a gravação e a reprodução do estado da emulação
-[no]rewind
Quando ativo e a emulação for paralisada, o estado da condição da memória toda a vez que um quadro for avançado será automaticamente salvo. Ao pressionar a tecla para rebobinar passo único (Shift Esquerdo + ~) [2], as condições de estado salvas podem ser carregadas de maneira consecutiva.
O valor predefinido é
desligado(-norewind).Caso o depurador esteja no estado break, a condição de estado atual é criada a cada "step in", "step over" ou "step out". Nesse modo os estados salvos podem ser carregados e rebobinados executando o comando rewind ou rw no depurador.
- Exemplo:
mame -norewind
-rewind_capacity <valor>
Define a capacidade de rebobinar em megabytes. É a quantidade total de memória que será utilizada para rebobinar os savestates. Quando a capacidade é alcança, os savestates antigos são apagados enquanto novos são capturados. Ao definir uma capacidade menor do que o savestate atual, o rebobinamento é desativado. Valores negativos são fixados automaticamente em
0.
- Exemplo:
-statename <nome>
Descreve como o MAME deve armazenar os arquivos de estado salvos relativos ao caminho do "state_directory". <nome> é uma string (texto) que fornece um modelo a ser utilizado para gerar um nome de arquivo.
São disponibilizadas duas substituições simples: o caractere
/representa o separador de caminho em qualquer plataforma de destino (inclusive mesmo no Windows); e a string%grepresenta o nome do driver do sistema atual.O valor predefinido é
%g, que cria uma pasta separada para cada sistema.E além disso, para os drivers que usam mídias diferentes, como cartões ou disquetes, é possível usar o indicador
%d_[media]. Substitua[media]pelo comutador de mídia desejado.Alguns exemplos:
Se usar o comando mame robby -statename foo/%g%i, as capturas de tela serão salvas em sta\foo\robby\.
Se usar o comando mame nes -cart robby -statename %g/%d_cart, as capturas de tela serão salvas em sta\nes\robby.
Se usar o comando mame c64 -flop1 robby -statename %g/%d_flop1/%i, as capturas de tela serão salvas como sta\c64\robby\0000.png.
-state <slot>
Após iniciar um sistema específico, carregue imediatamente o estado salvo no <slot>.
- Exemplo:
-[no]autosave
Quando ativado, cria automaticamente um arquivo com o estado atual do sistema ao encerrar o MAME e tenta carregá-lo automaticamente caso o MAME inicie novamente com o mesmo sistema. A opção só funciona para os sistemas compatíveis com o salvamento de estado.
O valor predefinido é
desligado(-noautosave).
- Exemplo:
mame -autosave
-playback / -pb <nome do arquivo>
Reproduz um arquivo de gravação. Embora esse recurso não funcione de maneira confiável com todos os sistemas, ele pode ser usado para assistir a uma sessão de jogo gravada anteriormente do início ao fim. Para manter a consistência, apague os arquivos de configuração .cfg, NVRAM .nv e o cartão de memória antes de tentar reproduzir uma gravação. Consulte o comando -record para obter mais informações.
O valor predefinido é
NULO(sem reprodução).
- Exemplo:
Nota
Você pode ter problemas com a falta de sincronismo caso a configuração, a NVRAM, e o cartão de memória não coincidam com o original, principalmente se for usada uma versão diferente do MAME usada na gravação. É recomendável excluir a configuração (.cfg), a NVRAM (.nv) ou a pasta com o nome do sistema dentro da pasta nvram antes de iniciar uma gravação ou uma reprodução.
Aviso
Para que a reprodução (playback) funcione em alguns sistemas onde os drivers usam NVRAM, como, por exemplo, os sistemas CPS1, CPS2 e CPS3. Manter ou não o arquivo de configuração nesses casos não faz diferença alguma. Então, caso pense em compartilhar a gravação com alguém, certifique-se de enviar junto o arquivo NVRAM do sistema em questão.
Aviso
Em sistemas que não usam NVRAM como a pacman, mspacman dentre outras, elas também perdem o sincronismo e, algumas vezes, criam anomalias (bugs) apenas durante a reprodução. Neste caso apague o arquivo que mantém o registro de high score dentro da pasta hi. Se você mantém um registro de pontuações, faça um backup antes de apagar o arquivo.
-[no]exit_after_playback
O MAME encerra a emulação ao final do arquivo de reprodução se a opção -playback for usada. O padrão é não encerrar a emulação.
- Exemplo:
O valor predefinido é
desligado(-noexit_after_playback).
-record / -rec <nome do arquivo>
Faz a gravação de todos os comandos feitos pelos usuários durante uma sessão e define o nome do arquivo onde esses comandos serão registrados. No entanto, esse recurso não funciona de maneira confiável com todos os sistemas.
O valor predefinido é
NULO(sem gravação).
- Exemplo:
Aviso
Em alguns sistemas como o neogeo por exemplo, é preciso excluir a NVRAM ANTES de iniciar uma gravação ou a reprodução com -playback. Caso contrário, a reprodução pode iniciar em um estágio diferente (como na série "The King of Fighters") e fazer com que a ação não corresponda ao que foi gravado, ou até mesmo causar uma interrupção abrupta da reprodução muito antes do fim. Se for iniciar a gravação do sistema kof2002 por exemplo, dentro da pasta NVRAM, exclua a pasta kof2002 ou uma pasta kof2002_* caso ela exista. Para obter mais informações, consulte Mantenha as configurações da BIOS de um sistema ao apagar a NVRAM.
Opções para a gravação de áudio e vídeo
Em alguns casos, certos sistemas alternam a resolução da tela, o que atrapalha a gravação de vídeo. Algumas gravações podem ficar com bordas pretas na tela e com o vídeo menor no meio ou em algum outro canto da tela. Nesses casos, use as opções -noswitchres com -snapsize.
-mngwrite <nome do arquivo>.mng
Escreve cada quadro de vídeo em um arquivo <nome do arquivo> no formato MNG, produzindo uma animação da sessão. Note que a opção -mngwrite só grava quadros de vídeo, não grava qualquer áudio. Para gravar áudio, use a opção -wavwrite. Posteriormente, use uma ferramenta de edição para unir o áudio e o vídeo ou use -aviwrite para gravar ambos em um único arquivo.
O valor predefinido é
NULO(sem gravação).
- Exemplo:
-aviwrite <nome do arquivo>.avi
Grava todos os dados de áudio e vídeo em formato AVI sem compressão. É importante observar que a taxa de quadros e a resolução são sempre fixas. Vídeos sem compressão ocupam muito espaço, portanto é necessário um HD rápido (um SSD ou outro com grande velocidade de gravação, por exemplo) para que a gravação ocorra sem problemas. Para alterar a resolução do arquivo que será gravado, consulte a opção -snapsize.
Talvez seja mais prático gravar os seus comandos com -record e depois fazer o vídeo com -aviwrite combinado com -playback e -exit_after_playback.
O valor predefinido é
NULO(sem gravação).
- Exemplo:
-wavwrite <nome do arquivo>.wav
Apenas grava apenas o áudio do jogo em formato PCM de 16 bits. Para gravar com uma taxa de amostragem diferente da predefinida (48000 Hz), consulte a opção -samplerate.
O valor predefinido é
NULO(sem gravação).
- Exemplo:
Opções para a captura da tela
-snapname <nome>
Descreve como o MAME deve nomear arquivos de captura de tela. Em <nome>, indica qual o nome que o MAME usará.
São disponibilizadas três substituições simples:
O caractere
/Usado como separador de caminho em qualquer plataforma inclusive no Windows.
Especificador de conversão
%gConverte
%gpara o nome do driver que for usado.Especificador de conversão
%iCria arquivos iniciando com nome 0000 e os incrementa à medida que novas capturas sejam criadas, O MAME incrementará o valor de
%ipara o próximo valor vazio. Se o nome omitido for igual ao de uma captura já existente, ela será substituído.O valor predefinido é
%g/%i.Para os drivers que usam mídias diferentes, como cartões ou disquetes, também é possível usar
%d_[media]. Substitua[media]pelo dispositivo que deseja usar.Alguns exemplos:
Se usar o comando mame robby -snapname foo/%g%i as capturas serão salvas como snaps\foo\robby0000.png,
snaps\foo\robby0001.pnge assim por diante.Se usar o comando mame nes -cart robby -snapname %g/%d_cart as capturas serão salvas como snaps\nes\robby.png.
E por fim, mame c64 -flop1 robby -snapname %g/%d_flop1/%i estes serão salvos como snaps\c64\robby0000.png.
-snapsize <largura> x <altura>
Define um tamanho fixo para as capturas de tela e os vídeos. É predefinido que o MAME criará capturas de tela e vídeos na resolução nativa do sistema em pixels brutos. Se esta opção for usada, o MAME criará capturas de tela e vídeos no tamanho especificado, com filtro bilinear (filtro de embaçamento de pixels) aplicado no resultado final. Observe que, ao definir este tamanho, a tela não gira automaticamente caso o sistema seja orientado verticalmente.
O valor predefinido é
auto.
- Exemplo:
-snapview <tipo>
Define a visualização que será utilizada nas capturas de tela e para gravar vídeos.
É predefinido que ambos utilizem a primeira visualização que estiver disponível ou somente a da primeira tela. Ao usar esta opção, é possível alterar o comportamento predefinido da exibição e selecionar apenas a visualização que será aplicada a todas as capturas de tela e os vídeos.
Observe que o <tipo> não precisa ser o nome exato; em vez disso, o MAME selecionará a primeira exibição cujo nome corresponda ao definido por meio do <tipo>. Supondo que o nome seja Cabine Animada basta usar Cabine ou cabine.
Por exemplo, -snapview native casará a visualização Nativa em (15:14), ainda que o nome não combine perfeitamente. O <tipo> também pode ser "auto", quando será escolhida a primeira exibição de todas que existirem.
Nos casos em que você utiliza uma visualização com mais de uma opção ou que tenha nomes estranhos, nomes com caracteres não ASCII ou diferentes opções como mostrado no exemplo abaixo:
XXYYZZ_01
XXYYZZ_02
XXYYZZ_03
Use -snapview XXYYZZ_03 para definir exatamente a visualização desejada na sua captura.
O valor predefinido é internal.
- Exemplo:
-[no]snapbilinear
Especifique se o instantâneo ou vídeo deve ter filtragem bilinear aplicada. O filtro bilinear aplica um leve efeito de embaçamento ou suavização à tela, amenizando um pouco o serrilhado nos contornos gráficos e deixando a tela do sistema mais suave. Desligar essa opção pode fazer a diferença, melhorando o desempenho durante a gravação do vídeo ou deixando as capturas de tela com o pixel bruto.
O valor predefinido é
ligado(-snapbilinear).
- Exemplo:
Opções relacionadas ao desempenho e a velocidade da emulação
-[no]autoframeskip / -[no]afs
Para manter a velocidade máxima de uma emulação, a quantidade de quadros que serão pulados é ajustada dinamicamente no sistema emulado. Ao ativar esta opção, ela se sobrepõe ao que for definido em -frameskip, descrito logo abaixo.
O valor predefinido é
desligado(-noautoframeskip).
- Exemplo:
-frameskip / -fs <quantidade>
Determina a quantidade de quadros que serão ignorados. Enquanto estiver sendo executado, ela elimina cerca de 12 quadros. Se o parâmetro -frameskip 2 for definido, o MAME então exibirá 10 de cada 12 quadros, por exemplo.
Ao ignorar esses quadros, pode ser que se atinja a velocidade nativa do sistema emulado sem que haja sobrecarga no computador, ainda que ele não tenha um grande poder de processamento.
O valor predefinido é não ignorar nenhum quadro (-frameskip 0).
- Exemplo:
-seconds_to_run / -str <segundos>
Este comando pode ser usado para realizar um teste de velocidade de maneira automatizada. Ele instrui o MAME a interromper a emulação após alguns segundos. Ao combiná-lo com outras opções fixas de linha de comando, é possível definir um ambiente para realizar testes de desempenho. Ao encerrar, a opção -str captura a tela com o nome determinado pela opção -snapname dentro da pasta dos instantâneos.
O comando diz ao MAME para interromper a emulação após um tempo determinado. Esse tempo em questão não é o tempo real, e sim o tempo interno da emulação. Assim, se 30 segundos forem definidos, a parada pode demorar mais dependendo do sistema que estiver sendo emulado.
- Exemplo:
-[no]throttle
Ativa ou não a função de controle de velocidade do emulador [4]. Ao ativar esta opção, o MAME tenta manter o sistema rodando em sua velocidade nativa. Com a opção desativada, a emulação é executada na velocidade mais rápida possível. Dependendo das características do sistema emulado, o desempenho final pode se limitado pelo seu processador, pela sua placa de vídeo ou até mesmo pelo desempenho da sua memória.
O valor predefinido é
ligado(-throttle).
- Exemplo:
-[no]sleep
Quando utilizada em conjunto com o -throttle, o MAME elimina os processos não utilizados durante a limitação de velocidade da emulação, melhorando o rendimento de processamento. Em outras palavras, permite que outros programas tenham mais tempo de CPU, desde que a emulação não esteja consumindo 100% dos recursos do processador. No entanto, essa opção pode causar uma certa intermitência no desempenho caso outros programas que também demandem processamento estejam em execução junto com o MAME.
O valor predefinido é
ligado(-sleep).
- Exemplo:
-speed <fator>
Muda a forma como o MAME controla a velocidade da emulação, de modo a permitir que o sistema emulado rode em múltiplos da sua velocidade original.
Um <fator>
1.0significa que o sistema é executado á velocidade normal. Um fator0.5significa executar o sistema a metade da velocidade normal e um <fator>2.0significa executar o sistema 2 vezes mais rápido. Note que, ao alterar este valor, a velocidade de execução do áudio também será alterada proporcionalmente. A precisão interna da fração é de duas casas decimais. Assim sendo, um <fator> com o valor1.002será arredondado para1.0.O valor predefinido é
1.0.
- Exemplo:
Dica
Quando utilizada em conjunto com a opção -rec, é possível colocar o sistema em velocidade lenta durante a gravação com a opção -speed 0.3, por exemplo. Ao terminar a gravação e reproduzir o que foi gravado com a opção -pb, tudo ocorrerá à velocidade normal, como se a gravação tivesse sido feita na velocidade nativa do sistema.
- Exemplo:
A opção -sound none serve para eliminar o áudio durante a gravação em velocidade lenta. Para mais informações, consulte slowmomame.
-[no]refreshspeed / -[no]rs
Ele permite que o MAME ajuste a velocidade da emulação para que a taxa de atualização da primeira tela emulada não exceda a taxa de atualização da tela de qualquer um dos monitores do seu sistema. Visando evitar cortes no áudio ou efeitos colaterais indesejáveis, o MAME reduzirá a velocidade da emulação para 99% em casos em que, por exemplo, um monitor que funcione nativamente a 60 Hz e o sistema emulado rode a 60,6 Hz.
Utilize esta opção caso note pequenas travadas de tela durante cenas de movimentação horizontal ou vertical.
O valor predefinido é
desligado(-norefreshspeed).
- Exemplo:
-numprocessors / -np <auto|valor>
Define a quantidade de núcleos do processador que serão utilizados. A opção
autousará o número de núcleos informado pelo sistema ou pela variável de ambiente OSDPROCESSORS. Esse valor é limitado internamente para quatro vezes o número de processadores informado pelo seu sistema.O valor predefinido é
auto.
- Exemplo:
-bench <n>
Define a quantidade de segundos de emulação em <n> usados para teste de desempenho. O comando é um atalho com o comando abaixo:
-str <n> -video none -sound none -nothrottle
- Exemplo:
-[no]lowlatency
Diz ao MAME para desenhar um novo quadro antes de controlar a velocidade de emulação (throttling) visando reduzir o atraso (latência) de resposta da entrada. Essa opção é particularmente efetiva com telas que variam sua taxa de atualização (Variable Refresh Rate).
No entanto, ela pode causar um efeito colateral de despassamento ou problemas com o sequenciamento dos quadros, gerando instabilidades (especialmente em sistemas mais recentes com base 3D ou dependentes do 3D, assim como sistemas nos quais rodam um softwares similares ao sistema operacional).
O valor predefinido é
desligado(-nolowlatency).
- Exemplo:
Opções para a rotação da tela
-[no]rotate
Gira a tela para que rla corresponda à orientação normal do sistema (horizontal ou vertical). Isso garante que os sistemas orientados vertical e horizontalmente sejam exibidos corretamente, sem a necessidade de girar fisicamente a tela. Caso queira manter a disposição da tela como ela é no arcade original, mantenha esta opção desligada.
O valor predefinido é
ligado(-rotate).
- Exemplo:
-[no]ror -[no]rol
Rotacione a tela do sistema para a direita -ror ou para a esquerda -rol em relação ao seu estado normal (caso -rotate seja definido) ou seu estado nativo (caso -norotate seja definido).
O valor predefinido para ambas é
desligado(-noror, -norol).
- Exemplo:
-[no]autoror -[no]autorol
Essas opções são projetadas para uso com telas giratórias que giram apenas em uma única direção. Se a tela girar somente no sentido horário, use o comando -autorol para garantir que o sistema preencha a tela horizontalmente ou verticalmente na direção desejada. Se a sua tela girar somente no sentido anti-horário, use -autoror.
- Exemplo:
-[no]flipx -[no]flipy
Espelhe a tela do sistema horizontalmente com a opção -flipx ou verticalmente com -flipy. As inversões são aplicadas após as opções de rotação -rotate e rolagem -ror/-rol.
O valor predefinido para ambas as opções é
desligado(-noflipx, -noflipy).
- Exemplo:
Opções para a configuração de vídeo
-video < bgfx | gdi | d3d | opengl | soft | accel | none >
Define qual tipo de saída de vídeo a ser utilizado. As opções descritas aqui dependem do sistema operacional utilizado e se a versão do MAME é SDL ou não.
Opções geralmente disponíveis:
bgfx (preferível)
Determina o novo renderizador acelerado por hardware. Utilize esta opção caso a sua placa de vídeo seja compatível.
opengl
Faz a renderização do vídeo usando OpenGL, recomendado para sistemas Windows compatíveis quando as outras opções causarem problemas.
Em sistemas não Windows, essa é a opção predefinida para a renderizar a tela e para fazer a aceleração via hardware, caso seja compatível com o seu sistema operacional e com a sua placa de vídeo.
none
Não exibe janelas e nem mostra nada na tela. É utilizado principalmente utilizado para realizar testes de desempenho (benchmarks), usando apenas a CPU.
No Windows:
gdi
Diz ao MAME para usar funções gráficas mais antigas do Windows e renderizar o vídeo. Em termos de desempenho é a opção mais lenta, porém é a mais compatível com as versões mais antigas do Windows.
d3d (obsoleto)
Diz ao MAME para renderizar a tela com o Direct3D. Isso produz uma saída de melhor qualidade se comparada com a opção gdi, além de permitir opções adicionais de renderização da tela e aceleração gráfica via hardware.
É recomendável ter uma placa de vídeo mediana (2002+) ou uma placa de vídeo Intel embutida, modelo HD3000 ou superior.
Nota
Essa opção já é obsoleta para um hardware mais moderno; prefira a opção
bgfxusando o bgfx_backend comd3d11ou a versão mais recente compatível com a sua placa. Caso a sua placa seja compatível, usevulkanpara obter o melhor desempenho possível (isso também depende da compatibilidade relacionada ao desenvolvimento do MAME, do driver da sua placa de vídeo e do sistema operacional utilizado).
Em outras plataformas (incluindo o SDL no Windows):
accel
Diz ao MAME para, se possível, processar o vídeo usando a aceleração 2D do SDL.
soft
A tela é renderizada por meio de software. Por não utilizar nenhum tipo de aceleração de vídeo, o desempenho da emulação pode ser penalizado, porém, há uma maior compatibilidade em qualquer plataforma.
Predefinições até a versão 0.240:
No Windows é
d3d.No macOS é
openglpois é quase certo que exista uma pilha OpenGL compatível.No Linux é
opengl.O valor predefinido para todos os outros sistemas é
soft.- Exemplo:
mame ssf2tu -video bgfx
Predefinições após a versão 0.241:
Todos os sistemas passam a utilizar
bgfx[22].
-numscreens <quantidade>
Diz ao MAME quantas telas devem ser criadas. Para a maioria dos sistemas, só exite uma, porém alguns sistemas originalmente usavam mais de uma (como os sistemas Darius e Arcade PlayChoice-10, por exemplo). Cada tela (até quatro), possui suas próprias configurações, taxa de proporção de tela, resolução e exibição, que podem ser definidas usando uma das opções abaixo.
O valor predefinido é
1.
- Exemplo:
-[no]window / -[no]w
Inicia a tela do MAME em uma janela em vez de na tela inteira.
O valor predefinido é
desligado(-nowindow).
- Exemplo:
-[no]maximize / -[no]max
Controla o tamanho inicial da janela. Se essa opção estiver ativada, a janela será exibida com o maior tamanho possível durante a inicialização do MAME. Com a opção desligada, a emulação terá início com o tamanho aproximado ao tamanho original do sistema, e a sua escala será em apenas um eixo quando os pixels não quadrados estiverem em uso. Essa opção apenas surte efeito quando a opção -window é utilizada.
O valor predefinido é
ligado(-maximize).
- Exemplo:
-[no]keepaspect / -[no]ka
Define se a proporção da tela deve ser mantida. Quando essa opção está ativa, a taxa de proporção adequada da tela do sistema é aplicada, geralmente 4:3 ou 3:4 para monitores CRT, dependendo da orientação. No entanto, muitas outras proporções de tela já foram usadas, como 3:2 (Nintendo Game Boy) e 5:4 para algumas estações de trabalho, entre outras.
Se a tela que estiver sendo emulada ou a ilustração não preencher toda a tela, a imagem será centralizada com barras pretas adicionadas às laterais, conforme a necessidade, para ocupar os espaços não utilizados, seja na parte superior, inferior, esquerda ou direita.
Ao desativar essa opção, a tela ou ilustração poderá ser esticada livremente para preencher os espaços vazios no modo janela. Em tela cheia, a imagem ficará distorcida e fora das proporções.
Quando essa opção estiver ativa no Windows e o MAME estiver em modo janela, a proporção da tela será mantida mesmo que a janela seja redimensionada para tamanhos diferentes, desde que a tecla Ctrl seja mantida pressionada durante o redimensionamento.
O valor predefinido é
ligado(-keepaspect).
- Exemplo:
A equipe do MAME sugere veementemente que essa opção seja mantida ativada. Esticar a tela do sistema além da proporção original causa distorções na sua aparência que vão muito além da capacidade de reparo dos filtros internos do MAME.
-[no]unevenstretch / -[no]ues
Permite o uso de valores não inteiros para o redimensionamento da tela, o que pode distorcer ou esticar a imagem para preencher toda a tela. No entanto, há um preço a ser pago.
O uso de valores não inteiros causa uma interferência chamada aliasing nos pixels [30] [31]. Imagine o mapa de um jogo feito de linhas retas com 1 pixel de largura. Quando ocorre o "aliasing", a linha que originalmente era feita com 1 pixel de largura passa a ter 2 pixels ou mais. Essa interferência cria pixels onde antes não existiam, gerando distorções em todos os pixels. Abaixo, um exemplo com destaque nas regiões marcadas com vermelho, mas observe que o problema afeta toda a imagem.
Atualmente as pessoas sentem a necessidade de preencher toda a tela de uma TV 16:9 com gráficos feitos para 4:3, ainda que isso gere distorções em detrimento da desproporção dos gráficos.
Esse é um assunto bem complexo, pois, apesar de todos os pixels do lado esquerdo estarem com os quadrados perfeitos, o que significa uma proporção de pixels de 1:1, também conhecido como pixel perfect, a imagem está com as suas proporções erradas. Na época, os gráficos não foram desenvolvidos com os pixels no formato de um quadrado perfeito, e sim para terem 1 pixel mais alto visando às telas CRT 4:3 da época como mostra a imagem do lado direito.
Dica
Leia mais sobre este assunto do formato de pixel na reportagem da página Video Games Densetsu.
Assim, apesar dos pixels estarem distorcidos na imagem da direita, a proporção dos gráficos está correta! Ao mesmo, apesar de os pixels estarem perfeitos do lado esquerdo, a proporção está errada.
Com esta opção, é possível preencher a tela da sua TV 16:9 com gráficos desenvolvidos para uma tela 4:3, mas há distorções nos gráficos, que fica pior com textos.
Consulte também -aspect, -keepaspect e -prescale.
O valor predefinido é
ligado(-unevenstretch).
- Exemplo:
-[no]unevenstretchx / -[no]uesx
Permite que a proporção da tela seja desigual e que a tela ou janela possa ser preenchida (esticada) apenas na horizontal.
O valor predefinido é
ligado(-unevenstretchx).
- Exemplo:
-[no]unevenstretchy / -[no]uesy
Permite que a proporção da tela seja desigual e que a tela ou janela possa ser preenchida (esticada) apenas na vertical.
O valor predefinido é
ligado(-unevenstretchy).
- Exemplo:
-[no]autostretchxy / -[no]asxy
Ao utilizar a opção -unevenstretchx/y a tela é esticada automaticamente com base na orientação nativa do sistema.
O valor predefinido é
desligado(-noautostretchxy).
- Exemplo:
-[no]intoverscan / -[no]ios
Permite que a imagem passe dos limites da tela (overscan) de alvos inteiros e dimensionáveis.
O valor predefinido é
desligado(-nointoverscan).
- Exemplo:
-[no]intscalex / -[no]sx <fator>
Define o fator da escala para o preenchimento e a aproximação (zoom) da tela na horizontal, não causando aliasing nos pixels quando utilizado sozinho ou até o fator 4.0. Causa aliasing mínimo nos pixels quando utilizado em conjunto com a opção -intscaley.
O valor predefinido é
0.0(-nointscalex 0.0).
- Exemplo:
- -[no]intscaley / -[no]sy <fator>
Define o fator da escala para o preenchimento e a aproximação (zoom) da tela na vertical, não causando aliasing nos pixels quando utilizado sozinho ou até o fator 4.0. Causa aliasing mínimo nos pixels quando utilizado em conjunto com a opção -intscalex.
O valor predefinido é
0.0(-nointscaley 0.0).- Exemplo:
mame ssf2tu -sy 1.0 mame ssf2tu -nowindow -ka -sx 5.0 -sy 5.0
-[no]waitvsync
Aguarda o término do período de atualização da tela do monitor do seu computador antes de mostrar a imagem na tela. Caso essa opção esteja desligada, o MAME só irá mostrar a tela quando o quadro estiver pronto, mesmo que isso ocorra durante o processo de atualização da tela. Isso pode causar artefato de screen tearing [5].
O efeito "tearing" não é perceptível em todos os sistemas, mas algumas pessoas acham o consideram desagradável, algumas mais do que outras.
Os efeitos colaterais de se ativar a opção -waitvsync podem variar dependendo da combinação usada em diferentes sistemas operacionais e drivers de vídeo.
No Windows, -waitvsync será bloqueado até o próximo apagamento de vídeo, permitindo que o MAME desenhe o próximo quadro e sincronizando a taxa de quadros do sistema emulado com a taxa de quadros nativa do monitor em uso. Apenas ative esta opção caso esteja utilizando o modo janela. Em tela inteira, esta opção só é necessária caso a opção -triplebuffer não remova o efeito "tearing" indesejado. neste caso, tente usar ambas as opções -notriplebuffer -waitvsync. Note que a opção -waitvsync não funciona em conjunto com a opção -video gdi.
No macOS, -waitvsync não é bloqueado, mas o quadro completamente desenhado será exibido no próximo apagamento de vídeo (VBLANK). Isso significa que, se a taxa de quadros de um sistema emulado for maior do que a do seu sistema (ou do seu monitor), haverá uma queda periódica na velocidade dos quadros de vídeo emulados, resultando em pequenos travamentos durante as cenas com movimentos.
O valor predefinido é
desligado(-nowaitvsync).
- Exemplo:
O MAME SDL funcionará nesse modo janela caso haja compatibilidade com o seu sistema operacional, com a sua placa de vídeo e os respectivos drivers.
Para aumentar as suas chances de sucesso, rode o MAME SDL com a opção -video opengl.
-[no]syncrefresh
Ativa o controle de velocidade da taxa de atualização do seu monitor. Isso significa que a taxa de atualização usada pelo sistema será ignorada, mas o código responsável pelo som tentará manter o sincronismo com a taxa de atualização usada pelo sistema, o que pode resultar em problemas com o som.
Essa opção foi pensada para aqueles que modificaram as configurações da sua placa de vídeo, combinando uma opção a mais com as de atualização da tela. Essa opção não funciona com a opção -video gdi.
O valor predefinido é
desligado(-nosyncrefresh).
- Exemplo:
Dica
O syncrefresh pode ser útil para as pessoas com display compatível com G-Sync ou FreeSync.
-prescale <fator>
Controla a proporcionalidade da grandeza do redimensionamento do vídeo antes da aplicação de filtros ou shaders (texturas). Com o ajuste mínimo, a tela é renderizada em seu tamanho original antes de ser dimensionada. Com valores maiores, a tela é expandida pelo fator definido em <fator>. Isso gera imagens menos borradas com a opção -video d3d mas com perda de desempenho.
Experimente usar -prescale 4 ou valores maiores para atenuar um pouco as distorções causadas pela opção -unevenstretch e para reduzir o efeito de "blur", mas lembre-se de que isso aumenta o processamento.
Os valores válidos são
1(mínimo) e8(máximo).O valor predefinido é
1(-prescale 1).Funciona com todos os modos de vídeo no Windows (bgfx, d3d, etc.), mas nas outras plataformas funciona APENAS naquelas que forem compatíveis com o OpenGL. Não funciona com filtros GLSL.
- Exemplo:
-[no]filter / -[no]d3dfilter / -[no]flt
Ativa o filtro bilinear, aplica um leve efeito de embaçamento ou suavização é aplicado à tela, amenizando um pouco o serrilhado nos contornos gráficos e suavizando a tela do sistema.
Quando desativado, a imagem fica pura, com uma aparência serrilhada natural do sistema, e podem aparecer artefatos na tela em caso de redimensionamento. Se não gostar da aparência amaciada da imagem, tente aumentar o valor da opção -prescale em vez de desativar todos os filtros. Consulte também a opção -gl_glsl_filter.
O valor predefinido é
ligado(-filter).
- Exemplo:
No Windows funciona com todos os modos de vídeo (bgfx, d3d, etc.), mas nas outras plataformas apenas aqueles compatíveis com o OpenGL.
-[no]burnin
Monitora o brilho da tela durante a reprodução e, no final da emulação, gera um PNG que pode ser usado para simular um efeito burn-in [3] na tela. O PNG é criado de tal maneira que as áreas menos usadas da tela ficam totalmente brancas (pois as áreas a serem marcadas são escuras, todo o resto da tela deverá ficar um pouco mais iluminado).
A intenção é que esse PNG possa ser carregado por meio de um arquivo de ilustração usando um valor alpha pequeno, como valores entre
0.1e0.2, para se misturarem bem com o resto da tela. Os arquivos PNG gerados são gravados na pasta snap dentro da pasta nome_do_sistemaburnin-<nome.da.tela>.png.O valor predefinido é
desligado(-noburnin).
- Exemplo:
Opções para a configuração da tela inteira
-[no]switchres
Permite ou não a comutação ou a troca da resolução durante a emulação. Esta opção é necessária para as opções -resolution, evitando a troca das resoluções enquanto o modo de tela inteira estiver ativo.
Em placas de vídeo modernas, há poucas razões para alternar as resoluções, a menos que o usuário esteja tentando alcançar as resoluções exatas dos pixels dos sistemas originais, o que exige ajustes consideráveis.
Essa opção também é útil em monitores de LCD, pois eles operam com uma resolução fixa e as comutações da resolução às vezes são exageradas.
Essa opção não funciona com a opção -video gdi.
O valor predefinido é
desligado(-noswitchres).
- Exemplo:
Opções de vídeo para uso com janelas individuais
-screen[0-3] <display>
Define qual monitor físico do sistema será usado em cada janela. Para usar várias janelas, o valor da opção -numscreens deve ser aumentado. O nome de cada tela do seu sistema pode ser identificado executando o MAME com a opção -verbose. Os nomes de cada tela geralmente estão no formato: No Windows, é: \\.\DISPLAYn, e no macOS e em variantes do OpenGL, como Linux, por exemplo é screenN onde o n ou N é um número do monitor conectado.
O valor predefinido para essas opções é
auto. Isso significa que a primeira janela é colocada na primeira exibição, a segunda janela na segunda e assim por diante.
- Exemplo:
Os parâmetros -screen0, -screen1, -screen2 e -screen3 são específicos para cada janela. Já o parâmetro -screen aplica a configuração a todas elas. As opções definidas para uma janela específica têm prioridade sobre as opções das outras janelas.
Dica
Utilize a opção -verbose para ver quais os displays estão disponíveis no seu sistema e qual é a sua resolução quando estiverem conectados.
Nota
A partir de agora a opção de várias telas simultâneas pode não funcionar corretamente em alguns computadores Mac.
-aspect[0-3] <largura:altura> / -screen_aspect <num:den>
Define a proporção física do monitor para cada janela. Para usar várias janelas, é necessário aumentar o valor da opção -numscreens. A proporção física pode ser determinada medindo a largura e a altura da imagem visível da tela e definindo-as separadas por dois pontos.
O valor predefinido para essas opções é
auto.Isso significa que o MAME assume que a proporção da tela é proporcional ao número de pixels no modo de vídeo da área de trabalho para cada monitor.
Os parâmetros -aspect0, -aspect1, -aspect2 e -aspect3 são específicos para cada janela. O parâmetro -aspect se aplica à todas as janelas. As opções definidas para uma janela específica têm prioridade sobre as opções das outras janelas. Consulte -unevenstretch.
- Exemplo:
-resolution[0-3] <[largura_x_altura]@[taxa de atualização]> / -r[0-3] <[largura_x_altura]@[taxa de atualização]>
Define a resolução exata a ser exibida. No modo de tela cheia, o MAME tentará usar a resolução solicitada. A largura e a altura são obrigatórias, e a taxa de atualização é opcional.
Se uma dessas opções for omitida ou configurada para
0, o MAME determinará o modo automaticamente. Por exemplo, a opção -resolution 640x480 forçará a resolução de 640x480, a taxa de atualização será escolhida pelo MAME.Da mesma forma, o comando -resolution 0x0@60 obrigará que a taxa de atualização seja de 60 Hz, mas permitirá que o MAME escolha a resolução. O comando também funciona com
autoe é o mesmo que0x0@0.No modo janela essa resolução é usada para determinar o tamanho máximo da janela. Essa opção também requer a utilização da opção -switchres para ativar a comutação de resolução juntamente com a opção -video d3d.
O valor predefinido para essas opções é
auto.O parâmetro -resolution0, -resolution1, -resolution2 e -resolution3 se aplica a todas as janelas definidas. O parâmetro -resolution se aplica a todas elas. As opções específicas da janela substituem os valores das opções de todas as janelas.
- Exemplo:
-view[0-3] <nome>
Define a configuração da visualização inicial de cada janela. Note que o nome da visualização <nome> não precisa ser uma combinação exata; em vez disso, será selecionada a primeira exibição cujo nome corresponde a todos os caracteres especificados por <nome>. Por exemplo, -view native usa a visualização chamada "Native (15:14)", ainda que não seja o nome exato. Suponto que o nome seja Cabine Animada basta usar Cabine ou cabine e ignorando o Animada. O campo <nome> também funciona com a opção
autoque faz com que um nome seja automaticamente escolhido.O valor predefinido para estas opções é
auto.Os parâmetros -view0, -view1, -view2 e -view3 se aplicam a todas as janelas especificadas. O parâmetro -view se aplica a todas elas. As opções definidas para uma janela substituem os valores das opções de todas as janelas.
Para identificar qual o nome correto a ser utilizado com a opção -view, ao iniciar o sistema, pressione Tab e vá até Opções de Vídeo. Escolha a visualização que mais lhe agrada e encerre a emulação. Na pasta cfg, haverá um arquivo de configuração com nome_da_rom.cfg (se usarmos o exemplo abaixo o nome do arquivo será neobombe.cfg). Abra-o em um editor de texto qualquer e veja, no campo view, qual a opção está sendo usada. Use-a na linha de comando, conforme o exemplo abaixo:
- Exemplo:
Dica
Use aspas (") no início e no final do nome da visualização, caso ele tenha espaços.
Supondo que esta seja a sua opção de visualização preferida e caso queira aplicá-la a todos os sistemas deste driver, basta executar o comando mame -ls neobombe para identificá-lo. Com o nome do driver em mãos, crie o arquivo neogeo.ini dentro da pasta ini\source e use a opção view "Screen 0 Cropped (304x224)".
Salve o arquivo e rode o sistema novamente na linha de comando sem a opção -view. Note que ele já começa com a opção selecionada de visualização.
Opções para uso com as ilustrações
-[no]artwork_crop / -[no]artcrop
Ativa o recorte de arte somente na área da tela do sistema. Isso significa que sistemas com telas horizontais em modo de tela cheia podem exibir a sua ilustração à esquerda e à direita da tela.
Na interface gráfica, essa opção está disponível em Opções do vídeo > Tela #0.
O valor predefinido é
desligado(-noartwork_crop).
- Exemplo:
-fallback_artwork <nome da ilustração>
Especifica uma ilustração alternativa na ausência de uma ilustração externa ou layout interno do driver. No entanto, se houver uma ilustração externa ou um layout do driver, a ilustração aqui definida terá precedência.
- Exemplo:
Dica
É possível utilizar fallback_artwork <nome da ilustração> em
horizont.inievertical.inipara determinar diferentes ilustrações alternativas para sistemas que usam tela na horizontal e na vertical.
-override_artwork <nome da ilustração>
Impõem o uso de uma ilustração para substituir a ilustração interna ou externa do layout.
- Exemplo:
-artwork_font / -artfont <nome da fonte>
Define a fonte que será utilizada pelos elementos de texto da ilustração. O mesmo se aplica para a fonte da interface (consulte a opção uifont).
Observe que as ilustrações são normalmente projetadas em torno de uma fonte sans serif com espaçamento estreito entre os caracteres (Tahoma, que é a fonte padrão no Windows por exemplo). O uso de uma fonte com espaçamento mais amplo entre os caracteres ou de uma fonte com espaçamento fixo (uma fonte da família Courier por exemplo) pode resultar em problemas de posicionamento do texto.
- Exemplo:
Opções para os ajustes de imagem da tela
-brightness <valor>
Controla o nível de brilho ou de preto da tela. Essa opção não afeta a arte ou outras partes da imagem. Usando a interface interna do MAME, é possível configurar o brilho de cada tela do sistema e configurar o brilho de cada sistema individualmente. Ao selecionar valores menores (não menor que
0.1), a tela ficará mais escura, enquanto valores maiores (até2.0) produzirão uma tela mais clara.O valor predefinido é
1.0(-brightness 1.0).
- Exemplo:
-contrast <valor>
Ajusta a escala de luminância da tela. Essa opção não afeta a arte ou outras partes da tela. Usando a interface interna do MAME, é possível configurar o gamma para cada tela do sistema e para todos os sistemas individualmente. Essa opção define o valor inicial de luminância de todas as telas visíveis de todos os sistemas. Essa configuração oferece um ajuste linear da luminância do preto ao branco. Ao selecionar valores menores (não menor que
0.1), a luminância se aproxima mais do preto, enquanto valores maiores (até3.0) a aproximam do branco.O valor predefinido é
1.0(-contrast 1.0).
- Exemplo:
-gamma <valor>
Controle de gamma, ajusta a escala de luminância da tela. Essa opção não afeta a arte ou outras partes da tela. Usando a interface interna do MAME, é possível configurar o gamma para cada tela do sistema e para todos os sistemas individualmente. Essa opção define o valor inicial de todas as telas visíveis de todos os sistemas. Essa configuração oferece um ajuste de luminância linear de preto para o branco. Ao selecionar valores menores (até
0.1) trará a luminância mais para o preto, enquanto valores maiores (até 3.0) empurrarão essa luminância para o branco.O valor predefinido é
1.0(-gamma 1.0).
- Exemplo:
-pause_brightness <valor>
Ajusta a intensidade de brilho da tela durante a pausa.
O valor predefinido é
0.65(-pause_brightness 0.65).
- Exemplo:
-effect <nome do arquivo>
Use um arquivo .png como sobreposição na tela de qualquer sistema. Presume-se que o aquivo .png esteja em um dos diretórios raiz do artpath.
Ambas as combinações horizontais e verticais dentro do arquivo .png são repetidas para cobrir toda a tela (mas nenhuma parte da arte externa). O arquivo é renderizado na resolução nativa do sistema.
É possível adicionar o efeito de forma automática para sistemas com orientação horizontal ou vertical; basta criar os arquivos vertical.ini e horizont.ini dentro da pasta ini. No arquivo vertical.ini adicione a linha abaixo e salve ao terminar:
- Exemplo:
effect RealScanlinesVPara o arquivo horizont.ini adicione a linha abaixo e salve ao terminar:
- Exemplo:
effect RealScanlinesHConsulte o capítulo Opções para a configuração para saber quais os arquivos .ini estão disponíveis.
Para os modos de vídeo -video gdi e -video d3d, um pixel dentro do arquivo .png será mapeado para um pixel da tela. Os valores RGB de cada pixel dentro do arquivo .png são multiplicados pelos valores de RGB da tela de destino. Os arquivos de teste RealScanlinesV e RealScanlinesH estão disponíveis no site do projeto.
O valor predefinido é
noneou nenhum efeito.
- Exemplo:
Claro que os exemplos acima são apenas exemplos e uma preferência estética particular. Existem diferentes outros tipos espalhados pela internet, e também é uma questão de gosto: há quem prefira os as texturas (shaders) que dão uma aparência muito mais convincente de um monitor CRT real. Para mais informações sobre esses efeitos consulte o capítulo BGFX, HLSL, GLSL e a opção -glsl_shader_mame.
Opções para sistemas que usem gráficos vetoriais
-beam_width_min <largura>
Define a espessura mínima do feixe do vetor. Essa espessura varia entre um mínimo e um máximo à medida que a intensidade do traçado do vetor muda. Para desativar as alterações da largura do vetor com base na intensidade, defina o mesmo valor para -beam_width_max e -beam_width_min.
- Exemplo:
-beam_width_max <largura>
Define a espessura máxima do feixe do vetor. Essa espessura varia entre um mínimo e um máximo à medida que a intensidade do traçado do vetor muda. Para desativar as alterações da largura do vetor com base na intensidade, defina o mesmo valor para -beam_width_max e -beam_width_min.
- Exemplo:
-beam_dot_size <tamanho>
Fator de escala que será aplicado ao tamanho dos pontos nos jogos vetoriais com ponto único. Normalmente esses são renderizados de acordo com a largura do feixe computado, no entanto, é comum que isso produza pontos difíceis de serem vistos. Esta opção aplica um fator de escala na largura do feixe para que esses fiquem mais visíveis.
- Exemplo:
-beam_intensity_weight <altura>
Define a intensidade do feixe do vetor. Esse valor determina como a intensidade afeta a largura. O valor
0(zero) cria um mapeamento linear a partir da intensidade da largura. Valores negativos fazem com que os vetores de menor intensidade aumentem sua largura máxima mais rapidamente, enquanto valores positivos o fazem mais lentamente.
- Exemplo:
-flicker <valor>
Simula um vetor de efeito de tremulação ou de oscilação da tela, semelhante ao que é visto em monitores desregulados, utilizados em jogos vetoriais. É necessário informar um valor flutuante (float) no intervalo entre
0.00e100.00(0= nenhum e100= máximo).O valor predefinido é
0(-flicker 0.0).
- Exemplo:
Opções das principais características do vídeo OpenGL
Essas são as opções compatíveis com a opção -video opengl. Caso apareçam artefatos na tela, os desenvolvedores poderão solicitar que você tente alterá-los. No entanto, normalmente esses valores devem ser mantidos com seus valores originais para que se obtenha o melhor desempenho possível.
-[no]gl_forcepow2texture
Sempre utilize a potência de 2 para o tamanho das texturas.
O valor predefinido é
desligado(-nogl_forcepow2texture).
-[no]gl_notexturerect
Não use o OpenGL GL_ARB_texture_rectangle
O valor predefinido é
ligado(-gl_notexturerect).
-[no]gl_vbo
Ative o OpenGL VBO (Vertex Buffer Objects) caso esteja disponível.
O valor predefinido é
ligado(-gl_vbo).
-[no]gl_pbo
Ativar o OpenGL PBO (Pixel Buffer Objects) caso esteja disponível.
O valor predefinido é
ligado(-gl_pbo).
Opções de vídeo OpenGL GLSL
-[no]gl_glsl
Ativar o OpenGL GLSL caso esteja disponível.
O valor predefinido é
desligado(-nogl_glsl).
- Exemplo:
-gl_glsl_filter <valor>
Ativa a interpolação da imagem OpenGL GLSL, os valores válidos [6] são:
0, Simples: método de interpolação rápida e menos precisa, deixa os pixels com aparência serrilhada pois utiliza a técnica de interpolação do vizinho mais próximo.
1, Bilinear: método de interpolação lento e de qualidade mediana, que suaviza a transição entre as cores dos pixels, deixando a imagem como um todo mais suave. Consulte também a opção -filter.
2, Bicúbico: método de interpolação lento e mais preciso, que suaviza a transição entre as cores dos pixels próximos, gerando uma gradação mais suave. Também suaviza a imagem, porém não tanto quanto o método bilinear.O valor predefinido é
1(-gl_glsl_filter 1).
- Exemplo:
-glsl_shader_mame[0-9]
Define um efeito de textura (shader) OpenGL GLSL personalizada do MAME no slot fornecido entre
0e9. É possível aplicar um para cada slot. O MAME não vem com nenhuma textura (shader), mas alguns podem ser encontrados online, como no mameau e no mameworld.
- Exemplo:
O valor predefinido é
NULO(sem efeitos).
-glsl_shader_screen[0-9]
Define um efeito de textura (shader) OpenGL GLSL personalizada do MAME que é escalado na tela para ser processado pela sua placa de vídeo no slot fornecido entre
0e9. Como no exemplo anterior, o MAME não vem com nenhuma textura (shader).
- Exemplo:
O valor predefinido é
NULO(sem efeitos).
Opções para a configuração do áudio
-samplerate <valor> / -sr <valor>
Define a taxa de amostragem do áudio. Valores menores, como
11025, por exemplo, reduzem a qualidade do áudio, porém melhoram o desempenho da emulação. Valores maiores que48000, por outro lado, aumentam a qualidade do áudio, mas reduzem o desempenho da emulação.Nota
Observe que nem toda a placa de áudio suporta uma taxa de amostragem baixa como
11025ou até mesmo taxas muitos mais altas que48000. Consulte antes quais são os limites da sua placa de áudio.O valor predefinido é
48000(-samplerate 48000).
- Exemplo:
-[no]samples
Use arquivos de amostra, se houver. Esses arquivos são gravações analógicas feitas para registrar os efeitos de áudio usados por alguns sistemas.
O valor predefinido é
ligado(-samples).
- Exemplo:
-volume / -vol <valor>
Define o volume inicial. Ele pode ser alterado posteriormente usando a interface do usuário (consulte o capítulo Teclas já predefinidas). O valor do volume está definido em decibéis (dB); por exemplo, -volume -12 iniciará a emulação com uma atenuação de -12 dB. Observe que, caso o volume seja alterado na interface do usuário, ele será salvo no arquivo de configuração do sistema. O valor do arquivo de configuração do sistema tem prioridade sobre as configurações de volume nos arquivos INI.
O valor predefinido é
0(-volume 0, sem atenuação com volume no máximo).
- Exemplo:
-sound < wasapi | xaudio2 | coreaudio | pipewire | pulse | sdl | portaudio | none >
Define o módulo de áudio a ser usado. Ao selecionar
none, desativa completamente a saída e a entrada de áudio, embora o hardware de áudio ainda seja emulado.Os recursos disponíveis, o desempenho e a latência (atraso) variam entre os módulos de áudio. A interpretação exata e o intervalo útil da opção de latência também variam entre os módulos de áudio. Talvez seja necessário ajustar a configuração de latência se você trocar de módulo de áudio.
Ao usar o subsistema de áudio
sdl, a API de áudio pode ser selecionada com a configuração da variável de ambiente SDL_AUDIODRIVER. As APIs de áudio disponíveis dependem do sistema operacional. No Windows, talvez seja necessário definirSDL_AUDIODRIVER=wasapise nenhuma saída de áudio for produzida por padrão.O valor predefinido é
wasapino Windows, no Mac écoreaudioe nas outras plataformas ésdl.
- Exemplo:
Módulo |
Compatibilidade |
Entrada |
Monitoramento [23] |
Multicanal |
Alterações no dispositivo |
|---|---|---|---|---|---|
|
Windows |
Sim |
Sim |
Sim |
Sim |
|
Windows |
Não |
Não |
Sim |
Sim |
|
macOS |
Não |
Não |
Não |
Não |
|
Linux |
Sim |
? |
Sim |
Sim |
|
Linux |
Não |
Não |
Sim |
Sim |
|
Todos [24] |
Não |
Não |
Sim [25] |
Não |
|
Todos |
Sim |
Sim [26] |
Sim |
Não |
-audio_latency <valor> / -alat <valor>
Convencionalmente, a latência do áudio é medida em número de quadros de áudio, sendo que um quadro corresponde a 20 ms. Não são necessários números inteiros; por exemplo, um valor de
1.5corresponde a 30 ms. Valores menores resultam em menos atraso de áudio, mas exigem um sistema com melhor desempenho. Valores maiores aumentam o atraso de áudio, mas podem ajudar a evitar o esvaziamento da memória intermediária (buffer) e as interrupções de áudio. Um valor de0usa a configuração padrão do módulo selecionado.Talvez seja necessário ajustar essa configuração se você alterar o módulo de áudio com a opção -sound. Está opção não é compatível com os módulos
pipewire,pulseesdl.Os valores válidos variam entre
0e50. O valor predefinido é0.
- Exemplo:
Opções para as configurações de diferentes entradas
-[no]coin_lockout / -[no]coinlock
Simula o recurso "bloqueio de ficha", implementado em vários PCIs de jogos de arcade. Antes, cabia ao operador saber se as saídas de bloqueio da moeda estavam realmente conectadas aos mecanismos das moedas. Se esse recurso estiver ativado, as tentativas de inserir uma moeda enquanto o bloqueio estiver ativo falharão e uma mensagem será exibida na tela (no modo de depuração). Se a função estiver desativada, o sinal de bloqueio da moeda será ignorado.
O valor predefinido é
ligado(-coin_lockout).
- Exemplo:
-ctrlr <controle>
Define um arquivo de configuração personalizada do controle, normalmente usado para definir novas atribuições das entradas predefinidas. Todas as pastas definidas em ctrlr são pesquisadas. Os arquivos de configuração do controle utilizam um formato similar ao .cfg, utilizado para gravar as configurações do sistema. Esses arquivos são criados durante a configuração dos botões do controle de um sistema e são gravados na pasta cfg como nome_do_sistema.cfg. Para mais informações, consulte os capítulos Arquivos de configuração para os controles e Configurando a ordem dos botões.
O valor predefinido é
NULO(nenhum arquivo de configuração).
- Exemplo:
-[no]mouse
Define se o MAME faz uso ou não do mouse. Caso essa opção esteja ativa, o mouse ficará reservado para uso exclusivo do MAME até que a emulação seja pausada ou até que a emulação seja encerrada. A compatibilidade depende da configuração do seu -mouseprovider.
Observe que, se esta opção estiver desligada (-nomouse), a entrada do mouse ainda pode estar ativa, dependendo da entrada presente no sistema emulado e da sua definição automática de entrada. Mais especificamente, o padrão é ativar a entrada do mouse quando o sistema emulado tiver entradas para o mouse (-mouse_device mouse), de modo que o ponteiro do seu mouse será capturado pelo MAME caso o sistema emulado tenha tal entrada, a menos que você altere a configuração através da opção -mouse_device.
O valor predefinido é
desligado(-nomouse).
- Exemplo:
-[no]joystick / -[no]joy
Define se o MAME faz uso ou não de controle de jogos (joystick, gamepad e outras simulações de controles). A compatibilidade com os controles depende da configuração do seu -joystickprovider. Se essa opção estiver ativa, o MAME perguntará sobre quais os controles estão atualmente conectados no sistema.
Observe que, se esta opção estiver desligada (-nojoystick), a entrada do joystick ainda pode estar ativa, dependendo da entrada presente no sistema emulado e da sua definição automática de entrada.
O valor predefinido é
desligado(-nojoystick).
- Exemplo:
-[no]lightgun / -[no]gun
Define se o MAME faz uso ou não de controles tipo arma de luz (lightgun). Observe que a maioria das armas de luz é mapeada para o mouse. Assim, ao usar as opções -lightgun e -mouse juntas, resultados inesperados podem ser obtidos. O suporte aos controladores da arma de luz depende das configurações do -lightgunprovider. Para mais informações, consulte o capítulo Funcionamento.
Observe que, se esta opção estiver desligada (-nolightgun), a entrada para a arma de luz ainda pode estar ativa, dependendo da entrada presente no sistema emulado e a sua definição automática de entrada.
O valor predefinido é
desligado(-nolightgun).
- Exemplo:
-[no]multikeyboard / -[no]multikey
Determina se o MAME diferencia entre os vários tipos de teclado disponíveis. Alguns sistemas podem reportar mais de um teclado; por padrão, os dados de todos esses teclados são combinados para que pareçam um só. Ao ativar essa opção, o MAME retornará quais teclas foram pressionadas em diferentes teclados de maneira independente.
O valor predefinido é
desligado(-nomultikeyboard).
- Exemplo:
-[no]multimouse
Determina se o MAME diferencia entre os vários mouses disponíveis. Alguns sistemas podem reportar mais de um dispositivo de mouse; por padrão, os dados de todos esses mouses são combinados para que pareçam um só. Ao ativar esta opção, o MAME relatará o movimento e a pressão de botões do mouse de maneira independente, em diferentes mouses.
O valor predefinido é
desligado(-nomultimouse).
- Exemplo:
-[no]steadykey / -[no]steady
Alguns sistemas exigem que dois ou mais botões sejam pressionados exatamente ao mesmo tempo para executar movimentos ou comandos especiais. Devido à limitação do hardware do teclado, pode ser difícil ou até mesmo impossível realizar esse tipo de operação com um teclado comum. Essa opção seleciona diferentes modos de manuseio, o que torna mais fácil registrar o pressionamento simultâneo das teclas. Porém, tem a desvantagem de deixar a sua capacidade de resposta mais lenta.
O valor predefinido é
desligado(-nosteadykey).
- Exemplo:
-[no]ui_active
Ativa a opção para que a interface do usuário se sobreponha à do teclado emulado, caso esteja presente.
O valor predefinido é
desligado(-noui_active).
- Exemplo:
-joystick_map / -joymap <mapa>
Controla como os valores do joystick analógico são mapeados para os controles em um joystick digital.
Sistemas como o Pac-Man utilizam um controle digital com quatro posições (4-way joystick ou joystick de 4 vias), que exibe um comportamento inapropriado quando a diagonal é acionada: o Pac-Man simplesmente para nos cruzamentos do mapa, fazendo com que seja quase impossível jogá-lo direito ou, pelo menos, da maneira como foi desenvolvido para ser jogado. Outros sistemas arcade utilizam controles digitais do tipo 4-way ou 8-way (em vez de utilizarem controles analógicos). Assim, controles analógicos, como os utilizados em sistemas de voo com manches ou "thumb sticks" analógicos, precisam ser mapeados para valores correspondentes aos controles digitais com 4 ou 8 posições.
Para tanto, o MAME divide o alcance do controle analógico em uma grade 9x9, muito semelhante ao desenho abaixo:
Então, o MAME assume a posição do eixo do joystick (apenas os valores nos eixos X e Y), mapeia para esta grade e monitora a tradução a partir do mapa do joystick. Este parâmetro permite que você defina tal mapa.
Um joystick com 8 posições, por exemplo, se assemelha à imagem abaixo:
Esse mapeamento oferece uma grande margem de manobra para os ângulos aceitos em uma determinada direção, de modo que o controle se aproxime bastante da área desejada. Caso esteja um pouco fora do eixo central enquanto segura o controle para a esquerda, o sistema não reconhecerá a ação de forma adequada.
O valor predefinido é
auto, o que significa que o controle padrão com 4, 8 posições ou um mapa diagonal para um controle com 4 posições é selecionado automaticamente com base nas informações da configuração da porta de entrada do sistema atual.Caso queira configurar a opção -joystick_map de forma individual através do <sistema>.ini, em vez da configuração do mame.ini, para que tais configurações afetem apenas os sistemas que necessitem desses mapeamentos. Para obter mais informações consulte o capítulo Diversos arquivos de configuração.
Os mapeamentos são definidos como uma cadeia de caracteres e números. Como a grade possui 9x9, existem 81 caracteres no total para que seja possível definir um mapa completo. Abaixo, há um exemplo de um mapa para um joystick com 8 posições, que coincide com a imagem anterior.
Para definir um mapa com esses parâmetros, informe a cadeia de caracteres com as linhas separadas por um ponto (.) que indica o final de uma linha:
- Exemplo:
Contudo, é possível reduzir o tamanho do comando utilizando atalhos compatíveis com o parâmetro <mapa>. Se uma linha não tiver informações, presume-se que os dados faltantes nas colunas 5-9 sejam simétricos em relação à posição esquerda/direita em relação aos dados das colunas 0-4. O mesmo raciocínio vale para os dados que faltam nas colunas 0-4. A mesma lógica se aplica às linhas faltantes, exceto quando se assume a simetria cima/baixo.
Ao utilizar esta forma abreviada, os 81 caracteres deste mapa podem ser simplificados para uma cadeia com 11 caracteres:
7778...4445(o que significa que podemos utilizar o comando -joymap 7778...4445).Olhando para a 1ª fileira, o
7778tem apenas 4 caracteres. Não é possível utilizar a simetria na 5º entrada, então deduz-se que seja igual ao caractere anterior, '8'. O 6º caractere é simétrico à posição esquerda/direita em conjunto com o 4º caractere, resultando em um "8". O 7º caractere é simétrico com a posição esquerda/direita em conjunto com o 3º caractere, dando um "9" (que é "7" com os lados esquerdo e direito invertidos). Por fim, retorna o conjunto completo da linha777888999.As carreiras dois e três estão faltando, então deduz-se que sejam idênticas à primeira linha. A 4ª carreira é decodificada de forma semelhante à 1ª, gerando
444555666. A quinta carreira está faltando, deduz-se, então, que seja a mesma que a 4ª.As outras três carreiras também estão faltando, então deduz-se que sejam espelhos do sentido cima/baixo das três primeiras, gerando as carreiras finais com
111222333.Em sistemas compatíveis com controles de quatro posições, o "sticky" (pegadiço) é importante para eliminar os problemas com as diagonais, ou seja, tudo o que for definido nessa área será ignorada pelo MAME. Geralmente, seria escolhido um mapa semelhante a este:
Se você pressioná-lo e depois girar o controle para cima (sem passar pelo centro), o eixo do controle passará canto pegadiço, fazendo com que o movimento "pegue" ou "raspe" o manche nas diagonais, o que atrapalhará o movimento. Durante o movimento, o MAME interpretará essa posição como esquerda, ignorando a região pegadiça. Até que o movimento chega à posição superior do mapa, resultando no movimento para cima.
O mapa ficaria então muito parecido com isso:
Para definir um mapa com esses parâmetros ,informe a cadeia de caracteres com as linhas separadas por um ponto (.) que indica o final de uma linha:
- Exemplo:
-joymap s8888888s.4s88888s6.44s888s66.444555666.444555666.444555666.44s222s66.4s22222s6.s2222222sAssim como antes, por causa da simetria entre cima, baixo, esquerda e direita, podemos reduzir o comando para:
- Exemplo:
-joymap s8.4s8.44s8.4445
-joystick_deadzone / -joy_deadzone / -jdz <valor>
Caso esteja utilizando um joystick analógico, ele poderá estar um pouco fora de centro. O -joystick_deadzone informa uma folga ao longo de um eixo que deve ser ajustada antes que o eixo comece a mudar. Essa opção espera um valor flutuante (float) no intervalo entre
0.0e1.0. Onde0é o centro do joystick e1é o limite externo.Em ocasiões em que o joystick aparente ser muito sensível, tente alterar o valor de -joystick_deadzone para
0e o -joystick_saturation para1.O valor predefinido é
0.3(-joystick_deadzone 0.3).
- Exemplo:
-joystick_saturation / joy_saturation / -jsat <valor>
Caso esteja utilizando um joystick analógico, as extremidades podem estar um pouco fora de centro e não corresponderem às direções +/-. O -joystick_saturation define se uma folga no movimento do eixo será aceita até que o alcance máximo seja atingido. Essa opção espera um valor flutuante (float) no intervalo entre
0.0até1.0. Onde0é o centro do joystick e1é o limite externo.O valor predefinido é
0.85(-joystick_saturation 0.85).
- Exemplo:
-joystick_threshold <valor> / joy_threshold <valor> / -jthresh <valor>
Quando um eixo do joystick (ou outro eixo analógico absoluto) for atribuído a uma entrada digital, ele controla o quanto deve ser movido da posição neutra (ou centro) para ser considerado ativo ou ligado. Espera-se uma flutuação na faixa entre
0.0e1.0, sendo que0significa que qualquer movimento da posição neutra é considerado ativo, e1significa que apenas os limites externos são considerados ativos. Esse limite não é ajustado para a faixa entre a zona morta e o ponto de saturação. Observe que, caso um mapa do joystick seja configurado, essa configuração terá precedência sobre esta quando os eixos principais X/Y de um joystick forem atribuídos às entradas digitais.O valor predefinido é
0.3.
- Exemplo:
-[no]natural
Permite que o usuário defina se deve ou não usar um teclado natural. Isso permite que o sistema funcione em modo nativo, dependendo da sua região, garantindo compatibilidade com teclados fora do padrão "QWERTY".
O valor predefinido é
desligado(-nonatural).No modo de "teclado emulado" (predefinido), o MAME traduz a pressão/liberação de teclas/botões do host em pressionamentos emulados de tecla. Ao pressionar ou soltar uma tecla ou botão mapeado para uma tecla emulada, o MAME pressiona ou libera a tecla emulada.
No modo "teclado natural", o MAME tenta traduzir os caracteres para as teclas digitadas. O sistema operacional traduz pressionamentos de tecla a caracteres (da mesma forma que quando se digita em um editor de texto) e o MAME tenta traduzir esses caracteres para pressionamentos de tecla emulados.
Existem várias limitações inevitáveis no modo "teclado natural":
É necessário que o driver do sistema emulado ou do dispositivo de teclado precisam seja compatível e tenha suporte para ele.
O teclado selecionado deve corresponder ao layout do teclado selecionado no sistema operacional emulado.
As teclas que não produzam caracteres não serão traduzidas.
Segurar uma tecla até que o caractere se repita, fará com que ela seja pressionada repetidamente, em vez de ser mantida pressionada.
As sequências de chaves inativas, na melhor das hipóteses, são complicadas de se usar.
Não funcionará se a edição do IME estiver envolvida como no caso do chinês/japonês/coreano, por exemplo)
- Exemplo:
-[no]joystick_contradictory
Aceita a entrada de comandos contraditórios e simultâneos no controle digital, como combinações simultâneas de esquerda e direita ou cima e baixo, por exemplo.
O valor predefinido é
desligado(-nojoystick_contradictory).
- Exemplo:
-coin_impulse [n]
Define o tempo do sinal de impulso da moeda/ficha com base em n (
n<0desativa,n==0obedece o driver,0<ndefine o tempo em n).O valor predefinido é
0(-coin_impulse 0).
- Exemplo:
Opções das entadas principais ativadas automaticamente
-paddle_device / -paddle
Opções válidas
none|keyboard|mouse|lightgun|joystick
-adstick_device / -adstick
Opções válidas
none|keyboard|mouse|lightgun|joystick
-pedal_device / -pedal
Opções válidas
none|keyboard|mouse|lightgun|joystick
-dial_device / -dial
Opções válidas
none|keyboard|mouse|lightgun|joystick
-trackball_device / -trackball
Opções válidas
none|keyboard|mouse|lightgun|joystick
-lightgun_device
Opções válidas
none|keyboard|mouse|lightgun|joystick
-positional_device
Opções válidas
none|keyboard|mouse|lightgun|joystick
-mouse_device
Opções válidas
none|keyboard|mouse|lightgun|joystickCada uma dessas opções de controle define se o
mouse, ojoystickou olightgundevem ser ativados ao executar a emulação de um sistema que usa uma classe específica de entradas analógicas. Essas opções podem definir o -mouse, o -joystick ou o -lightgun, dependendo do tipo de entrada disponível no sistema emulado. Observe que essas opções não substituirão as configurações usadas explicitamente na linha de comando de -nomouse, -nojoystick ou -nolightgun em um nível de prioridade mais alto (estamos falando de um arquivo INI mais específico ou na linha de comando, por exemplo).Por exemplo, se você definir a opção -paddle_device mouse, os controles do mouse serão automaticamente ativados ao executar um jogo que tenha controles do tipo "paddle" (como o Super Breakout, por exemplo), mesmo que você tenha usado a opção -nomouse.
A predefinição é ativar os controles do mouse automaticamente ao executar sistemas emulados com entradas do mouse (-mouse_device mouse).
- Exemplo:
Dica
Observe que essas configurações podem substituir as opções -nomouse, -nojoystick ou -nolightgun, dependendo das entradas presentes no sistema emulado.
Opções voltadas para a depuração
-[no]verbose / -[no]v
Este é o modo loquaz [7], que exibe todas as informações de diagnóstico disponíveis. Essas informações são úteis para identificar qualquer tipo de problema com a sua configuração ou qualquer outro que possa aparecer. IMPORTANTE: para entrar em contato conosco para relatar um erro, rode o MAME com a opção -verbose e inclua essa saída ao seu relato.
O valor predefinido é
desligado(-noverbose).
- Exemplo:
-[no]oslog
Escreve mensagens de diagnósticos do sistema em um arquivo error.log.
É predefinido que as mensagens de erro sejam enviadas para a saída padrão, que geralmente é exibida no terminal, prompt de comando ou em um arquivo de log do sistema. No Windows, se um depurador estiver sendo usado, como o depurador do Visual Studio ou WinDbg, as mensagens de erros serão enviadas para ele em vez de serem exibidas no terminal.
O valor predefinido é
desligado(-nooslog).
- Exemplo:
-[no]log
Cria um arquivo chamado error.log, que contém todas as mensagens internas gerada pelo núcleo do MAME e pelos drivers do sistema. Isso pode ser usado em conjunto com a opção -oslog para escrever os dados de saída de ambos simultaneamente.
O valor predefinido é
desligado(-nolog).
- Exemplo:
-[no]debug / -[no]d
Ativa o depurador embutido no MAME. Ele entra em ação ao pressionar a tecla til ~ [8] e a tecla de acento grave \ durante a emulação. Ele também é direcionado para o depurador quando a emulação é redefinida, caso esta opção esteja ativa. Consulte -debugger para obter mais informações sobre como usar o depurador.
O valor predefinido é
desligado(-nodebug).
- Exemplo:
-debugger <módulo>
Escolhe o módulo que será usado para depurar o sistema quando a opção -debug estiver ativada. A disponibilidade dos módulos de depuração depende da plataforma e das opções de compilação.
Abaixo, estão os módulos compatíveis com esta opção:
windowsDepurador Win32 GUI (padrão no Windows). Compatível apenas no Windows.
qtDepurador Qt GUI (padrão no Linux). Ele é compatível com Windows, Linux e macOS, mas é incluído apenas no Linux. Para torná-lo disponível no Windows ou macOS, defina a opção
USE_QTDEBUG=1ao compilar o MAME.
osxDepurador Cocoa GUI (padrão no macOS). Compatível apenas no macOS.
imguiO depurador ImgUi GUI é exibido na primeira janela do MAME. É preciso definir a opção -video como
bgfx. Ele é compatível com todas as plataformas que suportem a opção BGFX.
gdbstubEle atua como um servidor de depuração remota para o depurador GNU (GDB). O MAME suporta apenas um pequeno subconjunto emulado das CPUs. Utilize as opções debugger_port e debugger_host para definir a porta de escuta e o endereço. É compatível com todas as plataformas que tenham suporte a TCP/IP.
- Examplo:
-debugscript <nome do arquivo>
Define um arquivo que conterá a lista de comandos de depuração a que serão executados no momento da inicialização.
O valor predefinido é
NULO(nenhum comando).
- Exemplo:
-[no]update_in_pause
Ativa a atualização do bitmap inicial da tela enquanto o sistema estiver em pausa. Isso significa que a opção de retorno VIDEO_UPDATE sempre será chamada durante a pausa, o que pode ser útil para depurar o sistema.
O valor predefinido é
desligado(-noupdate_in_pause).
- Exemplo:
-debugger_port <porta>
Define o número da porta TCP para aceitar as conexões GDB ao usar o módulo de depuração do GDB (consulte a opção -debugger).
A porta predefinida é
23946.
- Exemplo:
-debugger_font <nome da fonte> / -dfont <nome da fonte>
Define o nome da fonte a ser usada nas janelas do depurador.
A fonte predefinida é Lucida Console. Mo Mac (Cocoa), a fonte predefinida é o padrão da fonte de tamanho fixo do sistema (geralmente a fonte Monaco). A fonte padrão do Qt é Courier New.
- Exemplo:
-debugger_font_size <pontos> / -dfontsize <pontos>
Define o tamanho da fonte a ser usada nas janelas do depurador em pontos.
O tamanho padrão da janela é de
9pontos.O tamanho padrão do Qt é de
11pontos.O tamanho padrão do Mac (Cocoa) é o tamanho padrão usado pelo sistema.
- Exemplo:
-watchdog <tempo> / -wdog <tempo>
Ativa o temporizador watchdog interno que vai matar o processo do MAME automaticamente caso o tempo de duração definido em <tempo> passe sem que haja nenhuma atualização de quadro. Tenha em mente que alguns sistemas ficam parados por algum tempo durante o carregamento da tela, então <duration> deve ser grande o suficiente para levar esse tempo extra em consideração. Geralmente, um valor entre
10e30é suficiente.O valor predefinido é
Nenhum.
- Exemplo:
-debugger_host <endereço>
Defina o endereço IP que será utilizado para ouvir e aceitar conexões GDB ao usar o módulo de depuração do GDB (consulte a opção -debugger).
O valor predefinido é
localhost.
- Examplo:
Opções para a configuração da rede
-comm_localhost <endereço>
Definição para o endereço local. Ele pode ser um endereço tradicional, como
192.168.0.1, ou um nome de host que possa ser resolvido.O valor predefinido é
0.0.0.0.
- Exemplo:
-comm_localport <porta>
Definição da porta local. Ela pode ser qualquer porta de comunicação tradicional, com um valor inteiro entre
0e65535.O valor predefinido é
15112.
- Exemplo:
-comm_remotehost <endereço>
Definição do endereço remoto. Ele pode ser um endereço tradicional, como
192.168.0.1, ou um nome de host que possa ser resolvido.O valor predefinido é
0.0.0.0.
- Exemplo:
-comm_remoteport <porta>
Definição da porta remota. Ela pode ser qualquer porta de comunicação tradicional, como um valor inteiro non-signed de 16-bit entre
0e65535.O valor predefinido é
15112.
- Exemplo:
-[no]comm_framesync
Sincroniza os quadros entre os hosts na rede.
O valor predefinido é
desligado(-nocomm_framesync).
- Exemplo:
Opções diversas
-[no]drc
Se disponível, ativa os núcleos DRC da CPU (Recompilador Dinâmico). Desative esta opção para usar os núcleos da CPU do interpretador. Esta opção não afeta CPUs que suportam apenas um tipo de núcleo.
Na recompilação dinâmica, as instruções são traduzidas em tempo real, de modo a serem o mais próximas possível do sistema que está sendo emulado. Elas são reagrupadas em código de alto nível, que é então compilado na linguagem nativa do sistema hospedeiro. A grande vantagem dessa técnica é a melhor adequação do código gerado, o que resulta em melhor desempenho e eficiência durante a execução. Por outro lado, é necessário um poder de processamento muito maior para que isso seja possível.
O valor predefinido é
ligado(-drc).
- Exemplo:
-[no]drc_rwx
Se compatível, permita que os núcleos DRC utilizem memória que seja simultaneamente gravável e executável. Desativar esta opção pode diminuir o desempenho. Observe que esta opção afeta apenas os núcleos DRC da CPU e é ineficaz em configurações que não permitem que a memória seja simultaneamente gravável e executável (versões recentes do macOS e NetBSD por exemplo).
O valor predefinido é
ligado(-drc_rwx).
- Exemplo:
-[no]drc_use_c
Obriga que os núcleos DRC da CPU a usar o back-end de código C portátil quando um back-end nativo estiver disponível. Essa opção afeta apenas os núcleos DRC da CPU e não tem efeito se um back-end DRC nativo não estiver disponível.
O valor predefinido é
desligado(-nodrc_use_c).
- Exemplo:
-[no]drc_log_uml
Grava um registro descompilado DRC UML em um arquivo (log).
O valor predefinido é
desligado(-nodrc_log_uml).
- Exemplo:
-[no]drc_log_native
Grava o DRC nativo e descompilado em um arquivo log em formato assembler.
O valor predefinido é
desligado(-nodrc_log_native).
- Exemplo:
-bios <nome da bios>
Determina qual BIOS usar no sistema a ser emulado em sistemas que fazem uso de uma BIOS. A opção -listbios listará todos os nomes disponíveis das BIOS para o sistema, assim como a opção -listxml.
Não há valor predefinido: o MAME usará a primeira BIOS nativa do sistema, caso uma esteja disponível).
- Exemplo:
-[no]cheat / -[no]c
Ativa o cardápio de trapaças, exibindo uma lista de trapaças que ficam armazenadas em um arquivo externo chamado cheat.7z. [27] [28] Essa opção também ativa as opções adicionais no menu deslizante para ajustar a velocidade geral e fazer overclocking ou underclocking.
O valor predefinido é
desligado(-nocheat).Nota
Observe que os savestates, gravações e reproduções criados com cheats podem não funcionar corretamente se esse recurso estiver desativado, e vice-versa.
- Exemplo:
-[no]skip_gameinfo
Ao iniciar, faz com que o MAME não exiba a tela de informações do sistema.
O valor predefinido é
desligado(-noskip_gameinfo).
- Exemplo:
-uifont <nome da fonte>
Define o nome da fonte ou o nome do arquivo da fonte a ser utilizada para o texto da interface do usuário. Se essa fonte não puder ser encontrada ou carregada, o MAME a sua própria. A compatibilidade das fontes dependem da plataforma selecionada e do módulo provedor de fontes da interface do usuário. Em algumas configurações, <nome da fonte> pode ser o nome da fonte no sistema ou um caminho para um arquivo de fonte TrueType. Em todos os casos, pode ser usado um caminho para um arquivo de fonte .bdf (Adobe Glyph Bitmap Distribution Format).
Observe que os caracteres disponíveis dependem da fonte, e muitas fontes não cobrem diferentes sistemas de escrita e idiomas, ou símbolos como setas por exemplo. Dependendo da configuração, o MAME pode não substituir automaticamente caracteres de outras fontes. Os caracteres que não estão disponíveis podem ser substituídos por glifos substitutos (geralmente retângulos). Para fontes com espaço no nome, utilize o nome entre aspas (-uifont "nome do arquivo da fonte").
O valor predefinido é
default(O MAME usará a fonte nativa determinada pelo módulo provedor de fontes da interface do usuário).
- Exemplo:
-ui <tipo>
Define o tipo de interface do usuário. as opções disponíveis são:
simple, uma interface bem simplificada.
cabinet, a mais completa.O valor predefinido é
cabinet(-ui cabinet).
- Exemplo:
-ramsize / -ram <n>
Permite alterar o tamanho padrão da RAM (caso haja suporte no sistema emulado). O valor dessa opção é ignorada em sistemas não compatíveis.
- Exemplo:
-[no]confirm_quit
Remove o aviso na tela "Tem certeza que deseja encerrar?" ao pressionar a tecla Esc.
O valor predefinido é
desligado(-noconfirm_quit).
- Exemplo:
-[no]ui_mouse
Exibe ou não o ponteiro do mouse na interface do MAME.
O valor predefinido é
ligado(-ui_mouse).
- Exemplo:
mame -ui_mouse
-language / -lang <idioma>
Especifique um idioma para ser usado na interface do usuário. Os arquivos de tradução para cada idioma estão no caminho definido em languagepath.
- Exemplo:
-[no]nvram_save
Ao encerrar a emulação, o conteúdo da NVRAM é salvo. Se essa opção for desligada, o conteúdo gravado anteriormente não será apagado e qualquer alteração atual não será gravada. Quando desligado, os dados não serão salvos nos arquivos .nv associados a alguns tipos de programas usados em cartuchos.
O valor predefinido é
ligado(-nvram_save).
- Exemplo:
Opções para uso com script
-autoboot_command / -ab "<comando>"
Trata-se de uma cadeia de comandos que serão executados após a inicialização do sistema (entre aspas " "). Para emitir uma cotação para a emulação, use """ no comando. O uso de \n cria uma nova linha e exibe o que foi digitado antes como comando.
- Exemplo:
-autoboot_delay <n>
Tempo de atraso (em segundos) para a opção -autoboot_command.
- Exemplo:
-autoboot_script / -script <nome_do_arquivo.lua>
Carrega e executa um scrit após a inicialização do sistema.
- Exemplo:
-console
Ativa emulador do console Lua.
O valor predefinido é
desligado(-noconsole).
- Exemplo:
-plugins
Ativa o uso de plug-ins Lua, para mais informações consulte o capítulo PLUG-INS.
O valor predefinido é
ligado(-plugins).
- Exemplo:
-plugin <apelido do plugin>
Permite o uso de uma lista de plug-ins Lua separados por vírgula, para mais informações consulte o capítulo PLUG-INS.
- Exemplo:
-noplugin <apelido do plugin>
Permite desativar uma lista de plug-ins Lua separados por vírgula.
mame alcon -noplugin cheat
Opções do servidor HTTP
-http
Ativa o servidor HTTP.
O valor predefinido é
desligado(-nohttp).
- Exemplo:
mame -httpNota
Até a última versão deste documento o comando não funciona.
-http_port <porta>
Define uma porta para o servidor HTTP.
O valor predefinido é
8080.
- Exemplo:
Nota
Até a última versão deste documento o comando não funciona.
-http_root <diretório raíz>
Define a pasta raíz para os documentos do servidor HTTP.
O valor predefinido é
web.
- Exemplo:
Nota
Até a última versão deste documento o comando não funciona.