CapXML 3.0 File Format

Version 3.0.3 (2019-05-20)
Copyright © 2018 capella-software AG

CapXML 3.0.3 is used in capella 8.0.10

This documentation has been automatically generated from the CapXML-Schema Definition
The basic types (used in this definition: xsd:int, xsd:decimal, xsd:nonNegativeInteger, xsd:positiveInteger, xsd:boolean, and xsd:string) are not documented here. See the W3C Schema recommendation.

Contents

Root Element

score

Alphabetical Index

All Types

BasicDrawObj Brackets Chord Clef ClefSign Color DrawObjScope DrawObject DrawObjects Duration Ellipse EnharmonicNote ExplicitBarline Font FrameType GalleryObjs Gap Gap10 Gap2 Gap256 Gap32 Gap4 Guitar Head Heads HorizAlign Info KeySign Language Layout LineObj Lyric Metafile MidiNumber Millimeter NoteObjects Notelines NotelinesObj OctaveClef Pages PaperNorm Pixmap Polygon Rectangle Rest RichText Score Slur SlurTieShape SoundMap Staff StaffLayout Staves Svg System Systems Text TextFormat Time TimeSign TranspObjects Trill Tuplet TupletBracket Verse VerticalDir Voice Voices Volta WavyLine Wedge

Complex Types

BasicDrawObj Brackets Chord ClefSign DrawObjects Duration Ellipse ExplicitBarline Font GalleryObjs Guitar Head Heads Info KeySign Layout LineObj Lyric Metafile NoteObjects NotelinesObj OctaveClef Pages Pixmap Polygon Rectangle Rest RichText Score Slur SlurTieShape SoundMap Staff StaffLayout Staves Svg System Systems Text TimeSign TranspObjects Trill Tuplet TupletBracket Verse Voice Voices Volta WavyLine Wedge

Group Types

DrawObject

Simple Types

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

Root Element

Name	Type
`score`	`Score`

Complex Types

Score

Complex Type

Name Type Occurrence

info Info 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.

Complex Type

Name Type Default

show bar number at each system

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.

Complex Type

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

System

Complex Type

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: `"10.0"` Maximum: `"720.0"`

*** New in capella 2008:
Tempo in quarters per minute for first playback and repetitions.
If the list contains more than one item, they are used for consecutive repeats. The last item is used for the remaining repeats.
0 for "no change" is not allowed (possible with chords and rests).
Example: "80 84.3" means first playback with 80.0 quarters per minute, second playback (first repetition) 84.3.

justified xsd:boolean "false"

justifiedSingle

*** New in capella 7.0
Substitute for "justified" in singlePart layout. If missing, "justified" value is used (see layout singlePart for details).

pageBreak xsd:boolean "false"

pageBreakSingle

*** New in capella 7.0
Substitute for "pageBreak" in singlePart layout. If missing, "pageBreak" value is used (see layout singlePart for details).

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

*** New in capella 7.0
Substitute for "leftIndent" in singlePart layout. If missing, "leftIndent" value is used (see layout singlePart for details).

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

rightIndentSingle

*** New in capella 7.0
Substitute for "rightIndent" in singlePart layout. If missing, "rightIndent" value is used (see layout singlePart for details).

bracketColor Color "000000"

Name Type Occurrence

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

Complex 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

Complex Type

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.

Complex Type

Name Type Default

Refers to the staff layout with matching description attribute.

lineColor Color "000000"

defaultTime Time required

*** New in capella 7.0
Staff has been inserted only for singlePart layout and is to be removed in whole score layout.

Name Type Occurrence

extraDistance

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

Complex Type

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.

Complex Type

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

Voice

A sequence of note objects.

Complex Type

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.
*** New in capella 7.0: If more than one font element is present, they are used for consecutive verses.
The last element is used for the remaining verses.

Complex Type

Name Type Default

Position of the first lyrics verse

Distance between lyrics verses

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

