mirror of
https://github.com/Abdess/retroarch_system.git
synced 2026-10-11 05:53:23 -05:00
154 lines
7.5 KiB
YAML
154 lines
7.5 KiB
YAML
emulator: ruffle
|
|
type: standalone
|
|
core_classification: game_engine
|
|
source: "https://github.com/ruffle-rs/ruffle"
|
|
upstream: "https://github.com/ruffle-rs/ruffle"
|
|
profiled_date: "2026-08-08"
|
|
source_commit: "1636c780671f5f751504240c462524ae6cfcc4bb"
|
|
core_version: "0.5.0"
|
|
display_name: "Adobe Flash (Ruffle)"
|
|
cores:
|
|
- ruffle
|
|
systems:
|
|
- flash
|
|
mode: standalone
|
|
|
|
notes: |
|
|
Flash Player and Adobe AIR runtime written in Rust, playing SWF files of any
|
|
ActionScript version, as a desktop binary or as a WebAssembly browser build.
|
|
Distribution is by nightly build: Batocera compiles the nightly-2026-01-31 tag
|
|
and installs ruffle_desktop as ruffle, RetroDECK pulls the rs.ruffle.Ruffle
|
|
Flathub build. ES-DE runs it as `ruffle --fullscreen <rom>`, Batocera as
|
|
`ruffle <rom>`, RetroBat as `ruffle.exe --graphics <renderer> --force-align
|
|
-q <quality> <rom>`, RetroDECK as `ruffle --graphics vulkan --config
|
|
/var/data/ruffle --save-directory <saves>/ruffle <rom>`. The ActionScript
|
|
class library is compiled by build_playerglobal into playerglobal_avm1.swf and
|
|
playerglobal_avm2.swf and linked into the binary from OUT_DIR
|
|
(core/src/avm1/globals.rs:89, core/src/avm2/globals.rs:548), so startup reads
|
|
nothing. Locale texts, wgsl shaders, the window icon and the OpenH264 license
|
|
are embedded the same way (desktop/src/gui/locale.rs:7-12,
|
|
desktop/src/app.rs:464, render/wgpu/src/shaders.rs:28-76).
|
|
|
|
H.264 video is the one external dependency. external_video is a default
|
|
feature and pulls ruffle_video_external with openh264
|
|
(desktop/Cargo.toml:26,83,90), and enable_openh264 defaults to true
|
|
(desktop/src/preferences.rs:291,316). OpenH264Codec::load first dlopens the
|
|
system sonames libopenh264.so.7, libopenh264.so.2.4.1 and libopenh264.so on
|
|
Linux, then falls back to <cache>/ruffle/video/ and fetches the Cisco binary
|
|
from ciscobinary.openh264.org bz2-compressed into it
|
|
(video/external/src/decoder/openh264.rs:53-56,109-133,173-191,
|
|
desktop/src/player.rs:234-241). Whether the library was already there or was
|
|
just downloaded, its SHA-256 is checked before loading and the size is read
|
|
only to format the mismatch message
|
|
(video/external/src/decoder/openh264.rs:135-146), and WelsGetCodecVersion must
|
|
answer 2.4.1 exactly (video/external/src/decoder/openh264.rs:46,153-166). The
|
|
cache root comes from dirs::cache_dir(), ~/.cache/ruffle by default, and
|
|
--cache-directory moves it (desktop/src/cli.rs:29-33,140). Without the library
|
|
the player still starts: ExternalVideoBackend wraps SoftwareVideoBackend, so
|
|
H.263, Screen Video and VP6 keep decoding and only H.264 streams fail
|
|
(video/external/src/backend.rs:41,51-69,73-80).
|
|
|
|
Text uses system fonts. fontdb::Database::load_system_fonts() fills the
|
|
database at startup (desktop/src/app.rs:433-434), and both the Flash device
|
|
fonts and the egui menu bar resolve family names against it and take whatever
|
|
face the host answers with. How that face is read now depends on the renderer:
|
|
freetype joined the desktop default features, so on Linux it goes through
|
|
FreetypeFontRenderer, and the plain memory map of the file is the other branch
|
|
(desktop/src/backends/ui.rs:366-406,518-562,
|
|
desktop/src/gui/controller.rs:760-803). The families asked for are Times New
|
|
Roman, Arial, Courier New and their metric-compatible substitutes, plus the
|
|
CJK, Hebrew, Arabic and Thai faces (desktop/src/player.rs:361-412,
|
|
desktop/src/gui/controller.rs:639-711), and on Unix fontconfig sorts the
|
|
fallback chain (desktop/src/backends/ui.rs:363-376,536-550). No name, path,
|
|
size or hash is fixed anywhere. The compiled-in Noto Sans subset sits behind
|
|
the default_font feature, which the desktop build does not enable
|
|
(core/src/player.rs:84-85, core/Cargo.toml:82,95, desktop/Cargo.toml:22), so
|
|
an unmatched family leaves the run without that face rather than falling back
|
|
to a bundled one.
|
|
|
|
Files the player writes rather than expects: preferences.toml, bookmarks.toml
|
|
and recents.toml under --config, each defaulted when absent
|
|
(desktop/src/preferences.rs:54-96), .sol SharedObjects under --save-directory
|
|
(frontend-utils/src/backends/storage.rs:31-60), and the log file
|
|
(desktop/src/main.rs:156-166). ruffle-bundle.toml is the manifest inside a
|
|
.ruf bundle, which is content alongside the .swf rather than a runtime input
|
|
(frontend-utils/src/bundle/info.rs:11, frontend-utils/src/bundle.rs:42-53).
|
|
mms.cfg is not
|
|
implemented, the name appears only in an AVM2 error string
|
|
(core/src/avm2/error_messages.rs:237).
|
|
|
|
files:
|
|
# -- OpenH264 2.4.1 decoder, one build per OS and architecture --
|
|
|
|
- name: libopenh264-2.4.1-linux64.7.so
|
|
path: "video/libopenh264-2.4.1-linux64.7.so"
|
|
system: flash
|
|
required: false
|
|
description: "OpenH264 2.4.1 decoder library, Linux x86_64"
|
|
sha256: "1392d21466bc638e68151b716d5b2086d54cd812afd43253f1adb5b6e0185f51"
|
|
validation: [sha256]
|
|
source_ref: "video/external/src/decoder/openh264.rs:65-68, 104-146, 173-191"
|
|
|
|
- name: libopenh264-2.4.1-linux-arm64.7.so
|
|
path: "video/libopenh264-2.4.1-linux-arm64.7.so"
|
|
system: flash
|
|
required: false
|
|
description: "OpenH264 2.4.1 decoder library, Linux aarch64"
|
|
sha256: "e8ea7e42855ceb4a90e7bd0b3abeba0c58b5f97166e8b0a30eefd58e099557a4"
|
|
validation: [sha256]
|
|
source_ref: "video/external/src/decoder/openh264.rs:73-76, 104-146, 173-191"
|
|
|
|
- name: libopenh264-2.4.1-linux-arm.7.so
|
|
path: "video/libopenh264-2.4.1-linux-arm.7.so"
|
|
system: flash
|
|
required: false
|
|
description: "OpenH264 2.4.1 decoder library, Linux arm"
|
|
sha256: "fd1dfb27d30bb72e903c9d2b4c650104a4369d2e7ffe8a4a533e8db2e7e9b19e"
|
|
validation: [sha256]
|
|
source_ref: "video/external/src/decoder/openh264.rs:69-72, 104-146, 173-191"
|
|
|
|
- name: libopenh264-2.4.1-linux32.7.so
|
|
path: "video/libopenh264-2.4.1-linux32.7.so"
|
|
system: flash
|
|
required: false
|
|
description: "OpenH264 2.4.1 decoder library, Linux x86"
|
|
sha256: "b7cf0e407f99056d90cbf62787a34820a7595b2129b165319d50766e00a66704"
|
|
validation: [sha256]
|
|
source_ref: "video/external/src/decoder/openh264.rs:61-64, 104-146, 173-191"
|
|
|
|
- name: libopenh264-2.4.1-mac-arm64.dylib
|
|
path: "video/libopenh264-2.4.1-mac-arm64.dylib"
|
|
system: flash
|
|
required: false
|
|
description: "OpenH264 2.4.1 decoder library, macOS aarch64"
|
|
sha256: "213ff93831cfa3dd6d7ad0c3a3403a6ceedf4ac1341e1278b5b869d42fefb496"
|
|
validation: [sha256]
|
|
source_ref: "video/external/src/decoder/openh264.rs:81-84, 104-146, 173-191"
|
|
|
|
- name: libopenh264-2.4.1-mac-x64.dylib
|
|
path: "video/libopenh264-2.4.1-mac-x64.dylib"
|
|
system: flash
|
|
required: false
|
|
description: "OpenH264 2.4.1 decoder library, macOS x86_64"
|
|
sha256: "cc0ba518a63791c37571f3c851f0aa03a4fbda5410acc214ecd4f24f8d1c478e"
|
|
validation: [sha256]
|
|
source_ref: "video/external/src/decoder/openh264.rs:77-80, 104-146, 173-191"
|
|
|
|
- name: openh264-2.4.1-win64.dll
|
|
path: "video/openh264-2.4.1-win64.dll"
|
|
system: flash
|
|
required: false
|
|
description: "OpenH264 2.4.1 decoder library, Windows x86_64"
|
|
sha256: "081b0c081480d177cbfddfbc90b1613640e702f875897b30d8de195cde73dd34"
|
|
validation: [sha256]
|
|
source_ref: "video/external/src/decoder/openh264.rs:89-92, 104-146, 173-191"
|
|
|
|
- name: openh264-2.4.1-win32.dll
|
|
path: "video/openh264-2.4.1-win32.dll"
|
|
system: flash
|
|
required: false
|
|
description: "OpenH264 2.4.1 decoder library, Windows x86"
|
|
sha256: "83270149640469c994a62cc32a6d8c0413cd7b802b7f1f2f532159f5bdc1cedd"
|
|
validation: [sha256]
|
|
source_ref: "video/external/src/decoder/openh264.rs:85-88, 104-146, 173-191"
|