From cbb35cca2d0a87a664e5d72fe71dce45c3030823 Mon Sep 17 00:00:00 2001 From: Philip Chimento Date: Sat, 11 Feb 2012 22:47:17 +0100 Subject: [PATCH] Update to Blorb protocol 1.5 Update documentation of new Blorb constants --- docs/reference/chimara-sections.txt | 5 ++++- libchimara/doc.c | 24 +++++++++++++++++++++--- libchimara/gi_blorb.c | 6 +++--- libchimara/gi_blorb.h | 11 +++++++---- 4 files changed, 35 insertions(+), 11 deletions(-) diff --git a/docs/reference/chimara-sections.txt b/docs/reference/chimara-sections.txt index 8668f38..09b2dcf 100644 --- a/docs/reference/chimara-sections.txt +++ b/docs/reference/chimara-sections.txt @@ -650,12 +650,15 @@ giblorb_count_resources giblorb_method_DontLoad giblorb_method_Memory giblorb_method_FilePos -giblorb_ID_Snd giblorb_ID_Exec +giblorb_ID_Snd giblorb_ID_Pict +giblorb_ID_Data giblorb_ID_Copyright giblorb_ID_AUTH giblorb_ID_ANNO +giblorb_ID_TEXT +giblorb_ID_BINA giblorb_make_id diff --git a/libchimara/doc.c b/libchimara/doc.c index ab842bb..c45859f 100644 --- a/libchimara/doc.c +++ b/libchimara/doc.c @@ -873,8 +873,8 @@ * but it can also contain raw data files, which are accessed by * glk_stream_open_resource() and glk_stream_open_resource_uni(). A data file * is identified by number, not by a filename. The Blorb usage field will be - * 'Data'. The chunk type will be 'TEXT' for text - * resources, 'BINA' for binary resources. + * 'Data'. The chunk type will be %giblorb_ID_TEXT for text + * resources, %giblorb_ID_BINA for binary resources. * * * @@ -3656,6 +3656,12 @@ * Resource usage constant representing an image file. */ +/** + * giblorb_ID_Data: + * + * Resource usage constant representing a data file. + */ + /** * giblorb_ID_Copyright: * @@ -3678,7 +3684,19 @@ * Resource usage constant representing any textual annotation that the user or * writing program sees fit to include. */ - + +/** + * giblorb_ID_TEXT: + * + * Resource usage constant representing a text data file. + */ + +/** + * giblorb_ID_BINA: + * + * Resource usage constant representing a binary data file. + */ + /** * giblorb_map_t: * diff --git a/libchimara/gi_blorb.c b/libchimara/gi_blorb.c index cdee5f7..3f947f9 100644 --- a/libchimara/gi_blorb.c +++ b/libchimara/gi_blorb.c @@ -1,9 +1,9 @@ /* gi_blorb.c: Blorb library layer for Glk API. - gi_blorb version 1.4. + gi_blorb version 1.5. Designed by Andrew Plotkin - http://www.eblong.com/zarf/glk/index.html + http://eblong.com/zarf/glk/ - This file is copyright 1998-2000 by Andrew Plotkin. You may copy, + This file is copyright 1998-2010 by Andrew Plotkin. You may copy, distribute, and incorporate it into your own programs, by any means and under any conditions, as long as you do not modify it. You may also modify this file, incorporate it into your own programs, diff --git a/libchimara/gi_blorb.h b/libchimara/gi_blorb.h index ddec1bd..4e051ca 100644 --- a/libchimara/gi_blorb.h +++ b/libchimara/gi_blorb.h @@ -2,11 +2,11 @@ #define _GI_BLORB_H /* gi_blorb.h: Blorb library layer for Glk API. - gi_blorb version 1.4. + gi_blorb version 1.5. Designed by Andrew Plotkin - http://www.eblong.com/zarf/glk/index.html + http://eblong.com/zarf/glk/ - This file is copyright 1998-2000 by Andrew Plotkin. You may copy, + This file is copyright 1998-2012 by Andrew Plotkin. You may copy, distribute, and incorporate it into your own programs, by any means and under any conditions, as long as you do not modify it. You may also modify this file, incorporate it into your own programs, @@ -35,12 +35,15 @@ typedef glui32 giblorb_err_t; #define giblorb_make_id(c1, c2, c3, c4) \ (((c1) << 24) | ((c2) << 16) | ((c3) << 8) | (c4)) -#define giblorb_ID_Snd (giblorb_make_id('S', 'n', 'd', ' ')) #define giblorb_ID_Exec (giblorb_make_id('E', 'x', 'e', 'c')) +#define giblorb_ID_Snd (giblorb_make_id('S', 'n', 'd', ' ')) #define giblorb_ID_Pict (giblorb_make_id('P', 'i', 'c', 't')) +#define giblorb_ID_Data (giblorb_make_id('D', 'a', 't', 'a')) #define giblorb_ID_Copyright (giblorb_make_id('(', 'c', ')', ' ')) #define giblorb_ID_AUTH (giblorb_make_id('A', 'U', 'T', 'H')) #define giblorb_ID_ANNO (giblorb_make_id('A', 'N', 'N', 'O')) +#define giblorb_ID_TEXT (giblorb_make_id('T', 'E', 'X', 'T')) +#define giblorb_ID_BINA (giblorb_make_id('B', 'I', 'N', 'A')) /* giblorb_map_t: Holds the complete description of an open Blorb file. This type is opaque for normal interpreter use. */ -- 2.30.2