capella 7: CapXML 2.0.0 File Format

Version 2.0.0
Copyright © 2010 Hartmut Ring, Bernd Jungmann

Automatically generated from the CapXML-Schema Definition
The basic types (used in this definition: xsd:int, xsd:boolean, and xsd:string) are not documented here. See the W3C Schema recommendation.

Contents

Root Element

score

Complex Types

Score and its Main Components

Score Systems System Staves Staff Voices Voice NoteObjects Tuplet Verse Lyric Heads Head Duration Rest Chord ExplicitBarline ClefSign KeySign TimeSign

Other Complex Types (in Alphabetical Order)

Brackets Font DrawObjects TranspObjects GalleryObjs Info Layout Pages StaffLayout SoundMap

Draw-Object Types

BasicDrawObj Guitar Metafile Polygon Slur RichText Rectangle Ellipse LineObj TupletBracket Wedge NotelinesObj Volta OctaveClef Trill WavyLine Text

Group Types

DrawObject

Simple Types

Language Millimeter Gap Gap10 Gap2 Gap4 Gap32 HorizAlign VerticalDir MidiNumber Color FrameType Clef Time Notelines EnharmonicNote PaperNorm DrawObjScope

Root Element

Name	Type
`score`	`Score`

Complex Types

Score

Name Type Occurrence

info Info 0 ... 1

layout Layout 1

gallery GalleryObjs 0 ... 1

pageObjects DrawObjects 0 ... 1

determines if and how bars numbers are shown at the beginning of the systems.

Name Type Default

Subtype
Base	`xsd:int`
Subset	Minimum: `"0"` Maximum: `"2"`

determines how the bar numbers are framed:
0=no frame, 1=rectangular frame, 2=oval frame.

x

horizontal position of the bar number relative to the left upper corner of the system.

y

vertical position of the bar number relative to the left upper corner of the system.

*** New in capella 2008: If > 0: Show bar number at each bar divisible by barInterval.

*** New in capella 2008: Line width for bar-number frames.

*** New in capella 2008: Line color for bar-number frames.

*** New in capella 2008: Specifies wether to fill the bar-number frames.

*** New in capella 2008: Fill color for bar-number frames (if filled).

*** New in capella 2008: Opacity of the fill color for bar-number frames.
capella offers only the values 255 (opaque) and 128 (half-transparent).

Name	Type	Occurrence
`font`	`Font`	1

systems Systems 1

Systems

contains a sequence of system elements representing consecutive parts of music.

Name	Type	Occurrence
`system`	`System`	1 ...

System

Name Type Default

Subtype
Base	`xsd:int`
Subset	Minimum: `"0"` Maximum: `"4"`

Defines the beam grouping for a system with the following categories: 0 = flags only, 1=small beam groups, 2=medium, 3=large, 4=whole bar beams
Exceptions may be defined in each Rest and Chord element.

List (string of elements separated by space)

Subtype
Base	`xsd:decimal`
Subset	Minimum: `"0.0f"` Maximum: `"720.0"`

*** New in capella 2008:
Tempo in quarters per minute for first playback and repetitions.
0 means unchanged.
Example: "80 0 84.3" means first playback with 80.0 quarters per minute, second playback (first repetition) unchanged, second repetition 84.3

justified xsd:boolean "false"

justifiedSingle

Substitute for "justified" in singlePart layout. If missing, "justified" value is used.

pageBreak xsd:boolean "false"

pageBreakSingle

Substitute for "pageBreak" in singlePart layout. If missing, "pageBreak" value is used.

instrNotation

Subtype
Base	`xsd:string`
Subset	`"none"` `"short"` `"long"`

Specifies whether the the long/short/no instrument names (defined in the score layout) are shown.

Left indentation in note line gaps; default value means automatic.

leftIndentSingle

Substitute for "leftIndent" in singlePart layout. If missing, "leftIndent" value is used.

*** New in capella 2008:
Right indentation in note line gaps.
If the justified attribute is false, this value is ignored.

rightIndentSingle

Substitute for "rightIndent" in singlePart layout. If missing, "rightIndent" value is used.

bracketColor Color "000000"

Name Type Occurrence

modifications of the automatic bar numbering defined in the Score type.

Name Type Default

Additional offset to the number of bars (positive or negative number). This changes the bar count shown in this system and all following systems.

if true: resets the bar count to 1 at the beginning of the system (count 1 is not displayed).

staves Staves 1

Staves

