<cutout>

A cutout is a section of a document sheet that has been removed and is now missing.
Module
Attributes
@cert, @class, @copyof, @corresp, @decls, @evidence, @follows, @hand, @height, @instant, @label, @meiversion, @n, @next, @precedes, @prev, @removed.by, @removed.from, @resp, @sameas, @seq, @state, @synch, @type, @unit, @width, @x, @xml:base, @xml:id, @y
@cert(optional)Signifies the degree of certainty or precision associated with a feature.
@class(optional)Contains one or more URIs which denote classification terms that apply to the entity bearing this attribute.
@copyof(optional)Points to an element of which the current element is a copy.
@corresp(optional)Used to point to other elements that correspond to this one in a generic fashion.
@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.
@evidence(optional)Indicates the nature of the evidence supporting the reliability or accuracy of the intervention or interpretation. Suggested values are: "internal" (There is evidence within the document to support the intervention.), "external" (There is evidence outside the document to support the intervention.), "conjecture" (The assertion has been made by the editor, cataloguer, or scholar on the basis of their expertise.)
@follows(optional)points to one or more events in a user-defined collection that are known to be predecessors of the current element.
@hand(optional)Signifies the hand responsible for an action. The value must be the ID of a <hand> element declared in the header.
@height(optional)Measurement of the vertical dimension of an entity.
@instant(optional)The @instant attribute is syntactic sugar for classifying a scribal intervention as an ad-hoc modification; that is, one which does not interrupt the writing process.
@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.
@meiversion(recommended)Specifies a generic MEI version label. Allowed values are: "6.0-dev" (Version of MEI), "6.0-dev+anyStart" (Version of MEI All AnyStart customization)
@n(optional)Provides a number-like designation that indicates an element’s position in a sequence of similar elements. May not contain space characters.
@next(optional)Used to point to the next event(s) in a user-defined collection.
@precedes(optional)Points to one or more events in a user-defined collection that are known to be successors of the current element.
@prev(optional)Points to the previous event(s) in a user-defined collection.
@removed.by(optional)Describes the method of removing the cutout. Suggested values are: "cut" (section is cleanly cut by a knife, scissor or other sharp blade.), "rip" (section is ripped off the page, leaving a rough edge.)
@removed.from(required)Describes the position of the cutout on the parent folium / bifolium. Allowed values are: "outer.recto" (removed from outer recto side of bifolium.), "inner.verso" (removed from inner verso side of bifolium.), "inner.recto" (removed from inner recto side of bifolium.), "outer.verso" (removed from outer verso side of bifolium.), "recto" (removed from recto side of folium.), "verso" (removed from verso side of folium.)
@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.
@sameas(optional)Points to an element that is the same as the current element but is not a literal copy of the current element.
@seq(optional)Used to assign a sequence number related to the order in which the encoded features carrying this attribute are believed to have occurred.
@state(optional)Points to the genetic state that results from this modification.
@synch(optional)Points to elements that are synchronous with the current element.
@type(optional)Designation which characterizes the element in some sense, using any convenient classification scheme or typology that employs single-token labels.
@unit(optional)Indicates the unit of measurement. Suggested values are: "byte" (Byte.), "char" (Character.), "cm" (Centimeter.), "deg" (Degree.), "in" (Inch.), "issue" (Serial issue.), "ft" (Foot.), "m" (Meter.), "mm" (Millimeter.), "page" (Page.), "pc" (Pica.), "pt" (Point.), "px" (Pixel.), "rad" (Radian.), "record" (Record.), "vol" (Serial volume.), "vu" (MEI virtual unit.)
@width(optional)Measurement of the horizontal dimension of an entity.
@x(optional)Encodes an x coordinate for a feature in an output coordinate system. When it is necessary to record the placement of a feature in a facsimile image, use the facs attribute.
@xml:base(optional)Provides a base URI reference with which applications can resolve relative URI references into absolute URI references.
@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.
@y(optional)Encodes a y coordinate for a feature in an output coordinate system. When it is necessary to record the placement of a feature in a facsimile image, use the facs attribute.
@removed.from(required)Describes the position of the cutout on the parent folium / bifolium. Allowed values are: "outer.recto" (removed from outer recto side of bifolium.), "inner.verso" (removed from inner verso side of bifolium.), "inner.recto" (removed from inner recto side of bifolium.), "outer.verso" (removed from outer verso side of bifolium.), "recto" (removed from recto side of folium.), "verso" (removed from verso side of folium.)
@removed.by(optional)Describes the method of removing the cutout. Suggested values are: "cut" (section is cleanly cut by a knife, scissor or other sharp blade.), "rip" (section is ripped off the page, leaving a rough edge.)
(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.
(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.
(MEI.shared) Attributes that record the version of MEI in use.
@meiversion(recommended)Specifies a generic MEI version label. Allowed values are: "6.0-dev" (Version of MEI), "6.0-dev+anyStart" (Version of MEI All AnyStart customization)
(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.
(MEI.shared) Attributes that specify element-to-element relationships.
@copyof(optional)Points to an element of which the current element is a copy.
@corresp(optional)Used to point to other elements that correspond to this one in a generic fashion.
@follows(optional)points to one or more events in a user-defined collection that are known to be predecessors of the current element.
@next(optional)Used to point to the next event(s) in a user-defined collection.
@precedes(optional)Points to one or more events in a user-defined collection that are known to be successors of the current element.
@prev(optional)Points to the previous event(s) in a user-defined collection.
@sameas(optional)Points to an element that is the same as the current element but is not a literal copy of the current element.
@synch(optional)Points to elements that are synchronous with the current element.
(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.
(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.
(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.
(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.
(MEI.shared) Attributes that capture the dimensions of an entity.
(MEI.shared) Attributes that describe vertical size.
@height(optional)Measurement of the vertical dimension of an entity.
(MEI.shared) Attributes that describe horizontal size.
@width(optional)Measurement of the horizontal dimension of an entity.
(MEI.shared) Attributes describing the support for and the certainty of an assertion.
@cert(optional)Signifies the degree of certainty or precision associated with a feature.
@evidence(optional)Indicates the nature of the evidence supporting the reliability or accuracy of the intervention or interpretation. Suggested values are: "internal" (There is evidence within the document to support the intervention.), "external" (There is evidence outside the document to support the intervention.), "conjecture" (The assertion has been made by the editor, cataloguer, or scholar on the basis of their expertise.)
(MEI.shared) Attributes that record the unit of measurement in which a value is expressed.
@unit(optional)Indicates the unit of measurement. Suggested values are: "byte" (Byte.), "char" (Character.), "cm" (Centimeter.), "deg" (Degree.), "in" (Inch.), "issue" (Serial issue.), "ft" (Foot.), "m" (Meter.), "mm" (Millimeter.), "page" (Page.), "pc" (Pica.), "pt" (Point.), "px" (Pixel.), "rad" (Radian.), "record" (Record.), "vol" (Serial volume.), "vu" (MEI virtual unit.)
(MEI.edittrans) Attributes for elements encoding authorial or scribal intervention when transcribing manuscript or similar sources.
(MEI.genetic) Attributes that pertain to a genetic state.
@instant(optional)The @instant attribute is syntactic sugar for classifying a scribal intervention as an ad-hoc modification; that is, one which does not interrupt the writing process.
@state(optional)Points to the genetic state that results from this modification.
(MEI.shared) Attributes which identify a document hand.
@hand(optional)Signifies the hand responsible for an action. The value must be the ID of a <hand> element declared in the header.
(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.
(MEI.shared) Attributes that describe order within a collection of features.
@seq(optional)Used to assign a sequence number related to the order in which the encoded features carrying this attribute are believed to have occurred.
(MEI.shared) Output coordinate attributes. Some elements may have their exact rendered *output* coordinates recorded. x and y attributes indicate where to place the rendered output. Recording the coordinates of a feature in a facsimile requires the use of the facs attribute.
@x(optional)Encodes an x coordinate for a feature in an output coordinate system. When it is necessary to record the placement of a feature in a facsimile image, use the facs attribute.
@y(optional)Encodes a y coordinate for a feature in an output coordinate system. When it is necessary to record the placement of a feature in a facsimile image, use the facs attribute.
@instant(optional)The @instant attribute is syntactic sugar for classifying a scribal intervention as an ad-hoc modification; that is, one which does not interrupt the writing process.
@state(optional)Points to the genetic state that results from this modification.
@removed.by(optional)Describes the method of removing the cutout. Suggested values are: "cut" (section is cleanly cut by a knife, scissor or other sharp blade.), "rip" (section is ripped off the page, leaving a rough edge.)
@removed.from(required)Describes the position of the cutout on the parent folium / bifolium. Allowed values are: "outer.recto" (removed from outer recto side of bifolium.), "inner.verso" (removed from inner verso side of bifolium.), "inner.recto" (removed from inner recto side of bifolium.), "outer.verso" (removed from outer verso side of bifolium.), "recto" (removed from recto side of folium.), "verso" (removed from verso side of folium.)
@cert(optional)Signifies the degree of certainty or precision associated with a feature.
@class(optional)Contains one or more URIs which denote classification terms that apply to the entity bearing this attribute.
@copyof(optional)Points to an element of which the current element is a copy.
@corresp(optional)Used to point to other elements that correspond to this one in a generic fashion.
@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.
@evidence(optional)Indicates the nature of the evidence supporting the reliability or accuracy of the intervention or interpretation. Suggested values are: "internal" (There is evidence within the document to support the intervention.), "external" (There is evidence outside the document to support the intervention.), "conjecture" (The assertion has been made by the editor, cataloguer, or scholar on the basis of their expertise.)
@follows(optional)points to one or more events in a user-defined collection that are known to be predecessors of the current element.
@hand(optional)Signifies the hand responsible for an action. The value must be the ID of a <hand> element declared in the header.
@height(optional)Measurement of the vertical dimension of an entity.
@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.
@meiversion(recommended)Specifies a generic MEI version label. Allowed values are: "6.0-dev" (Version of MEI), "6.0-dev+anyStart" (Version of MEI All AnyStart customization)
@n(optional)Provides a number-like designation that indicates an element’s position in a sequence of similar elements. May not contain space characters.
@next(optional)Used to point to the next event(s) in a user-defined collection.
@precedes(optional)Points to one or more events in a user-defined collection that are known to be successors of the current element.
@prev(optional)Points to the previous event(s) in a user-defined collection.
@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.
@sameas(optional)Points to an element that is the same as the current element but is not a literal copy of the current element.
@seq(optional)Used to assign a sequence number related to the order in which the encoded features carrying this attribute are believed to have occurred.
@synch(optional)Points to elements that are synchronous with the current element.
@type(optional)Designation which characterizes the element in some sense, using any convenient classification scheme or typology that employs single-token labels.
@unit(optional)Indicates the unit of measurement. Suggested values are: "byte" (Byte.), "char" (Character.), "cm" (Centimeter.), "deg" (Degree.), "in" (Inch.), "issue" (Serial issue.), "ft" (Foot.), "m" (Meter.), "mm" (Millimeter.), "page" (Page.), "pc" (Pica.), "pt" (Point.), "px" (Pixel.), "rad" (Radian.), "record" (Record.), "vol" (Serial volume.), "vu" (MEI virtual unit.)
@width(optional)Measurement of the horizontal dimension of an entity.
@x(optional)Encodes an x coordinate for a feature in an output coordinate system. When it is necessary to record the placement of a feature in a facsimile image, use the facs attribute.
@xml:base(optional)Provides a base URI reference with which applications can resolve relative URI references into absolute URI references.
@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.
@y(optional)Encodes a y coordinate for a feature in an output coordinate system. When it is necessary to record the placement of a feature in a facsimile image, use the facs attribute.
Member of
model.paperModLikeGroups elements dealing with modifications of document pages.
Contained By
(MEI.header) Groups elements dealing with modifications of document pages.
<bifolium>Describes a folded sheet of paper.
<folium>Describes a single leaf of paper.
<bifolium>Describes a folded sheet of paper.
<folium>Describes a single leaf of paper.
May Contain
(MEI.header) Collects bifoliumlike elements.
<bifolium>Describes a folded sheet of paper.
(MEI.header) Collects foliumlike elements.
<folium>Describes a single leaf of paper.
<bifolium>Describes a folded sheet of paper.
<folium>Describes a single leaf of paper.
Remarks

The dimensions (@width, @height) of the parent element (e.g., <folium>) indicate the size of the bounding box of the remaining part of the page. That is, if the complete lower half of a page has been cut, the @width and @height attributes describe the remaining upper half. If, in contrast, only the lower right quarter of the page has been cut, these attributes still indicate the size of the full page (assuming that the removed section was a regular rectangle).

The dimensions (@width, @height) on <cutout> itself are only to be used when there is a "gap" in the manuscript that allows to specify the dimensions of that missing part. In this case, the bounding box dimensions are given, together with @x and @y to indicate the upper left point on the original page. If, however, the removed section is available by itself, then a corresponding <folium> (or <bifolium>) should be placed inside the <cutout> element, and should provide it’s own dimensions using @width and @height there. In this case, @width and @height on <cutout> is expendable.

Declaration
<elementSpec xmlns="http://www.tei-c.org/ns/1.0" rend="add" ident="cutout" module="MEI.header">
<desc xml:lang="en">A cutout is a section of a document sheet that has been removed and is now missing.</desc>
<classes>
<memberOf key="att.common"/>
<memberOf key="att.dimensions"/>
<memberOf key="att.evidence"/>
<memberOf key="att.measurement"/>
<memberOf key="att.trans"/>
<memberOf key="att.xy"/>
<memberOf key="model.paperModLike"/>
</classes>
<content>
<alternate minOccurs="0" maxOccurs="unbounded">
<classRef key="model.foliumLike"/>
<classRef key="model.bifoliumLike"/>
</alternate>
</content>
<attList>
<attDef ident="removed.from" usage="req">
<desc xml:lang="en">Describes the position of the cutout on the parent folium / bifolium.</desc>
<valList type="closed">
<valItem ident="outer.recto">
<desc xml:lang="en">removed from outer recto side of bifolium.</desc>
</valItem>
<valItem ident="inner.verso">
<desc xml:lang="en">removed from inner verso side of bifolium.</desc>
</valItem>
<valItem ident="inner.recto">
<desc xml:lang="en">removed from inner recto side of bifolium.</desc>
</valItem>
<valItem ident="outer.verso">
<desc xml:lang="en">removed from outer verso side of bifolium.</desc>
</valItem>
<valItem ident="recto">
<desc xml:lang="en">removed from recto side of folium.</desc>
</valItem>
<valItem ident="verso">
<desc xml:lang="en">removed from verso side of folium.</desc>
</valItem>
</valList>
</attDef>
<attDef ident="removed.by" usage="opt">
<desc xml:lang="en">Describes the method of removing the cutout.</desc>
<datatype>
<dataRef name="NMTOKEN"/>
</datatype>
<valList type="semi">
<valItem ident="cut">
<desc xml:lang="en">section is cleanly cut by a knife, scissor or other sharp blade.</desc>
</valItem>
<valItem ident="rip">
<desc xml:lang="en">section is ripped off the page, leaving a rough edge.</desc>
</valItem>
</valList>
</attDef>
</attList>
<remarks xml:lang="en">
<p>The dimensions (@width, @height) of the parent element (
<abbr>e.g.</abbr>
, <gi scheme="MEI">folium</gi>) indicate the size of the bounding box of the remaining part of the page. That is, if the complete lower half of a page has been cut, the @width and @height attributes describe the remaining upper half. If, in contrast, only the lower right quarter of the page has been cut, these attributes still indicate the size of the full page (assuming that the removed section was a regular rectangle).</p>
<p>The dimensions (@width, @height) on <gi scheme="MEI">cutout</gi> itself are only to be used when there is a "gap" in the manuscript that allows to specify the dimensions of that missing part. In this case, the bounding box dimensions are given, together with @x and @y to indicate the upper left point on the original page. If, however, the removed section is available by itself, then a corresponding <gi scheme="MEI">folium</gi> (or <gi scheme="MEI">bifolium</gi>) should be placed inside the <gi scheme="MEI">cutout</gi> element, and should provide it’s own dimensions using @width and @height there. In this case, @width and @height on <gi scheme="MEI">cutout</gi> is expendable.</p>
</remarks>
</elementSpec>