323da9ded3
This also incurred a large number of ancillary changes, as it turns out nearly every native object is currently pulling a prototype and sticking it into an object. Right now, I have it instead pulling the constructor out of the prototype, but a future PR will also remove `system_prototypes` as well. Other ancillary changes include: * `Domain` now supports partial initialization to avoid an order-of-events issue. Accessing domain memory on a partially-initialized `Domain` will panic. * `Domain` construction requires a full `activation` now, except for `global_scope` which needs to be initialized later with valid domain memory before user code runs. * Pretty much every native object constructor now takes a proto/constr pair * Trait lookup was rewritten to handle this. It's still buggy - seven tests don't work * `TObject.construct` now actually does the full object construction dance. This allows `ClassObject` to implement the ES4 object construction pathway directly while `FunctionObject` maintains ES3 compatibility. This is a tentative commit; there are still seven failing tests that I need to fix. |
||
---|---|---|
.github | ||
core | ||
desktop | ||
exporter | ||
render | ||
scanner | ||
swf | ||
tests | ||
web | ||
.gitattributes | ||
.gitignore | ||
CODE_OF_CONDUCT.md | ||
CONTRIBUTING.md | ||
Cargo.lock | ||
Cargo.toml | ||
LICENSE.md | ||
PKGBUILD | ||
README.md | ||
rustfmt.toml |
README.md
website | demo | nightly builds | wiki
Ruffle
Ruffle is an Adobe Flash Player emulator written in the Rust programming language. Ruffle targets both the desktop and the web using WebAssembly.
Project status
Ruffle is in the proof-of-concept stage and can currently run early Flash animations and games. Basic ActionScript 1.0/2.0 support is in place and improving; ActionScript 3.0 support is forthcoming. For more info, read the project roadmap.
Using Ruffle
The easiest way to try out Ruffle is to visit the web demo page, then click the "Browse..." button to load an SWF file of your choice.
Nightly builds of Ruffle are available for desktop and web platforms including the browser extension.
For more detailed instructions, see our wiki page.
Building from source
Follow the official guide to install Rust for your platform.
Desktop
cargo run --package=ruffle_desktop -- test.swf
Web or Extension
Follow the instructions in the web directory for building either the web or browser extension version of Ruffle.
Scanner
If you have a collection of "real world" SWFs to test against, the scanner may be used to benchmark ruffle's parsing capabilities. Provided with a folder and an output filename, it will attempt to read all of the flash files and report on the success of such a task.
cargo run --package=ruffle_scanner -- folder/with/swfs/ results.csv
Exporter
If you have a swf and would like to capture an image of it, you may use the exporter tool. This currently requires hardware acceleration, but can be run headless (with no window).
cargo run --package=exporter -- path/to/file.swf
cargo run --package=exporter -- path/to/file.swf path/to/screenshots --frames 5
Structure
core
contains the core emulator and common codedesktop
contains the desktop client (useswgpu-rs
)web
contains the web client and browser extension (useswasm-bindgen
)scanner
contains a utility to bulk parse swf filesexporter
contains a utility to generate PNG screenshots of a swf file
Sponsors
You can support the development of Ruffle via GitHub Sponsors. Your sponsorship will help to ensure the accessibility of Flash content for the future. Thank you!
Sincere thanks to the diamond level sponsors of Ruffle:
License
Ruffle is licensed under either of
- Apache License, Version 2.0 (http://www.apache.org/licenses/LICENSE-2.0)
- MIT License (http://opensource.org/licenses/MIT)
at your option.
Ruffle depends on third-party libraries under compatible licenses. See LICENSE.md for full information.
Contribution
Ruffle welcomes contribution from everyone. See CONTRIBUTING.md for help getting started.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you shall be dual licensed as above, without any additional terms or conditions.
The entire Ruffle community, including the chat room and GitHub project, is expected to abide by the Code of Conduct that the Rust project itself follows.