ruffle/swf
relrelb 3046d68da1 swf: Introduce `PointDelta`
Generally, when transforming a difference between two points, `p1`
and `p2`, with a matrix `m`, we would like the following property
to hold:

```
m * (p1 - p2) == m * p1 - m * p2
```

Unfortunately, it wasn't like this before, because matrices have a
translation component, which is non-linear. In `m * p1 - m * p2`,
the translations of `m * p1` and `m * p2` are the same and therefore
cancel out each other. However, in `m * (p1 - p2)` the translation
stays.

In order to preserve this property, introduce a new `PointDelta`
type which is not subject to translation when transformed by a matrix.

For now, the following operations are supported:

* `Point - Point -> PointDelta`
* `Point + PointDelta -> Point`
* `Point += PointDelta`
* `Point - PointDelta -> Point`
* `Point -= PointDelta`

As a consequence, the expression `position + global_to_local_matrix * mouse_delta`
in `update_drag()` now ignores translation, which fixes #817.
2023-04-29 22:29:37 +03:00
..
examples swf: Use Fixed in more places 2021-05-30 21:24:03 -07:00
src swf: Introduce `PointDelta` 2023-04-29 22:29:37 +03:00
tests/swfs swf: Write a non-zero 'index' value for true/false/undefined/null default values 2022-08-15 12:30:10 -07:00
Cargo.toml chore(deps): lock file maintenance rust dependencies 2023-04-24 01:22:07 +02:00
LICENSE-APACHE Merge swf-rs into ruffle repo 2019-10-02 17:25:30 -07:00
LICENSE-MIT Merge swf-rs into ruffle repo 2019-10-02 17:25:30 -07:00
README.md swf: Bump version to 0.2 2022-08-16 12:59:20 -07:00

README.md

swf

crates.io docs.rs

A Rust library for reading and writing the Adobe Flash SWF file format.

# Cargo.toml
[dependencies]
swf = "0.2"

Reading

use std::io::BufReader;
use std::fs::File;

let file = File::open("file.swf").unwrap();
let reader = BufReader::new(file);
let swf_buf = swf::decompress_swf(reader).unwrap();
let swf = swf::parse_swf(&swf_buf).unwrap();
println!("The SWF has {} frame(s).", swf.header.num_frames());
println!("The SWF has {} tag(s).", swf.tags.len());

Try cargo run --example reading in this repository to run this example.

Writing

use swf::*;
let header = Header {
    compression: Compression::Zlib,
    version: 6,
    stage_size: Rectangle {
        x_min: Twips::from_pixels(0.0), x_max: Twips::from_pixels(400.0),
        y_min: Twips::from_pixels(0.0), y_max: Twips::from_pixels(400.0)
    },
    frame_rate: Fixed8::from_f32(60.0),
    num_frames: 1,
};
let tags = [
    Tag::SetBackgroundColor(Color { r: 255, g: 0, b: 0, a: 255 }),
    Tag::ShowFrame
];
let file = std::fs::File::create("file.swf").unwrap();
let writer = std::io::BufWriter::new(file);
swf::write_swf(&header, &tags, writer).unwrap();

Try cargo run --example writing in this repository to run this example.

License

Licensed under either of

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.