noteObjects NoteObjects 1

NoteObjects

Complex Type

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	8/11
11	true	false	6	6/11
11	false	true	16	16/11
11	true	true	12	12/11

Complex Type

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.

Complex Type

Name Type Default

i xsd:int required

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

extender xsd:boolean "false"

hyphen xsd:boolean "false"

verseNumber xsd:string ""

extentControl

*** New in capella 7:
Don't care for overwriting next syllable

*** New in capella 8.0.7:
Start melism hyphens up to next non empty syllable

Content xsd:string

Lyric

Complex Type

Name Type Default

not yet used in capella 5.1

Name Type Occurrence

verse Verse 1 ...

Complex Type

Name	Type	Default
`lang`	`Language`	required

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

Heads

capella will evaluate at most 15 heads.

Complex Type

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

Head

Complex Type

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"`

*** New in capella 7.0: Shapes "openDiamond", ..., "filledSquare"

*** New in capella 8.0.7: Place head on other side of stem.
Is evaluated only if chord xShift is not zero or chord noXAutoShift is true, and at least 2 voices are to be displayed in a staff. Thus, for a single extracted voice, this setting has no effect.

Name Type Occurrence

Alteration (usually displayed by an accidental)

Complex Type

Name Type Default

Subtype
Base	`xsd:decimal`
Subset	Minimum: `"-2.5"` Maximum: `"2.5"`

*** new in capella 8.0:
Decimal values allowed. For future use.

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.

Complex Type

Name Type Default

begin xsd:boolean "false"

end xsd:boolean "false"

explicitOrientation

*** New in capella 7.0
Specifies tie curvature if "begin" is true. For broken ties at the beginning of a staff, also if "end" is true.

Subtype
Base	`xsd:string`
Subset	`"normal"` `"dashed"` `"dotted"`

*** New in capella 8.0.8
Specifies tie shape.

Duration

Complex Type

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

Complex Type

Name Type Default

List (string of elements separated by space)

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

*** New in capella 2008:
Tempo in quarters per minute for first playback and repetitions.
0 means unchanged.
If the list contains more than one item, they are used for consecutive repeats. The last item is used for the remaining repeats.
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

If no display element is present, full measure rests will be displayed in churchStyle if they are no longer than 2 measures.

Complex Type

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"

*** New in capella 7.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.

*** New in capella 7.0
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

widthBarStyle

Gap

*** New in capella 8.0.7
Evaluated only for full measure rests in bar style: Width of the rest bar

stemUnderBeam

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

*** New in capella 8.0.7: If displayed under a beam, control stem fragment display. Meanings:
auto: automatically: Display a stem fragment at the edge of a beam group, a subgroup, or a beam division
suppress: don't display a stem fragment
force: always display a stem fragment

Complex Type

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

*** New in capella 8.0.7: Rests can be beamed.
The following attributes specify changes of the overall display of beams as defined globally in score/layout/beamFlattening. They override the settings for each system in score/systems/system/beamGrouping.

Complex Type

Name Type Default

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

auto: beams are split between this rest and the following chord or rest.
force: beams are connected (between this rest and the following chord or rest).
divide: The first beam is connected.

parallel shift relative to the precalculated beam.

gradient change relative to the precalculated beam.

drawObjects DrawObjects 0 ... 1

Chord

Complex Type

Name Type Default

List (string of elements separated by space)

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

*** New in capella 2008:
Tempo in quarters per minute for first playback and repetitions.
0 means unchanged.
If the list contains more than one item, they are used for consecutive repeats. The last item is used for the remaining repeats.
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

Complex Type

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.

*** New behaviour in capella 8.0.0: If xShift is zero, automatic x-shifts may be applied in order to resolve collisions with other notes in parallel voices.

*** New in capella 8.0.7: If xShift is zero, automatic x-shifts may be applied in order to resolve collisions with other notes in parallel voices. This can be forbidden by setting noAutoXShift true.

