motion-core 0.2.0

//! Backend-independent motion engine primitives.
//!
//! This package owns time, geometry, animation, colors and diagnostics without
//! rendering devices, font engines, media codecs or window-system dependencies.
//!
//! ```
//! use motion_core::{FrameRate, Time, TimeLiteral};
//! let boundary = Time::from_frame(30_000, FrameRate::NTSC);
//! assert_eq!(boundary, 1001.seconds().after_origin());
//! assert_eq!(boundary.to_frame(FrameRate::NTSC), 30_000);
//! ```

#![forbid(unsafe_code)]

pub mod animation;
pub mod asset;
pub mod audio;
pub mod authoring;
pub mod budget;
pub mod color;
pub mod display_list;
pub mod drawing;
pub mod error;
pub mod filter;
pub mod geometry;
pub mod grading;
pub mod instances;
pub mod key;
pub mod math;
pub mod noise;
pub mod optics;
pub mod path2d;
pub mod pixels;
pub mod random;
pub mod report;
pub mod shape;
pub mod sync;
pub mod time;
pub mod validation;

pub use animation::{
    Constant, Easing, FiniteAnimation, Interpolate, Interval, Keyframes, Signal, Spring,
    SpringBuilder, Tween,
};
pub use animation::{
    Extrapolate, FollowPath, Noise, NoiseBuilder, Oscillator, OscillatorBuilder, PathSample,
    Waveform, piecewise, remap, try_piecewise, try_remap,
};
pub use asset::environment::FontEnvironment;
pub use asset::environment::{FontIdentity, FontUsage};
pub use asset::{
    Asset, AssetState, Assets, Handle, LoadContext, RequestDiagnostics, ResourceLimits,
    ResourceStore, Source,
};
pub use audio::{
    AudioBus, AudioChapter, AudioClip, AudioClipParameters, AudioEffect, AudioMetadata,
    AudioSource, Duck, DuckTrigger, Ducking, Limiter, Loudness, Master, PanLaw,
};
pub use authoring::camera::camera;
pub use authoring::camera::{Camera, DepthOfField, DepthPlane, try_camera};
pub use authoring::context::{CacheLimits, CachePartition, RenderCache, SceneCache, SceneContext};
pub use authoring::elevation::{Elevation, ShadowLayer};
pub use authoring::sampling::{MotionBlur, ShutterCurve, ShutterSampling, sample_offsets};
pub use authoring::scene::IntoSceneOutput;
pub use authoring::scene::scene;
pub use authoring::skeleton::{Bone, BonePose, BoneTransform, Pose, Skeleton};
pub use authoring::timeline::{
    BoundaryAdjustment, BoundaryEdge, Clip, Diagnostics, ResolvedAudio, Soundtrack, Timeline,
    TimelineBuilder, TimelineVisual, TimelineWarning, Track, TrackBuilder,
};
pub use authoring::transition::Direction;
pub use authoring::transition::{
    CrossFade, Iris, IrisShape, Push, Slide, Transition, Wipe, ZoomBlur,
};
pub use authoring::{Alignment, Column, Layout, Node, NodeModifiers, Row, Scene, Side};
pub use budget::{RasterLimits, SceneLimits};
pub use color::Color;
pub use color::math::{
    linear_to_srgb, premultiply, rec709_luminance, srgb_to_linear, unpremultiply,
};
pub use display_list::{DisplayList, PixelSize, ValidatedDisplayList};
pub use drawing::{AtmosphereKind, AtmospherePaint, AtmosphereParameters};
pub use drawing::{
    BlendMode, BlendSpace, Canvas, ClipMode, DeferredContent, DrawCommand, DrawContext, Drawable,
    Evaluation, FillRule, IntoShapeClip, LineCap, LineJoin, MAX_STROKE_VERBS, MaskMode, Paint,
    PathClip, RectClip, RenderQuality, Shape, ShapeClip, StrokeStyle, Styled,
};
pub use drawing::{
    GradientExtend, GradientSpace, GradientUnits, ImagePattern, LinearGradient, PatternImage,
    RadialGradient, SweepGradient, WeakPatternImage,
};
pub use drawing::{
    MAX_MESH_POINTS_PER_AXIS, MAX_MESH_SUBDIVISIONS, MeshGradient, MeshImage, MeshPaint, MeshPatch,
    MeshVertex,
};
pub use error::{BoxedError, Error, ErrorKind};
pub use filter::{Filter, FilterOperation};
pub use geometry::bounds::{Pivot, Rect, Size};
pub use geometry::{
    AngleLiteral, MAX_PERSPECTIVE_CURVE_PIECES, Perspective, Point, Transform, TransformComponents,
    Vector2,
};
pub use grading::{Cdl, ColorWheels, Lut1d, Lut3d, LutInput};
pub use optics::{ApertureShape, HeightFrom, Optics};
pub use path2d::{
    MAX_BOOLEAN_EDGES, MAX_PATH_VERBS, MAX_SVG_PATH_BYTES, MorphPath, Path2D, PathBooleanOp,
    PathBooleanOptions, PathBuilder, PathVerb,
};
pub use pixels::{ImagePixels, Sampling};
pub use random::Random;
pub use report::ErrorReport;
pub use shape::{
    Arc as ArcShape, Arrow, ArrowHead, Circle, Ellipse, FunctionGraph, Line, Polygon, Polyline,
    RegularPolygon, Ring, RoundedRect, Spline, Star,
};
pub use time::{Duration, FrameRate, TICKS_PER_SECOND, Time, TimeLiteral, TimeOffset};
pub use validation::{SceneStats, ValidationError, ValidationErrorKind, ValidationLimits};

