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 que estão incluídas na distribuição do 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 ela existir) nós a chamamos de parâmetro da
opção. No Português Brasileiro, subentende-se que quando falamos
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 que foi combinado com este conjunto de
instruções, a correspondência dessas combinações podem equiparar um
sistema (ou vários deles) assim como 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 que desejamos usar (mame -validate "pac*" por exemplo).
Nome dos arquivos e a localização dos diretórios¶
Nativa em (O MAME aceita a utilização de mais de um caminho nas suas configurações, como por exemplo, as configurações que permitam a pesquisa das ROMs em diferentes locais, desde que tais configurações utilizem ; para separar cada caminho.
O MAME consegue também identificar o caminho dos locais dos diretórios usando as variáveis de ambiente já existente no seu sistema e sua sintaxe irá depender do sistema operacional a ser usado. No Windows por exemplo, caso a configuração %APPDATA%\mame\cfg seja definida, o MAME conseguirá ler a variável %APPDATA% e resolver o caminho completo para o diretório de dados de aplicativos do usuário.
Em sistemas estilo UNIX como macOS e Linux que utilizam o interpretador de comandos Bourne Shell, aconteceria o mesmo caso o caminho seja 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 o diretório home do usuário, assim em vez de se 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, o MAME não reconhece expressões mais complexas compatíveis com Bash, ksh, ou zsh.
Os caminhos relativos são resolvidos a partir do diretório de trabalho atual. Caso inicie o MAME com um clique duplo, o diretório de trabalho atual será aquele onde estiver o executável do MAME. Caso faça o mesmo usando um macOS, será aberto uma janela de terminal onde o seu diretório home será o seu diretório de trabalho.
Caso queira um comportamento semelhante ao Windows Explorer no macOS, crie um script que contenha 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 no mesmo diretório do executável do MAME, abra o seu terminal e torne o script executável com o comando chmod u+x meumame, agora ao executar o script, uma janela do terminal se abrirá, o MAME será executado e o diretório de trabalho será definido no mesmo local do script.
Opções de ajuda e verificação¶
-help / -h / -?
Exibe a versão atual do MAME e o aviso de direitos autorais.
mame -help
-validate / -valid <palavra chave>
Executa uma validação interna num ou mais drivers e dispositivos no sistema. Execute isso antes de enviar qualquer alterações para nós visando garantir qualquer tipo de violação em nenhuma das regras do sistema principal.
Caso um padrão seja 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, este será comparado apenas com sistemas e não com outros dispositivos, nenhum tipo de validação será realizada com dispositivos.
- Exemplo:
-verifyroms <palavra chave>
Verifica a condição dos arquivos da imagem ROM num 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 seja exibido uma lista com todos os outros sistemas relacionadas com o nome do sistema principal e a sua condição atual, exemplo:
- Exemplo:
Todos os sistemas e os arquivos da imagem ROM serão verificadas caso nenhum nome seja informado.
-verifysamples <palavra chave>
Verifica a condição dos arquivos samples informado. Todos os arquivos samples ou diretórios 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 exibido uma lista com todos os outros samples relacionados com o nome do sample principal e a sua condição atual, 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. Por predefinição, todos os drivers que possuem arquivos
.zipou 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 da lista de programa>
Verifica ROMs ausentes com base numa lista de software predeterminado na pasta hash. É predefinido que a busca e a verificação será feita em todos os drivers e arquivos
.zipem 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.inipré-configurado. Todas as opções de configuração (não verbos) descritos abaixo podem ser permanentemente alterados ao fazer a edição deste arquivo de configuração. Consulte também o capítulo 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 será acompanhada de um breve descritivo (em inglês).
As configurações nativas do Windows como hlsl por exemplo, não estarão disponíveis, tão pouco serão listadas nas versões SDL do MAME que rodem 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, geralmente é a tela do terminal onde
o comando foi digitado. Caso queira 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 texto que será criado para
registrar toda a saída do terminal (por exemplo, lista.txt). Note
que qualquer conteúdo prévio que exista dentro deste arquivo será
apagado sem qualquer aviso prévio.
Exemplo:
Isso cria (ou sobrescreve se já existir) o arquivo
lista.txte completa o arquivo com os resultados de-listcrc puckman. Em outras palavras, a lista de cada ROM usada em Puckman e o CRC para essa ROM é gravada nesse arquivo.
-listxml / -lx < dispositivo | driver | sistema >
Gera uma lista detalhada e completa de toda a informação que o MAME mantém em seu banco de dados interno sobre os seus dispositivos, sistemas, drivers, nome do driver assim como muitas outras informações em formato XML. A sua saída pode ser limitada informando um nome de dispositivo (ym2203 por exemplo), um driver (megadriv por exemplo) ou sistema (sf2 por exemplo).
Geralmente a saída deste comando é usado para ser redirecionado em um arquivo 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 exibido uma lista com todas as outros sistemas relacionadas com o nome do driver principal e as suas respectivas descrições, exemplo:
- Exemplo:
É possível também 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 nome seja informado.
-listsource / -ls <palavra chave>
Exibe uma lista de drivers/dispositivos dos sistemas e o nome dos seus respectivos arquivos fonte. Útil para identificar qual driver o sistema roda, muito útil para o relatório de bugs. É predefinido que todos os sistemas e os dispositivos sejam listados; contudo, é possível limitar a lista através de um nome ou texto qualquer após a opção -listsource.
- Exemplo:
É possível também utilizar um curinga (asterisco) ao final do nome do sistema para que seja exibido uma lista com todos os outros sistemas que estejam relacionadas com o nome do sistema principal, exemplo:
- Exemplo:
Todos os sistemas serão listadas caso nenhuma palavra chave seja informada.
-listclones / -lc <palavra chave>
Exibe uma lista de clones de um determinado sistema. O MAME irá listar todos os clones em seu banco de dados porém a lista pode ser filtrada com o uso de uma palavra chave após o comando. Exemplo:
- Exemplo:
-listbrothers / -lb <palavra chave>
Exibe uma lista com o nome do driver, da ROM principal e parentes que compartilhem do mesmo driver do sistema pesquisado.
- Exemplo:
-listcrc <palavra chave>
Exibe uma lista completa com CRCs de todas as imagens ROM que compõem um sistema, os nomes do sistema ou do dispositivo num formato simples que pode ser facilmente filtrado por comandos como
grep,awkesedno Linux e macOS ou findstr no Windows. Caso nenhuma palavra chave seja usada como filtro após o comando, o MAME irá 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, assim como mostra também se uma das ROMs contidas no arquivo estão sinalizadas como BAD_DUMP. Isso significa que o conteúdo extraído não é válido, pode conter erro, não foi extraído de forma correta ou de forma apropriada, por algum motivo não pode ser validada, etc. Caso nenhuma palavra chave seja usada como filtro após o comando, o MAME irá 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, dos nomes de um sistema ou os nomes dos dispositivos. Caso nenhum termo seja usado como filtro depois do comando, todos os resultados dos sistemas e dos dispositivos serão exibidos.
- Exemplo:
-romident <caminho\completo\para\a\rom\desconhecida>
Tenta identificar os arquivos ROM desconhecidos comparando-o 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
.zipespecífico. Este comando também pode ser usado para tentar identificar conjuntos de ROM retirados de placas desconhecidas. A opção vai identificar os arquivos compactados ou não.
- Exemplo:
Ao finalizar, o comando retorna níveis de erro (errorlevel):
0: significa que todos os arquivos foram identificados
7: significa que todos os arquivos foram identificados, exceto um ou mais arquivos não qualificados como "não-ROM"
8: significa que alguns arquivos foram identificados
9: significa que nenhum arquivo foi identificado
Nota
Apesar do "errorlevel" constar na documentação oficial, o comando não retorna nenhum destes valores, pelo menos não é visível no terminal ou linha de comando. O comando retorna apenas a listagem mostrada no exemplo.
-listdevices / -ld <palavra chave>
Exibe as especificações técnicas e todos os dispositivos conhecidos e conectados no sistema. Caso os slots sejam populados por dispositivos, todos os slots adicionais que esses dispositivos fornecerem ficarão visíveis com
-listdevicestambém.
- Exemplo:
-listslots / -lslot <sistema>
Exibe uma lista com todos os slots disponíveis para o sistema e suas respectivas opções, caso estejam disponíveis.
- Exemplo:
Nem todos os itens opcionais acima estão conectados quando o sistema é iniciado, sendo necessário que o item descrito em SLOT NAME seja utilizado em conjunto com o SLOT OPTIONS, como por exemplo, para utilizar o dispositivo MIDI do seu computador faça:
- Exemplo:
Para saber qual o dispositivo MIDI disponível no seu sistema, consulte o comando -listmidi.
-listbios <palavra chave>
Exibe uma lista das BIOS para um sistemas (caso esteja disponível). As opções da BIOS podem estar disponíveis para o sistema ou quaisquer dispositivos selecionados como opções de slot.
Caso nenhum nome seja informado, a BIOS de todos os sistemas compatíveis serão listados.
- 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 como cada sistema caso elas existam, na dúvida, execute o comando
mame -lm sistemapara saber quais os tipo de mídia o MAME aceita e quais delas são compatíveis com o sistema em questão. Exemplo:
- Exemplo:
Caso queira carregar uma ROM num sistema como o Megadrive por exemplo faça
mame genesis -cart caminho_para_a_rom. Outros sistemas podem aceitar outros formatos, no caso dos sistemas que rodem CD-ROM por exemplo, a opção pode ser-cdrom caminho_para_a_imagemou-cdrm caminho_para_a_imagem, caso o sistema também aceite cartões de memória (memory card), é possível combinar a opção-cdrom caminho_para_a_imagemcom-memc1 caminho_para_a_imagem.
-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 que estão dentro do diretório
hash).
- Exemplo:
-getsoftlist / -glist <lista de programa>
Exibe o conteúdo de uma lista de software em formato XML, exatamente mesma coisa que
-listsoftwareacima, porém em vez do sistema se utiliza o nome da lista de programa.
- Exemplo:
Opções relacionadas ao que é exibido na tela (OSD)¶
-uimodekey <tecla>
Tecla usada para ativar ou desativar os controles de teclado do MAME. A configuração predefinida é SCRLOCK no Windows, Forward Delete no macOS ou SCRLOCK em outros sistemas como Linux por exemplo. Use FN-Delete em computadores/notebooks Macintosh que usem teclados compactos.
- Exemplo:
-controller_map / -ctrlmap <nome_do_arquivo>
O caminho para um arquivo de texto contendo os mapeamentos do controle, botões e do direcional no formato usado pelo SDL2 e pelo Steam ou
nonepara 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.Uma lista de controles mapeados da 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_GamepadBindno 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 o foco na interface. No Windows, o
RawInputé atualmente compatível para entrada com mouse e teclado, com oDirectInput, é compatível com mouse, teclado e joystick, com oXInputé compatível apenas com joystick. No SDL, oXInputé compatível com controle de jogo e joystick. Essa configuração é ignorada enquanto o depurador estiver ativo.O valor predefinido é
desligado. (-nobackground_input).
- Examplo:
-uifontprovider <módulo>
Define a fonte que será renderizada 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 |
Observações
Nota
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á o rawinput, caso contrário retornará para dinput. Nas versões SDL, oautoserá predefinido como 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 |
Observações
- 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 |
Observações
-joystickprovider <módulo>
Escolhe como o MAME lidará com a entrada do joystick ou 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 |
Observações
winhybrid
Usa o
XInputpara os controles compatíveis e retornando paraDirectInputpara outros controles. Geralmente, oferece uma melhor experiência no Windows.
dinput
Usa o
DirectInputpara todos os controles. Pode ser útil caso 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 do botão/eixo disponíveis, retorna para a 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á inclusos.
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 MAME se comunicará com os dispositivos e as aplicações MIDI (teclados de música 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 (os arquivos MIDI ainda podem ser reproduzidos).O padrão é
auto(utilizará o PortMidi caso esteja 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 da sua preferência caso o seu computador ou sistema utilize mais de um. O comando apenas funciona nos sistemas compatíveis e que estejam funcionando com uma entrada MIDI. Consulte também a opção -listslot para identificar o nome do slot. Caso o nome do dispositivo tenha espaço, use aspas.
- Exemplo:
-midiout <nome do dispositivo>
Informe manualmente o dispositivo MIDI de saída da sua preferência caso o seu computador ou sistema utilize mais de um. O comando apenas funciona nos sistemas compatíveis e que estejam funcionando com uma entrada MIDI. Consulte também a opção -listslot para identificar o nome do slot. Caso o nome do dispositivo tenha espaço, use aspas.
- Exemplo:
-listnetwork
Lista os adaptadores de redes que estiverem disponíveis para serem utilizados com a emulação.
- Exemplo:
Nota
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 para as interfaces de rede emuladas orientadas a pacotes (placas Ethernet por exemplo). As opções suportadas são
taptunpara usar o "TUN/TAP", TAP-Windows ou similar,pcappara usar uma biblioteca pcap ounonepara 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 dos botões iluminados de start para os jogadores 1 e 2 em determinados sistemas arcade, assim como qualquer outro tipo de iluminação externa caso esteja disponível.
- Exemplo:
Tão logo um crédito seja inserido e se for o caso do botão do Jogador 1 (1P) começar a piscar os valores começaram a alternar na tela.
Aqui no caso do sistema "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 os arquivos de configuração sejam lidos em sequência, como mostra a lista 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 que as opções sejam aplicadas apenas no driver do sistema, para saber qual o nome do driver de um determinado sistema faça o comando:
- Exemplo:
mame -ls sf2 sf2 capcom/cps1.cpp
O nome do driver é cps1 (sem a extensão .cpp), logo, o arquivo deve ser nomeado como
cps1.ini.Veja mais em Diversos arquivos de configuração para mais detalhes.
- 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.inicom a linha effect none nele, ele irá sobrescrever qualquer valor de efeito existente no seumame.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 é
Desligado(-nowriteconfig).
- Exemplo:
Opções para a configuração dos principais diretórios¶
-homepath <caminho>
Define o caminho para onde os plugins Lua armazenarão os dados. O valor predefinido é '.' (no diretório raiz do MAME).
- Exemplo:
-rompath / -rp / -biospath / -bp <caminho>
Define o caminho completo para encontrar imagens ROM, disco rígido, fita cassete, etc. Mais de um caminho podem ser definidos desde que estejam separados por ponto e vírgula. O valor predefinido é
roms(isto é, um diretório chamado roms no diretório raiz do MAME).
- Exemplo:
-hashpath / -hash_directory / -hash <caminho>
Define o caminho completo para a pasta com os arquivos hash que é usado pela lista de software no gerenciador de arquivos. Mais de um caminho podem ser definidos desde que estejam separados por ponto e vírgula. O valor predefinido é
hash(isto é, um diretório chamado hash no diretório raiz do MAME).
- Exemplo:
-samplepath / -sp <caminho>
Define o caminho completo para os arquivos de amostras (samples). Mais de um caminho podem ser definidos desde que estejam separados por ponto e vírgula. O valor predefinido é
samples(isto é, um diretório chamado samples no diretório 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. Mais de um caminho podem ser definidos desde que estejam separados por ponto e vírgula. O valor predefinido é
artwork(isto é, um diretório chamado artwork no diretório raiz do MAME).
- Exemplo:
-ctrlrpath <caminho>
Define um ou mais caminhos para os arquivos de configuração dos controles. Mais de um caminho pode ser definido desde que estejam separados por ponto e vírgula. É usado em conjunto com a opção
-ctrlr.O valor predefinido é
ctrlr(isto é, um diretório chamado ctrlr no diretório raiz do MAME).
- Exemplo:
-inipath <caminho>
Define um ou mais caminhos onde os arquivos
.inipossam ser encontrados. Mais de um caminho podem ser definidos desde que estejam separados por ponto e vírgula.
No Windows a predefinição é
.;ini;ini/presets, traduzindo, a primeira pesquisa é feita no diretório atual, a segunda no diretório ini e finalmente no diretório presets dentro do diretório ini.No macOS a predefinição é
$HOME/Library/Application Support/mame;$HOME/.mame;.;ini, traduzindo, pesquisa no diretório mame dentro do diretório Application Support do usuário atual, depois no diretório .mame dentro do diretório home do usuário atual, depois no diretório raiz e então no diretório ini.Em outras plataformas onde se incluem o Linux, a predefinição é
$HOME/.mame;.;ini, traduzindo, procura pelo diretório .mame no diretório home do usuário atual, seguido pelo diretório raiz e finalmente no diretório ini.mame -inipath D:\mameini
-fontpath <caminho>
Define um ou mais caminhos onde os arquivos de fonte
.bdf(Adobe Glyph Bitmap Distribution Format) possam ser encontrados. Mais de um caminho podem ser definidos desde que estejam separados por ponto e vírgula. O valor predefinido é.(isto é, no diretório raiz do MAME).
- Exemplo:
-cheatpath <caminho>
Define o caminho completo para os arquivos de trapaça em formato
.xml. Mais de um caminho podem ser definidos desde que estejam separados por ponto e vírgula. O valor predefinido écheat(isto é, uma pasta chamada cheat, localizada no diretório raiz do MAME).
- Exemplo:
-crosshairpath <caminho>
Define um ou mais caminhos onde os arquivos de mira crosshair possam ser encontrados. Mais de um caminho podem ser definidos desde que estejam separados por ponto e vírgula. O valor predefinido é
crosshair(isto é, um diretório chamado crosshair no diretório raiz do MAME). Caso uma mira seja definida no menu, o MAME procurará pornomedosistema\cross#.png, em seguida no crosshairpath especificado onde # é 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(isto é, um diretório chamado plugins no diretório raiz do MAME).
- Exemplo:
-languagepath <caminho>
Define um ou mais caminhos onde possam ser encontrados os arquivos de tradução que o MAME usa na Interface do Usuário. O valor predefinido é language (isto é, um diretório chamado language no diretório raiz do MAME).
- Exemplo:
-swpath <caminho>
Define um ou mais caminhos onde possam ser encontrados arquivos avulsos dos programas (rom, iso, etc.). O valor predefinido é
software(isto é, um diretório chamado software no diretório raiz do MAME).
- Exemplo:
-cfg_directory <caminho>
Define o diretório 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 lidas na inicialização do MAME ou de um sistema emulado, depois quaisquer alterações são salvas ao encerrar o MAME.
Os arquivos de configuração preservam as configurações da ordem dos botões do seu controle ou joystick, configurações das chaves DIP, informações da contabilidade do sistema e a organização das janelas do depurador.
O valor predefinido é
cfg(isto é, um diretório com o nome cfg no diretório raiz do MAME). Caso este diretório não exista, ele será criado automaticamente.
- Exemplo:
-nvram_directory <caminho>
Define o diretório onde os arquivos NVRAM sã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 fazem uso deste tipo de memória. As informações são lidas no início da emulação e gravadas ao encerrar.
O valor predefinido é
nvram(isto é, um diretório com nome "nvram" no diretório raiz do MAME). Caso este diretório não exista, ele será criado automaticamente.
- Exemplo:
-input_directory <caminho>
Define o diretório onde os arquivos de gravação da entrada são armazenados. As gravações da entrada são criadas através da opção -record e reproduzidas através da opção -playback. A opção grava todos os comando e acionamentos de botões que forem feitos durante a operação do sistema.
O valor predefinido é
inp(ou seja, um diretório de nome inp no diretório raiz do MAME). Caso este diretório não exista, ele será criado automaticamente.
- Exemplo:
-state_directory <caminho>
Define o diretório onde os arquivos de gravação de estado são armazenados. Os arquivos de estado são lidos e gravados mediante a solicitação do usuário ou ao usar a opção -autosave.
O valor predefinido é
sta(isto é, um diretório de nome sta no diretório raiz do MAME). Caso este diretório não exista, ele será criado automaticamente.
- Exemplo:
-snapshot_directory <caminho>
Define o diretório onde os arquivos de instantâneos da tela são armazenados quando solicitado pelo usuário.
O valor predefinido é
snap(isto é, um diretório chamado snap no diretório raiz do MAME). Caso este diretório não exista, ele será criado automaticamente.
- Exemplo:
-diff_directory <caminho>
Define o diretório onde os arquivos de diferencial do disco rígido são armazenados. Os arquivos de diferencial armazenam qualquer dado que é escrito de volta na imagem do disco, isso serve para preservar a imagem de disco original. Os arquivos são criados no inicio da emulação com uma imagem compactada do disco rígido.
O valor predefinido é
diff(isto é, um diretório chamado diff no diretório raiz do MAME). Caso este diretório não exista, ele será criado automaticamente.
- Exemplo:
-comment_directory <caminho>
Define o diretório onde os arquivos de comentário do depurador são armazenados. Os arquivos de comentário do depurador são escritos pelo depurador quando comentários são adicionados num sistema desmontado (disassembly).
O valor predefinido é
comments(isto é, um diretório chamado comments no diretório raiz do MAME). Caso este diretório não exista, ele será criado automaticamente.
- Exemplo:
Define o diretório que será compartilhado com o sistema ou o driver que está sendo emulado. Por exemplo, no caso de um sistema operacional compatível, os arquivos que forem colocados neste diretório será compartilhado 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, automaticamente é salvo o estado da condição da memória toda a vez que um quadro for avançado. O rebobinamento das condições de estado que foram salvas podem ser carregadas de forma consecutiva ao pressionar a tecla de atalho para rebobinar passo único (Shift Esquerdo + ~) [2].
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 caso ocorra um 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á usada para rebobinar os savestates. Quando a capacidade alcança o limite, os antigos savestates são apagados enquanto novos são capturados. Definindo uma capacidade menor do que o savestate atual, desativa o rebobinamento. Os valores negativos são automaticamente fixados em
0.
- Exemplo:
-statename <nome>
Descreve como o MAME deve armazenar os arquivos de estado salvos relativo ao caminho do state_directory. <nome> é uma string que fornece um modelo que 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 (até mesmo no Windows); a string%grepresenta o nome do driver do sistema atual.O valor predefinido é
%g, que cria uma pasta separada para cada sistema.Em adição ao que foi dito acima, para os drivers que usem 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:
Caso use
mame robby -statename foo/%g%ias capturas da tela serão salvos em sta\foo\robby\.Caso use
mame nes -cart robby -statename %g/%d_cartos instantâneos serão salvos em sta\nes\robby.Caso use
mame c64 -flop1 robby -statename %g/%d_flop1/%iestes serão salvos como sta\c64\robby\0000.png.
-state <slot>
Depois de iniciar um sistema determinado, fará com que o estado salvo no <slot> seja carregado imediatamente.
- Exemplo:
-[no]autosave
Quando ativado, cria automaticamente um arquivo com a condição atual do sistema ao encerrar o MAME e automaticamente tenta recarregá-lo caso o MAME inicie novamente com o mesmo sistema. A opção só funciona para os sistemas que sejam compatíves com o salvamento do seu estado.
O valor predefinido é
Desligado(-noautosave).
- Exemplo:
mame -autosave
-playback / -pb <nome do arquivo>
Faz a reprodução de um arquivo de gravação. Esse recurso não funciona de maneira confiável com todos os sistemas, mas pode ser usado para assistir a uma sessão do jogo gravado anteriormente do início ao fim. Para tornar as coisas consistentes, apague os arquivos de configuração
.cfg, NVRAM.nve o cartão de memória. Consulte o comando -record para obter mais informações importantes.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, inclusive caso seja utilizado uma versão do MAME muito diferente daquela usada na gravação. É recomendável que a configuração (.cfg), a NVRAM (.nv) ou o diretório com o nome do sistema dentro do diretório nvram sejam excluídos antes de iniciar uma gravação ou uma reprodução.
Aviso
Para que o playback funcione em alguns sistemas de alguns drivers, elas precisam da NVRAM como por exemplo a CPS1, a CPS2 e a CPS3, manter ou não o arquivo de configuração nestes casos não faz a menor diferença. Então caso você vá compartilhar a gravação com alguém, tenha certeza de enviar o arquivo NVRAM do sistema em questão.
Aviso
Em sistemas que não usam NVRAM como a pacman, mspacman e talvez 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 do high score dentro do diretório hi. Caso você mantenha 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 caso seja usado em conjunto com a opção -playback. É predefinido que o MAME não encerre a emulação.
- Exemplo:
O valor predefinido é
Desligado(-noexit_after_playback).
-record / -rec <nome do arquivo>
Faz a gravação de todos comandos feitos pelo usuários durante uma seção e define o nome do arquivo onde será registrado todos esses comandos durante uma seção. Esse recurso não funciona de forma 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 do sistema ANTES de iniciar uma gravação e ANTES de reproduzir com -playback, caso contrário, a reprodução pode iniciar num estágio diferente (na série "The King of Fighters" por exemplo) e fazendo com que a ação não bata com o que foi gravado ou até mesmo haja uma interrupção abrupta da reprodução muito antes do fim. Por exemplo, se for iniciar a gravação do sistema kof2002, dentro da pasta NVRAM, exclua a pasta kof2002 ou uma pasta kof2002_* caso ela exista. Para obter mais informações consulte Excluindo arquivos NVRAM (script).
Opções para a gravação de áudio e vídeo¶
Há casos onde certos sistemas alternam a resolução da tela atrapalhando a gravação de vídeo, algumas gravações podem ficar com um tamanho de tela todo preto com um vídeo menor no meio ou em algum outro canto da tela, use essas duas opções caso isso aconteça, -noswitchres com -snapsize.
-mngwrite <nome do arquivo>.mng
Escreve cada quadro de vídeo num arquivo <nome do arquivo> no formato MNG, produzindo uma animação da sessão. Note que
-mngwritesó grava quadros de vídeo, não grava qualquer áudio, use a opção-wavwritepara gravar o áudio e posteriormente use uma ferramenta de edição de áudio qualquer para unir os dois, ou use-aviwritepara gravar áudio e vídeo num ú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, note que a taxa de quadros e a resolução são sempre fixas. Vídeos sem compressão ocupam muito espaço assim como, para que a gravação ocorra sem problemas é necessário um HDD rápido. 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
Grava apenas o áudio da seção em formato PCM 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 MAME deve nomear arquivos de instantâneos de tela. <nome> será o guia que o MAME usará para nomear o arquivo.
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
0000e os incrementa enquanto novos instantâneos forem sendo criados, O MAME incrementará o valor de%ipara o próximo vazio, caso ele seja omitido, os instantâneos existentes com o mesmo nome serão gravados por cima.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:
Caso use
mame robby -snapname foo/%g%ios instantâneos serão salvos comosnaps\foo\robby0000.png,snaps\foo\robby0001.pnge assim por diante.Caso use
mame nes -cart robby -snapname %g/%d_cartos instantâneos serão salvos comosnaps\nes\robby.png.No caso deste outro exemplo,
mame c64 -flop1 robby -snapname %g/%d_flop1/%iestes serão salvos comosnaps\c64\robby\0000.png.
-snapsize <largura> x <altura>
Define um tamanho fixo para os instantâneos e vídeos. É predefinido que o MAME criará instantâneos, assim como os vídeos, na resolução original do sistema em pixels brutos. Caso use esta opção, o MAME criará instantâneos e vídeos no tamanho determinado, 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 da tela e para gravar vídeos.
É predefinido que ambos utilizem a primeira visualização que estiver disponível ou somente 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 em todos os instantâneos e 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 com o que for definido através do <tipo>, supondo que o nome seja Cabine Animada basta usar Cabine ou cabine.
Por exemplo,
-snapview nativeirá casar a visualização Nativa em (15:14) ainda que o nome não combine perfeitamente. O <tipo> também pode ser "auto" onde será escolhida a primeira exibição de todas que existirem.Nos casos onde você utiliza uma visualização com mais de uma opção ou que tenha nomes estranhos, nomes com caracteres não ASCII ou algo do tipo:
XXYYZZ_01
XXYYZZ_02
XXYYZZ_03
Use
-snapview XXYYZZ_03para 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 suavizando a tela do sistema. Desligar essa opção pode fazer a diferença melhorando o desempenho durante a gravação do vídeo.
O valor predefinido é
Ligado(-snapbilinear).
- Exemplo:
Opções relacionadas ao desempenho e a velocidade da emulação¶
-[no]autoframeskip / -[no]afs
Para que se mantenha a velocidade máxima de uma emulação, ajusta dinamicamente no sistema emulado a quantidade de quadros que serão pulados. Ativando esta opção ela se sobrepõem ao que for definido em -frameskip descrito logo abaixo.
O valor predefinido é
Desligado(-noautoframeskip).
- Exemplo:
-frameskip / -fs <quantidade>
Determina a quantidade de quadros que são ignorados. Ela elimina cerca de 12 quadros enquanto estiver sendo executado. Caso seja definido
-frameskip 2o MAME então exibirá 10 de cada 12 quadros por exemplo.Ao ignorar estes quadros, pode ser que se atinja a velocidade nativa do sistema emulado sem que haja sobrecarga no seu 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 forma automatizada. O comando diz ao MAME para para interromper a emulação depois de alguns segundos. Ao combinar com outras opções fixas de linha de comando é possível definir um ambiente para realizar testes de desempenho. Ao encerrar, a opção
-strfará uma captura da tela com o nome determinado pela opção -snapname.O comando diz ao MAME para interromper a emulação depois de um tempo determinado, o tempo em questão não é o tempo real e sim o tempo interno da emulação, assim, caso seja definido 30 segundos, pode ser que dependendo do sistema que esteja sendo emulado, a parada só venha a acontecer depois de algum tempo.
Este comando também é útil para a realização de benchmarks e testes de automação. Ao combinar esta opção com algumas outras, é possível construir uma estrutura de testes de desempenho do MAME. Adicionalmente a opção
-str, faz também que ao final do tempo seja criado uma captura da tela determinado pela opção-snapnamedentro da pasta dos instantâneos.
- 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 limitada pelo seu processador, placa de vídeo ou até mesmo pelo desempenho final da sua memória.
O valor predefinido é
Ligado(-throttle).
- Exemplo:
-[no]sleep
Quando utilizada em conjunto com
-throttleo 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 assumindo que a emulação não esteja consumindo 100% dos recursos do processador. Esta opção pode causar uma certa intermitência no desempenho caso outros programas que também demandem processamento estejam rodando junto com o MAME.O valor predefinido é
Ligado(-sleep).
- Exemplo:
-speed <fator>
Muda a maneira que o MAME controla a velocidade da emulação de maneira que seja possível que o sistema emulado rode em múltiplos da sua velocidade original.
Um <fator>
1.0significa rodar o sistema em velocidade normal. Já um fator 0.5 significa rodar o sistema na metade da velocidade normal e um <fator>2.0significa rodar o sistema 2x acima da sua velocidade normal. Note que ao mudar este valor a velocidade de execução do áudio irá mudar proporcionalmente também.A resolução interna da fração são dois pontos decimais, logo o valor 1.002 será arredondado para
1.0.O valor predefinido é
1.0.
- Exemplo:
Quando utilizado em conjunto com -rec é possível colocar o sistema em velocidade lenta como
-speed 0.3enquanto grava. Ao terminar, a reprodução com a opção -pb ocorrerá em velocidade normal, exemplo:
- Exemplo:
A opção
-sound noneserve para eliminar o áudio durante a gravação em câmera lenta. Para mais informações, consulte slowmomame.
-[no]refreshspeed / -[no]rs
Permite ao MAME ajustar a velocidade da emulação para que a taxa de atualização da primeira tela emulada não exceda o menor valor da 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 irá reduzir a velocidade da emulação para 99% em casos onde 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á a quantidade de núcleos informada pelo seu sistema ou pela variável de ambiente OSDPROCESSORS. Este valor é limitado internamente para quatro vezes o número dos processadores informado pelo seu sistema.O valor predefinido é
auto.
- Exemplo:
-bench <n>
Define a quantidade de segundos de emulação em <n> usado para teste de desempenho, o comando é um atalho com 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. Esta opção é particularmente efetiva com telas com variação em sua taxa de atualização (Variable Refresh Rate).
Esta opção 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 onde rodam um software similar ao sistema operacional).
O valor predefinido é
-nolowlatency.
- Exemplo:
Opções para a rotação da tela¶
-[no]rotate
Gira a tela para corresponder ao seu estado normal do sistema (horizontal / vertical). Isso garante que os sistemas vertical e horizontalmente orientados sejam exibidos corretamente sem que haja a necessidade de girar fisicamente a sua 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
-rorou para a esquerda-rolem relação ao seu estado normal caso-rotateseja definido ou seu estado nativo caso-norotateseja 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 numa única direção. Caso a tela gire somente no sentido horário, use o comando
-autorolpara garantir que o sistema encha a tela horizontalmente ou verticalmente numa das direções desejadas. Caso a sua tela gire somente no sentido anti-horário, use-autoror.
- Exemplo:
-[no]flipx -[no]flipy
Espelhe a tela do sistema horizontalmente
-flipxou verticalmente-flipy. As inversões são aplicadas depois que as opções de rotação-rotatee rolagem-ror/-rolforem aplicadas.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 usar. As opções aqui descritas dependem do sistema operacional utilizado e se a versão do MAME é uma versão 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, use em sistemas Windows compatíveis quando por algum motivo as outras opções causarem problemas.
Em sistemas não Windows, essa é a opção predefinida para a renderização da tela e para fazer a aceleração via hardware, caso seja compatível com o seu sistema operacional e pela sua placa de vídeo.
none
Não exibe janelas e nem mostra nada na tela. É principalmente utilizado para realizar testes de desempenho (benchmarks) usando apenas a CPU.
No Windows:
gdi
Diz ao MAME para renderizar o vídeo usando funções gráficas mais antigas do Windows. Em termos de desempenho é a opção mais lenta porém a mais compatível com as versões os sistemas Windows mais antigos.
d3d (obsoleto)
Diz ao MAME para renderizar a tela com o Direct3D. Isso produz uma saída com uma melhor qualidade se comparada com a opção que o gdi assim como permite 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
Esta opção já é obsoleta para um hardware mais moderno, prefira a opção
bgfxusando o bgfx_backend comd3d11ou a versão mais recente. 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 usado).
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
Faz com que a tela seja renderizada através de software. Por não usar nenhum tipo de aceleração de vídeo, o desempenho da emulação pode ser penalizada, porém favorecendo uma melhor 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 depois da 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 os sistemas Arcade PlayChoice-10 por exemplo). Cada tela (até 4), possem as suas próprias configurações, taxa de proporção de tela, resolução e exibição, que podem ser definidas usando as opções abaixo.
O valor predefinido é
1.
- Exemplo:
-[no]window / -[no]w
Inicia a tela do MAME numa janela em vez da tela inteira.
O valor predefinido é
Desligado(-nowindow).
- Exemplo:
-[no]maximize / -[no]max
Controla o tamanho inicial da janela. Caso esta opção seja ativada, durante a inicialização do MAME a janela será exibida com o maior tamanho possível. Com a opção desligada, a emulação terá início com o tamanho aproximado ao tamanho original do sistema, a sua escala será em apenas um eixo quando os pixeis não quadrados estiverem em uso. Esta opção apenas surte efeito quando a opção -window é utilizada.
O valor predefinido é
Ligado(-maximize).
- Exemplo:
-[no]keepaspect / -[no]ka
Faz com que a proporção de tela seja 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), 5:4 para algumas workstation assim como vários outros.
Caso a tela que estiver sendo emulada ou ilustração não preencher toda a tela por completo, a imagem será centralizada com barras pretas adicionadas as laterais conforme a necessidade para ocupar os espaços não utilizados, sejam eles em cima ou em baixo assim como na esquerda ou na 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 de tela será mantido mesmo que a janela seja redimensionada para diferente tamanhos, caso mantenha a tecla Control ou Ctrl pressionada durante redimensionamento da janela, a proporção será mantida.
O valor predefinido é
Ligado(-keepaspect).
- Exemplo:
A equipe do MAME, sugere veementemente que se mantenha esta opção ativada. Esticando a tela do sistema além da proporção original vai causar distorções na aparência do sistema que vai muito além da capacidade de reparo dos filtros internos do MAME.
-[no]unevenstretch / -[no]ues
Permite que valores não inteiros possam ser usados para o redimensionamento da tela, isso faz com que a imagem possa ter uma forma mais distorcida ou esticada para que ela preencha toda a tela, porém há um preço a ser pago.
O uso de valores não inteiros geram uma interferência chamada aliasing nos pixels [24] [25]. 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 aonde antes não existiam gerando distorções em todos os pixels. Abaixo um exemplo com destaque nas regiões marcadas com vermelho, porém nota-se 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 ao custo da desproporção dos gráficos.
Este é um assunto bem complexo pois, apesar de todos os pixels do lado esquerdo estarem com os quadrados perfeitos, o que significa uma proporção dos 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 as telas CRT 4:3 da época como mostra a imagem do lado direito.
Assim, apesar dos pixels estarem distorcidos na imagem da direita a proporção dos gráficos está correta! Ao mesmo tempo que apesar dos pixels estarem perfeitos do lado esquerdo a proporção do gráfico 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 ao custo de distorções nos gráficos e isso fica pior ainda com textos.
Consulte também -aspect, -keepaspect e -prescale.
O valor predefinido é
Ligado(-unevenstretch).
- Exemplo:
-[no]unevenstretchx / -[no]uesx
Permite que a relação de aspecto 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 relação de aspecto 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
Aplica a opção -unevenstretchx/y automaticamente com base na orientação nativa da fonte.
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 causa aliasing nos pixels quando usado sozinho ou até o fator 4.0. Causa aliasing mínimo nos pixels quando utilizado em conjunto com 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 causa aliasing nos pixels quando usado sozinho ou até o fator 4.0. Causa aliasing mínimo nos pixels quando utilizado em conjunto com intscalex.
O valor predefinido é
0.0(-nointscaley 0.0).
- Exemplo:
-[no]waitvsync
Aguarda acabar o período de atualização da tela do monitor do seu computador antes de começar a desenhar na tela. Caso esta opção esteja desligada, o MAME só irá desenhar na tela quando o quadro estiver pronto, mesmo que seja durante o processo de atualização de tela. Isso pode causar artefato de screen tearing [5].
O efeito "tearing" não é perceptível em todos os sistemas, porém algumas pessoas acham o efeito desagradável, algumas mais do que as outras.
Os efeitos colaterais de se ativar a opção
-waitvsyncpodem variar dependendo da combinação usada em diferentes sistemas operacionais e drivers de vídeo.No Windows,
-waitvsyncserá bloqueado até o próximo apagamento de vídeo, permitindo que o MAME desenhe o próximo quadro, sincronizando a taxa de quadros do sistema emulado com a taxa de quadros nativa do monitor que estiver sendo usado no Windows, apenas ative esta opção caso esteja utilizando o modo janela. Em tela inteira esta opção só é necessária caso a opção-triplebuffernão remova o indesejado efeito "tearing", neste caso, tente usar as duas opções juntas-notriplebuffer -waitvsync. Note que a opção-waitvsyncnão vai funcionar em conjunto com a opção-video gdi.No macOS,
-waitvsyncnão é bloqueado, contudo o quadro completamente desenhado será exibido no próximo apagamento de vídeo (vblank). Isso quer dizer que caso um sistema emulado tenha uma taxa de quadros 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á com essa opção em modo janela caso haja compatibilidade com o seu sistema operacional, da sua placa de vídeo e respectivos drivers.
Rode o MAME SDL com a opção
-video openglpara aumentar as suas chances de sucesso.
-[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 é ignorada, porém, o código responsável pelo som tentará manter o sincronismo com a taxa de atualização usada pelo sistema, assim haverá problemas com o som.
Esta opção foi pensada naqueles que modificaram as configurações da sua placa de vídeo, combinando uma opção a mais com as de atualização da tela. Esta opção não funciona com a opção
-video gdi.O valor predefinido é
Desligado(-nosyncrefresh).
- Exemplo:
Nota
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. No ajuste mínimo a tela é renderizada no 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 d3dao custo da perda de algum desempenho.Experimente
-prescale 4ou valores maiores para amenizar um pouco as distorções causadas pela opção -unevenstretch e para reduzir o efeito "blur" ao custo de um aumento de processamento.Os valores válidos são
1(mínimo) e8(máximo).O valor predefinido é
1.Funciona com todos os modos de vídeo no Windows (bgfx, d3d, etc.), 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 à tela, amenizando um pouco o serrilhado nos contornos gráficos e suavizando a tela do sistema.
Quando desativado terá uma imagem pura e com aparência mais serrilhada, esta opção também ocasiona artefatos na tela em caso de redimensionamento. Caso não goste da aparência amaciada da imagem, tente incrementar o valor da opção
-prescaleem 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.), nas outras plataformas APENAS aquelas compatíveis com 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 iluminada).
A intenção é que este PNG possa ser carregado através de um arquivo de ilustração usando um valor alpha pequeno como valores entre
0.1e0.2que se misturam bem com o resto da tela. Os arquivos PNG gerados são gravados no diretório snap dentro dosystemname/burnin-<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
-resolutionevitando a troca das resoluções enquanto estiver no modo de tela inteira.Em placas de vídeo modernas, há poucas razões para alternar as resoluções, a menos que esteja tentando alcançar as resoluções "exatas" dos pixels dos sistemas originais, o que exige ajustes significativos.
Útil também em monitores de LCD, uma vez que eles rodam com uma resolução fixa e as comutações da resolução algumas 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 usar em cada janela. Para usar várias janelas, o valor da opção -numscreens deverá ter sido 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: \\.\DISPLAYn no Windows e screenN no macOS e variantes do OpenGL como o Linux por exemplo, o n ou N é um número do monitor que estiver conectado.
O valor predefinido para estas opções é
auto. O que 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,-screen3são específicos para cada janela. Já o parâmetro-screenaplica a configuração à todas as janelas. As opções definidas para uma janela específica tem prioridade sobre às opções das outras janelas.
Nota
Utilize a opção -verbose para exibir 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 podem 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 da tela visível e definindo-as separadas por dois pontos.
O valor predefinido para essas opções é
auto.Significa que o MAME assume que a proporção de tela é proporcional ao número de pixels no modo de vídeo da área de trabalho para cada monitor.
O parâmetro
-aspect0,-aspect1,-aspect2e-aspect3são específicos para cada janela. O parâmetro-aspectse aplica à todas as janelas. As opções definidas para uma janela específica tem prioridade sobre às 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, a taxa de atualização é opcional.
Caso seja omitido ou configurado para
0, o MAME determinará o modo automaticamente. Por exemplo, a opção-resolution 640x480forçará a resolução de 640x480 porém o MAME escolherá a taxa de atualização por conta própria.Da mesma forma que
-resolution 0x0@60obrigará que a taxa de atualização seja de 60 Hz, mas permite que o MAME escolha a resolução. O comando também funciona com "auto" e é equivalente a 0x0@0.No modo janela essa resolução é usada para determinar o tamanho máximo para a janela. Essa opção também requer que seja usada a opção -switchres para ativar a comutação de resolução em conjunto com a opção -video d3d.
O valor predefinido para essas opções é
auto.O parâmetro
-resolution0,-resolution1,-resolution2e-resolution3se aplica a todas as janelas definidas. O parâmetro-resolutionse aplica a todas as janelas. As opções específicas da janela substituem os valores da 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 de visualização <nome> não precisa ser uma combinação exata, em vez disso, será selecionado a primeira exibição cujo nome corresponde a todos os caracteres especificados por <nome>. Por exemplo,
-view nativerepresenta uma visualização "Native (15:14)", ainda que não seja o nome exato, suponto que o nome seja Cabine Animada basta usar Cabine ou cabine. O campo <nome> também funciona com a opçãoautofazendo com que um nome seja automaticamente escolhido.O valor predefinido para estas opções é
auto.Os parâmetros
-view0,-view1,-view2e-view3se aplicam a todas as janelas especificadas. O parâmetro-viewse aplica a todas as janelas. As opções definidas para a janela substituem os valores da opções de todas as janelas.Para identificar qual o nome correto para ser utilizado com a opção
-view, ao iniciar o sistema pressione Tab e vá em Opções de Vídeo, escolha a visualização que mais lhe agrada e encerre a emulação. No diretório cfg haverá um arquivo de configuração com nomedarom.cfg (se usarmos o exemplo abaixo o nome do arquivo seráneobombe.cfg), abra-o num editor de texto qualquer, no campo view veja qual a opção está sendo usada e use-a na linha de comando como mostra o exemplo abaixo:
- Exemplo:
Supondo que esta seja a sua opção de visualização preferida e caso queira que ela seja aplicada a todos os sistemas deste driver, no nosso caso, basta fazer o comando
mame -ls neobombepara identificá-lo. Com o nome do driver em mãos crie o arquivoneogeo.inidentro do diretório ini/source e use a opçãoview "Screen 0 Cropped (304x224)".Salve o arquivo e rode o sistema novamente 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. Significa que sistemas que tenham telas com orientação horizontal rodando em tela cheia possam exibir a sua ilustração do lado esquerdo e direito da tela.
Essa opção também está disponível através da interface gráfica na parte das opções de vídeo.
O valor predefinido é
Desligado(-noartwork_crop).
- Exemplo:
-fallback_artwork
Define uma ilustração alternativa caso nenhuma ilustração interna ou externa do layout seja definida. Caso a ilustração para o sistema esteja presente ou o seu layout esteja incluso no driver do sistema, então este terá precedência.
mame coco -fallback_artwork suprmrio
-override_artwork
Define uma ilustração para substituir a ilustração interna ou a ilustração externa do layout.
- Exemplo:
Opções para os ajustes de imagem da tela¶
-brightness <valor>
Controla o valor de brilho ou nível de preto 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 brilho para cada tela do sistema e para todos os sistemas individualmente. Ao selecionar valores menores (não menor que
0.1) produzirá uma tela mais escura, enquanto valores maiores até2.0produzirão uma tela mais clara.O valor predefinido é
1.0.
- Exemplo:
-contrast <valor>
Controla o contraste da tela ou os nível de branco 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 brilho 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. Selecionando valores (não menor que
0.1) produzirá uma tela mais apagada, enquanto valores maiores até2.0produzirão uma tela mais saturada.O valor predefinido é
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.
- Exemplo:
-pause_brightness <valor>
Faz o controle do nível de brilho durante a pausa.
O valor predefinido é
0.65.
- Exemplo:
-effect <nome do arquivo>
Define um único arquivo
.pngque será usado como sobreposição na tela de qualquer sistema. Presume-se que o aquivo.pngesteja em um dos diretórios raiz do artpath.Ambas as combinações horizontais e verticais dentro do arquivo
.pngé repetido para cobrir toda a tela (mas nenhuma parte da arte externa). Ela é renderizada na resolução nativa do sistema.É possível adicionar o efeito de forma automática para sistemas com orientação horizontal e vertical, basta criar os arquivos vertical.ini e horizont.ini dentro do diretório ini. No arquivo
vertical.iniadicione a linha abaixo e salve ao terminar:
- Exemplo:
effect RealScanlinesVPara o arquivo
horizont.iniadicione a linha abaixo e salve ao terminar:
- Exemplo:
effect RealScanlinesHConsulte Opções para a configuração para saber quais os arquivos
.iniestão disponíveis.Para os modos de vídeo
-video gdie-video d3dsignifica que um pixel dentro do.pngserá mapeado para um pixel da sua tela. Os valores RGB de cada pixel dentro do.pngsão multiplicados com os valores de RGB da tela de destino. Ambos os arquivosRealScanlinesVeRealScanlinesHestão disponíveis no site do projeto.O valor predefinido é
noneou nenhum efeito.
- Exemplo:
Claro que os exemplos acima são apenas exemplos, existem diferentes outros tipos espalhados pela internet e também é uma questão de gosto, há quem prefira os shaders que dão uma aparência muito convincente de um monitor CRT. Para mais informações sobre estes efeitos consulte 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. Esta espessura varia entre mínimo e 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_maxe-beam_width_min.
- Exemplo:
-beam_width_max <largura>
Define a espessura máxima do feixe do vetor. Esta espessura varia entre mínimo e 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_maxe-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 estes são renderizados de acordo com a largura do feixe computado, no entanto, é comum que isto produza pontos que sejam difíceis de se ver. Esta opção aplica um fator de escala no topo da largura do feixe para que estes fiquem mais visíveis.
- Exemplo:
-beam_intensity_weight <altura>
Define a intensidade do feixe do vetor. Este valor determina como a intensidade afeta a sua largura, o valor
0(zero) cria um mapeamento linear a partir da intensidade da sua largura. Os valores negativos fazem com que os vetores com menor intensidade aumentem a sua largura máxima de forma mais rápida, enquanto valores positivos o farão de forma mais lenta.
- Exemplo:
-flicker <valor>
Simula um vetor de efeito de tremulação ou oscilação da tela semelhante aos monitores desregulados usados nos jogos vetoriais. Essa opção espera um valor flutuante (float) no intervalo entre
0.00e100.00(0= nenhum e100= máximo).O valor predefinido é
0.
- Exemplo:
Opções das principais características do vídeo OpenGL¶
Essas são as opções compatíveis com -video opengl.
Caso note artefatos renderizados na tela, poderá ser solicitado
pelos desenvolvedores que você tente alterá-los, porém normalmente estes
valores devem ser mantidos com seus valores originais para que se
obtenha a melhor desempenho possível.
-[no]gl_forcepow2texture
Sempre utilize a potência de 2 para o tamanhos 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 que deixa os pixels de forma serrilhada pois utiliza a técnica de interpolação do vizinho mais próximo.
1, Bilinear: Método de interpolação lenta e de qualidade mediana, suaviza a transição entre as cores dos pixels deixando a imagem mais suavizada como um todo. Veja também -filter.
2, Bicúbico: Método de interpolação lenta e mais precisa, suaviza a transição entre as cores dos pixels próximos gerando uma gradação mais suave. Também suaviza a imagem porém nem tanto como o método bilinear.O valor predefinido é
1(-gl_glsl_filter 1).
- Exemplo:
-glsl_shader_mame[0-9]
Define um efeito shader personalizado do OpenGL GLSL do MAME no slot fornecido entre (
0-9). É possível aplicar um para a cada slot. O MAME não incluí nenhum shader por alguns podem ser encontrados online, como no mameau e no mameworld.
- Exemplo:
-glsl_shader_screen[0-9]
Define um efeito shader personalizado do OpenGL GLSL do MAME que for escalada na tela para ser processada através da sua placa de vídeo no slot fornecido entre (
0-9). Como no exemplo anterior, o MAME não incluí nenhum shader.
- Exemplo:
Opções para a configuração do áudio¶
-samplerate <valor> / -sr <valor>
Define a taxa de amostragem do áudio. Valores menores como
11025por exemplo, reduzem a qualidade da áudio porém o desempenho da emulação melhora. Valores maiores que48000, aumentam a qualidade do áudio ao custo da perda do desempenho da emulação.O valor predefinido é
48000(-samplerate 48000).
- Exemplo:
-[no]samples
Usar arquivos de amostras caso estejam disponíveis. Esses arquivos são gravações de efeitos de áudio usados por alguns sistemas.
O valor predefinido é
Ligado(-samples).
- Exemplo:
-[no]compressor
Ativa a compressão do áudio. Reduz temporariamente o volume total quando a saída do áudio for saturada.
O valor predefinido é
Ligado(-compressor).
- Exemplo:
-volume / -vol <valor>
Define o volume inicial. Pode ser alterado posteriormente usando a interface do usuário (consulte Teclas já predefinidas). O valor do volume está definido em decibéis (dB); por exemplo,
-volume -12iniciará 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 para o sistema tem prioridade sobre as configurações devolumenos arquivos INI.O valor predefinido é
0(-volume 0, sem atenuação com volume no máximo).
- Exemplo:
-speaker_report <valor>
Imprime um relatório na tela dizendo se houve ou não um ceifamento ou "clipping" da onda gerada pela saída de áudio no alto-falante. Este ceifamento causa distorções no áudio devido a saturação do sinal, tornando as curvas de uma onda senoide numa onda quadrada.
Os valores válidos são:
nível 1: relate apenas se houve clipping.
nível 2: relate a máxima geral, ainda que não haja qualquer clipping.
nível 3: imprima uma lista detalhada de todos os momento que houveram clipping.
nível 4: imprima uma lista detalhada de tudo.
O valor predefinido é
Desligado.
- Exemplo:
Nota
Este comando não tem utilidade prática para o usuário, serve apenas como uma ferramenta para os desenvolvedores do MAME.
-sound < auto | dsound | sdl | coreaudio | xaudio2 | portaudio | none >
Define qual o tipo de saída de áudio usar, Ao usar
nonedesativa o áudio completamente porém o hardware de áudio continua sendo emulado. Abaixo as opções disponíveis para cada sistema operacional.As versões especiais como o SDLMAME para Windows, pode usar a opção
sdle ter o portaudio desativado. 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 é
dsoundno Windows, no Mac écoreaudionas outras plataformas ésdl.No Windows e no Linux a opção
portaudioprovavelmente dará uma menor latência possível, enquanto no Mac a opçãocoreaudiooferecerá os melhores resultados.
- Exemplo:
Microsoft Windows |
auto |
dsound |
xaudio2 |
portaudio |
none |
macOS |
auto |
coreaudio |
sdl |
portaudio |
none |
SDL |
auto |
portaudio |
sdl |
none |
-audio_latency <valor>
Nesta opção, latência significa o tempo que o dispositivo de áudio demora para responder a um comando. Essa opção ajusta a quantidade dessa latência incorporada ao fluxo de dados de áudio.
O comportamento exato depende do módulo da saída de áudio selecionada. Os valores menores oferecem um menor atraso no áudio enquanto exige um desempenho maior do seu sistema. Valores maiores incrementam o atraso do áudio porém ajudam a evitar o esvaziamento da memória intermediária (buffer) e as interrupções do áudio.
Os valores válidos ficam entre
0e5, o valor predefinido é2.
- Exemplo:
Nota
10ms.10ms.25ms.Xms.-pa_api <interface>
PortAudio é um novo recurso adicionado na versão 0.182 do MAME, o PortAudio é uma API, "Application Programming Interface" ou numa tradução livre "Interface de Programação para Aplicações". A API funciona como uma ponte conectando aplicações ao hardware de forma direta. Essa integração permite uma menor latência por haver uma redução no fluxo de dados e por estes dados de áudio serem direcionados diretamente ao dispositivo áudio, o desempenho é otimizado de maneira geral pois o que se salva em processamento no áudio pode ser aproveitado pelo MAME em outros setores da emulação.
Apesar do PortAudio ser o que há de mais moderno em comparação com o DirectSound ou OpenGL Audio e trazer muitos benefícios, há um ponto negativo, o PortAudio faz o uso exclusivo do dispositivo de áudio. Isso significa que não será possível por exemplo, escutar música ou qualquer outra coisa enquanto o MAME estiver rodando com PortAudio.
No Windows Vista ou mais recente nós temos essas interfaces:
MME: É um acrônimo para Multimedia Extension criada pela Microsoft para um sistema operacional pouco conhecido na época chamado "Windows with MultiMedia Extensions 1.0" com base no Windows 3.0, é um dos primeiros API para comunicação direta com a placa de áudio. Essa interface já é obsoleta porém ainda muito usada por questões de compatibilidade.
Windows DirectSound: É uma outra API introduzida pela Microsoft no Windows 95 que adicionou uma camada de software entre a aplicação e o dispositivo de som. Com ele uma placa de som poderia ter dois canais ou mais, efeitos de som 3D foi uma novidade na época, aceleração de áudio via hardware, a placa de som poderia ser compartilhada entre diferentes aplicativos. Essa interface já é obsoleta porém ainda muito usada por questões de compatibilidade.
Windows WASAPI: É um acrônimo para "Windows Audio Session API" ou numa tradução livre, "API da seção de áudio do Windows". Foi introduzido no Windows Vista, a grande vantagem do WASAPI é poder enviar os fluxos de dados de áudio direto para o dispositivo de áudio sem ter que passar por nenhum tipo de CODEC (codificador / decodificador). Outra característica do WASAPI é ter o uso exclusivo do dispositivo de áudio melhorando a latência assim como a qualidade do áudio.
Windows WDM-KS: É um acrônimo para "Windows Driver Model" também criado pela Microsoft e introduzido no Windows 98 e no Windows 2000. O KS vem de "Kernel Streaming" uma maneira ainda mais rápida de acessar o dispositivo de áudio de forma direta através do cerne (kernel) do Windows. Apesar de também fazer uso exclusivo do dispositivo de áudio essa é a interface mais problemática pois ela é muito dependente da qualidade dos drivers usados, gera problemas com a hibernação do Windows quando há problemas com os drivers, a melhor opção é ficar com o Windows WASAPI.
Para escolher qual interface usar, inicie o mame como mostra o exemplo abaixo:
- Exemplo:
No Windows dentre as várias informações que aparecerão no terminal as mais relevantes para nós serão estas:
- Exemplo:
No exemplo acima estão listados dois exemplos de interface, Windows WASAPI e Windows WDM-KS. O uso de qualquer uma destas interfaces depende do driver da sua placa de som. Para definir a interface use o nome dela entre aspas
-pa_api "Windows WASAPI"ou-pa_api "Windows WDM-KS".Já no Linux nós temos uma lista um pouco diferente ainda que estejamos usando o mesmo hardware acima:
- Exemplo:
O valor predefinido é
NULO(Nenhuma interface PortAudio).
-pa_device <dispositivo>
Define qual o dispositivo de áudio usar, assim como mostrado em -pa_api, escolha um dos dispositivos listados. O nome do dispositivo fica do lado direito da lista e entre aspas. Usando o exemplo para o Windows nós usaremos:
- Exemplo:
Já para Linux o comando também não é muito diferente para o mesmo dispositivo:
- Exemplo:
Como resultado o MAME deverá exibir a mensagem abaixo mostrando que tanto a interface quanto o dispositivo foram aceitos:
- Exemplo:
Aqui o mesmo para o Linux:
- Exemplo:
Caso nenhum seja definido o MAME escolherá o dispositivo padrão ou que estiver disponível.
O valor predefinido é
NULO(Nenhum dispositivo PortAudio).
-pa_latency <segundos>
Escolha o tamanho em segundos da memória intermediária para a saída PortAudio. Números menores tem um menor atraso porém valores muito agressivos podem aumentar a quantidade de cortes no áudio. Os valores compatíveis são em pontos decimais. Tente começar com valores como 0.20 e vá aumentando ou reduzindo este valor até encontrar o valor apropriado que funcione melhor com o seu hardware e o seu sistema operacional.
O valor predefinido é
0.
- Exemplo:
Opções para as configurações de diferentes entradas¶
-[no]coin_lockout / -[no]coinlock
Permite a simulação do recurso "bloqueio de ficha" implementado em vários PCBs de jogos de arcade. 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 exibirão uma mensagem na tela (no modo de depuração). Caso esta função esteja 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. Todos os diretórios definidos em
ctrlrpathsão pesquisados. Os arquivos de configuração do controle utilizam um formato similar ao.cfgque é utilizado para gravar as configurações do sistema. Estes arquivos são criados durante a configuração dos botões do controle de um sistema, estas configurações são gravadas no diretório cfg como (nome_da_maquina).cfg. Para mais informações, consulte o capítulo Arquivos de configuração para os controles e o capítulo Configurando a ordem dos botões.O valor predefinido é
NULO(nenhum arquivo de configuração).
- Exemplo:
-[no]mouse
Controla se o MAME faz uso ou não dos controladores do mouse. Caso esta 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 caso esta opção esteja desligada (
-nomouse), a entrada do mouse ainda pode estar ativa dependendo da entrada presente no sistema emulado e a sua definição automática de entrada. Mais especialmente, o padrão é ativar a entrada do mouse quando o sistema emulado tiver entradas para o mouse (-mouse_device mouse), assim sendo, 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
Controla se o MAME usa ou não os controles dos jogos (joystick, gamepad e outras simulações de controles). A compatibilidade com os controles dependem da configuração do seu -joystickprovider. Caso esta opção esteja ativa, o MAME perguntará sobre quais os controles estão conectados atualmente no sistema.
Observe que caso esta opção esteja desligada (
-nojoystick), a entrada do joystick ainda pode estar ativa dependendo da entrada presente no sistema emulado e a sua definição automática de entrada.O valor predefinido é
Desligado(-nojoystick).
- Exemplo:
-[no]lightgun / -[no]gun
Controla se o MAME usa ou não os controles da arma de luz (lightgun). Observe que a maioria das armas de luz são mapeadas para o mouse, assim, ao se usar ambas as opções
-lightgune-mousejuntas, isso pode poderá trazer resultados inesperados. O suporte aos controladores da arma de luz dependem das configurações do -lightgunprovider. Para mais informações, consulte o capítulo Funcionamento.Observe que caso esta opção esteja 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 teclados 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ó. Ativando essa opção permitirá que o MAME retorne 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ó. Ativando esta opção fará com que o MAME relate o movimento e o pressionar de botões do mouse em diferentes mouses de maneira independente.
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 realizar movimentos ou comandos especiais. Devido a limitação do hardware do teclado, pode ser difícil ou até mesmo impossível de realizar usando 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 a do teclado emulado caso esteja presente.
O valor predefinido é
Desligado(-noui_active).
- Exemplo:
-[no]offscreen_reload / -[no]reload
Controla se o MAME trata o segundo botão da arma de luz (lightgun) como um sinal para recarregar a arma. Neste caso, o MAME reportará a posição da arma como (0,MAX) com o gatilho pressionado, o que é o equivalente a uma recarga da arma com ela apontada para fora da tela. Isso só é necessário para jogos que precisam que o usuário atire para fora da tela para recarregar a arma e se também a sua arma não tiver essa funcionalidade.
O valor predefinido é
Desligado(-nooffscreen_reload).
- Exemplo:
-joystick_map / -joymap <mapa>
Controla como os valores do joystick analógico são mapeados para os controles num joystick digital.
Sistemas como o Pac-Man utilizam um controle digital com quatro posições (4-way joystick) que exibe um comportamento inapropriado quando a diagonal é acionada, o Pac-Man simplesmente para nos cruzamentos do mapa fazendo com que seja quase que impossível jogá-lo direito ou pelo menos, da maneira que ele 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 para controles analógicos como os utilizados em sistemas de voo com manches ou thumb sticks analógicos, estes 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 numa grade com 9x9 muito semelhante ao desenho abaixo:
O MAME então toma a posição do eixo do joystick (apenas os valores nos eixos X e Y), mapeia para esta grade e então monitora a tradução a partir do mapa do joystick. Este parâmetro permite que você defina tal mapa.
Como por exemplo, um joystick com 8 posições geralmente se assemelha com a imagem abaixo:
Este mapeamento oferece uma grande margem de manobra para os ângulos aceitos numa determinada direção, assim sendo bem próximo da área da direção desejada. Sem isso, caso esteja um pouco fora do eixo central enquanto segura o controle para a esquerda, o sistema não vai reconhecer a ação de forma adequada.
O valor predefinido é
auto, significa que o controle padrão com 4, 8 posições ou um mapa diagonal para um controle com 4 posições é selecionado de forma automática com base na informação da configuração da porta de entrada do sistema atual.Caso queira configurar a opção
-joystick_mapde forma individual através do<sistema>.iniem vez da configuração domame.inipara que tais configurações afetem apenas os sistemas que precisem destes mapeamentos, consulte a seção Diversos arquivos de configuração para mais detalhes.Os mapeamentos são definidos como uma cadeia de caracteres e números. Uma vez que a grade possui 9x9, existem 81 caracteres no total para que seja possível definir um mapa completo. Abaixo é um exemplo de um mapa para um joystick com 8 posições que coincide com a imagem anterior.
Para definir um mapa com estes 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-se de atalhos compatíveis com o parâmetro <mapa>. Caso falte uma informação sobre uma linha, se deduz então que qualquer dado que falte nas colunas 5-9 sejam simétricos com a posição esquerda/direita em relação com os dados das colunas 0-4; assim como, qualquer dado que falte nas colunas 0-4 é deduzido que sejam cópias dos dados anteriores. A mesma lógica se aplica para as 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 ( significa que podemos utilizar o comando -joymap 7778...4445)
Olhando na primeira fileira, o 7778 tem o comprimento de apenas 4 caracteres. Não é possível utilizar a simetria na 5ª entrada, se deduz então que seja igual ao caractere anterior, '8'. O 6º caractere é simétrico com a posição esquerda/direita em conjunto com o 4º caractere, dando 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/direito invertido). Por fim, retorna o conjunto completo da linha 777888999.
As carreiras dois e três estão faltando, se deduz então que sejam idênticos à 1ª linha. A 4ª carreira é decodificada de forma semelhante à 1ª gerando 444555666. A 5ª carreira está faltando, se deduz então que seja a mesma que a 4ª.
O resto das 3 carreiras também estão faltando, então deduz-se que sejam espelhos do sentido cima/baixo das 3 primeiras carreiras, gerando as carreiras finais com 111222333.
Em sistemas compatíveis com controles com 4 posições, o "sticky" (pegadiço) se torna importante para evitar problemas com as diagonais. Geralmente seria escolhido um mapa semelhante com este:
Significa que caso pressione esquerda e então role o controle para cima (sem passar pelo centro), o eixo do controle passará por aquela parte pegadiça do canto do controle fazendo com que o movimento "pegue" ou "raspe" o manche nas diagonais atrapalhando o movimento. Durante o movimento o MAME irá ler esta posição pegadiça como esquerda pois é a última posição não pegadiça que foi recebida. Até que o movimento chega até a posição cima do mapa até finalmente resultar no movimento para cima.
O mapa então ficaria muito parecido com isso:
Para definir um mapa com estes 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 jogue com um joystick analógico ele poderá estar um pouco fora de centro. O
-joystick_deadzoneinforma uma folga ao longo de um eixo que você deve mover antes que o eixo comece a mudar. Essa opção espera um valor flutuante (float) no intervalo entre0.0e1.0. Onde0é o centro do joystick e1o limite externo.Em ocasiões onde o joystick aparente ser muito sensível, tente alterar o valor do
joystick_deadzonepara0e ojoystick_saturationpara1.O valor predefinido é
0.3(-joystick_deadzone 0.3).
- Exemplo:
-joystick_saturation / joy_saturation / -jsat <valor>
Caso jogue com um joystick analógico as extremidades podem estar um pouco fora e podem não corresponder nas direções + /. O
-joystick_saturationdefine se uma folga no movimento do eixo será aceita até que se atinja o alcance máximo. Essa opção espera um valor flutuante (float) no intervalo entre0.0até1.0onde0é 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, isso controla o quanto ele deve ser movido da posição neutra (ou centro) para ser considerado ativo ou ligado. Esta opção espera uma flutuação na faixa entre
0,0a1,0onde0significa que qualquer movimento da posição neutra for considerado ativo e1significa que apenas os limites externos são considerados ativos. Este 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, isso terá precedência sobre esta configuração quando os eixos principaisX/Yde 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 seu sistema num modo nativo dependendo da sua região, permitindo compatibilidade para teclados fora do padrão "QWERTY".
O valor predefinido é
Desligado(-nonatural).No modo de "teclado emulado" (predefinido) o MAME traduz o pressionamento/liberação de teclas/botões do host para pressionamentos emulados de tecla. Ao pressionar/soltar uma tecla/botão mapeado para uma tecla emulada, o MAME pressiona/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 quando se digita num 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":
O driver do sistema emulado ou do dispositivo de teclado precisam ser compatíveis e haver suporte para eles.
O teclado selecionado deve corresponder ao layout do teclado selecionado no sistema operacional emulado!
As teclas que não produzam caracteres não podem ser traduzidas.
Segurar uma tecla até que o caractere se repitam fará com que a tecla emulada 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 Chinês/Japonês/Coreano por exemplo)
mame coco2 -natural
-[no]joystick_contradictory
Aceita a entrada de comandos contraditórios e simultâneos no controle digital como Esquerda e Direita ou Cima e Baixo ao mesmo tempo.
O valor predefinido é
Desligado(-nojoystick_contradictory).
- Exemplo:
-coin_impulse [n]
Define o tempo de impulso da moeda com base em n (
n<0desativa,n==0obedeça o driver,0<ndefina 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 destas opções de controle define se o
mouse, ojoystickou olightgundevem ser ativados ao executar a emulação de um sistema que usa uma classe das entradas analógicas em particular. Estas opções podem definir o -mouse, o -joystick ou o -lightgun dependendo do tipo das entradas disponíveis no sistema emulado. Observe que essas opções não substituirão as configurações usadas explicitamente na linha de comando de -nomouse, -nojoystick e/ou -nolightgun num nível de prioridade mais alto (num arquivo INI mais específico ou na linha de comando por exemplo).Por exemplo, caso defina a opção
-paddle_device mouse, então os controles do mouse serão automaticamente ativados ao executar um jogo que tenha controles do tipo "paddle" (como o Super Breakout por exemplo), ainda que você tenha usado a opção-nomouse.O padrão é ativar os controles do mouse automaticamente ao rodar sistemas emulados com entradas do mouse (-mouse_device mouse).
- Exemplo:
Dica
Observe que estas 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], exibe todas as informações de diagnósticos disponíveis. Essas informações são úteis para apurar qualquer tipo de problemas com a sua configuração ou qualquer outra que possa aparecer. IMPORTANTE: favor rodar com
mame -verbosee incluir a saída junto caso queira entrar em contato conosco para relatar um erro.O valor predefinido é
Desligado(-noverbose).
- Exemplo:
-[no]oslog
Escreve um arquivo error.log com mensagens de diagnósticos do sistema caso um esteja presente.
É predefinido que as mensagens de erro sejam enviadas para a saída padrão, geralmente é exibido no terminal, prompt de comando ou num arquivo de log de sistema. No Windows, caso um depurador esteja sendo usado como o depurador do Visual Studio ou WinDbg, as mensagens de erros serão enviadas para estes em vez de serem exibidas no terminal.
O valor predefinido é
Desligado(-nooslog).
- Exemplo:
-[no]log
Cria um arquivo chamado error.log que contém todos os registros de mensagens internas gerada pelo cerne do MAME e drivers de sistema. Isso pode ser usado ao mesmo tempo que
-oslogpara escrever os dados de saída de ambos ao mesmo tempo.O valor predefinido é
Desligado(-nolog).
- Exemplo:
-[no]debug / -[no]d
Ativa o depurador embutido no MAME. É predefinido que o depurador entre em ação ao pressionar a tecla til ~ [8] e acento grave ` durante a emulação. Ele também entra direto no depurador depois que a emulação é redefinida, caso esta opção esteja ativa. Consulte -debugger para obter mais informações de 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 ligada. A disponibilidade dos módulos de depuração dependem da plataforma e das opções de compilação.
Estes sã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). É compatível no Windows, Linux e macOS, porém é incluído apenas no Linux. Defina a opção
USE_QTDEBUG=1ao compilar o MAME para tornar disponível no Windows ou macOS.
osxDepurador Cocoa GUI (padrão no macOS). Compatível apenas no macOS.
imguiO depurador ImgUi GUI é exibido na primeira janela do MAME. É preciso que a opção -video esteja definido como
bgfx. É compatível com todas as plataformas que suportem a opção BGFX.
gdbstubFunciona como um servidor de depuração remota para o depurador GNU GDB. Apenas um pequeno conjunto emulado das CPUs são compatíveis. Use a opção -debugger_port para definir a porta na interface de rede. É compatível com todas as plataformas com suporte a TCP/IP.
- Examplo:
-debugscript <nome do arquivo>
Define um arquivo que vai conter a lista de comandos de depuração a serem 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 pausado. Isso significa que a opção de retorno VIDEO_UPDATE sempre será chamada durante a pausa, o que pode ser útil durante a depuração.
O valor predefinido é
Desligado(-noupdate_in_pause).
- Exemplo:
-debugger_port <valor>
Define uma porta a ser usada pelo gdbstub debugger. Para usar, execute o
gdbe faça o comandotarget remote localhost:23946.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 da janela é Lucida Console. A fonte predefinida do Mac (Cocoa) é o padrão de 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 é de11pontos. 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 automaticamente matar o processo do MAME caso o tempo de duração definido em <tempo> passe caso não 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
10e30segundos devem ser suficientes.O valor predefinido é
Nenhum.
- Exemplo:
Opções para a configuração da rede¶
-comm_localhost <endereço>
Definição para o endereço local. Este pode ser um endereço tradicional
xxx.xxx.xxx.xxxou um nome do host que possa ser resolvidoO valor predefinido é
0.0.0.0.
- Exemplo:
-comm_localport <porta>
Definição da porta local. Esta pode ser qualquer porta de comunicação tradicional como um valor inteiro (
0-65535).O valor predefinido é
15122.
- Exemplo:
-comm_remotehost <endereço>
Definição do endereço remoto. Este pode ser um endereço tradicional
xxx.xxx.xxx.xxxou um nome de host que possa ser resolvido.O valor predefinido é
0.0.0.0.
- Exemplo:
-comm_remoteport <porta>
Definição da porta remota. Esta pode ser qualquer porta de comunicação tradicional como um valor inteiro non-signed com 16-bit (
0-65535).O valor predefinido é
15122.
- Exemplo:
-[no]comm_framesync
Sincroniza os quadros entre os hosts na rede.
O valor predefinido é
Desligado(-nocomm_framesync).
- Exemplo:
Opções diversas¶
-[no]drc
Ativa o núcleo o DRC (recompilador dinâmico) da CPU visando uma velocidade máxima de emulação, caso esteja disponível.
Na recompilação dinâmica as instruções são traduzidas em tempo real e mais próxima possível do sistema que está sendo emulado com instruções reagrupadas em código de alto nível que então é compilado na linguagem nativa do sistema hospedeiro. A grande vantagem desta técnica é a melhor adequação do código gerado refletindo num melhor desempenho e eficiência durante a execução. Por outro lado, é preciso um poder de processamento muito maior para que isso seja possível.
O valor predefinido é
Ligado(-drc).
- Exemplo:
-[no]drc_use_c
Impõem o uso do DRC usando a infra-estrutura em código C.
O valor predefinido é
Desligado(-nodrc_use_c).
- Exemplo:
-[no]drc_log_uml
Grave um registro descompilado DRC UML num arquivo de registro (log).
O valor predefinido é (
-nodrc_log_uml).
- Exemplo:
-[no]drc_log_native
Grave o DRC nativo e descompilado num registro de 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 saída -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 que for encontrada, 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 num arquivo externo chamado
cheat.7z. Essa opção também ativa as opções de turbo dos botões.O valor predefinido é
Desligado(-nocheat).
- Exemplo:
-[no]skip_gameinfo
Ao iniciar, faz com que o MAME não exiba a tela de informações do sistema iniciado.
O valor predefinido é
Desligado(-noskip_gameinfo).
- Exemplo:
-uifont <nome da fonte>
Define o nome da fonte ou um nome do arquivo de fonte a ser usada na interface do usuário. Caso esta fonte não possa ser encontrada ou não puder ser carregada, o MAME usará a sua própria fonte embutida. Em algumas plataformas o <nome da fonte> (nome da fonte) pode ser um nome da fonte do sistema em vez de um arquivo fonte com extensão
.bdf. Para o nome das fontes que tem espaço utilize o nome entre aspas (-uifont "nome do arquivo da fonte").O valor predefinido é
default(O MAME usará a fonte nativa).
- Exemplo:
-ui <tipo>
Define o tipo de interface do usuário, as opções ficam entre
simplea mais simples oucabinetque é a mais completa.O valor predefinido é
cabinet(-ui cabinet).
- Exemplo:
-ramsize / -ram <n>
Permite que seja alterado o tamanho padrão da RAM (caso exista suporte para tanto no driver).
- 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 o ponteiro do mouse na interface do usuário 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
Salva o conteúdo da NVRAM ao encerrar a emulação. Caso essa opção seja desligada, o conteúdo que foi gravado anteriormente não será apagado e qualquer alteração atual não será gravado. Ao desligar esta função, n]ao será feito o salvamento dos dados nos arquivos
.nvassociados com alguns tipos de programas usados em cartuchos.O valor predefinido é
Ligado(-nvram_save).
- Exemplo:
Opções para uso com script¶
-autoboot_command / -ab "<comando>"
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. Usando \n irá criar uma nova linha, emitindo o que foi digitado antes como comando.
- Exemplo:
-autoboot_delay <n>
Tempo de atraso (em segundos) para 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 de 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.