Complex Type

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.
*** New in capella 8.0.7: Beams can be extended over rests.

Complex Type

Name Type Default

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

auto: beams are connected (between this chord and the following chord) according to the beam grouping rules.
force: beams are connected (between this chord and the following chord or rest).
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.

Complex Type

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

*** New in capella 7.0: Can have drawobjects

Complex Type

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

Complex Type

Name Type Default

clef Clef required

color Color "000000"

*** New in capella 8.0.8: Invisible clef signs can be used in piano parts, where one voice changes clef, while a note of another voice is still playing. An invisible clef after this note will make the following notes obey the clef change. May be visualized in some kind of score display, but does not require space in print.

KeySign

Complex Type

Name Type Default

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

color Color "000000"

TimeSign

Complex Type

Name Type Default

time Time required

color Color "000000"

*** New in capella 7.1-13
Space to be reserved, for use with invisible or infinite signatures. Default value means automatic.

*** New in capella 7.1-13

Brackets

Complex Type

Name Type Occurrence

Complex Type

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

Font

corresponding to the Windows API structure LOGFONT

Complex Type

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.

Complex Type

Name Type Occurrence

Complex Type

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

TranspObjects

DrawObjects with a reference note

Complex Type

Name	Type	Default
`base`	`EnharmonicNote`	required

Name Type Occurrence

Complex Type

Name	Type	Default
`base`	`EnharmonicNote`	required

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

GalleryObjs

DrawObjects with a name

Complex Type

Name Type Occurrence

Complex Type

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

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

Info

*** New in capella 7.0: encodingSoftware

Complex Type

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

Layout

Complex Type

Name Type Default

*** New in capella 7.0
singlePart layout. If true, display only those staves with StaffLayout notation attribute suppressSingle="false" If only one staff has the suppressSingle attribute set to "false", the score is to be displayed in single part layout. If more than one staves have the suppressSingle attribute to "false", the score is to be displayed in whole score layout, but without the suppressed staves. Staves combined with a curly bracket count as one staff in this respect, as they are thought of as a single instrumental part. In this case, all objects with separate parameters for single part layout and whole score layout use their whole score layout parameter.

Name Type Occurrence

pages Pages 1 ... 2

Complex Type

Name Type Occurrence

Complex Type

Name Type Default

small Millimeter required

normal Millimeter required

*** New in capella 7.0: Separate value for singlePart layout (see layout singlePart for details).

*** New in capella 7.0: Separate value for singlePart layout (see layout singlePart for details).

pageObj Millimeter "1.8"

Complex Type

Name Type Default

top Gap required

between Gap required

Gap

*** New in capella 7.0: Separate value for singlePart layout (see layout singlePart for details).

betweenSingle

Gap

*** New in capella 7.0: Separate value for singlePart layout (see layout singlePart for details).

pageJustified

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

instrumentNames

Complex Type

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

Name	Type	Occurrence
`font`	`Font`	1

Complex Type

Name Type Default

*** New in capella 8.0
Symbol font for musical symbols used in note objects

