prgpu 0.2.0

GPU-accelerated rendering utilities for Adobe Premiere Pro and After Effects plugins
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46

//! The single public authoring trait.
//!
//! `Effect` is the high-level surface effect crates implement. The adapters
//! drive every selector via these methods so authors stop hand-writing
//! host-specific selectors.

use crate::effect::ctx::Ctx;
use crate::effect::descriptor::{EffectDescriptor, ExpansionExtent};
use crate::effect::ui::Ui;
use crate::graph::Graph;
use crate::params::ParamsSpec;

/// Public effect-author trait, v2.
///
/// FrameData is gone — the snapshot is the frame data. Pipeline closures
/// receive `&Ctx<P>`. License wiring is automatic via `register_effect!`.
pub trait Effect: Sized + Send + Sync + 'static {
	type Params: ParamsSpec;

	/// Override points on the build-metadata descriptor (match name, version,
	/// flags come from `[package.metadata.prgpu]` via `register_effect!`).
	fn descriptor(_d: EffectDescriptor) -> EffectDescriptor {
		_d
	}

	/// Raw SDK access for cases `params!` doesn't cover (Ground rule 9).
	fn extra_params(
		_p: &mut after_effects::Parameters<Self::Params>,
	) -> Result<(), after_effects::Error> {
		Ok(())
	}

	/// Dynamic parameter visibility. Evaluated on every UpdateParamsUi /
	/// UserChangedParam against a fresh snapshot.
	fn ui(_u: &mut Ui<Self::Params>) {}

	/// Per-side output inflation. Geometry in `ctx` is layer-sized; snapshot
	/// values are current.
	fn expansion(_ctx: &Ctx<Self::Params>) -> ExpansionExtent {
		ExpansionExtent::NONE
	}

	/// Declared once per effect lifetime; closures re-evaluate per frame
	/// against each frame's `Ctx<P>`.
	fn pipeline(_g: &mut Graph<Self::Params>);
}