Engine:CVAR module: Difference between revisions
Tag: Undo |
|||
| (10 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
{{dev/uicvar}} | {{dev/uicvar}} | ||
Base name for the default 'world' module, without platform postfix or extensions. | |||
<kua>set module 'game'</kua> | <kua>set module 'game'</kua> | ||
| Line 13: | Line 13: | ||
Name of the world native library to load. | Name of the world native library to load. | ||
'World' in this context means a graphically or otherwise conceptually interactive environment, and is apart from any regular 2D UI environment, or may have no direct user interfaces. | 'World' in this context means a graphically or otherwise conceptually interactive environment, and is apart from any regular 2D UI environment, or may have no direct user interfaces. | ||
A world library typically loads when the 'world' loads and provides support for managing discrete world components how they interact and can act as a sink and/or source for messaging with other systems. | |||
; Lifetime | |||
World is loaded separately through configuration, and lives on its own managed by the engine 'World' module. A library may create and manage sets of entities and control how they interact and provide other services. | |||
During world load, the world may manage which native libraries if any get loaded. A library may also cause a different world to load. Also, no library may load at all. | |||
; Library load name and path: | ; Library load name and path: | ||
The actual load path | The actual load path set with [[CVAR lib_path]], and final library file name will be calculated from the 'module' name and the platform suffixes. See [[CVAR lib_path]] for the list of suffixes and explanation. | ||
The library state typically unloads when the world unloads or changes, and loads again when the world loads again. The actual OS module that is the library may or may not, from the OS standpoint, ever be unloaded from the engine process, once loaded. | |||
== Examples == | == Examples == | ||
Latest revision as of 05:12, 17 October 2023
Base name for the default 'world' module, without platform postfix or extensions.
set module 'game'
Arguments[edit]
- name - 'module'
- value - module name to load
Associations[edit]
- Is by default placed in the 'global' context.
Details[edit]
Name of the world native library to load.
'World' in this context means a graphically or otherwise conceptually interactive environment, and is apart from any regular 2D UI environment, or may have no direct user interfaces.
A world library typically loads when the 'world' loads and provides support for managing discrete world components how they interact and can act as a sink and/or source for messaging with other systems.
- Lifetime
World is loaded separately through configuration, and lives on its own managed by the engine 'World' module. A library may create and manage sets of entities and control how they interact and provide other services.
During world load, the world may manage which native libraries if any get loaded. A library may also cause a different world to load. Also, no library may load at all.
- Library load name and path
The actual load path set with CVAR lib_path, and final library file name will be calculated from the 'module' name and the platform suffixes. See CVAR lib_path for the list of suffixes and explanation.
The library state typically unloads when the world unloads or changes, and loads again when the world loads again. The actual OS module that is the library may or may not, from the OS standpoint, ever be unloaded from the engine process, once loaded.
Examples[edit]
Default values[edit]
For the path executable path 'd:\install\engine.exe', and a 'lib_path' of './lib/' on windows running the 64-bit engine:
set module 'game' becomes: ./lib/gamex64.dll with install in: d:\install\engine effective OS load: d:\install\engine\lib\gamex86.dll