ruffle/render/src/shape_utils.rs

1362 lines
47 KiB
Rust

use crate::bounding_box::BoundingBox;
use crate::matrix::Matrix;
use smallvec::SmallVec;
use swf::{CharacterId, FillStyle, LineStyle, Shape, ShapeRecord, Twips};
pub fn calculate_shape_bounds(shape_records: &[swf::ShapeRecord]) -> swf::Rectangle<Twips> {
let mut bounds = swf::Rectangle {
x_min: Twips::new(i32::MAX),
y_min: Twips::new(i32::MAX),
x_max: Twips::new(i32::MIN),
y_max: Twips::new(i32::MIN),
};
let mut x = Twips::ZERO;
let mut y = Twips::ZERO;
for record in shape_records {
match record {
swf::ShapeRecord::StyleChange(style_change) => {
if let Some((move_x, move_y)) = style_change.move_to {
x = move_x;
y = move_y;
bounds.x_min = Twips::min(bounds.x_min, x);
bounds.x_max = Twips::max(bounds.x_max, x);
bounds.y_min = Twips::min(bounds.y_min, y);
bounds.y_max = Twips::max(bounds.y_max, y);
}
}
swf::ShapeRecord::StraightEdge { delta_x, delta_y } => {
x += *delta_x;
y += *delta_y;
bounds.x_min = Twips::min(bounds.x_min, x);
bounds.x_max = Twips::max(bounds.x_max, x);
bounds.y_min = Twips::min(bounds.y_min, y);
bounds.y_max = Twips::max(bounds.y_max, y);
}
swf::ShapeRecord::CurvedEdge {
control_delta_x,
control_delta_y,
anchor_delta_x,
anchor_delta_y,
} => {
x += *control_delta_x;
y += *control_delta_y;
bounds.x_min = Twips::min(bounds.x_min, x);
bounds.x_max = Twips::max(bounds.x_max, x);
bounds.y_min = Twips::min(bounds.y_min, y);
bounds.y_max = Twips::max(bounds.y_max, y);
x += *anchor_delta_x;
y += *anchor_delta_y;
bounds.x_min = Twips::min(bounds.x_min, x);
bounds.x_max = Twips::max(bounds.x_max, x);
bounds.y_min = Twips::min(bounds.y_min, y);
bounds.y_max = Twips::max(bounds.y_max, y);
}
}
}
if bounds.x_max < bounds.x_min || bounds.y_max < bounds.y_min {
bounds = Default::default();
}
bounds
}
/// `DrawPath` represents a solid fill or a stroke.
/// Fills are always closed paths, while strokes may be open or closed.
/// Closed paths will have the first point equal to the last point.
#[derive(Clone, Debug, Eq, PartialEq)]
pub enum DrawPath<'a> {
Stroke {
style: &'a LineStyle,
is_closed: bool,
commands: Vec<DrawCommand>,
},
Fill {
style: &'a FillStyle,
commands: Vec<DrawCommand>,
},
}
/// `DistilledShape` represents a ready-to-be-consumed collection of paths (both fills and strokes)
/// that has been converted down from another source (such as SWF's `swf::Shape` format).
#[derive(Clone, Debug, Eq, PartialEq)]
pub struct DistilledShape<'a> {
pub paths: Vec<DrawPath<'a>>,
pub shape_bounds: BoundingBox,
pub edge_bounds: BoundingBox,
pub id: CharacterId,
}
impl<'a> From<&'a swf::Shape> for DistilledShape<'a> {
fn from(shape: &'a Shape) -> Self {
Self {
paths: ShapeConverter::from_shape(shape).into_commands(),
shape_bounds: (&shape.shape_bounds).into(),
edge_bounds: (&shape.edge_bounds).into(),
id: shape.id,
}
}
}
/// `DrawCommands` trace the outline of a path.
/// Fills follow the even-odd fill rule, with opposite winding for holes.
#[derive(Clone, Debug, Eq, PartialEq)]
pub enum DrawCommand {
MoveTo {
x: Twips,
y: Twips,
},
LineTo {
x: Twips,
y: Twips,
},
CurveTo {
x1: Twips,
y1: Twips,
x2: Twips,
y2: Twips,
},
}
impl DrawCommand {
pub fn end_point(&self) -> (Twips, Twips) {
match self {
DrawCommand::MoveTo { x, y } => (*x, *y),
DrawCommand::LineTo { x, y } => (*x, *y),
DrawCommand::CurveTo { x2, y2, .. } => (*x2, *y2),
}
}
}
#[derive(Clone, Copy, Debug)]
struct Point {
x: Twips,
y: Twips,
is_bezier_control: bool,
}
/// A continuous series of edges in a path.
/// Fill segments are directed, because the winding determines the fill-rule.
/// Stroke segments are undirected.
#[derive(Clone, Debug)]
struct PathSegment {
pub points: Vec<Point>,
}
impl PathSegment {
fn new(start: (Twips, Twips)) -> Self {
Self {
points: vec![Point {
x: start.0,
y: start.1,
is_bezier_control: false,
}],
}
}
fn reset(&mut self, start: (Twips, Twips)) {
self.points.clear();
self.points.push(Point {
x: start.0,
y: start.1,
is_bezier_control: false,
});
}
/// Flips the direction of the path segment.
/// Flash fill paths are dual-sided, with fill style 1 indicating the positive side
/// and fill style 0 indicating the negative. We have to flip fill style 0 paths
/// in order to link them to fill style 1 paths.
fn flip(&mut self) {
self.points.reverse();
}
/// Adds an edge to the end of the path segment.
fn add_point(&mut self, point: Point) {
self.points.push(point);
}
fn is_empty(&self) -> bool {
self.points.len() <= 1
}
fn start(&self) -> Option<(Twips, Twips)> {
let pt = &self.points.first()?;
Some((pt.x, pt.y))
}
fn end(&self) -> Option<(Twips, Twips)> {
let pt = &self.points.last()?;
Some((pt.x, pt.y))
}
fn is_closed(&self) -> bool {
self.start() == self.end()
}
fn to_draw_commands(&self) -> impl '_ + Iterator<Item = DrawCommand> {
assert!(!self.is_empty());
let mut i = self.points.iter();
let first = i.next().expect("Points should not be empty");
std::iter::once(DrawCommand::MoveTo {
x: first.x,
y: first.y,
})
.chain(std::iter::from_fn(move || match i.next() {
Some(&Point {
is_bezier_control: false,
x,
y,
}) => Some(DrawCommand::LineTo { x, y }),
Some(&Point {
is_bezier_control: true,
x,
y,
}) => {
let end = i.next().expect("Bezier without endpoint");
Some(DrawCommand::CurveTo {
x1: x,
y1: y,
x2: end.x,
y2: end.y,
})
}
None => None,
}))
}
}
/// The internal path structure used by ShapeConverter.
///
/// Each path is uniquely identified by its fill/stroke style. But Flash gives
/// the path edges as an "edge soup" -- they can arrive in an arbitrary order.
/// We have to link the edges together for each path. This structure contains
/// a list of path segment, and each time a path segment is added, it will try
/// to merge it with an existing segment.
#[derive(Clone, Debug)]
struct PendingPath {
/// The list of path segments for this fill/stroke.
/// For fills, this should turn into a list of closed paths when the shape is complete.
/// Strokes may or may not be closed.
segments: Vec<PathSegment>,
}
impl PendingPath {
fn new() -> Self {
Self { segments: vec![] }
}
/// Adds a path segment to the path, attempting to link it to existing segments.
fn add_segment(&mut self, mut new_segment: PathSegment) {
if !new_segment.is_empty() {
// Try to link this segment onto existing segments with a matching endpoint.
// Both the start and the end points of the new segment can be linked.
let mut start_open = true;
let mut end_open = true;
let mut i = 0;
while (start_open || end_open) && i < self.segments.len() {
let other = &mut self.segments[i];
if start_open && other.end() == new_segment.start() {
other.points.extend_from_slice(&new_segment.points[1..]);
new_segment = self.segments.swap_remove(i);
start_open = false;
} else if end_open && new_segment.end() == other.start() {
std::mem::swap(&mut other.points, &mut new_segment.points);
other.points.extend_from_slice(&new_segment.points[1..]);
new_segment = self.segments.swap_remove(i);
end_open = false;
} else {
i += 1;
}
}
// The segment can't link to any further segments. Add it to list.
self.segments.push(new_segment);
}
}
fn push_path(&mut self, segment: PathSegment) {
self.segments.push(segment);
}
fn to_draw_commands(&self) -> impl '_ + Iterator<Item = DrawCommand> {
self.segments.iter().flat_map(PathSegment::to_draw_commands)
}
}
#[derive(Clone, Debug)]
pub struct ActivePath {
style_id: u32,
segment: PathSegment,
}
impl ActivePath {
fn new() -> Self {
Self {
style_id: 0,
segment: PathSegment::new(Default::default()),
}
}
fn add_point(&mut self, point: Point) {
self.segment.add_point(point)
}
fn flush_fill(&mut self, start: (Twips, Twips), pending: &mut [PendingPath], flip: bool) {
if self.style_id > 0 && !self.segment.is_empty() {
if flip {
self.segment.flip();
}
pending[self.style_id as usize - 1].add_segment(self.segment.clone());
}
self.segment.reset(start);
}
fn flush_stroke(&mut self, start: (Twips, Twips), pending: &mut [PendingPath]) {
if self.style_id > 0 && !self.segment.is_empty() {
pending[self.style_id as usize - 1].push_path(self.segment.clone());
}
self.segment.reset(start);
}
}
pub struct ShapeConverter<'a> {
// SWF shape commands.
iter: std::slice::Iter<'a, swf::ShapeRecord>,
// Pen position.
x: Twips,
y: Twips,
// Fill styles and line styles.
// These change from StyleChangeRecords, and a flush occurs when these change.
fill_styles: &'a [swf::FillStyle],
line_styles: &'a [swf::LineStyle],
fill_style0: ActivePath,
fill_style1: ActivePath,
line_style: ActivePath,
// Paths. These get flushed for each new layer.
fills: Vec<PendingPath>,
strokes: Vec<PendingPath>,
// Output.
commands: Vec<DrawPath<'a>>,
}
impl<'a> ShapeConverter<'a> {
const DEFAULT_CAPACITY: usize = 512;
fn from_shape(shape: &'a swf::Shape) -> Self {
ShapeConverter {
iter: shape.shape.iter(),
x: Twips::ZERO,
y: Twips::ZERO,
fill_styles: &shape.styles.fill_styles,
line_styles: &shape.styles.line_styles,
fill_style0: ActivePath::new(),
fill_style1: ActivePath::new(),
line_style: ActivePath::new(),
fills: vec![PendingPath::new(); shape.styles.fill_styles.len()],
strokes: vec![PendingPath::new(); shape.styles.line_styles.len()],
commands: Vec::with_capacity(Self::DEFAULT_CAPACITY),
}
}
fn into_commands(mut self) -> Vec<DrawPath<'a>> {
// As u32 is okay because SWF has a max of 65536 fills (TODO: should be u16?)
let mut num_fill_styles = self.fill_styles.len() as u32;
let mut num_line_styles = self.line_styles.len() as u32;
while let Some(record) = self.iter.next() {
match record {
ShapeRecord::StyleChange(style_change) => {
if let Some((x, y)) = style_change.move_to {
self.x = x;
self.y = y;
// We've lifted the pen, so we're starting a new path.
// Flush the previous path.
self.flush_paths();
}
if let Some(styles) = &style_change.new_styles {
// A new style list is also used to indicate a new drawing layer.
self.flush_layer();
self.fill_styles = &styles.fill_styles[..];
self.line_styles = &styles.line_styles[..];
self.fills
.resize_with(self.fill_styles.len(), PendingPath::new);
self.strokes
.resize_with(self.line_styles.len(), PendingPath::new);
num_fill_styles = self.fill_styles.len() as u32;
num_line_styles = self.line_styles.len() as u32;
}
if let Some(new_style_id) = style_change.fill_style_1 {
self.fill_style1
.flush_fill((self.x, self.y), &mut self.fills[..], false);
// Validate in case we index an invalid fill style.
// <= because fill ID 0 (no fill) is implicit, so the array is actually 1-based
self.fill_style1.style_id = if new_style_id <= num_fill_styles {
new_style_id
} else {
0
};
}
if let Some(new_style_id) = style_change.fill_style_0 {
self.fill_style0
.flush_fill((self.x, self.y), &mut self.fills[..], true);
self.fill_style0.style_id = if new_style_id <= num_fill_styles {
new_style_id
} else {
0
}
}
if let Some(new_style_id) = style_change.line_style {
self.line_style
.flush_stroke((self.x, self.y), &mut self.strokes[..]);
self.line_style.style_id = if new_style_id <= num_line_styles {
new_style_id
} else {
0
}
}
}
ShapeRecord::StraightEdge { delta_x, delta_y } => {
self.x += *delta_x;
self.y += *delta_y;
self.visit_point(Point {
x: self.x,
y: self.y,
is_bezier_control: false,
});
}
ShapeRecord::CurvedEdge {
control_delta_x,
control_delta_y,
anchor_delta_x,
anchor_delta_y,
} => {
let x1 = self.x + *control_delta_x;
let y1 = self.y + *control_delta_y;
self.visit_point(Point {
x: x1,
y: y1,
is_bezier_control: true,
});
let x2 = x1 + *anchor_delta_x;
let y2 = y1 + *anchor_delta_y;
self.visit_point(Point {
x: x2,
y: y2,
is_bezier_control: false,
});
self.x = x2;
self.y = y2;
}
}
}
// Flush any open paths.
self.flush_layer();
self.commands
}
/// Adds a point to the current path for the active fills/strokes.
fn visit_point(&mut self, point: Point) {
if self.fill_style1.style_id > 0 {
self.fill_style1.add_point(point);
}
if self.fill_style0.style_id > 0 {
self.fill_style0.add_point(point);
}
if self.line_style.style_id > 0 {
self.line_style.add_point(point);
}
}
/// When the pen jumps to a new position, we reset the active path.
fn flush_paths(&mut self) {
// Move the current paths to the active list.
self.fill_style1
.flush_fill((self.x, self.y), &mut self.fills, false);
self.fill_style0
.flush_fill((self.x, self.y), &mut self.fills, true);
self.line_style
.flush_stroke((self.x, self.y), &mut self.strokes);
}
/// When a new layer starts, all paths are flushed and turned into drawing commands.
fn flush_layer(&mut self) {
self.flush_paths();
// Draw fills, and then strokes.
// Paths are drawn in order of style id, not based on the order of the draw commands.
for (i, path) in self.fills.iter_mut().enumerate() {
// These invariants are checked above (any invalid/empty fill ID should not have been added).
debug_assert!(i < self.fill_styles.len());
if path.segments.is_empty() {
continue;
}
let style = unsafe { self.fill_styles.get_unchecked(i) };
self.commands.push(DrawPath::Fill {
style,
commands: path.to_draw_commands().collect(),
});
path.segments.clear();
}
// Strokes are drawn last because they always appear on top of fills in the same layer.
// Because path segments can either be open or closed, we convert each stroke segment into
// a separate draw command.
for (i, path) in self.strokes.iter_mut().enumerate() {
debug_assert!(i < self.line_styles.len());
let style = unsafe { self.line_styles.get_unchecked(i) };
for segment in &path.segments {
if segment.is_empty() {
continue;
}
self.commands.push(DrawPath::Stroke {
style,
is_closed: segment.is_closed(),
commands: segment.to_draw_commands().collect(),
});
}
path.segments.clear();
}
}
}
#[cfg(test)]
mod tests {
use super::*;
const FILL_STYLES: [FillStyle; 1] = [FillStyle::Color(swf::Color {
r: 255,
g: 0,
b: 0,
a: 255,
})];
const LINE_STYLES: [LineStyle; 0] = [];
/// Convenience method to quickly make a shape,
fn build_shape(records: Vec<ShapeRecord>) -> swf::Shape {
let bounds = calculate_shape_bounds(&records);
swf::Shape {
version: 2,
id: 1,
shape_bounds: bounds.clone(),
edge_bounds: bounds,
flags: swf::ShapeFlag::HAS_SCALING_STROKES,
styles: swf::ShapeStyles {
fill_styles: FILL_STYLES.to_vec(),
line_styles: LINE_STYLES.to_vec(),
},
shape: records,
}
}
/// A simple solid square.
#[test]
fn basic_shape() {
let shape = build_shape(vec![
ShapeRecord::StyleChange(Box::new(swf::StyleChangeData {
move_to: Some((Twips::from_pixels(100.0), Twips::from_pixels(100.0))),
fill_style_0: None,
fill_style_1: Some(1),
line_style: None,
new_styles: None,
})),
ShapeRecord::StraightEdge {
delta_x: Twips::from_pixels(100.0),
delta_y: Twips::from_pixels(0.0),
},
ShapeRecord::StraightEdge {
delta_x: Twips::from_pixels(0.0),
delta_y: Twips::from_pixels(100.0),
},
ShapeRecord::StraightEdge {
delta_x: Twips::from_pixels(-100.0),
delta_y: Twips::from_pixels(0.0),
},
ShapeRecord::StraightEdge {
delta_x: Twips::from_pixels(0.0),
delta_y: Twips::from_pixels(-100.0),
},
]);
let commands = ShapeConverter::from_shape(&shape).into_commands();
let expected = vec![DrawPath::Fill {
style: &FILL_STYLES[0],
commands: vec![
DrawCommand::MoveTo {
x: Twips::from_pixels(100.0),
y: Twips::from_pixels(100.0),
},
DrawCommand::LineTo {
x: Twips::from_pixels(200.0),
y: Twips::from_pixels(100.0),
},
DrawCommand::LineTo {
x: Twips::from_pixels(200.0),
y: Twips::from_pixels(200.0),
},
DrawCommand::LineTo {
x: Twips::from_pixels(100.0),
y: Twips::from_pixels(200.0),
},
DrawCommand::LineTo {
x: Twips::from_pixels(100.0),
y: Twips::from_pixels(100.0),
},
],
}];
assert_eq!(commands, expected);
}
/// A solid square with one edge flipped (fillstyle0 instead of fillstyle1).
#[test]
fn flipped_edges() {
let shape = build_shape(vec![
ShapeRecord::StyleChange(Box::new(swf::StyleChangeData {
move_to: Some((Twips::from_pixels(100.0), Twips::from_pixels(100.0))),
fill_style_0: None,
fill_style_1: Some(1),
line_style: None,
new_styles: None,
})),
ShapeRecord::StraightEdge {
delta_x: Twips::from_pixels(100.0),
delta_y: Twips::from_pixels(0.0),
},
ShapeRecord::StraightEdge {
delta_x: Twips::from_pixels(0.0),
delta_y: Twips::from_pixels(100.0),
},
ShapeRecord::StraightEdge {
delta_x: Twips::from_pixels(-100.0),
delta_y: Twips::from_pixels(0.0),
},
ShapeRecord::StyleChange(Box::new(swf::StyleChangeData {
move_to: Some((Twips::from_pixels(100.0), Twips::from_pixels(100.0))),
fill_style_0: Some(1),
fill_style_1: Some(0),
line_style: None,
new_styles: None,
})),
ShapeRecord::StraightEdge {
delta_x: Twips::from_pixels(0.0),
delta_y: Twips::from_pixels(100.0),
},
]);
let commands = ShapeConverter::from_shape(&shape).into_commands();
let expected = vec![DrawPath::Fill {
style: &FILL_STYLES[0],
commands: vec![
DrawCommand::MoveTo {
x: Twips::from_pixels(100.0),
y: Twips::from_pixels(100.0),
},
DrawCommand::LineTo {
x: Twips::from_pixels(200.0),
y: Twips::from_pixels(100.0),
},
DrawCommand::LineTo {
x: Twips::from_pixels(200.0),
y: Twips::from_pixels(200.0),
},
DrawCommand::LineTo {
x: Twips::from_pixels(100.0),
y: Twips::from_pixels(200.0),
},
DrawCommand::LineTo {
x: Twips::from_pixels(100.0),
y: Twips::from_pixels(100.0),
},
],
}];
assert_eq!(commands, expected);
}
}
/* SHAPEFLAG HITTEST (point-in-contour)
*
* To determine whether a point is inside a shape, we shoot a ray on the +x axis and calculate a winding number based
* on the edges that intersect with the ray.
*
* For each edge:
* if the edge cross the ray downward (+y), we add 1 to the winding number.
* if the edge cross the ray upward (-y), we add -1 to the winding number.
*
* We must also handle intersection with edge endpoints consistently to avoid double counting:
* the initial point of an edge is considered for upwards rays.
* the final point of an edge is considered for downward rays.
*
* For SWF shapes, edges with fillstyle1 use clockwise winding, and edges with fillstyle0 use CCW winding (flip them).
* We ignore any edges with fills on both sides (interior edges).
*
* If the final winding number is odd, then the point is inside the shape (for default even-odd winding).
*
* For strokes, we calculate the distance to the line segment or curve and compare it to the stroke width.
* Note that Flash renders with a minimum stroke width of 1px (20 twips) that we must account for.
* TODO: We currently don't consider non-round endcaps or joins, or stroke scaling flags.
*/
/// Test whether the given point in object space is contained within the contour of the given shape.
/// local_matrix is used to calculate the proper stroke widths.
pub fn shape_hit_test(
shape: &swf::Shape,
(point_x, point_y): (Twips, Twips),
local_matrix: &Matrix,
) -> bool {
// Transform point to local space.
let mut x = Twips::ZERO;
let mut y = Twips::ZERO;
let mut winding = 0;
let mut has_fill_style0: bool = false;
let mut has_fill_style1: bool = false;
let min_width = stroke_minimum_width(local_matrix);
let mut stroke_width = None;
let mut line_styles = &shape.styles.line_styles;
for record in &shape.shape {
match record {
swf::ShapeRecord::StyleChange(style_change) => {
// New styles indicates a new layer;
// Check if the point is within the current layer, then reset winding.
if let Some(new_styles) = &style_change.new_styles {
if winding & 0b1 != 0 {
return true;
}
line_styles = &new_styles.line_styles;
winding = 0;
}
if let Some((move_x, move_y)) = style_change.move_to {
x = move_x;
y = move_y;
}
if let Some(i) = style_change.fill_style_0 {
has_fill_style0 = i > 0;
}
if let Some(i) = style_change.fill_style_1 {
has_fill_style1 = i > 0;
}
if let Some(i) = style_change.line_style {
stroke_width = if i > 0 {
// Flash renders strokes with a 1px minimum width.
if let Some(line_style) = line_styles.get(i as usize - 1) {
let width = line_style.width().get() as f64;
let scaled_width = 0.5 * width.max(min_width);
Some((scaled_width, scaled_width * scaled_width))
} else {
None
}
} else {
None
};
}
}
swf::ShapeRecord::StraightEdge { delta_x, delta_y } => {
let x1 = x + *delta_x;
let y1 = y + *delta_y;
// If this edge has a fill style on only one-side, check for a crossing.
if has_fill_style1 {
if !has_fill_style0 {
winding += winding_number_line((point_x, point_y), (x, y), (x1, y1));
}
} else if has_fill_style0 {
winding += winding_number_line((point_x, point_y), (x1, y1), (x, y));
}
if let Some(width) = stroke_width {
if hit_test_stroke((point_x, point_y), (x, y), (x1, y1), width) {
return true;
}
}
x = x1;
y = y1;
}
swf::ShapeRecord::CurvedEdge {
control_delta_x,
control_delta_y,
anchor_delta_x,
anchor_delta_y,
} => {
let x1 = x + *control_delta_x;
let y1 = y + *control_delta_y;
let x2 = x1 + *anchor_delta_x;
let y2 = y1 + *anchor_delta_y;
// If this edge has a fill style on only one-side, check for a crossing.
if has_fill_style1 {
if !has_fill_style0 {
winding +=
winding_number_curve((point_x, point_y), (x, y), (x1, y1), (x2, y2));
}
} else if has_fill_style0 {
winding += winding_number_curve((point_x, point_y), (x2, y2), (x1, y1), (x, y));
}
if let Some(width) = stroke_width {
if hit_test_stroke_curve((point_x, point_y), (x, y), (x1, y1), (x2, y2), width)
{
return true;
}
}
x = x2;
y = y2;
}
}
}
winding & 0b1 != 0
}
/// Test whether the given point is contained within the paths specified by the draw commands.
pub fn draw_command_fill_hit_test(commands: &[DrawCommand], test_point: (Twips, Twips)) -> bool {
let mut cursor = (Twips::ZERO, Twips::ZERO);
let mut fill_start = (Twips::ZERO, Twips::ZERO);
let mut winding = 0;
// Draw command only contains a single fill, so don't have to worry about fill styles.
for command in commands {
match *command {
DrawCommand::MoveTo { x: x1, y: y1 } => {
cursor = (x1, y1);
fill_start = (x1, y1);
}
DrawCommand::LineTo { x: x1, y: y1 } => {
winding += winding_number_line(test_point, cursor, (x1, y1));
cursor = (x1, y1);
}
DrawCommand::CurveTo { x1, y1, x2, y2 } => {
winding += winding_number_curve(test_point, cursor, (x1, y1), (x2, y2));
cursor = (x2, y2);
}
}
}
if cursor != fill_start {
// Close fill.
winding += winding_number_line(test_point, cursor, fill_start);
}
winding & 0b1 != 0
}
/// Test whether the given point is contained within the strokes specified by the draw commands.
/// local_matrix is used to calculate the minimum stroke width.
pub fn draw_command_stroke_hit_test(
commands: &[DrawCommand],
stroke_width: Twips,
(point_x, point_y): (Twips, Twips),
local_matrix: &Matrix,
) -> bool {
let stroke_min_width = stroke_minimum_width(local_matrix);
let stroke_width = 0.5 * f64::max(stroke_width.get().into(), stroke_min_width);
let stroke_widths = (stroke_width, stroke_width * stroke_width);
let mut x = Twips::default();
let mut y = Twips::default();
for command in commands {
match *command {
DrawCommand::MoveTo { x: x1, y: y1 } => {
x = x1;
y = y1;
}
DrawCommand::LineTo { x: x1, y: y1 } => {
if hit_test_stroke((point_x, point_y), (x, y), (x1, y1), stroke_widths) {
return true;
}
x = x1;
y = y1;
}
DrawCommand::CurveTo { x1, y1, x2, y2 } => {
if hit_test_stroke_curve(
(point_x, point_y),
(x, y),
(x1, y1),
(x2, y2),
stroke_widths,
) {
return true;
}
x = x2;
y = y2;
}
}
}
false
}
/// Given a matrix, calculates the scale for stroke widths.
/// TODO: Verify the actual behavior; I think it's more like the average between scaleX and scaleY.
/// Does not yet support vertical/horizontal stroke scaling flags.
/// This might be better to add as a method to Matrix.
fn stroke_minimum_width(matrix: &Matrix) -> f64 {
let sx = (matrix.a * matrix.a + matrix.b * matrix.b).sqrt();
let sy = (matrix.c * matrix.c + matrix.d * matrix.d).sqrt();
let scale: f64 = sx.max(sy).into();
20.0 * scale
}
/// Returns whether the given point is inside the stroked line segment.
/// `width_sq` should be the squared width of the stroke.
fn hit_test_stroke(
(point_x, point_y): (Twips, Twips),
(x0, y0): (Twips, Twips),
(x1, y1): (Twips, Twips),
(stroke_width, stroke_width_sq): (f64, f64),
) -> bool {
let px = point_x.get() as f64;
let py = point_y.get() as f64;
let x0 = x0.get() as f64;
let y0 = y0.get() as f64;
let x1 = x1.get() as f64;
let y1 = y1.get() as f64;
// Early exit: out of bounds
let x_min = x0.min(x1);
let x_max = x0.max(x1);
if px < x_min - stroke_width || px > x_max + stroke_width {
return false;
}
let y_min = y0.min(y1);
let y_max = y0.max(y1);
if py < y_min - stroke_width || py > y_max + stroke_width {
return false;
}
// AB is the segment from (x0, y0) to (x1, y1) and P is (point_x, point_y).
// P
// .
// .
// A----->B
// If AP dot AB is <= 0.0, then PA is pointing away from AB, so A is the closest point.
let abx = x1 - x0;
let aby = y1 - y0;
let apx = px - x0;
let apy = py - y0;
let dot_a = abx * apx + aby * apy;
let dist = if dot_a <= 0.0 {
apx * apx + apy * apy
} else {
// If BP dot AB is >= 0.0, then BP is pointing away from BA, so B is the closest point.
let bpx = px - x1;
let bpy = py - y1;
let dot_b = abx * bpx + aby * bpy;
if dot_b >= 0.0 {
bpx * bpx + bpy * bpy
} else {
// Otherwise, the closest point will be within the interval of the segment.
// Project the point onto the segment.
let len = abx * abx + aby * aby;
let ex = apx - dot_a * abx / len;
let ey = apy - dot_a * aby / len;
ex * ex + ey * ey
}
};
dist <= stroke_width_sq
}
/// Returns whether the given point is inside the stroked bezier curve.
/// `width_sq` should be the squared width of the stroke.
fn hit_test_stroke_curve(
(point_x, point_y): (Twips, Twips),
(x0, y0): (Twips, Twips),
(x1, y1): (Twips, Twips),
(x2, y2): (Twips, Twips),
(stroke_width, stroke_width_sq): (f64, f64),
) -> bool {
let px = point_x.get() as f64;
let py = point_y.get() as f64;
let x0 = x0.get() as f64;
let y0 = y0.get() as f64;
let x1 = x1.get() as f64;
let y1 = y1.get() as f64;
let x2 = x2.get() as f64;
let y2 = y2.get() as f64;
// Early exit: out of bounds
// TODO: Since this involves an expensive cubic, probably wortwhile to calculate the tight bounds for the curve:
// https://www.iquilezles.org/www/articles/bezierbbox/bezierbbox.htm
let x_min = x0.min(x1).min(x2);
let x_max = x0.max(x1).max(x2);
if px < x_min - stroke_width || px > x_max + stroke_width {
return false;
}
let y_min = y0.min(y1).min(y2);
let y_max = y0.max(y1).max(y2);
if py < y_min - stroke_width || py > y_max + stroke_width {
return false;
}
// The closest point on the curve will be normal to the curve.
// The tangent of a quadratic bezier:
// C'(t) = -2 * (1-t) * P0 + 2 * (1-t) * P1 + 2*t*P2
// Dot product to determine when we are perpendicular to the tangent.
// (point - C(t)) . C'(t) = 0
// The result is a cubic polynomial that we can solve for.
// After solving this polynomial, we choose the t with [0, 1.0] that gives us the minimum distance
// (also considering the endcaps).
// via http://blog.gludion.com/2009/08/distance-to-quadratic-bezier-curve.html
let ax = x1 - x0;
let ay = y1 - y0;
let bx = x2 - x1 - ax;
let by = y2 - y1 - ay;
let mx = x0 - px;
let my = y0 - py;
let a = bx * bx + by * by;
let b = 3.0 * (ax * bx + ay * by);
let c = 2.0 * (ax * ax + ay * ay) + (mx * bx + my * by);
let d = mx * ax + my * ay;
let distance_to_curve = |t| -> f64 {
// Sample bezier at the given t and return distance to the point.
let comp_t = 1.0 - t;
let cx = comp_t * comp_t * x0 + 2.0 * comp_t * t * x1 + t * t * x2;
let cy = comp_t * comp_t * y0 + 2.0 * comp_t * t * y1 + t * t * y2;
let dx = cx - px;
let dy = cy - py;
dx * dx + dy * dy
};
// Test end-caps
let mut dist = distance_to_curve(0.0);
dist = dist.min(distance_to_curve(1.0));
// Test roots.
for t in solve_cubic(a, b, c, d) {
if t >= 0.0 && t <= 1.0 {
dist = dist.min(distance_to_curve(t));
}
}
dist <= stroke_width_sq
}
/// Calculates the winding number for a line segment relative to the given point.
fn winding_number_line(
(point_x, point_y): (Twips, Twips),
(x0, y0): (Twips, Twips),
(x1, y1): (Twips, Twips),
) -> i32 {
let point_x = point_x.get() as f64;
let point_y = point_y.get() as f64;
let x0 = x0.get() as f64;
let y0 = y0.get() as f64;
let x1 = x1.get() as f64;
let y1 = y1.get() as f64;
// Adjust winding number if we are on the left side of the segment.
// An upward segment (-y) increments the winding number (including the initial endpoint).
// A downward segment (+y) decrements the winding number (including the final endpoint)
// Perp-dot indicates which side of the segment the point is on.
if y0 < point_y {
if y1 >= point_y {
let val = (x1 - x0) * (point_y - y0) - (y1 - y0) * (point_x - x0);
if val > 0.0 {
return 1;
}
}
} else if y1 < point_y {
let val = (x1 - x0) * (point_y - y0) - (y1 - y0) * (point_x - x0);
if val < 0.0 {
return -1;
}
}
0
}
/// Calculates the winding number for a bezier curve around the given point.
fn winding_number_curve(
(point_x, point_y): (Twips, Twips),
(ax0, ay0): (Twips, Twips),
(ax1, ay1): (Twips, Twips),
(ax2, ay2): (Twips, Twips),
) -> i32 {
// Intersect a ray on the +x axis with the quadratic bezier.
//
// Translate so the test point and ray is at the origin.
// The ray-curve intersection is solving the quadratic:
// y_0*(1-t)^2 + y_1*2*t*(1-t) + y_2*t^2 = 0
// However, there are two issues:
// 1) Solving the quadratic needs to be numerically robust, particularly near the endpoints 0.0 and 1.0, and as the curve is tangent to the ray.
// We use the "Citardauq" method for improved numerical stability.
// 2) The convention for including/excluding endpoints needs to act similarly to lines, with the initial point included if the curve is "upward",
// and the final point included if the curve is pointing "downward". This is complicated by the fact that the curve could be tangent to the ray
// at the endpoint (this is still considered "upward" or "downward" depending on the slope at earlier t).
// We solve this by splitting the curve into y-monotonic subcurves. This is helpful because
// a) each subcurve will have 1 intersection with the ray
// b) if the subcurve surrounds the ray, we know it has an intersection without having to check if t is in [0, 1]
// c) we know the winding of the segment upward/downward based on which root it contains
let x0 = ax0.get() - point_x.get();
let y0 = ay0.get() - point_y.get();
let x1 = ax1.get() - point_x.get();
let y1 = ay1.get() - point_y.get();
let x2 = ax2.get() - point_x.get();
let y2 = ay2.get() - point_y.get();
// Early exit: all control points out of bounds.
if (y0 < 0 && y1 < 0 && y2 < 0)
|| (y0 > 0 && y1 > 0 && y2 > 0)
|| (x0 <= 0 && x1 <= 0 && x2 <= 0)
{
return 0;
}
let x0 = x0 as f64;
let y0 = y0 as f64;
let x1 = x1 as f64;
let y1 = y1 as f64;
let x2 = x2 as f64;
let y2 = y2 as f64;
let a = y0 - 2.0 * y1 + y2;
let b = 2.0 * (y1 - y0);
let c = y0;
let (t0, t1) = solve_quadratic(a, b, c);
let is_t0_valid = t0.is_finite();
let is_t1_valid = t1.is_finite();
if !is_t0_valid && !is_t1_valid {
return 0;
}
// Split the curve into two y-monotonic segments.
let mut winding = 0;
let ax = x0 - 2.0 * x1 + x2;
let bx = 2.0 * (x1 - x0);
let t_extrema = -0.5 * b / a;
let is_monotonic = t_extrema <= 0.0 || t_extrema >= 1.0;
if a >= 0.0 {
// Downward opening parabola.
let y_min = if is_monotonic {
y0.min(y2)
} else {
a * t_extrema * t_extrema + b * t_extrema + c
};
// First subcurve is moving upward, include initial point.
if is_t0_valid && y0 >= 0.0 && y_min < 0.0 {
// If curve point is to the right of the ray origin (x > 0), the ray will hit it.
// We don't have to check 0 <= t <= 1 check because we've already guaranteed that the subcurve
// straddles the ray.
let x = x0 + bx * t0 + ax * t0 * t0;
if x > 0.0 {
winding += 1;
}
}
// Second subcurve is moving downard, include final point.
if is_t1_valid && y_min < 0.0 && y2 >= 0.0 {
let x = x0 + bx * t1 + ax * t1 * t1;
if x > 0.0 {
winding -= 1;
}
}
} else {
// Upward opening parabola.
let y_max = if is_monotonic {
y0.max(y2)
} else {
a * t_extrema * t_extrema + b * t_extrema + c
};
// First subcurve is moving downward, include extrema point.
if is_t1_valid && y0 < 0.0 && y_max >= 0.0 {
let x = x0 + bx * t1 + ax * t1 * t1;
if x > 0.0 {
winding -= 1;
}
}
// Second subcurve is moving upward, include extrema point.
if is_t0_valid && y_max >= 0.0 && y2 < 0.0 {
let x = x0 + bx * t0 + ax * t0 * t0;
if x > 0.0 {
winding += 1;
}
}
}
winding
}
const COEFFICIENT_EPSILON: f64 = 0.0000001;
/// Returns the roots of the quadratic ax^2 + bx + c = 0.
/// The roots may not be unique. NAN is returned for invalid roots. The first root will be where
/// the curve is sloping upward, the second root will be where the curve is slopping downward.
/// Uses the "Citardauq" formula for numerical stability.
/// See https://math.stackexchange.com/questions/866331
fn solve_quadratic(a: f64, b: f64, c: f64) -> (f64, f64) {
if a.abs() <= COEFFICIENT_EPSILON {
// Nearly linear, solve as linear equation.
if b >= 0.0 {
return (f64::NAN, -c / b);
} else {
return (-c / b, f64::NAN);
}
}
let mut disc = b * b - 4.0 * a * c;
if disc < 0.0 {
return (f64::NAN, f64::NAN);
}
disc = disc.sqrt();
// Order the roots so that the first root is where the curve slopes upward,
// and the second root is where the root slopes downward.
if b >= 0.0 {
let root0 = (-b - disc) / (2.0 * a);
let root1 = c / (a * root0);
(root0, root1)
} else {
let root0 = (-b + disc) / (2.0 * a);
let root1 = c / (a * root0);
(root1, root0)
}
}
/// Returns the roots of a cubic polynomial, ax^3 + bx^2 + cx + d = 0
/// from http://www.cplusplus.com/forum/beginner/234717/
/// The roots are not necessarily unique.
/// TODO: This probably isn't numerically robust
#[allow(clippy::many_single_char_names)]
fn solve_cubic(a: f64, b: f64, c: f64, d: f64) -> SmallVec<[f64; 3]> {
let mut roots = SmallVec::new();
if a.abs() <= COEFFICIENT_EPSILON {
// Fall back to quadratic formula.
let (t0, t1) = solve_quadratic(b, c, d);
roots.extend_from_slice(&[t0, t1]);
return roots;
}
// Reduce to a "depressed cubic", x^3 + px + q = 0
// https://en.wikipedia.org/wiki/Cubic_equation#Cardano's_formula
let p = (b * b - 3.0 * a * c) / (9.0 * a * a);
let q = (9.0 * a * b * c - 27.0 * a * a * d - 2.0 * b * b * b) / (54.0 * a * a * a);
let offset = b / (3.0 * a);
let disc = p * p * p - q * q;
// The discriminant determines the number of real roots.
if disc > 0.0 {
let theta = f64::acos(q / (p * f64::sqrt(p)));
let r = 2.0 * f64::sqrt(p);
let t0 = r * f64::cos(theta / 3.0) - offset;
let t1 = r * f64::cos((theta + 2.0 * std::f64::consts::PI) / 3.0) - offset;
let t2 = r * f64::cos((theta + 4.0 * std::f64::consts::PI) / 3.0) - offset;
roots.extend([t0, t1, t2]);
} else {
let gamma1 = f64::cbrt(q + f64::sqrt(-disc));
let gamma2 = f64::cbrt(q - f64::sqrt(-disc));
let t0 = gamma1 + gamma2 - offset;
let t1 = -0.5 * (gamma1 + gamma2) - offset;
roots.push(t0);
if disc == 0.0 {
roots.push(t1);
}
}
roots
}
/// Converts an SWF glyph into an SWF shape, for ease of use by rendering backends.
pub fn swf_glyph_to_shape(glyph: &swf::Glyph) -> swf::Shape {
// Per SWF19 p.164, the FontBoundsTable can contain empty bounds for every glyph (reserved).
// SWF19 says this is true through SWFv7, but it seems like it might be generally true?
// In any case, we have to be sure to calculate the shape bounds ourselves to make a proper
// SVG.
let bounds = glyph
.bounds
.clone()
.filter(|b| b.x_min != b.x_max || b.y_min != b.y_max)
.unwrap_or_else(|| calculate_shape_bounds(&glyph.shape_records));
swf::Shape {
version: 2,
id: 0,
shape_bounds: bounds.clone(),
edge_bounds: bounds,
flags: swf::ShapeFlag::HAS_SCALING_STROKES,
styles: swf::ShapeStyles {
fill_styles: vec![swf::FillStyle::Color(swf::Color {
r: 255,
g: 255,
b: 255,
a: 255,
})],
line_styles: vec![],
},
shape: glyph.shape_records.clone(),
}
}
/// Scale mode used by strokes in a shape.
///
/// Determines how the line thickness is affected by the shape's transform.
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
pub enum LineScaleMode {
None = 0,
Horizontal,
Vertical,
Both,
}
/// Helper type for calculating line widths for a transformed shape.
pub struct LineScales<'a> {
matrix: &'a Matrix,
scales: Option<[f32; 4]>,
}
impl<'a> LineScales<'a> {
/// Create a new line scaler for the given matrix.
#[inline]
pub fn new(matrix: &'a Matrix) -> Self {
Self {
matrix,
scales: None,
}
}
/// Returns the final width of a line after transformation.
#[inline]
pub fn transform_width(&mut self, width: f32, scale_mode: LineScaleMode) -> f32 {
// Lazily calculate the scale to avoid doing so for shapes that have no strokes.
let scales = self.scales.get_or_insert_with(|| {
let line_scale_x = f32::abs(self.matrix.a + self.matrix.c);
let line_scale_y = f32::abs(self.matrix.b + self.matrix.d);
let line_scale =
((line_scale_x * line_scale_x + line_scale_y * line_scale_y) / 2.0).sqrt();
[1.0, line_scale_x, line_scale_y, line_scale]
});
let scaled_width = width * scales[scale_mode as usize];
// Flash draws all strokes with a minimum width of 1 pixel.
// This usually occurs in "hairline" strokes (exported with width of 1 twip).
scaled_width.max(1.0)
}
}