CapXML 3.0 File Format

Version 3.0.2 (2018-11-07)
Copyright © 2018 capella-software AG

CapXML 3.0.2 is used in capella 8.0.8

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

NameType
scoreScore

Complex Types

Score

Complex Type
Elements
NameTypeOccurrence
infoInfo1
layoutLayout1
galleryGalleryObjs0 ... 1
pageObjectsDrawObjects0 ... 1
barCount
determines if and how bars numbers are shown at the beginning of the systems.
Complex Type
Attributes
NameTypeDefault
atSystemsxsd:boolean
show bar number at each system
"true"
frame
Subtype
Basexsd:int
SubsetMinimum: "0"
Maximum: "2"
determines how the bar numbers are framed:
0=no frame, 1=rectangular frame, 2=oval frame.
"0"
xGap2
horizontal position of the bar number relative to the left upper corner of the system.
required
yGap2
vertical position of the bar number relative to the left upper corner of the system.
required
barIntervalxsd:int
*** New in capella 2008: If > 0: Show bar number at each bar divisible by barInterval.
"0"
lineWidthGap10
*** New in capella 2008: Line width for bar-number frames.
"0.1"
lineColorColor
*** New in capella 2008: Line color for bar-number frames.
"000000"
filledxsd:boolean
*** New in capella 2008: Specifies wether to fill the bar-number frames.
"false"
fillColorColor
*** New in capella 2008: Fill color for bar-number frames (if filled).
"FFFFFF"
fillOpacityxsd:int
*** New in capella 2008: Opacity of the fill color for bar-number frames.
capella offers only the values 255 (opaque) and 128 (half-transparent).
"255"
Elements
NameTypeOccurrence
fontFont1
0 ... 1
systemsSystems1

Systems

contains a sequence of system elements representing consecutive parts of music.
Complex Type
Elements
NameTypeOccurrence
systemSystem1 ...

System

Complex Type
Attributes
NameTypeDefault
beamGrouping
Subtype
Basexsd:int
SubsetMinimum: "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.
"3"
tempo
List (string of elements separated by space)
Elements
Subtype
Basexsd:decimal
SubsetMinimum: "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.
"120.0"
justifiedxsd:boolean "false"
justifiedSinglexsd:boolean
*** New in capella 7.0
Substitute for "justified" in singlePart layout. If missing, "justified" value is used (see layout singlePart for details).
"false"
pageBreakxsd:boolean "false"
pageBreakSinglexsd:boolean
*** New in capella 7.0
Substitute for "pageBreak" in singlePart layout. If missing, "pageBreak" value is used (see layout singlePart for details).
"false"
instrNotation
Subtype
Basexsd:string
Subset"none"
"short"
"long"

Specifies whether the the long/short/no instrument names (defined in the score layout) are shown.
"none"
leftIndentxsd:int
Left indentation in note line gaps; default value means automatic.
"-1"
leftIndentSinglexsd:int
*** New in capella 7.0
Substitute for "leftIndent" in singlePart layout. If missing, "leftIndent" value is used (see layout singlePart for details).
"-1"
rightIndentxsd:int
*** New in capella 2008:
Right indentation in note line gaps.
If the justified attribute is false, this value is ignored.
"0"
rightIndentSinglexsd:int
*** New in capella 7.0
Substitute for "rightIndent" in singlePart layout. If missing, "rightIndent" value is used (see layout singlePart for details).
"0"
bracketColorColor "000000"
Elements
NameTypeOccurrence
barCount
modifications of the automatic bar numbering defined in the Score type.
Complex Type
Attributes
NameTypeDefault
nAddxsd:int
Additional offset to the number of bars (positive or negative number). This changes the bar count shown in this system and all following systems.
"0"
resetxsd:boolean
if true: resets the bar count to 1 at the beginning of the system (count 1 is not displayed).
"false"
0 ... 1
stavesStaves1

Staves

Complex Type
Elements
NameTypeOccurrence
staffStaff1 ...

Staff

