X-Git-Url: https://git.stderr.nl/gitweb?a=blobdiff_plain;f=docs%2Freference%2Fblorb.sgml;fp=docs%2Freference%2Fblorb.sgml;h=eeafe8ee7a01943cdb6e1330d8a72decee29080f;hb=6478a4f44526dde5ec7b1090d97b2255ed2879a1;hp=0000000000000000000000000000000000000000;hpb=e887e681be593844f5b785cab709d6c5a63f175f;p=rodin%2Fchimara.git diff --git a/docs/reference/blorb.sgml b/docs/reference/blorb.sgml new file mode 100644 index 0000000..eeafe8e --- /dev/null +++ b/docs/reference/blorb.sgml @@ -0,0 +1,37 @@ + + + + +The Blorb Layer +3 +CHIMARA Library + + +The Blorb Layer +Loading resources from a Blorb file + + +Description + +The material described in this section is not part of the Glk API per se. It is an external layer which allows the library to load resources (images and sounds) from a file specified by your program. The Blorb file format is a standard IF resource archive. + + +The Glk spec does not require that resources be stored in a Blorb file. It says only that the library knows how to load them and use them, when you so request. However, Blorb is the recommended way to supply portable resources. Most Glk libraries will support Blorb, using the interface defined in this section. + + +For the complete Blorb specification and tools for Blorb file manipulation, see: +http://www.eblong.com/zarf/blorb/ + + +How This Works + +The Blorb layer is implemented in a C source file, gi_blorb.c, and its header, gi_blorb.h. This code is (mostly) platform-independent — it is identical in every library, just as the glk.h header file is identical in every library. Each library author who wants to support Blorb should download the gi_blorb.c and gi_blorb.h files from the Glk web site, and compile them unchanged into the library. + + +Most of the functions defined in gi_blorb.h are intended for the library. If you are writing a Glk program, you can ignore them all, except for giblorb_set_resource_map(); see What the Program Does. If you are implementing a Glk library, you can use this API to find and load resource data. + + + +