Category:Interfaces: Difference between revisions
Jump to navigation
Jump to search
Note:If you try to construct an interface directly, your mod will crash. This is done deliberately.
Warning:It is important to create all objects listed when exposing a vital interface, even if your mod can be compiled and run without one or another of them. If you try to cut corners you are likely to encounter weird, almost impossible to debug errors either today or after a future engine update!
Warning:Never, ever modify an interface class itself. You must always inherit then cast back.
TomEdwards (talk | contribs) (explained interfaces) |
mNo edit summary |
||
| (8 intermediate revisions by 5 users not shown) | |||
| Line 1: | Line 1: | ||
{{lang|Category:Interfaces}} | |||
{{warning|'''''Never, ever''''' modify an interface class itself. You | '''[[Wikipedia:Interface (computer science)|Interfaces]]''' are C++ classes that other parts of the engine access when your mod is running. | ||
Some interface objects are very important, and are required for game DLLs to function; to use these you inherit from them for implementation, then cast back to the interface class in a global [[pointer]] with a predefined name. | |||
{{note|If you try to construct an interface directly, your mod will crash. This is done deliberately.}} | |||
{{warning|It is important to create ''all'' objects listed when exposing a vital interface, even if your mod can be compiled and run without one or another of them. If you try to cut corners you are likely to encounter weird, almost impossible to debug errors either today or after a future engine update!}} | |||
{{warning|'''''Never, ever''''' modify an interface class itself. You must always inherit then cast back.}} | |||
== Example == | == Example == | ||
< | <syntaxhighlight lang=cpp>static CInput g_Input; | ||
IInput* input = (IInput*)&g_Input;</syntaxhighlight> | |||
This creates the <code>[[IInput]]* input</code> | This creates the <code>[[IInput]]* input</code> and <code>g_Input</code> objects the engine expects, placing behind them Valve's basic input code from <code>[[CInput]]</code>. | ||
You are free to modify <code>CInput</code> or to create your own inherited class and use that instead; just remember that only the members of <code>IInput</code> | You are free to modify <code>CInput</code>, or to create your own inherited class and use that instead; just remember that only the members of <code>IInput</code> will be accessed by the engine. | ||
[[Category: | [[Category:C++]] | ||
Latest revision as of 10:03, 24 January 2025
Interfaces are C++ classes that other parts of the engine access when your mod is running.
Some interface objects are very important, and are required for game DLLs to function; to use these you inherit from them for implementation, then cast back to the interface class in a global pointer with a predefined name.
Note:If you try to construct an interface directly, your mod will crash. This is done deliberately.Warning:It is important to create all objects listed when exposing a vital interface, even if your mod can be compiled and run without one or another of them. If you try to cut corners you are likely to encounter weird, almost impossible to debug errors either today or after a future engine update!Warning:Never, ever modify an interface class itself. You must always inherit then cast back.Example
static CInput g_Input;
IInput* input = (IInput*)&g_Input;
This creates the IInput* input and g_Input objects the engine expects, placing behind them Valve's basic input code from CInput.
You are free to modify CInput, or to create your own inherited class and use that instead; just remember that only the members of IInput will be accessed by the engine.
Subcategories
This category has the following 5 subcategories, out of 5 total.
I
- IScheme (1 P)
- ISchemeManager (1 P)
- ISystem (1 P)
- ITextureRegenerator (2 P)
Pages in category "Interfaces"
The following 26 pages are in this category, out of 26 total.