From 0e699be281c8dea53e589e08a5831837e0eae7ea Mon Sep 17 00:00:00 2001 From: David Thompson Date: Thu, 7 Oct 2021 20:17:50 -0400 Subject: Updates for Chickadee 0.8.0 and Guile-SDL2 0.7.0. --- manuals/chickadee/Invoking-chickadee-play.html | 198 +++++++++++++++++++++++++ 1 file changed, 198 insertions(+) create mode 100644 manuals/chickadee/Invoking-chickadee-play.html (limited to 'manuals/chickadee/Invoking-chickadee-play.html') diff --git a/manuals/chickadee/Invoking-chickadee-play.html b/manuals/chickadee/Invoking-chickadee-play.html new file mode 100644 index 0000000..0c9c065 --- /dev/null +++ b/manuals/chickadee/Invoking-chickadee-play.html @@ -0,0 +1,198 @@ + + + + + + +Invoking chickadee play (The Chickadee Game Toolkit) + + + + + + + + + + + + + + + + + + + +
+

+Next: , Up: Command Line Interface   [Contents][Index]

+
+
+

3.1 Invoking chickadee play

+ +

The chickadee play command is used to open a window and run +the Chickadee game contained within a Scheme source file. +

+
+
chickadee play the-legend-of-emacs.scm
+
+ +

In this file, special procedures may be defined to handle various +events from the game loop: +

+ + +

See The Game Loop for complete information on all of these +hooks, such as the arguments that each procedure receives. +

+

In additional to evaluating the specified source file, the directory +containing that file is added to Guile’s load path so that games can +easily be divided into many different files. Furthermore, that +directory is entered prior to evaluating the file so that data files +(images, sounds, etc.) can be loaded relative to the main source file, +regardless of what the current directory was when chickadee +play was invoked. +

+

Many aspects of the initial game window and environment can be +controlled via the following options: +

+
+
--title=title
+
-t title
+
+

Set the window title to title. +

+
+
--width=width
+
-w width
+
+

Set the window width to width pixels. +

+
+
--height=height
+
-h height
+
+

Set the window height to height pixels. +

+
+
--fullscreen
+
-f
+
+

Open window in fullscreen mode. +

+
+
--resizable
+
-r
+
+

Make window resizable. +

+
+
--update-hz=n
+
-u n
+
+

Update the game n times per second. +

+
+
--repl
+
+

Launch a REPL in the terminal. This will allow the game environment +to debugged and modified without having to stop and restart the game +after each change. +

+
+
--repl-server[=port]
+
+

Launch a REPL server on port port, or 37146 by default. +

+

telnet localhost 37146 (or whatever port number was given) +will do the trick, but using the Geiser extension for Emacs is by far the best way to develop at the +REPL with Guile. Use M-x connect-to-guile to connect to the +REPL server. +

+
+
+ +
+
+

+Next: , Up: Command Line Interface   [Contents][Index]

+
+ + + + + -- cgit v1.2.3