mirror of
https://github.com/storytold/effectcraft.git
synced 2026-11-12 21:32:52 +00:00
Sean Hawkey
24df676af5
* Expressions, Scripting: a layer's property numbers follow After Effects
In After Effects a layer's top-level number reaches the same group on every layer of a kind:
Marker is 1, and slots the layer has not used yet (Time Remap, Motion Trackers, Layer Styles,
Data, Sets...) keep their place. EffectCraft numbered only the groups a layer holds, without
Marker, so `layer(n)` and `layer.property(n)` reached a different group, and the numbers moved
as groups were added. Rigs that read a palette by number, such as
`comp("Palette").layer(1)(4)(n)(1)` on a shape layer, read Transform instead of Effects; their
`try` fell back to the stored value and every linked colour rendered near-black, with no
expression error.
`effectcraft_project::ae_order` holds After Effects' slot order per layer kind, observed in
After Effects 26.3 from a script (`layer.property(i).matchName`) and from an expression
(`thisComp.layer(..)(i).name`) on new layers of each kind. The expression host and the
scripting model resolve a layer's numbers through it: 1 is the markers, a used slot is its
group, an unused one is an empty group (never null, so loops over `numProperties` are safe).
`numProperties` at layer level and `propertyIndex` of top-level groups are After Effects'
numbers too. 3D model and primitive layers keep EffectCraft's own numbers.
* Expressions: a layer's top-level groups by After Effects match name
`thisLayer("ADBE Effect Parade")`, as scripts such as Karton write their expressions, reaches the
group through the same table as the layer's numbers: Effects, or an empty group for a slot the
layer has not used, and `("ADBE Marker")` the markers.
* Expressions, Scripting: review follow-ups for After Effects layer numbers
- An enabled Time Remap (a top-level property) reports After Effects' number 2 as its propertyIndex.
- In scripting, an unused slot resolves to the same empty group by match name
(`property("ADBE Layer Styles")`) as by number (`property(7)`).
- The empty group is callable like any group: `layer.property(7)(1)` is null, not a TypeError.
76 lines
2.7 KiB
Rust
76 lines
2.7 KiB
Rust
//! The EffectCraft document model.
|
|
//!
|
|
//! `Project` → items (folders, compositions, footage, solids) → `Comp` → `Layer` → property tree
|
|
//! ([`props`]). Compositions, and each layer within them ([`Layers`]), sit behind `Arc` so undo
|
|
//! snapshots share everything that did not change.
|
|
|
|
#![deny(clippy::unwrap_used, clippy::expect_used, clippy::panic, clippy::unimplemented, clippy::todo, clippy::unreachable)]
|
|
|
|
pub mod ae_order;
|
|
pub mod build;
|
|
pub mod essential;
|
|
mod file_check;
|
|
pub mod limits;
|
|
pub mod props;
|
|
pub mod render_queue;
|
|
pub mod render_templates;
|
|
pub mod sequence;
|
|
pub mod styles;
|
|
pub mod tracking;
|
|
|
|
use std::collections::BTreeMap;
|
|
use std::sync::Arc;
|
|
|
|
pub use effectcraft_color::ColorSpace;
|
|
use effectcraft_color::{BlendMode, Label};
|
|
use effectcraft_time::{FrameRate, Tick};
|
|
pub use props::{Expression, FeatherFalloff, GroupKind, MaskMode, MaskMotionBlur, Node, ParamUi, PropGroup, Property, Uid, parse_path};
|
|
use serde::{Deserialize, Serialize};
|
|
|
|
pub use effectcraft_keyframe as keyframe;
|
|
pub use effectcraft_keyframe::{Keyframe, Value};
|
|
|
|
mod comp;
|
|
mod dirty;
|
|
mod footage;
|
|
mod item;
|
|
mod layer;
|
|
mod layers;
|
|
mod reach;
|
|
mod settings;
|
|
|
|
pub use comp::{Comp, Guide, Renderer, Resolution};
|
|
pub use footage::{AlphaMode, CineonSettings, CineonUnits, FieldOrder, Footage, FootageKind, Proxy, Solid, SourceLayer, VIDEO_EXTENSIONS, cineon_log_to_lin};
|
|
pub use item::NO_LAYER;
|
|
pub use item::{Heard, Item, ItemId, ItemKind, LayerId};
|
|
pub use layer::{
|
|
AutoOrient, FrameBlend, Layer, LayerSource, LightKind, MatteKind, PrimitiveKind, Quality, Sampling, Switches, TrackMatte, is_audio_effect,
|
|
reads_other_frames, text_layer_name,
|
|
};
|
|
pub use layers::Layers;
|
|
pub use reach::{ExprReach, PixelReach, expression_reach};
|
|
pub use settings::{
|
|
APP_VERSION, BitDepth, ColorEngine, CuePoint, HdrMode, Marker, ProjectError, ProjectSettings, SCHEMA_EFFECT_SPACE, SCHEMA_VERSION, SavedView,
|
|
TimeDisplayStyle, is_newer_version, saved_by, saved_view,
|
|
};
|
|
|
|
#[derive(Clone, Debug, PartialEq, Serialize, Deserialize)]
|
|
pub struct Project {
|
|
pub schema: u32,
|
|
pub settings: ProjectSettings,
|
|
pub items: BTreeMap<ItemId, Item>,
|
|
pub next_id: u64,
|
|
/// The Render Queue (Composition ▸ Add to Render Queue).
|
|
#[serde(default, skip_serializing_if = "Vec::is_empty")]
|
|
pub render_queue: Vec<render_queue::RenderQueueItem>,
|
|
/// Render Settings / Output Module templates and their defaults.
|
|
#[serde(default, skip_serializing_if = "render_templates::RenderTemplates::is_default")]
|
|
pub render_templates: render_templates::RenderTemplates,
|
|
/// Render Queue preferences (Notify, storage overflow folders).
|
|
#[serde(default, skip_serializing_if = "render_queue::RenderQueuePrefs::is_default")]
|
|
pub render_prefs: render_queue::RenderQueuePrefs,
|
|
}
|
|
|
|
#[cfg(test)]
|
|
mod tests;
|