<surface>

<surface> defines a written surface as a two-dimensional coordinate space, optionally grouping one or more graphic representations of that space, zones of interest within that space, and, when using an embedded transcription approach, transcriptions of the writing within them. [12.1 Digital Facsimiles 12.2.2 Embedded Transcription]
Module transcr — Representation of Primary Sources
Attributes
attachment⚓︎ describes the method by which this surface is or was connected to the main surface
Status Optional
Datatype teidata.enumerated
Sample values include:
glued
glued in place
pinned
pinned or stapled in place
sewn
sewn in place
flipping⚓︎ indicates whether the surface is attached and folded in such a way as to provide two writing surfaces
Status Optional
Datatype teidata.truthValue
Contained by
transcr: facsimile sourceDoc surface surfaceGrp zone
May contain
analysis: interp interpGrp span spanGrp
certainty: certainty precision respons
core: binaryObject cb desc ellipsis gap gb graphic index label lb media milestone note noteGrp pb
figures: figure formula notatedMusic
iso-fs: fLib fs fvLib
linking: alt altGrp anchor join joinGrp link linkGrp timeline
spoken: incident kinesic pause shift vocal writing
textcrit: app witDetail
transcr: addSpan damageSpan delSpan fw line listTranspose metamark path space substJoin surface surfaceGrp zone
Note

The surface element represents any two-dimensional space on some physical surface forming part of the source material, such as a piece of paper, a face of a monument, a billboard, a scroll, a leaf etc.

The coordinate space defined by this element may be thought of as a grid lrx - ulx units wide and uly - lry units high.

The surface element may contain graphic representations or transcriptions of written zones, or both. The coordinate values used by every zone element contained by this element are to be understood with reference to the same grid.

Where it is useful or meaningful to do so, any grouping of multiple surface elements may be indicated using the surfaceGrp element.
Example
<facsimile>
 <surface ulx="0" uly="0" lrx="200" lry="300">
  <graphic url="Bovelles-49r.png"/>
 </surface>
</facsimile>
Content model 
<content>
 <sequence>
  <alternate minOccurs="0"
   maxOccurs="unbounded">
   <classRef key="model.global"/>
   <classRef key="model.labelLike"/>
   <classRef key="model.graphicLike"/>
  </alternate>
  <sequence minOccurs="0"
   maxOccurs="unbounded">
   <alternate>
    <elementRef key="zone"/>
    <elementRef key="line"/>
    <elementRef key="path"/>
    <elementRef key="surface"/>
    <elementRef key="surfaceGrp"/>
   </alternate>
   <classRef key="model.global"
    minOccurs="0" maxOccurs="unbounded"/>
  </sequence>
 </sequence>
</content>
Schema Declaration 
<rng:element name="surface">
 <rng:ref name="att.global.attributes"/>
 <rng:ref name="att.global.rendition.attributes"/>
 <rng:ref name="att.global.linking.attributes"/>
 <rng:ref name="att.global.analytic.attributes"/>
 <rng:ref name="att.global.facs.attributes"/>
 <rng:ref name="att.global.change.attributes"/>
 <rng:ref name="att.global.responsibility.attributes"/>
 <rng:ref name="att.global.source.attributes"/>
 <rng:ref name="att.coordinated.attributes"/>
 <rng:ref name="att.declaring.attributes"/>
 <rng:ref name="att.typed.attributes"/>
 <rng:optional>
  <rng:attribute name="attachment">
   <rng:ref name="teidata.enumerated"/>
  </rng:attribute>
 </rng:optional>
 <rng:optional>
  <rng:attribute name="flipping">
   <rng:ref name="teidata.truthValue"/>
  </rng:attribute>
 </rng:optional>
 <rng:group>
  <rng:zeroOrMore>
   <rng:choice>
    <rng:ref name="model.global"/>
    <rng:ref name="model.labelLike"/>
    <rng:ref name="model.graphicLike"/>
   </rng:choice>
  </rng:zeroOrMore>
  <rng:group>
   <rng:zeroOrMore>
    <rng:choice>
     <rng:ref name="zone"/>
     <rng:ref name="line"/>
     <rng:ref name="path"/>
     <rng:ref name="surface"/>
     <rng:ref name="surfaceGrp"/>
    </rng:choice>
    <rng:zeroOrMore>
     <rng:ref name="model.global"/>
    </rng:zeroOrMore>
   </rng:zeroOrMore>
  </rng:group>
 </rng:group>
</rng:element>
element surface
{
   att.global.attributes,
   att.global.rendition.attributes,
   att.global.linking.attributes,
   att.global.analytic.attributes,
   att.global.facs.attributes,
   att.global.change.attributes,
   att.global.responsibility.attributes,
   att.global.source.attributes,
   att.coordinated.attributes,
   att.declaring.attributes,
   att.typed.attributes,
   attribute attachment { teidata.enumerated }?,
   attribute flipping { teidata.truthValue }?,
   (
      ( model.global | model.labelLike | model.graphicLike )*,
      ( ( ( zone | line | path | surface | surfaceGrp ), model.global* )* )
   )
}