Name	Type	Occurrence
`staff`	`Staff`	1 ...

Staff

A staff inherits the properties defined in the corresponding staff layout.
The staff layouts are located at score/layout/staves.

Name Type Default

Refers to the staff layout with matching description attribute.

lineColor Color "000000"

defaultTime Time required

Name Type Occurrence

extraDistance

these values are added to the distances given in the staff layout

Name	Type	Default
`top`	`Gap`	`"0"`
`bottom`	`Gap`	`"0"`

voices Voices 1

Voices

A sequence of Voice elements (the voices of the staff). Maximum: six voices.

Name	Type	Occurrence
`voice`	`Voice`	1 ... 6

Voice

A sequence of note objects.

Name Type Default

General stem direction. Exceptions may be defined with each Chord element.

Name Type Occurrence

lyricsSettings

Specifies the style of lyric texts for this voice. If more than one font element is present, they are used for consecutive verses.

Name Type Default

Position of the first lyrics verse

Distance between lyrics verses

Name	Type	Occurrence
`font`	`Font`	1 ...

noteObjects NoteObjects 1

NoteObjects

Name Type Occurrence

Name	Type	Occurrence
`clefSign`	`ClefSign`	1
`keySign`	`KeySign`	1
`timeSign`	`TimeSign`	1
`barline`	`ExplicitBarline`	1
`chord`	`Chord`	1
`rest`	`Rest`	1

Tuplet

Modification of a duration by an irregular division:
If tripartite and prolong are set to the default values, the following rule applies:
The basic duration is shortened by multiplying with p/count, where p is the greatest power of two less than count.
If tripartite is set to true, p is the greatest number less than count, which equals three times a power of two.
If prolong is true, in the obove calculations "greatest ... less than" has to be replaced by "smallest ... greater than".
Examples:

`count . .`	`tripartite . .`	`prolong . .`	`p . .`	`modification factor`
3	false	false	2	2/3
11	false	false	8	4/11
11	true	false	6	3/11
11	false	true	16	8/11
11	true	true	12	6/11

Name Type Default

Subtype
Base	`xsd:int`
Subset	Minimum: `"2"` Maximum: `"15"`

tripartite xsd:boolean "false"

prolong xsd:boolean "false"

Verse

Text and alignment data for a lyrics syllable in one verse.

Name Type Default

i xsd:int required

Subtype
Base	`HorizAlign`
Subset	`"left"` `"center"`

extender xsd:boolean "false"

hyphen xsd:boolean "false"

verseNumber xsd:string ""

Content xsd:string

Lyric

Name Type Default

not yet used in capella 5.1

Name Type Occurrence

verse Verse 1 ...

Name	Type	Default
`lang`	`Language`	required

Name	Type	Occurrence
`verse`	`Verse`	1 ...

Heads

Name	Type	Occurrence
`head`	`Head`	1 ...

Head

Name Type Default

Subtype
Base	`xsd:string`
Subset	Regular Expression: `"[A-G][0-9]"`