A staff inherits the properties defined in the corresponding staff layout.
The staff layouts are located at score/layout/staves.
Complex Type
Attributes
NameTypeDefault
layoutxsd:string
Refers to the staff layout with matching description attribute.
required
lineColorColor "000000"
defaultTimeTime required
onlySinglexsd:boolean
*** New in capella 7.0
Staff has been inserted only for singlePart layout and is to be removed in whole score layout.
"false"
Elements
NameTypeOccurrence
extraDistance
these values are added to the distances given in the staff layout
Complex Type
Attributes
NameTypeDefault
topGap "0"
bottomGap "0"
0 ... 1
voicesVoices1

Voices

A sequence of Voice elements (the voices of the staff). Maximum: six voices.
Complex Type
Elements
NameTypeOccurrence
voiceVoice1 ... 6

Voice

A sequence of note objects.
Complex Type
Attributes
NameTypeDefault
stemDirVerticalDir
General stem direction. Exceptions may be defined with each Chord element.
"none"
Elements
NameTypeOccurrence
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
Attributes
NameTypeDefault
firstLineGap2
Position of the first lyrics verse
required
lineDistGap2
Distance between lyrics verses
required
Elements
NameTypeOccurrence
fontFont1 ...
1
noteObjectsNoteObjects1

NoteObjects

Complex Type
Elements
NameTypeOccurrence
Choice
NameTypeOccurrence
clefSignClefSign1
keySignKeySign1
timeSignTimeSign1
barlineExplicitBarline1
chordChord1
restRest1
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
Attributes
NameTypeDefault
count
Subtype
Basexsd:int
SubsetMinimum: "2"
Maximum: "15"
""
tripartitexsd:boolean "false"
prolongxsd:boolean "false"

Verse

Text and alignment data for a lyrics syllable in one verse.
Complex Type
Attributes
NameTypeDefault
ixsd:int required
align
Subtype
BaseHorizAlign
Subset"left"
"center"
"center"
extenderxsd:boolean "false"
hyphenxsd:boolean "false"
verseNumberxsd:string ""
extentControlxsd:boolean
*** New in capella 7:
Don't care for overwriting next syllable
"true"
melismsxsd:boolean
*** New in capella 8.0.7:
Start melism hyphens up to next non empty syllable
"false"
Contentxsd:string

Lyric

Complex Type
Attributes
NameTypeDefault
langLanguage
not yet used in capella 5.1
"neutral"
Elements
NameTypeOccurrence
verseVerse1 ...
translation
for future use
Complex Type
Attributes
NameTypeDefault
langLanguage required
Elements
NameTypeOccurrence
verseVerse1 ...
0 ...

Heads

capella will evaluate at most 15 heads.
Complex Type
Elements
NameTypeOccurrence
headHead1 ... 15

Head

Complex Type
Attributes
NameTypeDefault
pitch
Subtype
Basexsd:string
SubsetRegular Expression: "[A-G][0-9]"
absolute diatonic pitch
middle C (c'): "C5"
required
silentxsd:boolean "false"
shape
Subtype
Basexsd: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"
"auto"
otherSidexsd:boolean
*** 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.
"false"
Elements
NameTypeOccurrence
alter
Alteration (usually displayed by an accidental)
Complex Type
Attributes
NameTypeDefault
step
Subtype
Basexsd:decimal
SubsetMinimum: "-2.5"
Maximum: "2.5"

*** new in capella 8.0:
Decimal values allowed. For future use.
"0"
display
Subtype
Basexsd: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
"auto"
xShiftGap4 "0"
0 ... 1
tie
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
Attributes
NameTypeDefault
beginxsd:boolean "false"
endxsd:boolean "false"
explicitOrientationVerticalDir
*** 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.
"none"
shape
Subtype
Basexsd:string
Subset"normal"
"dashed"
"dotted"

*** New in capella 8.0.8
Specifies tie shape.
"normal"
0 ... 1

Duration

Complex Type
Attributes
NameTypeDefault
base
Subtype
Basexsd:string
SubsetRegular 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)
required
dots
Subtype
Basexsd:int
SubsetMinimum: "0"
Maximum: "3"
*** New in capella 2008: 3 dots possible.
"0"
noDurationxsd:boolean "false"
Elements
NameTypeOccurrence
tupletTuplet0 ... 1

