From f6e4bb2bf9fb001d1c4b0a26eba45da8445dfa6e Mon Sep 17 00:00:00 2001 From: David Robillard Date: Thu, 23 Feb 2012 02:41:59 +0000 Subject: Seriatom => Sratom. git-svn-id: http://svn.drobilla.net/lad/trunk/sratom@3994 a436a847-0d15-0410-975c-d299462d15a1 --- sratom/seriatom.h | 120 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 120 insertions(+) create mode 100644 sratom/seriatom.h (limited to 'sratom/seriatom.h') diff --git a/sratom/seriatom.h b/sratom/seriatom.h new file mode 100644 index 0000000..1fe2547 --- /dev/null +++ b/sratom/seriatom.h @@ -0,0 +1,120 @@ +/* + Copyright 2012 David Robillard + + Permission to use, copy, modify, and/or distribute this software for any + purpose with or without fee is hereby granted, provided that the above + copyright notice and this permission notice appear in all copies. + + THIS SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES + WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF + MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR + ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES + WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN + ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF + OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. +*/ + +/** + @file seriatom.h API for Seriatom, an LV2 Atom RDF serialisation library. +*/ + +#ifndef SERIATOM_SERIATOM_H +#define SERIATOM_SERIATOM_H + +#include + +#include "lv2/lv2plug.in/ns/ext/atom/atom.h" +#include "lv2/lv2plug.in/ns/ext/urid/urid.h" +#include "serd/serd.h" + +#ifdef SERIATOM_SHARED +# ifdef _WIN32 +# define SERIATOM_LIB_IMPORT __declspec(dllimport) +# define SERIATOM_LIB_EXPORT __declspec(dllexport) +# else +# define SERIATOM_LIB_IMPORT __attribute__((visibility("default"))) +# define SERIATOM_LIB_EXPORT __attribute__((visibility("default"))) +# endif +# ifdef SERIATOM_INTERNAL +# define SERIATOM_API SERIATOM_LIB_EXPORT +# else +# define SERIATOM_API SERIATOM_LIB_IMPORT +# endif +#else +# define SERIATOM_API +#endif + +#ifdef __cplusplus +extern "C" { +#endif + +/** + @defgroup seriatom Seriatom + An LV2 Atom RDF serialisation library. + @{ +*/ + +/** + Atom serialiser. +*/ +typedef struct SeriatomImpl Seriatom; + +/** + Create a new Atom serialiser. +*/ +SERIATOM_API +Seriatom* +seriatom_new(LV2_URID_Map* map, + LV2_URID_Unmap* unmap); + +/** + Free an Atom serialisation. +*/ +SERIATOM_API +void +seriatom_free(Seriatom* seriatom); + +/** + Serialise an Atom to a SerdWriter. +*/ +SERIATOM_API +void +atom_to_rdf(Seriatom* seriatom, + const SerdNode* subject, + const SerdNode* predicate, + const LV2_Atom* atom, + uint32_t flags); + +/** + Serialise an Atom body to a SerdWriter. +*/ +SERIATOM_API +void +atom_body_to_rdf(Seriatom* seriatom, + const SerdNode* subject, + const SerdNode* predicate, + uint32_t type_urid, + uint32_t size, + const void* body, + uint32_t flags); + +/** + Serialise an Atom to a Turtle string. + The returned string must be free()'d by the caller. +*/ +SERIATOM_API +char* +atom_to_turtle(Seriatom* seriatom, + const SerdNode* subject, + const SerdNode* predicate, + const LV2_Atom* atom); + +/** + @} +*/ + +#ifdef __cplusplus +} /* extern "C" */ +#endif + +#endif /* SERIATOM_SERIATOM_H */ -- cgit v1.2.1