Tachikoma
d5a0edd692
docs/20 builds the engine and the boundary: the startup order, the starfield, actors and collision, booting a DEF-only script, the issue #8 mode workaround, the custom update hook, first light, screens, and the headless harness. docs/21 builds the three shared structures and the AI: the host type tables, the actor binding, the randomness route around issue #16, the measured case against structure arguments (issue #36), the three language rules that shape the script, the maneuvers, the argued formation decision, the script-death policy, and the interop proof. Every fenced block runs under tests/docs_examples.sh in both build configurations; five new preludes carry the C fragments. docs/10 gains the 'Calling a function every frame' section the chapters lean on: the per-call akbasic_environment_zero() rule, the set_mode(RUN) workaround, the clear_error() revival, and the case for rebinding over structure arguments. Index rows and chapter counts updated. Co-authored-by: andrew <andrew@aklabs.net> Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01XiGgpHuXUm2mR4Wzndw3dc
31 lines
1.1 KiB
Plaintext
31 lines
1.1 KiB
Plaintext
/*
|
|
* Prelude for the "used like this" fragment in README.md.
|
|
*
|
|
* The fragment is a run of CATCH calls, which only compile inside an ATTEMPT --
|
|
* that is the whole point of the macro protocol and the reason the fragment is
|
|
* shown without its scaffolding. `host_set_string` is the third accessor the
|
|
* surrounding prose says exists but does not print.
|
|
*/
|
|
#include <akerror.h>
|
|
#include <akbasic/environment.h>
|
|
#include <akbasic/error.h>
|
|
#include <akbasic/runtime.h>
|
|
#include <akbasic/variable.h>
|
|
|
|
static akbasic_Runtime SCRIPT;
|
|
static const char *PROGRAM = "10 PRINT \"HI\"\n";
|
|
|
|
akerr_ErrorContext AKERR_NOIGNORE *host_set_int(akbasic_Runtime *obj, const char *name, int64_t value);
|
|
akerr_ErrorContext AKERR_NOIGNORE *host_get_int(akbasic_Runtime *obj, const char *name, int64_t *dest);
|
|
akerr_ErrorContext AKERR_NOIGNORE *host_set_string(akbasic_Runtime *obj, const char *name, const char *value);
|
|
|
|
akerr_ErrorContext AKERR_NOIGNORE *akbasic_docs_fragment(void);
|
|
akerr_ErrorContext AKERR_NOIGNORE *akbasic_docs_fragment(void)
|
|
{
|
|
PREPARE_ERROR(errctx);
|
|
int64_t score = 0;
|
|
akbasic_Value *argp[4];
|
|
akbasic_Value *result = NULL;
|
|
|
|
ATTEMPT {
|