townengine/docs/interop.md

17 lines
1.1 KiB
Markdown
Raw Normal View History

2024-10-22 10:53:10 +00:00
# interoperability
api needs to facilitate easy interoperability with other languages and tools,
for that certain considerations are taken:
* number of public api calls is kept at the minimum
* procedure parameters can only use basic types, no aggregates, with exception of Vec/Matrix types and alike,
2025-01-03 08:49:00 +00:00
with no new additions, ever (see [/include/twn_types.h](../include/twn_types.h))
* optionals can be expressed via pointer passage of value primitives, assumed immutable, with the NULL expressing default value
* no opaque types, only keys if needed
2025-01-03 08:45:10 +00:00
* pointers to pointers aren't allowed
2025-01-03 08:49:00 +00:00
* when mutation on input is done, - it shouldn't be achieved by a mutable pointer, but the return value
* return value could be a simple aggregate that is translatable to a dictionary of primitives
2024-11-03 20:27:10 +00:00
* module prefix is used for namespacing, actual symbols come after the prefix (`<module>_<symbol>`)
2024-11-03 20:30:29 +00:00
* symbols should not contain numerics at the start nor after the namespace prefix
2024-11-03 20:25:06 +00:00
* 32 bit floating point is the only numeric type
2025-01-03 08:49:00 +00:00
* [/include/twn_api.json](../share/twn_api.json) file is hand-kept with a schema to aid automatic binding generation and tooling