ares README

The project's README from github.com/ares-emulator/ares. As one markdown file: README.md.

License: ISC

ares is a multi-system emulator that began development on October 14th, 2004. It is a descendant of higan and bsnes, and focuses on accuracy and preservation.

It's worth noting that ares takes some uncommon design approaches that essentially trade speed for code clarity. We avoid state machines and bitmasks (when possible). Most cores end up being half the amount of code, but slower. The code is clearer and less spaghettified, especially for systems with lots of processors. C bitfields being non-portable incurs a speedhit. Windows also has a speedhit over Linux due to its ABI needing more instructions to switch contexts.

Official Releases

Official releases are available from the ares website.

Nightly Builds

Automated, untested builds of ares are available for Windows and macOS as a pre-release. Only the latest nightly build is kept.

Building ares

ares supports building on Windows, macOS, and various Linux/BSD distributions. See build instructions for:

Command-line options

When started from the command-line, ares accepts a few options.

Usage: ./ares [options] game(s)

  --help                 Displays available options and exit
  --version              Displays the version string of the application
  --terminal             Create new terminal window (Windows only)
  --fullscreen           Start in full screen mode
  --pseudofullscreen     Start in pseudo full screen mode
  --kiosk                Start in minimal UI mode (implies --no-file-prompt)
  --system system        Specify the system name
  --shader shader        Specify a slang shader to load (requires OpenGL or Metal)
  --setting name=value   Specify a value for a setting
  --dump-all-settings    Show a list of all existing settings and exit
  --no-file-prompt       Do not prompt to load (optional) additional roms (eg: 64DD)
  --settings-file path   Specify a settings file override (settings.bml)
  --save-state slot      Specify a save state slot to load (1-9)

The --system option is useful when the system type cannot be auto-detected. --fullscreen will only have an effect if a game is also passed in argument.

Example: ares --system MSX examples.rom --fullscreen

Specifying multiple games allows for multi-cart support. For example, to load the Super GameBoy BIOS and a game in one command (to avoid a file prompt), you can do:

ares "Super GameBoy.sfc" "Super Mario Land.gb"

The --no-file-prompt option is useful if you wish to launch a game from CLI without being prompted to load additional roms. For example, some Nintendo 64 games optionally support 64DD expansion disks, so this option can be used to suppress the "64DD Disk" file dialog, and assume any secondary content is disconnected.

High-level Components

Contributing

Please join our discord to chat with other ares developers: https://discord.com/invite/gz2quhk2kv

ares (ares-emulator/ares)

Searching Database…

1.8K ·GitHub
Ares
Что это?ares — это кроссплатформенный open-source мультиэмулятор, который делает упор на точность и сохранение классических игровых консолей и компьютеров.
Это эмулятор одной системы или он покрывает много консолей?Это мультиэмулятор с отдельными внутренними ядрами для каждой поддерживаемой системы, плюс общий GUI (desktop-ui) и тулкит (hiro), работающие на разных платформах.
Как его запустить?Скачайте официальный релиз с сайта ares, автоматическую ночную сборку для Windows/macOS или соберите его сами из исходников.
Нужно ли самому что-то компилировать или ставить инструменты сборки, чтобы им пользоваться?Нет, есть готовые официальные релизы и ночные сборки; сборка из исходников нужна, только если вы хотите скомпилировать его сами на Windows, macOS, Linux или BSD.
Подход «точность прежде всего» обходится производительностью?Да, ares сознательно жертвует скоростью ради ясности кода, избегая конечных автоматов и битовых масок, поэтому ядра работают медленнее, чем могли бы; Windows к тому же медленнее Linux из-за накладных расходов ABI на переключение контекста.
На каких платформах реально работает ares?ares работает на Windows, macOS и различных дистрибутивах Linux/BSD.
Как загрузить игру из командной строки?Запустите ares с путём к ROM, например 'ares --system MSX examples.rom --fullscreen'; можно также передать несколько ROM-файлов сразу (например, BIOS Super GameBoy плюс картридж) для конфигураций с несколькими картриджами.
Для чего нужна опция --no-file-prompt?Она подавляет вторичные диалоги выбора файлов, например запрос диска N64 64DD, позволяя запустить игру через CLI, не получая просьб загрузить дополнительные ROM.
Какое отношение к проекту имеет Near?ares — потомок более ранних эмуляторов Near, higan и bsnes, и проект до сих пор использует созданную Near замену стандартной библиотеки C++ под названием nall.
Что такое hiro, ruby, mia и libco?Это внутренние компоненты: hiro — кроссплатформенный тулкит нативного GUI, ruby связывает приложения на hiro с платформенными API видео/аудио/ввода, mia ведёт базу ROM и загрузку образов, а libco обеспечивает кооперативную многопоточность.
What are similar projects?widemelon, ProsperoEden, pcsx2, TheSimpsonsGameRecomp, exodium, PS5SX2, dolphin, mame
Which topics is it in?console, emulation, retrogaming, emulator, game, bsd, c++, command-line, hacktoberfest, desktop, gui, desktop-app
Creator
ares-emulator
Size
180 MB
Stars
1.8K
Updated
CommitOct 06Releasev148May 30
Age
5y
Commits · 90 Days