Sections

ExternalReference

Media at a URL.

Symbols in this group are spelled otio_external_reference_…. An SDK drops that prefix, which is why the name beside each call is the short one.

new

constructor

Creates a media reference pointing at a URL.

OtioStatus otio_external_reference_new(
    OtioDocument *target,
    const char *name,
    const char *target_url,
    OtioNode *out_node,
    OtioBuffer *out_error);

Parameter	Type	Role
target	document	the document, changed
name ?	text	input
target_url ?	text	input
out_node	node	written through, not read
out_error	text	why the call failed, or null to skip it

set_target_url

setter

Sets where an external reference's media lives.

OtioStatus otio_external_reference_set_target_url(
    OtioDocument *target,
    OtioNode node_handle,
    const char *url,
    OtioBuffer *out_error);

Parameter	Type	Role
target	document	the document, changed
node_handle	node	what the call is about
url	text	input
out_error	text	why the call failed, or null to skip it

target_url

getter

Returns where an external reference's media lives.

OtioStatus otio_external_reference_target_url(
    const OtioDocument *source,
    OtioNode node_handle,
    OtioBuffer *out_url,
    OtioBuffer *out_error);

Parameter	Type	Role
source ?	document	the document, borrowed
node_handle	node	what the call is about
out_url	text	written through, not read
out_error	text	why the call failed, or null to skip it