absolute diatonic pitch
middle C (c'): "C5"

silent xsd:boolean "false"

Subtype
Base	`xsd:string`
Subset	`"auto"` `"diamond"` `"crossCircle"` `"crossDiamond"` `"triangle"` `"square"` `"openDiamond"` `"crossCircle2"` `"openTriangle"` `"openSquare"` `"thickCross"` `"thickCrossCircle"` `"slash"` `"filledNote"` `"filledDiamond"` `"filledTriangle"` `"filledSquare"` `"none"`

Name Type Occurrence

Alteration (usually displayed by an accidental)

Name Type Default

Subtype
Base	`xsd:int`
Subset	Minimum: `"-2"` Maximum: `"2"`

Subtype
Base	`xsd:string`
Subset	`"auto"` `"suppress"` `"force"` `"parenth"`

Specifies if and how the accidental should be displayed. Meanings:
auto: automatically
suppress: don't display an accidental
force: always display an accidental
parenth: show accidental in parentheses

xShift Gap4 "0"

Specifies, whether this note is connected to the preceeding or following note by ties.
A tie is shown between two consecuting notes, only if the first has the begin and the second has the begin attribute set.

Name	Type	Default
`begin`	`xsd:boolean`	`"false"`
`end`	`xsd:boolean`	`"false"`

Duration

Name Type Default

Subtype
Base	`xsd:string`
Subset	Regular Expression: `"(2/1\|1/(1\|2\|4\|8\|16\|32\|64\|128))"` Regular Expression: `"[1-9]\d*"`

first pattern: normal times
second pattern: full measures (applies only to rests)

Subtype
Base	`xsd:int`
Subset	Minimum: `"0"` Maximum: `"3"`

*** New in capella 2008: 3 dots possible.

noDuration xsd:boolean "false"

Name	Type	Occurrence
`tuplet`	`Tuplet`	0 ... 1

Rest

Name Type Default

List (string of elements separated by space)

Subtype
Base	`xsd:decimal`
Subset	Minimum: `"0.0f"` Maximum: `"720.0"`

*** New in capella 2008:
Tempo in quarters per minute for first playback and repetitions.
0 means unchanged.
Example: "80 0 84.3" means first playback with 80.0 quarters per minute, second playback (first repetition) unchanged, second repetition 84.3

Name Type Occurrence

duration Duration 1

Name Type Default

color Color "000000"

small xsd:boolean "false"

postGrace xsd:boolean "false"

invisible xsd:boolean "false"

dotsInvisible xsd:boolean "false"

xShift Gap4 "0"

Filler rests are invisible in print and cannot have draw objects. They are inserted, removed and edited automatically as side effects of normal note and rest editing.

Must be displayed only in singlePart layout. If a complete voice has nothing but onlySingle rests, it is not shown in whole score layout.

applies only to full measure rests

applies only to full measure rests

Name	Type	Default
`centered`	`xsd:boolean`	`"false"`
`shift`	`Gap`	`"0"`

drawObjects DrawObjects 0 ... 1

Chord

Name Type Default

List (string of elements separated by space)

Subtype
Base	`xsd:decimal`
Subset	Minimum: `"0.0f"` Maximum: `"720.0"`

*** New in capella 2008:
Tempo in quarters per minute for first playback and repetitions.
0 means unchanged.
Example: "80 0 84.3" means first playback with 80.0 quarters per minute, second playback (first repetition) unchanged, second repetition 84.3

Name Type Occurrence

duration Duration 1

Name Type Default

color Color "000000"

notationStaff

up/down means: Chord is notated in the staff above/below it's staff.
This may be used, when a voice changes from one staff to another.

small xsd:boolean "false"

postGrace xsd:boolean "false"

invisible xsd:boolean "false"

dotsInvisible

The display of augmentation dots (if present) may be suppressed by this attribute. This may be used in capella e.g. if a dotted note on a noteline with two stems (up and down, notated in two voices) should be prevented from showing two dots.

xShift Gap4 "0"

Name Type Default

dir VerticalDir "none"

invisible xsd:boolean "false"

lengthening Gap2 "0"

Subtype
Base	`xsd:int`
Subset	Minimum: `"0"` Maximum: `"5"`

The following attributes specify changes of the overall display of beams as defined globally in score/layout/beamFlattening and for each system in score/systems/system/beamGrouping.

Name Type Default

Subtype
Base	`xsd:string`
Subset	`"auto"` `"force"` `"split"` `"divide"`

force: beams are connected (between this chord and the following).
split: beams are split.
divide: all beams but one are split.

parallel shift relative to the precalculated beam.

gradient change relative to the precalculated beam.

Name Type Default

List (string of elements separated by space)

Subtype
Base	`xsd:string`
Subset	`"staccato"` `"tenuto"` `"staccatissimo"` `"normalAccent"` `"strongAccent"` `"weakBeat"` `"strongBeat"`

currently single articulation or "staccato tenuto"

lyric Lyric 0 ... 1

drawObjects DrawObjects 0 ... 1

heads Heads 1

ExplicitBarline

Name Type Default

Subtype
Base	`xsd:string`
Subset	`"single"` `"double"` `"end"` `"repEnd"` `"repBegin"` `"repEndBegin"` `"dashed"`

*** New in capella 2008: "dashed"

Subtype
Base	`xsd:string`
Subset	`"auto"` `"internal"` `"full"`

color Color "000000"

Name	Type	Occurrence
`drawObjects`	`DrawObjects`	0 ... 1

ClefSign

Name	Type	Default
`clef`	`Clef`	required
`color`	`Color`	`"000000"`

KeySign

Name Type Default

Subtype
Base	`xsd:int`
Subset	Minimum: `"-7"` Maximum: `"7"`

color Color "000000"

TimeSign

Name	Type	Default
`time`	`Time`	required
`color`	`Color`	`"000000"`

Brackets

Name Type Occurrence

Name	Type	Default
`from`	`xsd:int`	required
`to`	`xsd:int`	required
`curly`	`xsd:boolean`	`"false"`

Font

corresponding to the Windows API structure LOGFONT

Name Type Default

face xsd:string required

height xsd:decimal required

width xsd:decimal "0"

Specifies the weight of the font in the range 0 through 1000. For example, 400 is normal and 700 is bold.
If this value is zero, a default weight is used.
The following values are defined for convenience:


            
              FW_DONTCARE   =   0
              FW_THIN       = 100
              FW_EXTRALIGHT = 200
              FW_ULTRALIGHT = 200
              FW_LIGHT      = 300
              FW_NORMAL     = 400
              FW_REGULAR    = 400
              FW_MEDIUM     = 500
              FW_SEMIBOLD   = 600
              FW_DEMIBOLD   = 600
              FW_BOLD       = 700
              FW_EXTRABOLD  = 800
              FW_ULTRABOLD  = 800
              FW_HEAVY      = 900
              FW_BLACK      = 900

italic xsd:boolean "false"

underline xsd:boolean "false"

strikeOut xsd:boolean "false"

Specifies the character set. The following values are predefined:


            
              ANSI_CHARSET        = 0  
              DEFAULT_CHARSET     = 1  
              SYMBOL_CHARSET      = 2  
              SHIFTJIS_CHARSET    = 128
              HANGEUL_CHARSET     = 129
              HANGUL_CHARSET      = 129
              GB2312_CHARSET      = 134
              CHINESEBIG5_CHARSET = 136
              OEM_CHARSET         = 255
              JOHAB_CHARSET       = 130
              HEBREW_CHARSET     = 177 
              ARABIC_CHARSET     = 178 
              GREEK_CHARSET      = 161 
              TURKISH_CHARSET    = 162 
              VIETNAMESE_CHARSET = 163 
              THAI_CHARSET       = 222 
              EASTEUROPE_CHARSET = 238 
              RUSSIAN_CHARSET    = 204 
              MAC_CHARSET        = 77  
              BALTIC_CHARSET     = 186

pitchAndFamily

Specifies the pitch and family of the font. The two low-order bits specify the pitch of the font and can be one of the following values:


            
              DEFAULT_PITCH  = 0
              FIXED_PITCH    = 1
              VARIABLE_PITCH = 2

Bits 4 through 7 of the member specify the font family and can be one of the following values:


            
              FF_DONTCARE   =  0
              FF_ROMAN      = 16
              FF_SWISS      = 32
              FF_MODERN     = 48
              FF_SCRIPT     = 64
              FF_DECORATIVE = 80

color Color "000000"

DrawObjects

DrawObjects attached to a chord, a rest, an explicit barline or the page. All measures given in draw objects are relative to the object attached to. For some horizontally spread draw objects the end is relative to another chord/rest or explicit barline.

Name Type Occurrence

Name	Type	Occurrence
`basic`	`BasicDrawObj`	0 ... 1

TranspObjects

DrawObjects with a reference note

Name Type Occurrence

Name	Type	Default
`base`	`EnharmonicNote`	required

Name	Type	Occurrence
	`DrawObject`	1...
`basic`	`BasicDrawObj`	0 ... 1

GalleryObjs

DrawObjects with a name

Name Type Occurrence

Name	Type	Default
`name`	`xsd:string`	`""`

Name	Type	Occurrence
	`DrawObject`	1...
`basic`	`BasicDrawObj`	0 ... 1

Info

Name	Type	Occurrence
`author`	`xsd:string`	0 ... 1
`keywords`	`xsd:string`	0 ... 1
`comment`	`xsd:string`	0 ... 1
`encodingSoftware`	`xsd:string`	0 ... 1

Layout

Name	Type	Default
`singlePart`	`xsd:boolean`	`"false"`

Name Type Occurrence

pages Pages 1 ... 2

Name Type Occurrence

Name	Type	Default
`small`	`Millimeter`	required
`normal`	`Millimeter`	required
`smallSingle`	`Millimeter`	`""`
`normalSingle`	`Millimeter`	`""`
`pageObj`	`Millimeter`	`"1.8"`

Name Type Default

top Gap required

between Gap required

topSingle Gap ""

betweenSingle Gap ""

pageJustified

Subtype
Base	`xsd:string`
Subset	`"none"` `"exceptLast"` `"all"`

instrumentNames

Name	Type	Default
`align`	`HorizAlign`	`"center"`

Name	Type	Occurrence
`font`	`Font`	1

Name Type Default

modernKeyChange

Show new keys without redundant naturals

Display double notes in modern style (whole note between verticla lines) instead of mensural notation.

systemSeparators

Show two slanting lines at the left side between systems.
The slanting lines are only shown between equally indented systems.

Name	Type	Occurrence
`staffLayout`	`StaffLayout`	1 ...

brackets Brackets 0 ... 1

Name	Type	Default
`rel`	`xsd:int`	`""`
`abs`	`xsd:int`	`""`
`useRealSize`	`xsd:boolean`	`"true"`
`allowCompression`	`xsd:boolean`	`"false"`
`useLyricsSize`	`xsd:boolean`	`"true"`

beamFlattening

Name	Type	Default
`from`	`xsd:int`	required
`to`	`xsd:int`	required
`fromMax`	`xsd:int`	required
`toMax`	`xsd:int`	required

Pages

If a second page object occurs and its attribute even="true", attributes left and right will be used for even pages.

Name Type Default

first xsd:int "1"

landscape xsd:boolean "false"

even xsd:boolean "false"

left Millimeter required

top Millimeter required

right Millimeter required

bottom Millimeter required

If paperSize is present, it overrides paperSizeX and paperSizeY. If no paper size is specified, it is taken from current printer.

paperSizeX Millimeter ""

paperSizeY Millimeter ""

StaffLayout

Name Type Default

Short description of this staff layout.
It must be unique in the set of all staff layouts.
Used in the layout attribute of the type Staff.

Name Type Occurrence

Name Type Default

suppressSingle xsd:boolean "false"

suppressSingleVoices

Subtype
Base	`xsd:string`
Subset	Regular Expression: `"[1-6]+"`

Voice indices to suppress, base 1

defaultClef Clef required

notelines Notelines "5"

Name Type Occurrence

Name Type Default

Subtype
Base	`xsd:string`
Subset	`"full"` `"none"` `"internal"` `"external"`

from xsd:int required

to xsd:int required

Name Type Default

Subtype
Base	`xsd:string`
Subset	`"normal"` `"small"`

top Gap required

bottom Gap required

group Gap "0"

Attributes name, abbrev, pairName, pairAbbrev are deprecated and written only for CapXML 1 compatibility.
On read, corresponding elements supersede attributes.

Name	Type	Default
`name`	`xsd:string`	required
`abbrev`	`xsd:string`	required
`pairName`	`xsd:string`	`""`
`pairAbbrev`	`xsd:string`	`""`

Name	Type	Occurrence
`name`	`xsd:string`	1
`abbrev`	`xsd:string`	1
`pairName`	`xsd:string`	1
`pairAbbrev`	`xsd:string`	1

If present, device, sample, genericSound, and instr specify a more elaborate sound mapping. If more than one sound element is present, they are used for consecutive voices. The last element is used for the remaining voices. The following elements and attributes are evaluated only for the first sound element: percussion, entryAssignment, outputAssignment, and transpose.

Name Type Default

percussion xsd:boolean "false"

instr MidiNumber required

volume MidiNumber required

Subtype
Base	`xsd:int`
Subset	Minimum: `"-64"` Maximum: `"63"`

transpose xsd:int "0"

device xsd:string ""

sample xsd:string ""

genericSound xsd:string ""

DataID is a key into an external database which may hold more information about an instrument, such as typical clefs, transposed notation, or pitch range.

preferredChannel

Subtype
Base	`xsd:int`
Subset	Minimum: `"0"` Maximum: `"15"`

Name	Type	Occurrence
`entryAssignment`	`SoundMap`	0 ... 1
`outputAssignment`	`SoundMap`	0 ... 1

SoundMap

Name Type Occurrence

If present, device, sample, genericSound, and instr specify a more elaborate sound mapping

Name	Type	Default
`from`	`xsd:int`	required
`to`	`xsd:int`	required
`device`	`xsd:string`	`""`
`sample`	`xsd:string`	`""`
`genericSound`	`xsd:string`	`""`
`instr`	`xsd:int`	`""`

BasicDrawObj

Common properties of all draw objects.

Name Type Default

behindNotes xsd:boolean "false"

applies only to objects anchored to page

oddPagesExceptFirst

applies only to objects anchored to page

applies only to objects anchored to page

Distance to the chord/rest or explicit barline relative to which the coordinates of of the end of the object are given.
Applies only to objects anchored to chords/rests or explicit barlines
CapXML 1.0 did not count explicit barlines, CapXML 2 does. Applications have to care for this difference.

Indicates that a DrawObj is a continuation of another DrawObj in the preceding system. It will be displayed in a way typical for the object's type and will be deleted if systems are joined.
Applies only to objects anchored to chords/rests or explicit barlines

If a DrawObj is a continuation of another DrawObj in the preceding system, drawNormal specifies that it is nevertheless to be drawn in normal fashion. This attribute is typically used for the continuations of volta objects linked to the last fixed barline on a staff.
Applies only to objects anchored to chords/rests or explicit barlines

Indicates the scope of the DrawObj. This may be evaluated on playback and on part extraction
Applies only to objects anchored to chords/rests or explicit barlines

Subtype
Base	`xsd:int`
Subset	Minimum: `"0"` Maximum: `"1"`

applies only to objects anchored to chords/rests
0=head, 1=stem

Subtype
Base	`xsd:int`
Subset	Minimum: `"0"` Maximum: `"5"`

applies only to objects anchored to chords/rests
0=stafflines, 1=outer note (applies to chords with several notes: head opposite to the stem), 2=inner note (applies to chords with several notes: first head from stem end), 3=stem end, 4=top, 5=bottom

Subtype
Base	`Gap2`
Subset	Minimum: `"0"` Maximum: `"8"`

Minimal distance to middle note line

visibilityFlags

Subtype
Base	`xsd:int`
Subset	Minimum: `"0"` Maximum: `"127"`

any combination of:

1 = visible if stem up
2 = visible if stem down
4 = visible in upper voice
8 = visible in main voice
16 = visible in lower voice
32 = visible in singlePart layout (if layout singlePart ="true")
64 = visible in whole score layout (if layout singlePart ="false")

flags 1 - 16 apply only to objects anchored to chords/rests, flags 32 and 64 to all.

If onlySingle is "true", the object has been added for singlePart layout only, because the scope attribute required it. Will be deleted when switching back to whole score layout. Will be set to "false" if singlePart layout is exported as standalone file.

Subtype
Base	`xsd:string`
Subset	Regular Expression: `"\d{1,6}-([1-3]\d{3}\|\d{1,3})"`

Customer Number and private number, separated by "-".
The Customer Number has to be smaller than 1000000, the private number smaller than 4000

Guitar

Name Type Default

x Gap32 required

y Gap32 required

Subtype
Base	`xsd:int`
Subset	Minimum: `"3"` Maximum: `"8"`

thickNut xsd:boolean "false"

openStrings xsd:boolean "false"

vertical xsd:boolean "true"

Subtype
Base	`Gap4`
Subset	`"0.5"` `"0.75"` `"1"`

Subtype
Base	`xsd:decimal`
Subset	`"1"` `"1.5"` `"2"`

relative to stringDist
Example: stringDist="0.75" fretDist="1.5" means fret distance = 1.125 staffline distances

Subtype
Base	`xsd:string`
Subset	Regular Expression: `"[/0-9]{3,8}"`

color Color "000000"

Metafile

Name	Type	Default
`file`	`xsd:string`	required
`x`	`Gap32`	required
`y`	`Gap32`	required
`width`	`Gap32`	required
`height`	`Gap32`	required

Polygon

Name	Type	Default
`filled`	`xsd:boolean`	`"false"`
`fillColor`	`Color`	`"000000"`
`lineWidth`	`Gap10`	`"0.1"`
`lineColor`	`Color`	`"000000"`

Name Type Occurrence

Name Type Occurrence

Name	Type	Default
`x`	`Gap32`	required
`y`	`Gap32`	required

Slur

Name	Type	Default
`x1`	`Gap32`	required
`y1`	`Gap32`	required
`x2`	`Gap32`	required
`y2`	`Gap32`	required
`x3`	`Gap32`	required
`y3`	`Gap32`	required
`x4`	`Gap32`	required
`y4`	`Gap32`	required
`color`	`Color`	`"000000"`

Name Type Occurrence

Name Type Default

endWidth Gap32 "0"

midWidth Gap32 "0.1875"

dotDist Gap32 "0"

Subtype
Base	`xsd:decimal`
Subset	Minimum: `"0"` Maximum: `"1"`

relative to dotDist ("1" means solid)

RichText

Name	Type	Default
`file`	`xsd:string`	required
`x`	`Gap32`	required
`y`	`Gap32`	required
`width`	`Gap32`	required

Rectangle

Name	Type	Default
`radius`	`Gap32`	`"0"`
`lineWidth`	`Gap10`	`"0.1"`
`lineColor`	`Color`	`"000000"`
`filled`	`xsd:boolean`	`"false"`
`fillColor`	`Color`	`"000000"`
`x1`	`Gap32`	required
`y1`	`Gap32`	required
`x2`	`Gap32`	required
`y2`	`Gap32`	required

Ellipse

Name	Type	Default
`lineWidth`	`Gap10`	`"0.1"`
`lineColor`	`Color`	`"000000"`
`filled`	`xsd:boolean`	`"false"`
`fillColor`	`Color`	`"000000"`
`x1`	`Gap32`	required
`y1`	`Gap32`	required
`x2`	`Gap32`	required
`y2`	`Gap32`	required

LineObj

Name	Type	Default
`x1`	`Gap32`	required
`y1`	`Gap32`	required
`x2`	`Gap32`	required
`y2`	`Gap32`	required
`lineWidth`	`Gap10`	`"0.1"`
`color`	`Color`	`"000000"`

TupletBracket

Name Type Default

x1 Gap32 required

y1 Gap32 required

x2 Gap32 required

y2 Gap32 required

color Color "000000"

lineWidth Gap10 "0.1"

orientation VerticalDir "none"

Subtype
Base	`xsd:string`
Subset	Regular Expression: `"(0\|[2-9]\|1[0-5])"`

0 (means no number) or 2 to 15

Wedge

Name	Type	Default
`x1`	`Gap32`	required
`y1`	`Gap32`	required
`x2`	`Gap32`	required
`y2`	`Gap32`	required
`color`	`Color`	`"000000"`
`lineWidth`	`Gap10`	`"0.1"`
`span`	`Gap32`	`"1"`
`decrescendo`	`xsd:boolean`	`"false"`

NotelinesObj

Name	Type	Default
`x1`	`Gap32`	required
`y1`	`Gap32`	required
`x2`	`Gap32`	required
`y2`	`Gap32`	required
`lines`	`Notelines`	`"5"`
`color`	`Color`	`"000000"`

Volta

Name Type Default

x1 Gap32 required

x2 Gap32 required

y Gap32 required

color Color "000000"

leftBent xsd:boolean "true"

rightBent xsd:boolean "true"

upBent xsd:boolean "false"

dotted xsd:boolean "false"

0 means no number

lastNumber xsd:int "0"

allNumbers xsd:boolean "false"

OctaveClef

Name Type Default

x1 Gap32 required

x2 Gap32 required

y Gap32 required

color Color "000000"

Subtype
Base	`xsd:int`
Subset	`"-2"` `"-1"` `"1"` `"2"`

onlyNumber xsd:boolean "false"

courtesyRepeat xsd:boolean "true"

Trill

Name	Type	Default
`x1`	`Gap32`	required
`x2`	`Gap32`	required
`y`	`Gap32`	required
`color`	`Color`	`"000000"`
`tr`	`xsd:boolean`	`"true"`

WavyLine

Name	Type	Default
`x1`	`Gap32`	required
`y1`	`Gap32`	required
`x2`	`Gap32`	required
`y2`	`Gap32`	required
`color`	`Color`	`"000000"`
`waveLen`	`Gap32`	`"1"`
`fullWaves`	`xsd:boolean`	`"true"`

Text

Name	Type	Default
`x`	`Gap32`	required
`y`	`Gap32`	required
`align`	`HorizAlign`	`"left"`
`frame`	`FrameType`	`"none"`
`frameDistance`	`Gap32`	`"0"`
`radius`	`Gap32`	`"0"`

Name	Type	Occurrence
`font`	`Font`	1
`content`	`xsd:string`	1

Group Types

DrawObject

Name	Type	Occurrence
`line`	`LineObj`	1
`rectangle`	`Rectangle`	1
`ellipse`	`Ellipse`	1
`polygon`	`Polygon`	1
`metafile`	`Metafile`	1
`text`	`Text`	1
`richText`	`RichText`	1
`guitar`	`Guitar`	1
`slur`	`Slur`	1
`wavyLine`	`WavyLine`	1
`bracket`	`TupletBracket`	1
`wedge`	`Wedge`	1
`notelines`	`NotelinesObj`	1
`volta`	`Volta`	1
`octaveClef`	`OctaveClef`	1
`trill`	`Trill`	1
`transposable`	`TranspObjects`	1
`group`	`DrawObjects`	1

Simple Types

Language

Subtype
Base	`xsd:string`
Subset	Regular Expression: `"[a-z]{2}-[a-z]{2}"` Regular Expression: `"neutral"`

For future use!
Identifier for a spoken language e.g. "en-us". Should be changed to an existing standard!

Millimeter

Subtype
Base	`xsd:decimal`
Subset	no restriction (provided for documentation only)

Absolute measure in millimeters.
capella uses up to two decimals. Other values will be rounded.

Gap

Subtype
Base	`xsd:int`
Subset	no restriction (provided for documentation only)

Staffline distance

Gap10

Subtype
Base	`xsd:decimal`
Subset	no restriction (provided for documentation only)

Staffline distance. capella uses multiples of .1 = 1/10. Other values will be rounded.

Gap2

Subtype
Base	`xsd:decimal`
Subset	no restriction (provided for documentation only)

Staffline distance. capella uses multiples of .5 = 1/2. Other values will be rounded.

Gap4

Subtype
Base	`xsd:decimal`
Subset	no restriction (provided for documentation only)

Staffline distance. capella uses multiples of .25 = 1/4. Other values will be rounded.

Gap32

Subtype
Base	`xsd:decimal`
Subset	no restriction (provided for documentation only)

Staffline distance. capella uses multiples of .03125 = 1/32. Other values will be rounded.

HorizAlign

Subtype
Base	`xsd:string`
Subset	`"left"` `"center"` `"right"`

VerticalDir

Subtype
Base	`xsd:string`
Subset	`"none"` `"up"` `"down"`

MidiNumber

Subtype
Base	`xsd:int`
Subset	Minimum: `"0"` Maximum: `"127"`

Color

Subtype
Base	`xsd:hexBinary`
Subset	Length: `"3"`

Conforming to the W3C Schema recommendation the length of type hexBinary is given in Octets (containing two hexadecimal digits). So the value "3" means 6 hex digits.

FrameType

Subtype
Base	`xsd:string`
Subset	`"rectangle"` `"ellipse"` `"circle"` `"none"`

Clef

Subtype
Base	`xsd:string`
Subset	Regular Expression: `"treble"` Regular Expression: `"bass"` Regular Expression: `"alto"` Regular Expression: `"tenor"` Regular Expression: `"[GCFPNU][12345][\-0\+]?"`

one of the 4 common clefs or a concatenation of

one of G,C,F,P,N,U (clef type)
one of 1,2,3,4,5 (line)
[one of -,0,+ (octave)]

e.g.: "G3-" (G-clef on middle line, octava bassa)

Time

Subtype
Base	`xsd:string`
Subset	Regular Expression: `"allaBreve"` Regular Expression: `"longAllaBreve"` Regular Expression: `"C"` Regular Expression: `"infinite"` Regular Expression: `"([1-9]?\d\|1[0-1]\d\|12[0-8])/(1\|2\|4\|8\|16\|32\|64\|128)"`

*** New in capella 2008: longAllaBreve for 4/2 Allowed values:
"C", "allaBreve", "longAllaBreve", "infinite", or n/d with

n in {0,1, ... , 128}
d in {1,2,4,8,16,32,64,128}

e.g.: "3/4", "7/16"

Notelines

Subtype
Base	`xsd:string`
Subset	Regular Expression: `"5\|1\|([_\\|:]{11})"`

allowed values:

"5" = normal stafflines (default)
"1" = single line staff
or general notation: string of length 11 containing '_', '|', ':'

"___|||||___" = normal stafflines (equivalent to "5")
"_____|_____" = single-line staff (equivalent to "1")
"__:|||||___" = normal stafflines, dashed helplines below

EnharmonicNote

Subtype
Base	`xsd:string`
Subset	Regular Expression: `"[A-G][#b]?"`

possible Values:

"C", "C#", "Db", "D", "D#", "Eb", "E", "E#", "Fb", "F", "F#" "Gb",

          "G", "G#", "Ab", "A", "A#", "Bb", "B", "B#", "Cb"

PaperNorm

Subtype
Base	`xsd:string`
Subset	`"A4"` `"B4"` `"A5"` `"B5"` `"A3"` `"Letter"` `"Legal"` `"Tabloid"`

DrawObjScope

Subtype
Base	`xsd:string`
Subset	`"voice"` `"staff"` `"brace"` `"bracket"` `"system"`