diff options
author | David Robillard <d@drobilla.net> | 2011-03-29 02:37:48 +0000 |
---|---|---|
committer | David Robillard <d@drobilla.net> | 2011-03-29 02:37:48 +0000 |
commit | b502bbc61895d61c39bf240b47e8a3664be2c541 (patch) | |
tree | 15b512390cec57c0a0a7b93f003a775060b51a70 /libs/ardour/rdff.h | |
parent | c9d0c2beaedfa14a394a811bb2669b72e6670afe (diff) |
Flesh out RDFF documentation.
git-svn-id: svn://localhost/ardour2/branches/3.0@9223 d708f5d6-7413-0410-9779-e7cbd77b26cf
Diffstat (limited to 'libs/ardour/rdff.h')
-rw-r--r-- | libs/ardour/rdff.h | 32 |
1 files changed, 19 insertions, 13 deletions
diff --git a/libs/ardour/rdff.h b/libs/ardour/rdff.h index ce38d1ff79..960085db04 100644 --- a/libs/ardour/rdff.h +++ b/libs/ardour/rdff.h @@ -40,40 +40,46 @@ extern "C" { #endif +/** + RDFF file or stream. + */ typedef struct _RDFF* RDFF; +/** + Status codes for function returns. +*/ typedef enum { - RDFF_STATUS_OK = 0, - RDFF_STATUS_UNKNOWN_ERROR = 1, - RDFF_STATUS_EOF = 2, - RDFF_STATUS_CORRUPT = 3 + RDFF_STATUS_OK = 0, /**< Success. */ + RDFF_STATUS_UNKNOWN_ERROR = 1, /**< Unknown error. */ + RDFF_STATUS_EOF = 2, /**< End of file. */ + RDFF_STATUS_CORRUPT = 3 /**< Corrupt data. */ } RDFFStatus; /** Generic RIFF chunk header. */ typedef struct { - char type[4]; - uint32_t size; - char data[]; + char type[4]; /**< Chunk type ID. */ + uint32_t size; /**< Size of chunk body (not including header). */ + char data[]; /**< Chunk body. */ } PACKED RDFFChunk; /** Body of a URID chunk. */ typedef struct { - uint32_t id; - char uri[]; + uint32_t id; /**< Numeric ID of URI in this RDFF. */ + char uri[]; /**< URI string. */ } PACKED RDFFURIChunk; /** Body of a KVAL chunk. */ typedef struct { - uint32_t key; - uint32_t type; - uint32_t size; - char value[]; + uint32_t key; /**< Predicate URI ID. */ + uint32_t type; /**< Type URI ID. */ + uint32_t size; /**< Size of object data. */ + char value[]; /**< Object data. */ } PACKED RDFFValueChunk; /** |