Struct CurrentContext 

pub struct CurrentContext<'a>(/* private fields */);

The current ANE context, on which most APIs in this crate depend.

The lifetime is strictly tied to the function call stack.

Invariant

During any context-related call, the current context is guaranteed to be valid, and its associated ExtensionContext object must not call dispose.

Violating this invariant may cause subsequent API calls to fail and lead to rapidly increasing complexity in error handling. This crate treats such situations as invalid state and does not attempt to recover from them.

Implementations

impl<'a> CurrentContext<'a>

pub fn ty(&self) -> Option<UCStr>

Returns the context type associated with the current context.

This corresponds to the contextType argument passed to ExtensionContext.createExtensionContext.

Returns None if that argument was null.

pub fn data(&self) -> Option<&dyn Any>

Returns an immutable reference to the Context Data associated with the current context.

Context Data is user-defined data bound to the context, sharing the same lifetime as the context itself.

It can only be set via the first return value of ContextInitializer.

pub fn data_mut(&mut self) -> Option<&mut dyn Any>

Returns a mutable reference to the Context Data associated with the current context.

Context Data is user-defined data bound to the context, sharing the same lifetime as the context itself.

It can only be set via the first return value of ContextInitializer.

pub fn construct( &self, class: UCStr, args: Option<&[Object<'_>]>, ) -> Result<NonNullObject<'a>, ExternalError<'a>>

Calls the constructor for the specified class.

pub fn call_method( &mut self, name: &str, args: Option<&[Object<'_>]>, ) -> Result<Object<'a>, ContextError>

Calls a method associated with the current context.

Methods can only be set via the second return value of ContextInitializer.

Err=> ContextError::MethodsNotRegistered, ContextError::MethodNotFound;

pub fn get_actionscript_data(&self) -> Object<'a>

Returns the ActionScript-side Context Data associated with the current context.

ExtensionContext.actionScriptData

pub fn set_actionscript_data(&self, object: Object<'_>)

Sets the ActionScript-side Context Data associated with the current context.

ExtensionContext.actionScriptData

pub unsafe fn cooperative_context_from_object( &self, context: Object<'a>, ) -> CooperativeContext<'a>

Returns the associated context from an ExtensionContext object.

Safety

context must be another context constructed by the current extension via ContextInitializer. Otherwise, the invariants of CooperativeContext are violated, and its internal APIs for accessing native data will result in undefined behavior.

Panics

Panics if context is not an ExtensionContext object, or if it is associated with the current context.

pub fn foreign_context_from_object( &self, context: Object<'a>, ) -> ForeignContext<'a>

Returns the associated context from an ExtensionContext object.

Panics

Panics if context is not an ExtensionContext object, or if it is associated with the current context.

Trait Implementations

impl<'a> Context<'a> for CurrentContext<'a>

fn as_handle(&self) -> NonNull<c_void>

fn is_valid(&self) -> bool

Returns whether the context is valid.

fn as_ptr(&self) -> FREContext

fn trace(&self, message: impl ToUcstrLossy)

Sends a message to the debugger output.

fn event_dispatcher(&self) -> EventDispatcher

Returns an EventDispatcher used to perform asynchronous callbacks via the AS3 event system.

fn get_render_mode(&self, stage: Option<Stage<'a>>) -> RenderMode

Returns the render mode of the stage.

fn set_render_source( &self, source: MediaBuffer<'a>, display_object: NonNullObject<'a>, ) -> Result<(), FfiError>

FRESetRenderSource

fn with_media_buffer<F, R>(&self, media_buffer: MediaBuffer<'a>, f: F) -> R

where F: FnOnce(MediaBufferDataAdapter<'_>) -> R,

FREMediaBufferLock FREMediaBufferUnlock

impl<'a> Debug for CurrentContext<'a>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.