Rest

Complex Type
Attributes
NameTypeDefault
tempo
List (string of elements separated by space)
Elements
Subtype
Basexsd:decimal
SubsetMinimum: "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
""
Elements
NameTypeOccurrence
durationDuration1
display
If no display element is present, full measure rests will be displayed in churchStyle if they are no longer than 2 measures.
Complex Type
Attributes
NameTypeDefault
colorColor "000000"
smallxsd:boolean "false"
postGracexsd:boolean "false"
invisiblexsd:boolean "false"
dotsInvisiblexsd:boolean "false"
xShiftGap4 "0"
fillerxsd:boolean
*** 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.
"false"
onlySinglexsd:boolean
*** 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.
"false"
churchStylexsd:boolean
applies only to full measure rests
"false"
numberVerticalDir
applies only to full measure rests
"none"
widthBarStyleGap
*** New in capella 8.0.7
Evaluated only for full measure rests in bar style: Width of the rest bar
"6"
stemUnderBeam
Subtype
Basexsd: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
"auto"
0 ... 1
verticalPos
Complex Type
Attributes
NameTypeDefault
centeredxsd:boolean "false"
shiftGap "0"
0 ... 1
beam
*** 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
Attributes
NameTypeDefault
group
Subtype
Basexsd: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.
"auto"
shiftGap2
parallel shift relative to the precalculated beam.
"0"
gradientGap2
gradient change relative to the precalculated beam.
"0"
0 ... 1
drawObjectsDrawObjects0 ... 1

Chord

Complex Type
Attributes
NameTypeDefault
tempo
List (string of elements separated by space)
Elements
Subtype
Basexsd:decimal
SubsetMinimum: "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
""
Elements
NameTypeOccurrence
durationDuration1
display
Complex Type
Attributes
NameTypeDefault
colorColor "000000"
notationStaffVerticalDir
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.
"none"
smallxsd:boolean "false"
postGracexsd:boolean "false"
invisiblexsd:boolean "false"
dotsInvisiblexsd:boolean
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.
"false"
xShiftGap4
*** 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.
"0"
noAutoXShiftxsd:boolean
*** 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.
"false"
0 ... 1
stem
Complex Type
Attributes
NameTypeDefault
dirVerticalDir "none"
invisiblexsd:boolean "false"
lengtheningGap2 "0"
tremoloBars
Subtype
Basexsd:int
SubsetMinimum: "0"
Maximum: "5"
"0"
0 ... 1
beam
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
Attributes
NameTypeDefault
group
Subtype
Basexsd: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.
"auto"
shiftGap2
parallel shift relative to the precalculated beam.
"0"
gradientGap2
gradient change relative to the precalculated beam.
"0"
0 ... 1
articulation
Complex Type
Attributes
NameTypeDefault
type
List (string of elements separated by space)
Elements
Subtype
Basexsd:string
Subset"staccato"
"tenuto"
"staccatissimo"
"normalAccent"
"strongAccent"
"weakBeat"
"strongBeat"
currently single articulation or "staccato tenuto"
required
0 ... 1
lyricLyric0 ... 1
drawObjectsDrawObjects0 ... 1
headsHeads1

ExplicitBarline

*** New in capella 7.0: Can have drawobjects
Complex Type
Attributes
NameTypeDefault
type
Subtype
Basexsd:string
Subset"single"
"double"
"end"
"repEnd"
"repBegin"
"repEndBegin"
"dashed"
*** New in capella 2008: "dashed"
"single"
range
Subtype
Basexsd:string
Subset"auto"
"internal"
"full"
"auto"
colorColor "000000"
Elements
NameTypeOccurrence
drawObjectsDrawObjects0 ... 1

ClefSign

Complex Type
Attributes
NameTypeDefault
clefClef required
colorColor "000000"
invisiblexsd:boolean
*** 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.
"false"

KeySign

Complex Type
Attributes
NameTypeDefault
fifths
Subtype
Basexsd:int
SubsetMinimum: "-7"
Maximum: "7"
required
colorColor "000000"

TimeSign

