mirror of
https://github.com/Abdess/retroarch_system.git
synced 2026-10-10 21:43:23 -05:00
Abdessamad Derraz
6e65b542bb
The freetype feature joined the desktop defaults, and load_fontdb_font takes a renderer and an atlas set: on Linux the face goes through FreetypeFontRenderer, and the memory map of the file is the other branch. Which faces are asked for is unchanged, and still no name, path, size or hash is fixed anywhere.
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: "f3a1263e164dc4cb56211ab1f113e1907730ce89"
|
|
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:546), 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:449, 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:283,307). 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:418-419), 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:321-359,442-484,
|
|
desktop/src/gui/controller.rs:690-733). 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:569-641), and on Unix fontconfig sorts the
|
|
fallback chain (desktop/src/backends/ui.rs:318-329,460-472). 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:82-83, core/Cargo.toml:82,96, 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:53-95), .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"
|