CapXML 2.0 File Format
Version 2.0.3 (2013-05-24)
Copyright © 2011 capella-software AG
CapXML 2.0.3 is used in capella 7.1
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 Gap32 Gap4 Guitar Head Heads HorizAlign Info KeySign Language Layout LineObj Lyric Metafile MidiNumber Millimeter NoteObjects Notelines NotelinesObj OctaveClef Pages PaperNorm Polygon Rectangle Rest RichText Score Slur SoundMap Staff StaffLayout Staves System Systems Text 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 Polygon Rectangle Rest RichText Score Slur SoundMap Staff StaffLayout Staves 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 Gap32 Gap4 HorizAlign Language MidiNumber Millimeter Notelines PaperNorm Time VerticalDir
Root Element
Complex Types
Score
Complex Type |
Elements |
Name | Type | Occurrence |
info | Info | 1 |
layout | Layout | 1 |
gallery | GalleryObjs | 0 ... 1 |
pageObjects | DrawObjects | 0 ... 1 |
barCount |
determines if and how bars numbers are shown at the beginning of the systems.
|
Complex Type |
Attributes |
Name | Type | Default |
atSystems | xsd:boolean
show bar number at each system
|
|
"true" |
frame |
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.
|
|
"0" |
x | Gap2
horizontal position of the bar number relative to the left upper corner of the system.
|
|
required |
y | Gap2
vertical position of the bar number relative to the left upper corner of the system.
|
|
required |
barInterval | xsd:int
*** New in capella 2008:
If > 0: Show bar number at each bar divisible by barInterval.
|
|
"0" |
lineWidth | Gap10
*** New in capella 2008:
Line width for bar-number frames.
|
|
"0.1" |
lineColor | Color
*** New in capella 2008:
Line color for bar-number frames.
|
|
"000000" |
filled | xsd:boolean
*** New in capella 2008:
Specifies wether to fill the bar-number frames.
|
|
"false" |
fillColor | Color
*** New in capella 2008:
Fill color for bar-number frames (if filled).
|
|
"FFFFFF" |
fillOpacity | xsd: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 |
Name | Type | Occurrence |
font | Font | 1 |
|
| 0 ... 1 |
systems | Systems | 1 |
|
Systems
contains a sequence of system elements representing consecutive parts of music.
|
Complex Type |
Elements |
Name | Type | Occurrence |
system | System | 1 ... |
|
System
Complex Type |
Attributes |
Name | Type | Default |
beamGrouping |
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.
|
|
"3" |
tempo |
List (string of elements separated by space) |
Elements |
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.
Example: "80 0 84.3" means first playback with 80.0 quarters per minute,
second playback (first repetition) unchanged,
second repetition 84.3
|
|
"120.0" |
justified | xsd:boolean |
"false" |
justifiedSingle | xsd:boolean
*** New in capella 7.0
Substitute for "justified" in singlePart layout. If missing, "justified" value is used.
|
|
"false" |
pageBreak | xsd:boolean |
"false" |
pageBreakSingle | xsd:boolean
*** New in capella 7.0
Substitute for "pageBreak" in singlePart layout. If missing, "pageBreak" value is used.
|
|
"false" |
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.
|
|
"none" |
leftIndent | xsd:int
Left indentation in note line gaps; default value means automatic.
|
|
"-1" |
leftIndentSingle | xsd:int
*** New in capella 7.0
Substitute for "leftIndent" in singlePart layout. If missing, "leftIndent" value is used.
|
|
"-1" |
rightIndent | xsd:int
*** New in capella 2008:
Right indentation in note line gaps.
If the justified attribute is false, this value is ignored.
|
|
"0" |
rightIndentSingle | xsd:int
*** New in capella 7.0
Substitute for "rightIndent" in singlePart layout. If missing, "rightIndent" value is used.
|
|
"0" |
bracketColor | Color |
"000000" |
|
Elements |
Name | Type | Occurrence |
barCount |
modifications of the automatic bar numbering defined in the Score type.
|
Complex Type |
Attributes |
Name | Type | Default |
nAdd | xsd: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" |
reset | xsd:boolean
if true: resets the bar count to 1 at the beginning of the system (count 1 is not displayed).
|
|
"false" |
|
| 0 ... 1 |
staves | Staves | 1 |
|
Staves
Complex Type |
Elements |
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 |
Attributes |
Name | Type | Default |
layout | xsd:string
Refers to the staff layout with matching description attribute.
|
|
required |
lineColor | Color |
"000000" |
defaultTime | Time |
required |
onlySingle | xsd:boolean
*** New in capella 7.0
Must be displayed only in singlePart layout. Is to be removed in whole score layout.
|
|
"false" |
|
Elements |
Name | Type | Occurrence |
extraDistance |
these values are added to the distances given in the staff layout
|
Complex Type |
Attributes |
Name | Type | Default |
top | Gap |
"0" |
bottom | Gap |
"0" |
|
| 0 ... 1 |
voices | Voices | 1 |
|
Voices
A sequence of Voice elements (the voices of the staff). Maximum: six voices.
|
Complex Type |
Elements |
Name | Type | Occurrence |
voice | Voice | 1 ... 6 |
|
Voice
A sequence of note objects.
|
Complex Type |
Attributes |
Name | Type | Default |
stemDir | VerticalDir
General stem direction. Exceptions may be defined with each Chord element.
|
|
"none" |
|
Elements |
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.
|
Complex Type |
Attributes |
Name | Type | Default |
firstLine | Gap2
Position of the first lyrics verse
|
|
required |
lineDist | Gap2
Distance between lyrics verses
|
|
required |
|
Elements |
Name | Type | Occurrence |
font | Font | 1 ... |
|
| 1 |
noteObjects | NoteObjects | 1 |
|
NoteObjects
Complex Type |
Elements |
Name | Type | Occurrence |
Choice |
| 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 |
|
Complex Type |
Attributes |
Name | Type | Default |
count |
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 |
Attributes |
Name | Type | Default |
i | xsd:int |
required |
align |
|
"center" |
extender | xsd:boolean |
"false" |
hyphen | xsd:boolean |
"false" |
verseNumber | xsd:string |
"" |
|
Content | xsd:string |
Lyric
Complex Type |
Attributes |
Name | Type | Default |
lang | Language
not yet used in capella 5.1
|
|
"neutral" |
|
Elements |
Name | Type | Occurrence |
verse | Verse | 1 ... |
translation |
Complex Type |
Attributes |
|
Elements |
Name | Type | Occurrence |
verse | Verse | 1 ... |
|
| 0 ... |
|
Heads
Complex Type |
Elements |
Name | Type | Occurrence |
head | Head | 1 ... |
|
Head
Complex Type |
Attributes |
Name | Type | Default |
pitch |
Subtype |
Base | xsd:string | Subset | Regular _expression_: "[A-G][0-9]"
|
absolute diatonic pitch
middle C (c'): "C5"
|
|
required |
silent | xsd:boolean |
"false" |
shape |
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"
|
|
"auto" |
|
Elements |
Name | Type | Occurrence |
alter |
Alteration (usually displayed by an accidental)
|
Complex Type |
Attributes |
Name | Type | Default |
step |
Subtype |
Base | xsd:int | Subset | Minimum: "-2" Maximum: "2"
|
|
"0" |
display |
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
|
|
"auto" |
xShift | Gap4 |
"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 |
Name | Type | Default |
begin | xsd:boolean |
"false" |
end | xsd:boolean |
"false" |
explicitOrientation | VerticalDir
*** 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" |
|
| 0 ... 1 |
|
Duration
Complex Type |
Attributes |
Name | Type | Default |
base |
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)
|
|
required |
dots |
Subtype |
Base | xsd:int | Subset | Minimum: "0" Maximum: "3"
|
*** New in capella 2008: 3 dots possible.
|
|
"0" |
noDuration | xsd:boolean |
"false" |
|
Elements |
Name | Type | Occurrence |
tuplet | Tuplet | 0 ... 1 |
|
Rest
Complex Type |
Attributes |
Name | Type | Default |
tempo |
List (string of elements separated by space) |
Elements |
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.
Example: "80 0 84.3" means first playback with 80.0 quarters per minute,
second playback (first repetition) unchanged,
second repetition 84.3
|
|
"" |
|
Elements |
Name | Type | Occurrence |
duration | Duration | 1 |
display |
Complex Type |
Attributes |
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 | xsd: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" |
onlySingle | xsd: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" |
churchStyle | xsd:boolean
applies only to full measure rests
|
|
"false" |
number | VerticalDir
applies only to full measure rests
|
|
"none" |
|
| 0 ... 1 |
verticalPos |
Complex Type |
Attributes |
Name | Type | Default |
centered | xsd:boolean |
"false" |
shift | Gap |
"0" |
|
| 0 ... 1 |
drawObjects | DrawObjects | 0 ... 1 |
|
Chord
Complex Type |
Attributes |
Name | Type | Default |
tempo |
List (string of elements separated by space) |
Elements |
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.
Example: "80 0 84.3" means first playback with 80.0 quarters per minute,
second playback (first repetition) unchanged,
second repetition 84.3
|
|
"" |
|
Elements |
Name | Type | Occurrence |
duration | Duration | 1 |
display |
Complex Type |
Attributes |
Name | Type | Default |
color | Color |
"000000" |
notationStaff | VerticalDir
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" |
small | xsd:boolean |
"false" |
postGrace | xsd:boolean |
"false" |
invisible | xsd:boolean |
"false" |
dotsInvisible | xsd: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" |
xShift | Gap4 |
"0" |
|
| 0 ... 1 |
stem |
Complex Type |
Attributes |
Name | Type | Default |
dir | VerticalDir |
"none" |
invisible | xsd:boolean |
"false" |
lengthening | Gap2 |
"0" |
tremoloBars |
Subtype |
Base | xsd:int | Subset | Minimum: "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 .
|
Complex Type |
Attributes |
Name | Type | Default |
group |
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.
|
|
"auto" |
shift | Gap2
parallel shift relative to the precalculated beam.
|
|
"0" |
gradient | Gap2
gradient change relative to the precalculated beam.
|
|
"0" |
|
| 0 ... 1 |
articulation |
Complex Type |
Attributes |
Name | Type | Default |
type |
List (string of elements separated by space) |
Elements |
Subtype |
Base | xsd:string | Subset | "staccato"
"tenuto"
"staccatissimo"
"normalAccent"
"strongAccent"
"weakBeat"
"strongBeat"
|
|
currently single articulation or "staccato tenuto"
|
|
required |
|
| 0 ... 1 |
lyric | Lyric | 0 ... 1 |
drawObjects | DrawObjects | 0 ... 1 |
heads | Heads | 1 |
|
ExplicitBarline
*** New in capella 7.0: Can have drawobjects |
Complex Type |
Attributes |
Name | Type | Default |
type |
Subtype |
Base | xsd:string | Subset | "single"
"double"
"end"
"repEnd"
"repBegin"
"repEndBegin"
"dashed"
|
*** New in capella 2008: "dashed" |
|
"single" |
range |
Subtype |
Base | xsd:string | Subset | "auto"
"internal"
"full"
|
|
"auto" |
color | Color |
"000000" |
|
Elements |
|
ClefSign
Complex Type |
Attributes |
Name | Type | Default |
clef | Clef |
required |
color | Color |
"000000" |
|
KeySign
Complex Type |
Attributes |
Name | Type | Default |
fifths |
Subtype |
Base | xsd:int | Subset | Minimum: "-7" Maximum: "7"
|
|
required |
color | Color |
"000000" |
|
TimeSign
Complex Type |
Attributes |
Name | Type | Default |
time | Time |
required |
color | Color |
"000000" |
space | Gap4
*** New in capella 7.1-13
Space to be reserved, for use with invisible or infinite signatures. Default value means automatic.
|
|
"-1" |
invisible | xsd:boolean
*** New in capella 7.1-13
|
|
"false" |
|
Brackets
Complex Type |
Elements |
Name | Type | Occurrence |
bracket |
Complex Type |
Attributes |
Name | Type | Default |
from | xsd:int |
required |
to | xsd:int |
required |
curly | xsd:boolean |
"false" |
|
| 1 ... |
|
Font
corresponding to the Windows API structure LOGFONT
|
Complex Type |
Attributes |
Name | Type | Default |
face | xsd:string |
required |
height | xsd:decimal |
required |
width | xsd:decimal |
"0" |
weight | xsd: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" |
italic | xsd:boolean |
"false" |
underline | xsd:boolean |
"false" |
strikeOut | xsd:boolean |
"false" |
charSet | xsd: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" |
pitchAndFamily | xsd: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" |
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 |
Elements |
Name | Type | Occurrence |
drawObj |
| 1 ... |
|
TranspObjects
DrawObjects with a reference note
|
Complex Type |
Attributes |
|
Elements |
Name | Type | Occurrence |
drawObj |
Complex Type |
Attributes |
|
Elements |
|
| 1 ... |
|
GalleryObjs
Complex Type |
Elements |
Name | Type | Occurrence |
drawObj |
Complex Type |
Attributes |
Name | Type | Default |
name | xsd:string |
"" |
|
Elements |
|
| 1 ... |
|
Info
*** New in capella 7.0: encodingSoftware
|
Complex Type |
Elements |
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 |
Attributes |
Name | Type | Default |
singlePart | xsd:boolean
*** New in capella 7.0
singlePart layout. If true, display only those staves with StaffLayout notation attribute suppressSingle="false"
|
|
"false" |
|
Elements |
Name | Type | Occurrence |
pages | Pages | 1 ... 2 |
distances |
Complex Type |
Elements |
Name | Type | Occurrence |
staffLines |
Complex Type |
Attributes |
Name | Type | Default |
small | Millimeter |
required |
normal | Millimeter |
required |
smallSingle | Millimeter
*** New in capella 7.0: Separate value for singlePart layout
|
|
"" |
normalSingle | Millimeter
*** New in capella 7.0: Separate value for singlePart layout
|
|
"" |
pageObj | Millimeter |
"1.8" |
|
| 1 |
systems |
Complex Type |
Attributes |
Name | Type | Default |
top | Gap |
required |
between | Gap |
required |
topSingle | Gap
*** New in capella 7.0: Separate value for singlePart layout
|
|
"" |
betweenSingle | Gap
*** New in capella 7.0: Separate value for singlePart layout
|
|
"" |
pageJustified |
Subtype |
Base | xsd:string | Subset | "none"
"exceptLast"
"all"
|
|
"none" |
|
| 1 |
|
| 1 |
instrumentNames |
Complex Type |
Attributes |
|
Elements |
Name | Type | Occurrence |
font | Font | 1 |
|
| 0 ... 1 |
style |
Complex Type |
Attributes |
Name | Type | Default |
modernKeyChange | xsd:boolean
Show new keys without redundant naturals
|
|
"true" |
modernBreve | xsd:boolean
Display double notes in modern style (whole note between verticla lines)
instead of mensural notation.
|
|
"true" |
systemSeparators | xsd:boolean
Show two slanting lines at the left side between systems.
The slanting lines are only shown between equally indented systems.
|
|
"false" |
|
| 0 ... 1 |
staves |
| 1 |
brackets | Brackets | 0 ... 1 |
spacing |
Complex Type |
Attributes |
Name | Type | Default |
rel | xsd:int |
"" |
abs | xsd:int |
"" |
useRealSize | xsd:boolean |
"true" |
allowCompression | xsd:boolean |
"false" |
useLyricsSize | xsd:boolean |
"true" |
|
| 0 ... 1 |
beamFlattening |
Complex Type |
Attributes |
Name | Type | Default |
from | xsd:int |
required |
to | xsd:int |
required |
fromMax | xsd:int |
required |
toMax | xsd: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 |
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 |
paperSize | PaperNorm
*** 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.
|
|
"" |
paperSizeX | Millimeter
|
"" |
paperSizeY | Millimeter
|
"" |
|
StaffLayout
Complex Type |
Attributes |
Name | Type | Default |
description | xsd: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 |
Name | Type | Occurrence |
notation |
Complex Type |
Attributes |
Name | Type | Default |
suppressSingle | xsd:boolean
*** New in capella 7.0: Suppress staff in singlePart layout
|
|
"false" |
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" |
|
Elements |
Name | Type | Occurrence |
barlines |
Complex Type |
Attributes |
Name | Type | Default |
mode |
Subtype |
Base | xsd:string | Subset | "full"
"none"
"internal"
"external"
|
|
"full" |
from | xsd:int |
required |
to | xsd:int |
required |
|
| 1 |
|
| 1 |
distances |
Complex Type |
Attributes |
Name | Type | Default |
lineDist |
Subtype |
Base | xsd:string | Subset | "normal"
"small"
|
|
"normal" |
top | Gap |
required |
bottom | Gap |
required |
group | Gap |
"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 |
Name | Type | Default |
name | xsd:string |
required |
abbrev | xsd:string |
required |
pairName | xsd:string |
"" |
pairAbbrev | xsd:string |
"" |
|
Elements |
Name | Type | Occurrence |
name | xsd:string | 1 |
abbrev | xsd:string | 1 |
pairName | xsd:string | 0 ... 1 |
pairAbbrev | xsd:string | 0 ... 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 |
Name | Type | Default |
percussion | xsd:boolean |
"false" |
instr | MidiNumber |
required |
volume | MidiNumber |
required |
panorama |
Subtype |
Base | xsd:int | Subset | Minimum: "-64" Maximum: "63"
|
|
"0" |
transpose | xsd:int |
"0" |
device | xsd:string |
"" |
sample | xsd:string |
"" |
genericSound | xsd:string |
"" |
DataID | 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.
|
|
"0" |
|
Elements |
Name | Type | Occurrence |
entryAssignment | SoundMap | 0 ... 1 |
outputAssignment | SoundMap | 0 ... 1 |
|
| 1 ... 6 |
|
SoundMap
Complex Type |
Elements |
Name | Type | Occurrence |
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 |
Name | Type | Default |
from |
Subtype |
Base | xsd:int | Subset | Minimum: "0" Maximum: "127"
|
|
required |
to |
Subtype |
Base | xsd:int | Subset | Minimum: "0" Maximum: "127"
|
|
required |
device | xsd:string |
"" |
sample | xsd:string |
"" |
genericSound | xsd:string |
"" |
instr | xsd:int |
"" |
midipitch | xsd:int |
"-1" |
|
| 1 ... |
|
BasicDrawObj
Common properties of all draw objects.
|
Complex Type |
Attributes |
Name | Type | Default |
behindNotes | xsd:boolean |
"false" |
firstPage | xsd:boolean
applies only to objects anchored to page
|
|
"true" |
oddPagesExceptFirst | xsd:boolean
applies only to objects anchored to page
|
|
"true" |
evenPages | xsd:boolean
applies only to objects anchored to page
|
|
"true" |
noteRange | xsd: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" |
noAdjust | xsd: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" |
continued | xsd: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" |
drawNormal | xsd: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" |
scope | DrawObjScope
*** 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 |
Base | xsd:int | Subset | Minimum: "0" Maximum: "1"
|
applies only to objects anchored to chords/rests
0=head, 1=stem
|
|
"0" |
vertAlign |
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
|
|
"0" |
minDistY |
Subtype |
Base | Gap2 | Subset | Minimum: "0" Maximum: "8"
|
*** New in capella 7.0
Minimal distance to middle note line
|
|
"0" |
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")
|
*** 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" |
onlySingle | xsd: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 |
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
|
|
"0-0" |
|
Guitar
Complex Type |
Attributes |
Name | Type | Default |
x | Gap32 |
required |
y | Gap32 |
required |
frets |
Subtype |
Base | xsd:int | Subset | Minimum: "3" Maximum: "8"
|
|
"4" |
thickNut | xsd:boolean |
"false" |
openStrings | xsd:boolean |
"false" |
vertical | xsd:boolean |
"true" |
stringDist |
Subtype |
Base | Gap4 | Subset | "0.5"
"0.75"
"1"
|
|
"0.75" |
fretDist |
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
|
|
"1" |
strings |
Subtype |
Base | xsd:string | Subset | Regular _expression_: "[/0-9]{3,8}"
|
|
required |
color | Color |
"000000" |
|
Metafile
Complex Type |
Attributes |
Name | Type | Default |
file | xsd:string |
required |
x | Gap32 |
required |
y | Gap32 |
required |
width | Gap32 |
required |
height | Gap32 |
required |
|
Polygon
Complex Type |
Attributes |
Name | Type | Default |
filled | xsd:boolean |
"false" |
fillColor | Color |
"000000" |
lineWidth | Gap10 |
"0.1" |
lineColor | Color |
"000000" |
|
Elements |
Name | Type | Occurrence |
points |
Complex Type |
Elements |
Name | Type | Occurrence |
point |
| 1 ... |
|
| 1 |
|
Slur
Complex Type |
Attributes |
|
Elements |
Name | Type | Occurrence |
form |
Complex Type |
Attributes |
Name | Type | Default |
endWidth | Gap32 |
"0" |
midWidth | Gap32 |
"0.1875" |
dotDist | Gap32 |
"0" |
dotWidth |
Subtype |
Base | xsd:decimal | Subset | Minimum: "0" Maximum: "1"
|
relative to dotDist ("1" means solid)
|
|
"1" |
|
| 0 ... 1 |
|
RichText
Complex Type |
Attributes |
Name | Type | Default |
file | xsd:string |
required |
x | Gap32 |
required |
y | Gap32 |
required |
width | Gap32 |
required |
|
Rectangle
Ellipse
Complex Type |
Attributes |
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
TupletBracket
Complex Type |
Attributes |
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" |
number |
Subtype |
Base | xsd:string | Subset | Regular _expression_: "(0|[2-9]|1[0-5])"
|
0 (means no number) or 2 to 15
|
|
"0" |
|
Wedge
NotelinesObj
Volta
Complex Type |
Attributes |
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" |
firstNumber | xsd:int
|
"0" |
lastNumber | xsd:int |
"0" |
allNumbers | xsd:boolean |
"false" |
|
OctaveClef
Complex Type |
Attributes |
Name | Type | Default |
x1 | Gap32 |
required |
x2 | Gap32 |
required |
y | Gap32 |
required |
color | Color |
"000000" |
octave |
Subtype |
Base | xsd:int | Subset | "-2"
"-1"
"1"
"2"
|
|
"1" |
onlyNumber | xsd:boolean |
"false" |
courtesyRepeat | xsd:boolean |
"true" |
|
Trill
Complex Type |
Attributes |
Name | Type | Default |
x1 | Gap32 |
required |
x2 | Gap32 |
required |
y | Gap32 |
required |
color | Color |
"000000" |
tr | xsd:boolean |
"true" |
|
WavyLine
Text
Complex Type |
Attributes |
|
Elements |
Name | Type | Occurrence |
font | Font | 1 |
content | xsd:string | 1 |
|
Group Types
DrawObject
|