1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
|
/* importxml.h
* Header file for importing "native" Denemo XML files
*
* for Denemo, a gtk+ frontend to GNU Lilypond
* (c) 2001 Eric Galluzzo
*/
#ifndef IMPORTXML_H
#define IMPORTXML_H
#include "datastructures.h"
#include "xmldefs.h"
#include <glib.h>
/* libxml includes: for libxml2 this should be <libxml/tree.h> */
#include <libxml/tree.h>
/*
* This is the "interface" that all import handlers must "implement" if they
* wish to import data into Denemo. If any of the callbacks in the structure
* are NULL, then they are not called. However, all other fields must be
* non-NULL.
*/
typedef struct _DenemoImportXMLNSHandler
{
/*
* The XML namespace URI handled by this handler (e.g.
* "http://www.denemo.sourceforge.net/Denemo/Lilypond")
*/
gchar * xmlnsURI;
/*
* Create and return user data necessary for importing the given score. If
* no user data is required, set this startScore function to NULL.
*/
gpointer (* startScore) (xmlDocPtr doc);
/*
* Delete the given user data. If no user data is required, set this
* endScore function to NULL.
*/
void (* endScore) (xmlDocPtr doc, gpointer userData);
/*
* Import the given score-level XML element into the given score.
*/
void (* importScoreInfo) (struct scoreinfo * si, xmlNodePtr elem);
/*
* Import the given staff-level XML element into the "primary" staff located
* in the given score (si->currentprimarystaff).
*/
void (* importStaffInfo) (struct scoreinfo * si, xmlNodePtr elem);
/*
* Import the given voice-level XML element into the voice located in the
* given score (si->currentstaff). Note that elem may be a child of
* <voice-info> or <voice-init-params>.
*/
void (* importVoiceInfo) (struct scoreinfo * si, xmlNodePtr elem);
/*
* Import the given measure-level XML element into the measure located in
* the given score (si->currentmeasure).
*/
void (* importMeasure) (struct scoreinfo * si, xmlNodePtr elem);
/*
* Import the given object-level XML element into the mudelaobject located
* in the given score (si->currentobj). Note that this function is only
* called for built-in object types, not custom types.
*/
void (* importObjectInfo) (struct scoreinfo * si, xmlNodePtr elem);
/*
* Import the given note-level XML element into the note located in the
* given score (N.B.: not yet implemented!).
*/
void (* importNoteInfo) (struct scoreinfo * si, xmlNodePtr elem);
/*
* Create a new mudelaobject from the given object-level XML element and
* return it. Return NULL if no object should be created.
*/
mudelaobject * (* importCustomObject) (struct scoreinfo * si,
xmlNodePtr elem);
} DenemoImportXMLNSHandler;
/*
* Import the given file in Denemo's "native" XML file format into the given
* score. Return TRUE if the file was imported successfully, FALSE otherwise.
*/
gboolean importXML (gchar * filename, struct scoreinfo *si);
void registerImportXMLNSHandler (DenemoImportXMLNSHandler * handler);
void unregisterImportXMLNSHandler (DenemoImportXMLNSHandler * handler);
#endif
|
