VocalEasel/musicxml11/layout.dtd

<!--
	MusicXML layout.dtd

	Version 1.1 - 20 May 2005
	
	Copyright © 2004-2005 Recordare LLC.
	http://www.recordare.com/
	
	This MusicXML work is being provided by the copyright
	holder under the MusicXML Document Type Definition 
	Public License Version 1.02, available from:
	
		http://www.recordare.com/dtds/license.html
-->

<!--
	MusicXML 1.1 adds layout information for pages,
	systems, staffs, and measures. These layout elements 
	join the print and sound elements in providing 
	formatting data as elements rather than attributes.

	Everything is measured in tenths of staff space.
	Tenths are then scaled to millimeters within the
	scaling element, used in the defaults element at
	the start of a score. Individual staves can apply
	a scaling factor to adjust staff size. When a
	MusicXML element or attribute refers to tenths,
	it means the global tenths defined by the scaling
	element, not the local tenths as adjusted by the
	staff-size element.
-->

<!-- Elements -->

<!--
	Margins, page sizes, and distances are all measured in
	tenths to keep MusicXML data in a consistent coordinate
	system as much as possible. The translation to absolute
	units is done in the scaling element, which specifies
	how many millimeters are equal to how many tenths. For
	a staff height of 7 mm, millimeters would be set to 7
	while tenths is set to 40. The ability to set a formula
	rather than a single scaling factor helps avoid roundoff
	errors.
-->
<!ELEMENT scaling (millimeters, tenths)>
<!ELEMENT millimeters (#PCDATA)>
<!ELEMENT tenths %layout-tenths;>

<!-- 
	Margin elements are included within many of the
	larger layout elements.
-->
<!ELEMENT left-margin %layout-tenths;>
<!ELEMENT right-margin %layout-tenths;>
<!ELEMENT top-margin %layout-tenths;>
<!ELEMENT bottom-margin %layout-tenths;>

<!--
	Page layout can be defined both in score-wide
	defaults and in the print element. Page margins
	are specified either for both even and odd pages,
	or via separate odd and even page number values.
	The type is not needed when used in as part of
	a print element. If omitted when used in the
	defaults element, "both" is the default.
-->
<!ELEMENT page-layout (page-height, page-width, 
	page-margins?, page-margins?)>
<!ELEMENT page-height %layout-tenths;>
<!ELEMENT page-width %layout-tenths;>
<!ELEMENT page-margins (left-margin, right-margin, 
	top-margin, bottom-margin)>
<!ATTLIST page-margins
    type (odd | even | both) #IMPLIED
>

<!--
	System layout includes left and right margins and the
	vertical distance from the previous system. Margins 
	are relative to the page margins. Positive values 
	indent and negative values reduce the margin size.
	The system distance is measured from the bottom line
	of the previous system to the top line of the current
	system. It is ignored for the first system on a page.
	The top system distance is measured from the page's
	top margin to the top line of the first system. It is 
	ignored for all but the first system on a page.
-->
<!ELEMENT system-layout
	(system-margins?, system-distance?, top-system-distance?)>
<!ELEMENT system-margins (left-margin, right-margin)>
<!ELEMENT system-distance %layout-tenths;>
<!ELEMENT top-system-distance %layout-tenths;>

<!--
	Staff layout includes the vertical distance from
	the bottom line of the previous staff in this system
	to the top line of the staff specified by the number
	attribute. The first staff of the part is used if
	the number attribute is missing. When used in the
	defaults element, the values apply to all parts.
	This value is ignored for the first staff in a system.
-->
<!ELEMENT staff-layout (staff-distance?)>
<!ELEMENT staff-distance %layout-tenths;>
<!ATTLIST staff-layout
    number CDATA #IMPLIED
>

<!--
	Measure layout includes the horizontal distance 
	from the previous measure. This value is only used
	for systems where there is horizontal whitespace 
	in the middle of a system, as in systems with codas.
	To specify the measure width, use the width attribute
	of the measure element.
-->
<!ELEMENT measure-layout (measure-distance?)>
<!ELEMENT measure-distance %layout-tenths;>