*** New in capella 8.0
Font specified in fontFace complies to the SMuFL specification (see http://www.smufl.org/)

modernKeyChange

Show new keys without redundant naturals

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

maySkipHyphens

*** New in capella 8.0.8:
Do not show hyphens between lyrics syllables, if this would save space.

legacyOctaveSign

*** New in capella 8.0.7:
Show eventual octave signs in a larger font, typical for capella prior to version 7.1-13.

legacyNoteSpacing

*** New in capella 8.0.7:
Use same spacing for normal as for dotted notes and rests, like capella up to version 7.1

lyricsExtenderNoWrap

*** New in capella 8.0.7:
For lyrics extender lines do not use the line wrapping at line breaks, like capella up to version 7.1

noCollisionManagement

*** New in capella 8.0.7:
For staves with more than one voice, do not care for note collisions, like capella up to version 7.1

Gap

*** New in capella 8.0.7:
Desired Distance for melism hyphens

Name Type Occurrence

*** New in capella 8.0

Complex Type

Name	Type	Default
`firstNote`	`Gap32`	`""`
`leftBarline`	`Gap32`	`""`
`rightBarline`	`Gap32`	`""`

*** New in capella 8.0

Complex Type

Name	Type	Default
`head0`	`Gap256`	`""`
`head1`	`Gap256`	`""`
`head2`	`Gap256`	`""`
`head4`	`Gap256`	`""`
`stem`	`Gap256`	`""`
`noteLine`	`Gap256`	`""`
`barline`	`Gap256`	`""`
`legerLineJut`	`Gap256`	`""`

*** New in capella 8.0

Complex Type

Name	Type	Default
`xDown2`	`Gap256`	`""`
`xDown4`	`Gap256`	`""`
`yDown2`	`Gap256`	`""`
`yDown4`	`Gap256`	`""`
`xUp2`	`Gap256`	`""`
`xUp4`	`Gap256`	`""`
`yUp2`	`Gap256`	`""`
`yUp4`	`Gap256`	`""`

*** New in capella 8.0

Complex Type

Name	Type	Default
`dx`	`Gap32`	`""`
`dy`	`Gap32`	`""`
`width`	`Gap32`	`""`
`hasEnds`	`xsd:boolean`	`""`
`x1`	`Gap32`	`""`
`y1`	`Gap32`	`""`
`x2`	`Gap32`	`""`
`y2`	`Gap32`	`""`
`x3`	`Gap32`	`""`
`y3`	`Gap32`	`""`
`x4`	`Gap32`	`""`
`y4`	`Gap32`	`""`
`x5`	`Gap32`	`""`
`y5`	`Gap32`	`""`
`x6`	`Gap32`	`""`
`y6`	`Gap32`	`""`
`x7`	`Gap32`	`""`
`y7`	`Gap32`	`""`

*** New in capella 8.0.8
If present, the following elements specify the score's default shape of slurs.

Complex Type

Name Type Default

mayMoveTowardsHead

*** New in capella 8.0.8

Name	Type	Occurrence
`normal`	`SlurTieShape`	0 ... 1
`dashed`	`SlurTieShape`	0 ... 1
`dotted`	`SlurTieShape`	0 ... 1

*** New in capella 8.0.8
If present, the following elements specify the score's shape of ties.

Complex Type

Name	Type	Occurrence
`normal`	`SlurTieShape`	0 ... 1
`dashed`	`SlurTieShape`	0 ... 1
`dotted`	`SlurTieShape`	0 ... 1

Complex Type

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

brackets Brackets 0 ... 1

Complex Type

Name Type Default

rel xsd:int ""

abs xsd:int ""

useRealSize xsd:boolean "true"

allowCompression xsd:boolean "false"

useLyricsSize xsd:boolean "true"

justifyMinPerc

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

*** New in capella 8.0.9:
Justify systems only if at least justifyMinPerc percent of available page width is used.

beamFlattening

Complex Type

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

Pages

*** New in capella 7.0:
If a second page object occurs and its attribute even="true", attributes left and right will be used for even pages.

Complex Type

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

*** New in capella 7.0
If paperSize is present, it overrides paperSizeX and paperSizeY. If no paper size is specified, it is taken from current printer.

*** New in capella 7.0

*** New in capella 7.0

StaffLayout

Complex Type

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

Complex Type

Name Type Default

suppressSingle

*** New in capella 7.0: Suppress staff in singlePart layout

suppressSingleVoices

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

*** New in capella 7.0
Voice indices to suppress, base 1

defaultClef Clef required

notelines Notelines "5"

Name Type Occurrence

Complex Type

Name Type Default

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

from xsd:int required

to xsd:int required

Complex Type

Name Type Default

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

top Gap required

bottom Gap required

group Gap "0"

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

Complex Type

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`	0 ... 1
`pairAbbrev`	`xsd:string`	0 ... 1

*** New in capella 7.0:
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.

Complex Type

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 ""

*** New in capella 7.0
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: `"16"`

Value 0 means automatic channel setting.

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

SoundMap

Complex Type

Name Type Occurrence

*** New in capella 7.0
If present, device, sample, genericSound, instr, and midipitch specify a more elaborate sound mapping. The meaning of these parameters may vary for different devices.

Complex Type

Name Type Default

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

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

device xsd:string ""

sample xsd:string ""

genericSound xsd:string ""

instr xsd:int ""

midipitch xsd:int "-1"

BasicDrawObj

Common properties of all draw objects.

Complex Type

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
*** New in capella 7.0:
CapXML 1.0 did not count explicit barlines, CapXML 2 does. Applications have to care for this difference.

*** New in capella 7.0
Prevent from automatic adjustment to notes after reformatting, e.g. transposition.
Applies only to objects anchored to chords/rests or explicit barlines

*** New in capella 7.0
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

*** New in capella 7.0
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

*** New in capella 7.0
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"`

*** New in capella 7.0
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 lower voice
8 = visible in main voice
16 = visible in upper voice
32 = visible in whole score layout (see layout singlePart for details)
64 = visible in singlePart layout (see layout singlePart for details)

*** New in capella 7.0: Flags 32 and 64. flags 1 - 16 apply only to objects anchored to chords/rests, flags 32 and 64 to all.

*** New in capella 7.0
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

Complex Type

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

Complex Type

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

Pixmap

*** New in capella 8.0
Describes a raster image. Image formats are distinguished by the filename extension. Supported formats are: .png, .jpg, .jpeg, .gif, .bmp, .tif, .tiff.

Complex Type

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

Svg

*** New in capella 8.0
Describes a vector image in svg format. Accepted filename extensions are .svg, .svgz.

Complex Type

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

Polygon

Complex Type

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

Name Type Occurrence

Complex Type

Name Type Occurrence

Complex Type

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

Slur

Complex Type

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"

Subtype
Base	`xsd:string`
Subset	`"normal"` `"dashed"` `"dotted"`

*** New in capella 8.0.8
Specifies slur shape, if no form element is present. The application may provide separate defaults for the form values, for normal, dashed and dotted slurs.

Name	Type	Occurrence
`form`	`SlurTieShape`	0 ... 1

RichText

Complex Type

Name Type Default

file xsd:string required

fileHtml xsd:string ""

*** New in capella 8.0:
If textFormat is "rtf", only the file attribute will be evaluated. If textFormat is "html", only the fileHtml attribute will be evaluated. In this case, however, writing applications should provide an rtf file with same contents (eventually slightly distorted) and a corresponding file attribute anyway, in order to make legacy scripts work. It is also recommended to provide an html file with same contents and corresponding fileHtml attribute, if textFormat is "rtf".

x Gap32 required

y Gap32 required

width Gap32 required

Rectangle

Complex Type

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

Complex Type

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

Complex Type

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

SlurTieShape

Complex Type

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)

TupletBracket

Complex Type

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

Complex Type

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

Complex Type

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

Volta

Complex Type

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

*** New in capella 7.0

Complex Type

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

Complex Type

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

WavyLine

Complex Type

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

Complex Type

Name Type Default

x Gap32 required

y Gap32 required

align HorizAlign "left"

*** New in capella 7.0

frameDistance

*** New in capella 7.0

*** New in capella 7.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
`pixmap`	`Pixmap`	1
`svg`	`Svg`	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.

Gap256

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

Staffline distance. capella uses multiples of .00390625 = 1/256. 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"`

*** New in capella 7.0

TextFormat

Subtype
Base	`xsd:string`
Subset	`"rtf"` `"html"`

*** New in capella 8.0

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"`

*** New in capella 7.0

DrawObjScope

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

*** New in capella 7.0