Complex Type
Attributes
NameTypeDefault
timeTime required
colorColor "000000"
spaceGap4
*** New in capella 7.1-13
Space to be reserved, for use with invisible or infinite signatures. Default value means automatic.
"-1"
invisiblexsd:boolean
*** New in capella 7.1-13
"false"

Brackets

Complex Type
Elements
NameTypeOccurrence
bracket
Complex Type
Attributes
NameTypeDefault
fromxsd:int required
toxsd:int required
curlyxsd:boolean "false"
1 ...

Font

corresponding to the Windows API structure LOGFONT
Complex Type
Attributes
NameTypeDefault
facexsd:string required
heightxsd:decimal required
widthxsd:decimal "0"
weightxsd:int
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
"400"
italicxsd:boolean "false"
underlinexsd:boolean "false"
strikeOutxsd:boolean "false"
charSetxsd:int
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
"0"
pitchAndFamilyxsd:int
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
"18"
colorColor "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
Elements
NameTypeOccurrence
drawObj
Complex Type
Elements
NameTypeOccurrence
basicBasicDrawObj0 ... 1
1 ...

TranspObjects

DrawObjects with a reference note
Complex Type
Attributes
NameTypeDefault
baseEnharmonicNote required
Elements
NameTypeOccurrence
drawObj
Complex Type
Attributes
NameTypeDefault
baseEnharmonicNote required
Elements
NameTypeOccurrence
  DrawObject 1...
basicBasicDrawObj0 ... 1
1 ...

GalleryObjs

DrawObjects with a name
Complex Type
Elements
NameTypeOccurrence
drawObj
Complex Type
Attributes
NameTypeDefault
namexsd:string ""
Elements
NameTypeOccurrence
  DrawObject 1...
basicBasicDrawObj0 ... 1
1 ...

Info

*** New in capella 7.0: encodingSoftware
Complex Type
Elements
NameTypeOccurrence
encodingSoftwarexsd:string0 ... 1
authorxsd:string0 ... 1
keywordsxsd:string0 ... 1
commentxsd:string0 ... 1

Layout

