Skip to main content

Application

Struct Application 

Source
pub struct Application { /* private fields */ }
Expand description

Lower-level application builder for runtime and platform integration.

Regular applications should prefer App. This type remains public for custom embedding, debug tooling, and direct Runtime construction.

Implementations§

Source§

impl Application

Source

pub fn new() -> Self

Create an empty application with built-in icon resources registered.

Source

pub fn window(self, window: WindowBuilder) -> Self

Add a lower-level window builder.

Source

pub fn controller(self, controller: impl CommandController + 'static) -> Self

Attach an application-scoped controller outside the widget tree.

Source

pub fn on_command<T, F>(self, key: CommandKey<T>, handler: F) -> Self
where T: Send + Sync + 'static, F: FnMut(&mut CommandCtx, &T) + 'static,

Subscribe an application-scoped typed command handler.

Source

pub fn with_feathering_enabled(self, enabled: bool) -> Self

Enable or disable analytic-edge feathering in the WGPU renderer.

Source

pub fn with_feather_width(self, feather_width: f32) -> Self

Set the analytic-edge feather width in logical pixels.

Source

pub fn with_external_texture_registry( self, registry: WgpuExternalTextureRegistry, ) -> Self

Attach an app-owned external texture registry.

Source

pub fn feathering_enabled(&self) -> bool

Return whether renderer feathering is enabled.

Source

pub fn feather_width(&self) -> f32

Return the configured renderer feather width.

Source

pub fn external_texture_registry(&self) -> Option<&WgpuExternalTextureRegistry>

Borrow the configured external texture registry, if present.

Source

pub fn with_window_render_options(self, options: WindowRenderOptions) -> Self

Set initial render options applied to every window at startup.

Source

pub fn initial_window_render_options(&self) -> Option<WindowRenderOptions>

Return the initial render options, if configured.

Source

pub fn register_font( &mut self, handle: FontHandle, font: RegisteredFont, ) -> Result<()>

Register a font with an explicit handle.

Source

pub fn register_font_bytes( &mut self, data: impl Into<Vec<u8>>, ) -> Result<FontHandle>

Register font bytes and allocate a handle.

Source

pub fn register_image( &mut self, handle: ImageHandle, image: RegisteredImage, ) -> Result<()>

Register an image with an explicit handle.

Source

pub fn register_rgba_image( &mut self, width: u32, height: u32, data: impl Into<Vec<u8>>, ) -> Result<ImageHandle>

Register RGBA8 pixels and allocate an image handle.

Source

pub fn register_svg_image( &mut self, data: impl AsRef<[u8]>, ) -> Result<ImageHandle>

Register SVG bytes at their intrinsic size and allocate an image handle.

Source

pub fn register_svg_image_with_handle( &mut self, handle: ImageHandle, data: impl AsRef<[u8]>, ) -> Result<()>

Register SVG bytes at their intrinsic size with an explicit handle.

Source

pub fn register_svg_image_at_size( &mut self, width: u32, height: u32, data: impl AsRef<[u8]>, ) -> Result<ImageHandle>

Rasterize SVG bytes at an explicit size and allocate an image handle.

Source

pub fn register_svg_image_at_size_with_handle( &mut self, handle: ImageHandle, width: u32, height: u32, data: impl AsRef<[u8]>, ) -> Result<()>

Rasterize SVG bytes at an explicit size and handle.

Source

pub fn register_embedded_svg_image( &mut self, resource: EmbeddedSvgImageResource, ) -> Result<()>

Register one embedded SVG resource.

Source

pub fn register_embedded_svg_images( &mut self, resources: impl IntoIterator<Item = EmbeddedSvgImageResource>, ) -> Result<()>

Register multiple embedded SVG resources.

Source

pub fn build(self) -> Result<Runtime>

Build the retained runtime without starting a platform event loop.

Source

pub fn run(self) -> Result<()>

Build and run the application on the default desktop or web platform.

Source

pub fn run_with(self, on_ready: impl FnOnce(CommandSender)) -> Result<()>

Like run but invokes on_ready with a typed, thread-safe CommandSender once the event loop is created.

Trait Implementations§

Source§

impl Default for Application

Source§

fn default() -> Self

Returns the “default value” for a type. Read more
Source§

impl From<App> for Application

Source§

fn from(app: App) -> Self

Converts to this type from the input type.

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<T> Downcast for T
where T: Any,

Source§

fn into_any(self: Box<T>) -> Box<dyn Any>

Convert Box<dyn Trait> (where Trait: Downcast) to Box<dyn Any>. Box<dyn Any> can then be further downcast into Box<ConcreteType> where ConcreteType implements Trait.
Source§

fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>

Convert Rc<Trait> (where Trait: Downcast) to Rc<Any>. Rc<Any> can then be further downcast into Rc<ConcreteType> where ConcreteType implements Trait.
Source§

fn as_any(&self) -> &(dyn Any + 'static)

Convert &Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot generate &Any’s vtable from &Trait’s.
Source§

fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)

Convert &mut Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot generate &mut Any’s vtable from &mut Trait’s.
Source§

impl<T> Downcast<T> for T

Source§

fn downcast(&self) -> &T

Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> Read<Exclusive, BecauseExclusive> for T
where T: ?Sized,

Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> Upcast<T> for T

Source§

fn upcast(&self) -> Option<&T>

Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more