/// A classified failure retaining its original source.
pub type Result<T = ()> = std::result::Result<T, Error>;

/// Common backend-independent authoring values.
pub mod prelude {
    pub use crate::ClipMode;
    pub use crate::{Alignment, Column, Layout, Node, NodeModifiers, Row, Scene, Side};
    pub use crate::{
        AngleLiteral, Color, Perspective, Pivot, Point, Rect, Size, Transform, TransformComponents,
        Vector2,
    };
    pub use crate::{
        ApertureShape, Cdl, ColorWheels, DepthOfField, DepthPlane, Elevation, HeightFrom, Lut1d,
        Lut3d, LutInput, Optics, ShutterCurve, ShutterSampling,
    };
    pub use crate::{
        ArcShape, Arrow, ArrowHead, Circle, Ellipse, FunctionGraph, Line, Polygon, Polyline,
        RegularPolygon, Ring, RoundedRect, Spline, Star,
    };
    pub use crate::{
        Asset, AssetState, Assets, AudioClip, AudioSource, Handle, LoadContext, RequestDiagnostics,
        Source,
    };
    pub use crate::{
        AtmosphereKind, AtmospherePaint, AtmosphereParameters, MeshGradient, MeshImage, MeshPaint,
        MeshVertex,
    };
    pub use crate::{BlendMode, BlendSpace, Filter, FilterOperation, MaskMode, PixelSize};
    pub use crate::{
        Bone, BonePose, BoneTransform, Camera, Direction, Pose, SceneCache, SceneContext, Skeleton,
        camera, try_camera,
    };
    pub use crate::{
        BoundaryAdjustment, BoundaryEdge, Clip, Soundtrack, Timeline, TimelineBuilder,
        TimelineWarning, Track, TrackBuilder,
    };
    pub use crate::{
        Canvas, DeferredContent, DrawCommand, DrawContext, Drawable, FillRule, LineCap, LineJoin,
        Paint, PathClip, RectClip, RenderQuality, Shape, ShapeClip, StrokeStyle, Styled,
    };
    pub use crate::{
        Constant, Easing, FiniteAnimation, Interpolate, Keyframes, Signal, Spring, Tween,
    };
    pub use crate::{
        CrossFade, Iris, IrisShape, MotionBlur, Push, Slide, Transition, Wipe, ZoomBlur,
    };
    pub use crate::{
        Duration, FrameRate, Random, TICKS_PER_SECOND, Time, TimeLiteral, TimeOffset, fps,
    };
    pub use crate::{
        Error, ErrorKind, ErrorReport, SceneLimits, SceneStats, ValidationError,
        ValidationErrorKind, ValidationLimits,
    };
    pub use crate::{
        Extrapolate, FollowPath, Noise, Oscillator, PathSample, Waveform, piecewise, remap,
    };
    pub use crate::{
        GradientExtend, GradientSpace, GradientUnits, ImagePattern, LinearGradient, RadialGradient,
        SweepGradient,
    };
    pub use crate::{MorphPath, Path2D, PathBooleanOp, PathBooleanOptions, PathVerb};
    pub use crate::{group, scene};
    pub use crate::{linear_to_srgb, premultiply, rec709_luminance, srgb_to_linear, unpremultiply};
}