Complex Type
Attributes
NameTypeDefault
singlePartxsd:boolean
*** 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.
"false"
Elements
NameTypeOccurrence
pagesPages1 ... 2
distances
Complex Type
Elements
NameTypeOccurrence
staffLines
Complex Type
Attributes
NameTypeDefault
smallMillimeter required
normalMillimeter required
smallSingleMillimeter
*** New in capella 7.0: Separate value for singlePart layout (see layout singlePart for details).
""
normalSingleMillimeter
*** New in capella 7.0: Separate value for singlePart layout (see layout singlePart for details).
""
pageObjMillimeter "1.8"
1
systems
Complex Type
Attributes
NameTypeDefault
topGap required
betweenGap required
topSingleGap
*** New in capella 7.0: Separate value for singlePart layout (see layout singlePart for details).
""
betweenSingleGap
*** New in capella 7.0: Separate value for singlePart layout (see layout singlePart for details).
""
pageJustified
Subtype
Basexsd:string
Subset"none"
"exceptLast"
"all"
"none"
1
1
instrumentNames
Complex Type
Attributes
NameTypeDefault
alignHorizAlign "center"
Elements
NameTypeOccurrence
fontFont1
0 ... 1
style
Complex Type
Attributes
NameTypeDefault
fontFacexsd:string
*** New in capella 8.0
Symbol font for musical symbols used in note objects
required
SMuFLxsd:boolean
*** New in capella 8.0
Font specified in fontFace complies to the SMuFL specification (see http://www.smufl.org/)
"false"
modernKeyChangexsd:boolean
Show new keys without redundant naturals
"true"
modernBrevexsd:boolean
Display double notes in modern style (whole note between verticla lines) instead of mensural notation.
"true"
maySkipHyphensxsd:boolean
*** New in capella 8.0.8:
Do not show hyphens between lyrics syllables, if this would save space.
"false"
legacyOctaveSignxsd:boolean
*** New in capella 8.0.7:
Show eventual octave signs in a larger font, typical for capella prior to version 7.1-13.
"false"
legacyNoteSpacingxsd:boolean
*** New in capella 8.0.7:
Use same spacing for normal as for dotted notes and rests, like capella up to version 7.1
"false"
lyricsExtenderNoWrapxsd:boolean
*** 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
"false"
noCollisionManagementxsd:boolean
*** 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
"false"
melismDistGap
*** New in capella 8.0.7:
Desired Distance for melism hyphens
"10"
Elements
NameTypeOccurrence
noteSpaces
*** New in capella 8.0
Complex Type
Attributes
NameTypeDefault
firstNoteGap32 ""
leftBarlineGap32 ""
rightBarlineGap32 ""
1
widths
*** New in capella 8.0
Complex Type
Attributes
NameTypeDefault
head0Gap256 ""
head1Gap256 ""
head2Gap256 ""
head4Gap256 ""
stemGap256 ""
notelineGap256 ""
barlineGap256 ""
legerLineJutGap256 ""
1
stemTouch
*** New in capella 8.0
Complex Type
Attributes
NameTypeDefault
xDown2Gap256 ""
xDown4Gap256 ""
yDown2Gap256 ""
yDown4Gap256 ""
xUp2Gap256 ""
xUp4Gap256 ""
yUp2Gap256 ""
yUp4Gap256 ""
1
bracketShape
*** New in capella 8.0
Complex Type
Attributes
NameTypeDefault
dxGap32 ""
dyGap32 ""
widthGap32 ""
hasEndsxsd:boolean ""
x1Gap32 ""
y1Gap32 ""
x2Gap32 ""
y2Gap32 ""
x3Gap32 ""
y3Gap32 ""
x4Gap32 ""
y4Gap32 ""
x5Gap32 ""
y5Gap32 ""
x6Gap32 ""
y6Gap32 ""
x7Gap32 ""
y7Gap32 ""
1
slurShape
*** New in capella 8.0.8
If present, the following elements specify the score's default shape of slurs.
Complex Type
Attributes
NameTypeDefault
mayMoveTowardsHeadxsd:boolean
*** New in capella 8.0.8
"false"
Elements
NameTypeOccurrence
normalSlurTieShape0 ... 1
dashedSlurTieShape0 ... 1
dottedSlurTieShape0 ... 1
0 ... 1
tieShape
*** New in capella 8.0.8
If present, the following elements specify the score's shape of ties.
Complex Type
Elements
NameTypeOccurrence
normalSlurTieShape0 ... 1
dashedSlurTieShape0 ... 1
dottedSlurTieShape0 ... 1
0 ... 1
0 ... 1
staves
Complex Type
Elements
NameTypeOccurrence
staffLayoutStaffLayout1 ...
1
bracketsBrackets0 ... 1
spacing
Complex Type
Attributes
NameTypeDefault
relxsd:int ""
absxsd:int ""
useRealSizexsd:boolean "true"
allowCompressionxsd:boolean "false"
useLyricsSizexsd:boolean "true"
0 ... 1
beamFlattening
Complex Type
Attributes
NameTypeDefault
fromxsd:int required
toxsd:int required
fromMaxxsd:int required
toMaxxsd:int required
0 ... 1

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
Attributes
NameTypeDefault
firstxsd:int "1"
landscapexsd:boolean "false"
evenxsd:boolean "false"
leftMillimeter required
topMillimeter required
rightMillimeter required
bottomMillimeter required
paperSizePaperNorm
*** 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.
""
paperSizeXMillimeter
*** New in capella 7.0
""
paperSizeYMillimeter
*** New in capella 7.0
""

StaffLayout

Complex Type
Attributes
NameTypeDefault
descriptionxsd:string
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.
required
Elements
NameTypeOccurrence
notation
Complex Type
Attributes
NameTypeDefault
suppressSinglexsd:boolean
*** New in capella 7.0: Suppress staff in singlePart layout
"false"
suppressSingleVoices
Subtype
Basexsd:string
SubsetRegular Expression: "[1-6]+"
*** New in capella 7.0
Voice indices to suppress, base 1
""
defaultClefClef required
notelinesNotelines "5"
Elements
NameTypeOccurrence
barlines
Complex Type
Attributes
NameTypeDefault
mode
Subtype
Basexsd:string
Subset"full"
"none"
"internal"
"external"
"full"
fromxsd:int required
toxsd:int required
1
1
distances
Complex Type
Attributes
NameTypeDefault
lineDist
Subtype
Basexsd:string
Subset"normal"
"small"
"normal"
topGap required
bottomGap required
groupGap "0"
1
instrument
*** 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
Attributes
NameTypeDefault
namexsd:string required
abbrevxsd:string required
pairNamexsd:string ""
pairAbbrevxsd:string ""
Elements
NameTypeOccurrence
namexsd:string1
abbrevxsd:string1
pairNamexsd:string0 ... 1
pairAbbrevxsd:string0 ... 1
1
sound
*** 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
Attributes
NameTypeDefault
percussionxsd:boolean "false"
instrMidiNumber required
volumeMidiNumber required
panorama
Subtype
Basexsd:int
SubsetMinimum: "-64"
Maximum: "63"
"0"
transposexsd:int "0"
devicexsd:string ""
samplexsd:string ""
genericSoundxsd:string ""
DataIDxsd: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
Basexsd:int
SubsetMinimum: "0"
Maximum: "16"

Value 0 means automatic channel setting.
"0"
Elements
NameTypeOccurrence
entryAssignmentSoundMap0 ... 1
outputAssignmentSoundMap0 ... 1
1 ... 6

SoundMap

Complex Type
Elements
NameTypeOccurrence
map
*** 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
Attributes
NameTypeDefault
from
Subtype
Basexsd:int
SubsetMinimum: "0"
Maximum: "127"
required
to
Subtype
Basexsd:int
SubsetMinimum: "0"
Maximum: "127"
required
devicexsd:string ""
samplexsd:string ""
genericSoundxsd:string ""
instrxsd:int ""
midipitchxsd:int "-1"
1 ...

BasicDrawObj

Common properties of all draw objects.
Complex Type
Attributes
NameTypeDefault
behindNotesxsd:boolean "false"
firstPagexsd:boolean
applies only to objects anchored to page
"true"
oddPagesExceptFirstxsd:boolean
applies only to objects anchored to page
"true"
evenPagesxsd:boolean
applies only to objects anchored to page
"true"
noteRangexsd:int
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.
"0"
noAdjustxsd:boolean
*** 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
"false"
continuedxsd:boolean
*** 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
"false"
drawNormalxsd:boolean
*** 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
"false"
scopeDrawObjScope
*** 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
"voice"
horizAlign
Subtype
Basexsd:int
SubsetMinimum: "0"
Maximum: "1"

applies only to objects anchored to chords/rests
0=head, 1=stem
"0"
vertAlign
Subtype
Basexsd:int
SubsetMinimum: "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
"0"
minDistY
Subtype
BaseGap2
SubsetMinimum: "0"
Maximum: "8"

*** New in capella 7.0
Minimal distance to middle note line
"0"
visibilityFlags
Subtype
Basexsd:int
SubsetMinimum: "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.
"127"
onlySinglexsd:boolean
*** 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.
"false"
tag
Subtype
Basexsd:string
SubsetRegular 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
"0-0"

Guitar

Complex Type
Attributes
NameTypeDefault
xGap32 required
yGap32 required
frets
Subtype
Basexsd:int
SubsetMinimum: "3"
Maximum: "8"
"4"
thickNutxsd:boolean "false"
openStringsxsd:boolean "false"
verticalxsd:boolean "true"
stringDist
Subtype
BaseGap4
Subset"0.5"
"0.75"
"1"
"0.75"
fretDist
Subtype
Basexsd:decimal
Subset"1"
"1.5"
"2"
relative to stringDist
Example: stringDist="0.75" fretDist="1.5" means fret distance = 1.125 staffline distances
"1"
strings
Subtype
Basexsd:string
SubsetRegular Expression: "[/0-9]{3,8}"
required
colorColor "000000"

Metafile

Complex Type
Attributes
NameTypeDefault
filexsd:string required
xGap32 required
yGap32 required
widthGap32 required
heightGap32 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
Attributes
NameTypeDefault
filexsd:string required
xGap32 required
yGap32 required
widthGap32 required
heightGap32 required

Svg

*** New in capella 8.0
Describes a vector image in svg format. Accepted filename extensions are .svg, .svgz.
Complex Type
Attributes
NameTypeDefault
filexsd:string required
xGap32 required
yGap32 required
widthGap32 required
heightGap32 required

Polygon

Complex Type
Attributes
NameTypeDefault
filledxsd:boolean "false"
fillColorColor "000000"
lineWidthGap10 "0.1"
lineColorColor "000000"
Elements
NameTypeOccurrence
points
Complex Type
Elements
NameTypeOccurrence
point
Complex Type
Attributes
NameTypeDefault
xGap32 required
yGap32 required
1 ...
1

Slur

Complex Type
Attributes
NameTypeDefault
x1Gap32 required
y1Gap32 required
x2Gap32 required
y2Gap32 required
x3Gap32 required
y3Gap32 required
x4Gap32 required
y4Gap32 required
colorColor "000000"
shape
Subtype
Basexsd: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.
"normal"
Elements
NameTypeOccurrence
formSlurTieShape0 ... 1

RichText

Complex Type
Attributes
NameTypeDefault
filexsd:string required
fileHtmlxsd:string ""
textFormatTextFormat
*** 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".
"rtf"
xGap32 required
yGap32 required
widthGap32 required

Rectangle

Complex Type
Attributes
NameTypeDefault
radiusGap32 "0"
lineWidthGap10 "0.1"
lineColorColor "000000"
filledxsd:boolean "false"
fillColorColor "000000"
x1Gap32 required
y1Gap32 required
x2Gap32 required
y2Gap32 required

Ellipse

Complex Type
Attributes
NameTypeDefault
lineWidthGap10 "0.1"
lineColorColor "000000"
filledxsd:boolean "false"
fillColorColor "000000"
x1Gap32 required
y1Gap32 required
x2Gap32 required
y2Gap32 required

LineObj

Complex Type
Attributes
NameTypeDefault
x1Gap32 required
y1Gap32 required
x2Gap32 required
y2Gap32 required
lineWidthGap10 "0.1"
colorColor "000000"

SlurTieShape

Complex Type
Attributes
NameTypeDefault
endWidthGap32 "0"
midWidthGap32 "0.1875"
dotDistGap32 "0"
dotWidth
Subtype
Basexsd:decimal
SubsetMinimum: "0"
Maximum: "1"
relative to dotDist ("1" means solid)
"1"

TupletBracket

Complex Type
Attributes
NameTypeDefault
x1Gap32 required
y1Gap32 required
x2Gap32 required
y2Gap32 required
colorColor "000000"
lineWidthGap10 "0.1"
orientationVerticalDir "none"
number
Subtype
Basexsd:string
SubsetRegular Expression: "(0|[2-9]|1[0-5])"
0 (means no number) or 2 to 15
"0"

Wedge

Complex Type
Attributes
NameTypeDefault
x1Gap32 required
y1Gap32 required
x2Gap32 required
y2Gap32 required
colorColor "000000"
lineWidthGap10 "0.1"
spanGap32 "1"
decrescendoxsd:boolean "false"

NotelinesObj

Complex Type
Attributes
NameTypeDefault
x1Gap32 required
x2Gap32 required
yGap32 required
linesNotelines "5"
colorColor "000000"

Volta

Complex Type
Attributes
NameTypeDefault
x1Gap32 required
x2Gap32 required
yGap32 required
colorColor "000000"
leftBentxsd:boolean "true"
rightBentxsd:boolean "true"
upBentxsd:boolean "false"
dottedxsd:boolean "false"
firstNumberxsd:int
0 means no number
"0"
lastNumberxsd:int "0"
allNumbersxsd:boolean "false"

OctaveClef

*** New in capella 7.0
Complex Type
Attributes
NameTypeDefault
x1Gap32 required
x2Gap32 required
yGap32 required
colorColor "000000"
octave
Subtype
Basexsd:int
Subset"-2"
"-1"
"1"
"2"
"1"
onlyNumberxsd:boolean "false"
courtesyRepeatxsd:boolean "true"

Trill

Complex Type
Attributes
NameTypeDefault
x1Gap32 required
x2Gap32 required
yGap32 required
colorColor "000000"
trxsd:boolean "true"

WavyLine

Complex Type
Attributes
NameTypeDefault
x1Gap32 required
y1Gap32 required
x2Gap32 required
y2Gap32 required
colorColor "000000"
waveLenGap32 "1"
fullWavesxsd:boolean "true"

Text

Complex Type
Attributes
NameTypeDefault
xGap32 required
yGap32 required
alignHorizAlign "left"
frameFrameType
*** New in capella 7.0
"none"
frameDistanceGap32
*** New in capella 7.0
"0"
radiusGap32
*** New in capella 7.0
"0"
Elements
NameTypeOccurrence
fontFont1
contentxsd:string1

Group Types

DrawObject

Group Type
Choice
NameTypeOccurrence
lineLineObj1
rectangleRectangle1
ellipseEllipse1
polygonPolygon1
metafileMetafile1
pixmapPixmap1
svgSvg1
textText1
richTextRichText1
guitarGuitar1
slurSlur1
wavyLineWavyLine1
bracketTupletBracket1
wedgeWedge1
notelinesNotelinesObj1
voltaVolta1
octaveClefOctaveClef1
trillTrill1
transposableTranspObjects1
groupDrawObjects1
1...

Simple Types

Language

Subtype
Basexsd:string
SubsetRegular 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
Basexsd:decimal
Subsetno restriction (provided for documentation only)
Absolute measure in millimeters.
capella uses up to two decimals. Other values will be rounded.

Gap

Subtype
Basexsd:int
Subsetno restriction (provided for documentation only)
Staffline distance

Gap10

Subtype
Basexsd:decimal
Subsetno restriction (provided for documentation only)
Staffline distance. capella uses multiples of .1 = 1/10. Other values will be rounded.

Gap2

Subtype
Basexsd:decimal
Subsetno restriction (provided for documentation only)
Staffline distance. capella uses multiples of .5 = 1/2. Other values will be rounded.

Gap4

Subtype
Basexsd:decimal
Subsetno restriction (provided for documentation only)
Staffline distance. capella uses multiples of .25 = 1/4. Other values will be rounded.

Gap32

Subtype
Basexsd:decimal
Subsetno restriction (provided for documentation only)
Staffline distance. capella uses multiples of .03125 = 1/32. Other values will be rounded.

Gap256

Subtype
Basexsd:decimal
Subsetno restriction (provided for documentation only)
Staffline distance. capella uses multiples of .00390625 = 1/256. Other values will be rounded.

HorizAlign

Subtype
Basexsd:string
Subset"left"
"center"
"right"

VerticalDir

Subtype
Basexsd:string
Subset"none"
"up"
"down"

MidiNumber

Subtype
Basexsd:int
SubsetMinimum: "0"
Maximum: "127"

Color

Subtype
Basexsd:hexBinary
SubsetLength: "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
Basexsd:string
Subset"rectangle"
"ellipse"
"circle"
"none"
*** New in capella 7.0

TextFormat

Subtype
Basexsd:string
Subset"rtf"
"html"
*** New in capella 8.0

Clef

Subtype
Basexsd:string
SubsetRegular 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
Basexsd:string
SubsetRegular 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
Basexsd:string
SubsetRegular Expression: "5|1|([_\|:]{11})"
allowed values:
  • "5" = normal stafflines (default)
  • "1" = single line staff
  • or general notation: string of length 11 containing '_', '|', ':'
examples:
  • "___|||||___" = normal stafflines (equivalent to "5")
  • "_____|_____" = single-line staff (equivalent to "1")
  • "__:|||||___" = normal stafflines, dashed helplines below

EnharmonicNote

Subtype
Basexsd:string
SubsetRegular 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
Basexsd:string
Subset"A4"
"B4"
"A5"
"B5"
"A3"
"Letter"
"Legal"
"Tabloid"
*** New in capella 7.0

DrawObjScope

Subtype
Basexsd:string
Subset"voice"
"staff"
"brace"
"bracket"
"system"
*** New in capella 7.0