<surface>

Defines a writing surface in terms of a rectangular coordinate space, optionally grouping one or more graphic representations of that space, and rectangular zones of interest within it.
3.7.1.5.1 Linking surface elements, 3.7.1.5.2 Specifying page dimensions, 12.1.1 Elements of the Facsimile Module, 14.4 SVG
Module
MEI.facsimile
Attributes
class, copyof, corresp, data, decls, follows, label, lrx, lry, n, next, precedes, prev, resp, rotate, sameas, startid, synch, type, ulx, uly, xml:base, xml:id
class(optional)Contains one or more URIs which denote classification terms that apply to the entity bearing this attribute. One or more values from data.URI, separated by spaces.
<surface>att.commonatt.typedatt.classed@class
copyof(optional)Points to an element of which the current element is a copy. Value conforms to data.URI.
<surface>att.commonatt.linking@copyof
corresp(optional)Used to point to other elements that correspond to this one in a generic fashion. One or more values from data.URI, separated by spaces.
<surface>att.commonatt.linking@corresp
data(optional)Used to link metadata elements to one or more data-containing elements. One or more values from data.URI, separated by spaces.
<surface>att.dataPointing@data
decls(optional)Identifies one or more metadata elements (other than classification terms) within the header, which are understood to apply to the element bearing this attribute and its content. One or more values from data.URI, separated by spaces.
<surface>att.metadataPointing@decls
follows(optional)points to one or more events in a user-defined collection that are known to be predecessors of the current element. One or more values from data.URI, separated by spaces.
<surface>att.commonatt.linking@follows
label(optional)Captures text to be used to generate a label for the element to which it’s attached, a "tool tip" or prefatory text, for example. Should not be used to record document content. Value is plain text.
<surface>att.commonatt.labelled@label
lrx(optional)Indicates the lower-right corner x coordinate. Value is a positive integer, including 0.
<surface>att.coordinated@lrx
lry(optional)Indicates the lower-left corner x coordinate. Value is a positive integer, including 0.
<surface>att.coordinated@lry
n(optional)Provides a number-like designation that indicates an element’s position in a sequence of similar elements. May not contain space characters. Value conforms to data.WORD.
<surface>att.commonatt.nNumberLike@n
next(optional)Used to point to the next event(s) in a user-defined collection. One or more values from data.URI, separated by spaces.
<surface>att.commonatt.linking@next
precedes(optional)Points to one or more events in a user-defined collection that are known to be successors of the current element. One or more values from data.URI, separated by spaces.
<surface>att.commonatt.linking@precedes
prev(optional)Points to the previous event(s) in a user-defined collection. One or more values from data.URI, separated by spaces.
<surface>att.commonatt.linking@prev
resp(optional)Indicates the agent(s) responsible for some aspect of the text’s transcription, editing, or encoding. Its value must point to one or more identifiers declared in the document header. One or more values from data.URI, separated by spaces.
<surface>att.commonatt.responsibility@resp
rotate Indicates the amount by which the contents of this element have been rotated clockwise or, if applicable, how the orientation of the element self should be interpreted, with respect to the normal orientation of the parent surface. The orientation is expressed in arc degrees. Value conforms to data.DEGREES.
<surface>att.coordinated@rotate
sameas(optional)Points to an element that is the same as the current element but is not a literal copy of the current element. One or more values from data.URI, separated by spaces.
<surface>att.commonatt.linking@sameas
startid(optional)Holds a reference to the first element in a sequence of events to which the feature applies. Value conforms to data.URI.
<surface>att.startId@startid
synch(optional)Points to elements that are synchronous with the current element. One or more values from data.URI, separated by spaces.
<surface>att.commonatt.linking@synch
type(optional)Designation which characterizes the element in some sense, using any convenient classification scheme or typology that employs single-token labels. One or more values of datatype NMTOKEN, separated by spaces.
<surface>att.commonatt.typed@type
ulx(optional)Indicates the upper-left corner x coordinate. Value is a positive integer, including 0.
<surface>att.coordinatedatt.coordinated.ul@ulx
uly(optional)Indicates the upper-left corner y coordinate. Value is a positive integer, including 0.
<surface>att.coordinatedatt.coordinated.ul@uly
xml:base(optional)Provides a base URI reference with which applications can resolve relative URI references into absolute URI references. Value conforms to data.URI.
<surface>att.commonatt.basic@xml:base
xml:id(optional)Regularizes the naming of an element and thus facilitates building links between it and other resources. Each id attribute within a document must have a unique value. Value is a valid xml:id.
<surface>att.commonatt.basicatt.id@xml:id
(MEI.shared) Attributes common to many elements.
(MEI.shared) Attributes that form the basis of the att.common class.
xml:base(optional)Provides a base URI reference with which applications can resolve relative URI references into absolute URI references. Value conforms to data.URI.
(MEI.shared) Attributes that uniquely identify an element.
xml:id(optional)Regularizes the naming of an element and thus facilitates building links between it and other resources. Each id attribute within a document must have a unique value. Value is a valid xml:id.
(MEI.shared)
label(optional)Captures text to be used to generate a label for the element to which it’s attached, a "tool tip" or prefatory text, for example. Should not be used to record document content. Value is plain text.
(MEI.shared) Attributes that specify element-to-element relationships.
copyof(optional)Points to an element of which the current element is a copy. Value conforms to data.URI.
corresp(optional)Used to point to other elements that correspond to this one in a generic fashion. One or more values from data.URI, separated by spaces.
follows(optional)points to one or more events in a user-defined collection that are known to be predecessors of the current element. One or more values from data.URI, separated by spaces.
next(optional)Used to point to the next event(s) in a user-defined collection. One or more values from data.URI, separated by spaces.
precedes(optional)Points to one or more events in a user-defined collection that are known to be successors of the current element. One or more values from data.URI, separated by spaces.
prev(optional)Points to the previous event(s) in a user-defined collection. One or more values from data.URI, separated by spaces.
sameas(optional)Points to an element that is the same as the current element but is not a literal copy of the current element. One or more values from data.URI, separated by spaces.
synch(optional)Points to elements that are synchronous with the current element. One or more values from data.URI, separated by spaces.
(MEI.shared) Attributes used to supply a number-like designation for an element.
n(optional)Provides a number-like designation that indicates an element’s position in a sequence of similar elements. May not contain space characters. Value conforms to data.WORD.
(MEI.shared) Attributes capturing information regarding responsibility for some aspect of the text's creation, transcription, editing, or encoding.
resp(optional)Indicates the agent(s) responsible for some aspect of the text’s transcription, editing, or encoding. Its value must point to one or more identifiers declared in the document header. One or more values from data.URI, separated by spaces.
(MEI.shared) Attributes which can be used to classify features.
type(optional)Designation which characterizes the element in some sense, using any convenient classification scheme or typology that employs single-token labels. One or more values of datatype NMTOKEN, separated by spaces.
(MEI.shared) Attributes which can be used to classify features.
class(optional)Contains one or more URIs which denote classification terms that apply to the entity bearing this attribute. One or more values from data.URI, separated by spaces.
(MEI.shared) This attribute class records the position of a feature within a two-dimensional coordinate system.
lrx(optional)Indicates the lower-right corner x coordinate. Value is a positive integer, including 0.
lry(optional)Indicates the lower-left corner x coordinate. Value is a positive integer, including 0.
rotate Indicates the amount by which the contents of this element have been rotated clockwise or, if applicable, how the orientation of the element self should be interpreted, with respect to the normal orientation of the parent surface. The orientation is expressed in arc degrees. Value conforms to data.DEGREES.
(MEI.shared) This attribute class records the upper left position of a feature within a two-dimensional coordinate system.
ulx(optional)Indicates the upper-left corner x coordinate. Value is a positive integer, including 0.
uly(optional)Indicates the upper-left corner y coordinate. Value is a positive integer, including 0.
(MEI.shared) Attributes for linking metadata to data.
data(optional)Used to link metadata elements to one or more data-containing elements. One or more values from data.URI, separated by spaces.
(MEI.shared) Provides attributes for elements which may be associated with particular contextual elements within the header.
decls(optional)Identifies one or more metadata elements (other than classification terms) within the header, which are understood to apply to the element bearing this attribute and its content. One or more values from data.URI, separated by spaces.
(MEI.shared) Attributes that identify a relative starting point.
startid(optional)Holds a reference to the first element in a sequence of events to which the feature applies. Value conforms to data.URI.
Component declarations that are shared between two or more modules.
class(optional)Contains one or more URIs which denote classification terms that apply to the entity bearing this attribute. One or more values from data.URI, separated by spaces.
copyof(optional)Points to an element of which the current element is a copy. Value conforms to data.URI.
corresp(optional)Used to point to other elements that correspond to this one in a generic fashion. One or more values from data.URI, separated by spaces.
data(optional)Used to link metadata elements to one or more data-containing elements. One or more values from data.URI, separated by spaces.
decls(optional)Identifies one or more metadata elements (other than classification terms) within the header, which are understood to apply to the element bearing this attribute and its content. One or more values from data.URI, separated by spaces.
follows(optional)points to one or more events in a user-defined collection that are known to be predecessors of the current element. One or more values from data.URI, separated by spaces.
label(optional)Captures text to be used to generate a label for the element to which it’s attached, a "tool tip" or prefatory text, for example. Should not be used to record document content. Value is plain text.
lrx(optional)Indicates the lower-right corner x coordinate. Value is a positive integer, including 0.
lry(optional)Indicates the lower-left corner x coordinate. Value is a positive integer, including 0.
n(optional)Provides a number-like designation that indicates an element’s position in a sequence of similar elements. May not contain space characters. Value conforms to data.WORD.
next(optional)Used to point to the next event(s) in a user-defined collection. One or more values from data.URI, separated by spaces.
precedes(optional)Points to one or more events in a user-defined collection that are known to be successors of the current element. One or more values from data.URI, separated by spaces.
prev(optional)Points to the previous event(s) in a user-defined collection. One or more values from data.URI, separated by spaces.
resp(optional)Indicates the agent(s) responsible for some aspect of the text’s transcription, editing, or encoding. Its value must point to one or more identifiers declared in the document header. One or more values from data.URI, separated by spaces.
rotate Indicates the amount by which the contents of this element have been rotated clockwise or, if applicable, how the orientation of the element self should be interpreted, with respect to the normal orientation of the parent surface. The orientation is expressed in arc degrees. Value conforms to data.DEGREES.
sameas(optional)Points to an element that is the same as the current element but is not a literal copy of the current element. One or more values from data.URI, separated by spaces.
startid(optional)Holds a reference to the first element in a sequence of events to which the feature applies. Value conforms to data.URI.
synch(optional)Points to elements that are synchronous with the current element. One or more values from data.URI, separated by spaces.
type(optional)Designation which characterizes the element in some sense, using any convenient classification scheme or typology that employs single-token labels. One or more values of datatype NMTOKEN, separated by spaces.
ulx(optional)Indicates the upper-left corner x coordinate. Value is a positive integer, including 0.
uly(optional)Indicates the upper-left corner y coordinate. Value is a positive integer, including 0.
xml:base(optional)Provides a base URI reference with which applications can resolve relative URI references into absolute URI references. Value conforms to data.URI.
xml:id(optional)Regularizes the naming of an element and thus facilitates building links between it and other resources. Each id attribute within a document must have a unique value. Value is a valid xml:id.
Member of
(surface isn't member of any model class)
Contained By
facsimileContains a representation of a written source in the form of a set of images rather than as transcribed or encoded text.
Facsimile component declarations.
facsimileContains a representation of a written source in the form of a set of images rather than as transcribed or encoded text.
May Contain
zoneDefines an area of interest within a surface or graphic file.
(MEI.figtable) Groups elements that provide a brief prose description of the appearance or content of a graphic figure.
figDescContains a brief prose description of the appearance or content of a graphic figure, for use when documenting an image without displaying it.
(MEI.figtable) Groups elements that indicate the location of an inline graphic, illustration, or figure.
graphicIndicates the location of an inline graphic.
Facsimile component declarations.
zoneDefines an area of interest within a surface or graphic file.
Figures and tables component declarations.
figDescContains a brief prose description of the appearance or content of a graphic figure, for use when documenting an image without displaying it.
graphicIndicates the location of an inline graphic.
Remarks

Scalable Vector Graphics (SVG) markup may be used when allowed by the graphicLike model.

The startid attribute may be used to hold a reference to the first feature occurring on this surface.

The model of this element is based on the surface element of the Text Encoding Initiative (TEI).

Declaration
<elementSpec ident="surface" module="MEI.facsimile">
<desc xml:lang="en">Defines a writing surface in terms of a rectangular coordinate space, optionally grouping one or more graphic representations of that space, and rectangular zones of interest within it.</desc>
<classes>
<memberOf key="att.common"/>
<memberOf key="att.coordinated"/>
<memberOf key="att.dataPointing"/>
<memberOf key="att.metadataPointing"/>
<memberOf key="att.startId"/>
</classes>
<content>
<rng:zeroOrMore>
<rng:ref name="model.figDescLike"/>
</rng:zeroOrMore>
<rng:zeroOrMore>
<rng:ref name="model.graphicLike"/>
</rng:zeroOrMore>
<rng:zeroOrMore>
<rng:ref name="zone"/>
</rng:zeroOrMore>
</content>
<remarks xml:lang="en">
<p>Scalable Vector Graphics (SVG) markup may be used when allowed by the graphicLike model.</p>
<p>The <att>startid</att> attribute may be used to hold a reference to the first feature occurring on this surface.</p>
</remarks>
<remarks xml:lang="en">
<p>The model of this element is based on the <ref target="https://tei-c.org/release/doc/tei-p5-doc/en/html/ref-surface.html">surface</ref> element of the Text Encoding Initiative (TEI).</p>
</remarks>
</elementSpec>
MEI Version: 5.0(#eb14650)