Executor
Executor is a simple wrapper that drives your game plugins, it is intended to be used for production builds of your game.
The editor runs the executor in separate process when you entering play mode. Basically, there is no significant
difference between running the game from the editor, or running it as a separate application. The main difference is that
the editor passes override_scene
parameter for the executor when entering the play mode.
Usage
Executor is meant to be a part of your project's workspace, its typical look could something like this:
extern crate fyrox; use fyrox::{ core::{pool::Handle, uuid::Uuid}, engine::executor::Executor, plugin::{Plugin, PluginConstructor, PluginContext}, scene::{node::TypeUuidProvider, Scene}, }; struct GameConstructor; impl PluginConstructor for GameConstructor { fn create_instance( &self, _override_scene: Handle<Scene>, _context: PluginContext, ) -> Box<dyn Plugin> { todo!() } } impl TypeUuidProvider for GameConstructor { fn type_uuid() -> Uuid { todo!() } } fn main() { let mut executor = Executor::new(); // Register your game constructor here. executor.add_plugin_constructor(GameConstructor); executor.run() }
Executor has full access to the engine, and through it to the main application window. You can freely change desired
parts, Executor
implements Deref<Target = Engine> + DerefMut
traits, so you can use its instance as an "alias"
to engine instance.
To add a plugin to the executor, just use add_plugin_constructor
method, it accepts any entity that implements
PluginConstructor
+ TypeUuidProvider
traits.
Typical Use Cases
This section covers typical use cases for the Executor
.
Setting Window Title
You can set window title by accessing window instance and calling set_title
:
#![allow(unused)] fn main() { extern crate fyrox; use fyrox::engine::executor::Executor; let mut executor = Executor::new(); executor.get_window().set_title("My Game"); }