The Ultra Engine Plugin SDK allows modular functionality to be added to the engine.
A plugin can be loaded by any Ultra Engine application using the LoadPlugin command. Plugins must be compiled separately for each supported platform. Windows uses DLL files for plugins. MacOS uses DYLIB files. Linux uses SO files. You can omit the file extension in the plugin file path, and the engine will choose a file extension based on the current platform:
LoadPlugin("Plugins/FITextureLoader");
A plugin is only required to have one function called "GetPluginInfo". This will return a string in JSON format containing information about the plugin. A top-level plugin object must be specified. This object is required to have string elements for "title" and "description". You can optionally include some text about the author:
{
"plugin":
{
"title": "Plugin Title",
"description": "Description of the plugin and its functionality.",
"author": "John Smith"
}
}
Other miscellaneous properties can be added to tell the engine how to handle the plugin.
Property | Type | Description |
---|---|---|
collapseSavedModels | boolean | if set to true models will be collapsed before SaveModel is called |
redistributable | boolean | indicates whether the plugin can be redistributed in a game or application, defaults to true |
saveModelExtensions | string or array | file format extensions supported for model saving |
saveModelFilter | string | file type filter for save file dialogs |
saveTextureExtensions | string or array | file format extensions supported for texture saving |
saveTextureFilter | string | file type filter for save file dialogs |
The plugin's functionality is defined by the functions it contains. A plugin can contain any of the following functions. It is possible to combine functionality, like a plugin that can save model files and load a new texture format. However, it is best to limit plugins to a single purpose, or a single file format, like loading and saving of a new image format.
Function | Description |
---|---|
GetPluginInfo | Required function that returns information about the plugin. |
ConvertPixmap | Converts pixel data between formats. |
LoadTexture | Loads an image from memory in a specific format. |
SaveTexture | Saves an image to memory in a specific format. |
Cleanup | Called after load and save commands to free allocated resources. |
A package plugin must contain all of the following commands:
Function | Description |
---|---|
LoadPackage | Loads a model from memory in a specific format. |
CountPackageFiles | Loads a model from memory in a specific format. |
GetPackageFileSize | Loads a model from memory in a specific format. |
LoadPackageFile | Loads a model from memory in a specific format. |
FreePackage | Loads a model from memory in a specific format. |
GetPackageFileName | Loads a model from memory in a specific format. |