eve::editor::ActionTimelinePayloadEditor类 参考

Applies typed partial payload changes through the canonical timeline transaction authority. 更多...

#include <ActionTimelinePayloadEditor.h>

Public 成员函数
	ActionTimelinePayloadEditor (ActionTimelineEditor &editor, const action::ActionNotifyRegistry &registry)
	Construct a transient payload editor over borrowed authoritative services.
Result< Value::Object >	payload (const LogicalId &itemId) const
	Return an owning copy of one editable notify or state payload.
Result< void >	patch (const LogicalId &itemId, Value::Object fields)
	Merge fields into one payload and commit exactly one validated undo step.
Result< void >	fitBlockToClip (const LogicalId &itemId)
	Resize one VFX state to its authored clip interval at 1.0x playback.
Result< void >	fitClipToBlock (const LogicalId &itemId)
	Extend one VFX state's clip end so its authored interval matches the block duration.
Result< void >	fitClipToNaturalDuration (const LogicalId &itemId, OptionalRef< const action::IActionVfxDurationProvider > provider)
	Set one VFX state's clip end to the finite duration reported by its resource provider.

详细描述

Applies typed partial payload changes through the canonical timeline transaction authority.

The adapter borrows an editor and registry that must outlive it. Calls are owner-thread-only. Existing and unknown payload fields are preserved; the merged payload is validated before publication.

在文件 ActionTimelinePayloadEditor.h 第 20 行定义.

构造及析构函数说明

ActionTimelinePayloadEditor()

eve::editor::ActionTimelinePayloadEditor::ActionTimelinePayloadEditor ( ActionTimelineEditor &  editor, const action::ActionNotifyRegistry &  registry  )

inline

Construct a transient payload editor over borrowed authoritative services.

Editor.

在文件 ActionTimelinePayloadEditor.h 第 23 行定义.

成员函数说明

fitBlockToClip()

Result< void > eve::editor::ActionTimelinePayloadEditor::fitBlockToClip

(

const LogicalId &

itemId

)

Resize one VFX state to its authored clip interval at 1.0x playback.

参数

itemId

Stable VFX notify-state identity.

返回

Applied, or a structured type, range, validation, or transaction failure.

在文件 ActionTimelinePayloadEditor.cpp 第 60 行定义.

引用了 binding, eve::action::ActionVfxBinding::clipEndTime, eve::action::ActionVfxBinding::clipStartTime, duration, eve::editor::ActionTimelineEditor::editItem(), end, eve::Result< T >::failure(), eve::action::ActionVfxBinding::fromPayload(), eve::Duration::fromSeconds(), itemId, eve::action::State, eve::action::StateEnter, eve::editor::ActionTimelineEditor::target() , 以及 eve::editor::ActionTimelineTarget::timeline().

被这些函数引用 eve::editor::exposeActionTimelineScriptBindings().

fitClipToBlock()

Result< void > eve::editor::ActionTimelinePayloadEditor::fitClipToBlock

(

const LogicalId &

itemId

)

Extend one VFX state's clip end so its authored interval matches the block duration.

参数

itemId

Stable VFX notify-state identity.

返回

Applied, or a structured type, range, validation, or transaction failure.

在文件 ActionTimelinePayloadEditor.cpp 第 77 行定义.

引用了 binding, eve::action::ActionVfxBinding::clipStartTime, eve::editor::ActionTimelineEditor::editItem(), eve::Result< T >::failure(), eve::Duration::fromNanoseconds(), eve::action::ActionVfxBinding::fromPayload(), itemId, eve::action::ActionTimelineEvent::kind, eve::Duration::seconds(), eve::action::State, eve::action::StateEnter, eve::editor::ActionTimelineEditor::target(), eve::editor::ActionTimelineTarget::timeline(), valid , 以及 eve::action::ActionNotifyRegistry::validate().

被这些函数引用 eve::editor::exposeActionTimelineScriptBindings().

fitClipToNaturalDuration()

Result< void > eve::editor::ActionTimelinePayloadEditor::fitClipToNaturalDuration	(	const LogicalId &	itemId,
		OptionalRef< const action::IActionVfxDurationProvider >	provider
	)

Set one VFX state's clip end to the finite duration reported by its resource provider.

参数

itemId	Stable VFX notify-state identity.
provider	Optional synchronously borrowed provider; absence is reported as Unsupported.

返回

Applied, or a structured provider, resource, type, validation, or transaction failure.

在文件 ActionTimelinePayloadEditor.cpp 第 96 行定义.

引用了 binding, duration, eve::editor::ActionTimelineEditor::editItem(), eve::Result< T >::failure(), eve::action::ActionVfxBinding::fromPayload(), itemId, eve::action::ActionTimelineEvent::kind, eve::action::State, eve::action::StateEnter, eve::editor::ActionTimelineEditor::target(), eve::editor::ActionTimelineTarget::timeline(), eve::action::ActionVfxBinding::uri, valid , 以及 eve::action::ActionNotifyRegistry::validate().

被这些函数引用 eve::editor::exposeActionTimelineScriptBindings().

patch()

Result< void > eve::editor::ActionTimelinePayloadEditor::patch	(	const LogicalId &	itemId,
		Value::Object	fields
	)

Merge fields into one payload and commit exactly one validated undo step.

参数

itemId	Stable notify or state identity.
fields	Fields to replace or append; omitted fields remain unchanged.

返回

Applied or a structured lookup, registry, validation, or transaction failure.

在文件 ActionTimelinePayloadEditor.cpp 第 48 行定义.

引用了 eve::Result< T >::failure(), fields, itemId, eve::action::ActionTimelineEvent::kind, eve::editor::ActionTimelineEditor::target(), eve::editor::ActionTimelineTarget::timeline(), eve::editor::ActionTimelineEditor::updateItem(), valid, eve::action::ActionNotifyRegistry::validate() , 以及 value.

payload()

Result< Value::Object > eve::editor::ActionTimelinePayloadEditor::payload

(

const LogicalId &

itemId

)

const

Return an owning copy of one editable notify or state payload.

在文件 ActionTimelinePayloadEditor.cpp 第 41 行定义.

引用了 itemId, eve::editor::ActionTimelineEditor::target() , 以及 eve::editor::ActionTimelineTarget::timeline().

---

该类的文档由以下文件生成:

• src/modules/action/editor/ActionTimelinePayloadEditor.h
• src/modules/action/editor/ActionTimelinePayloadEditor.cpp