OmrBuffer.SerializationFormat property

This property qualifies the format of the string returned by the FrontBuffer and BackBuffer members.

SerializationFormat.Unformatted (default value)

For each timing mark, the scanner recognizes 48 OMR cells across the sheet, in a row. The size of the string is 48 * the number of timing marks. This is an empty string (length=0) if no timing marks are detected.

The read-level detected for each OMR cell is stored in a byte: ‘0’ –‘ 9’, ‘A ‘– ‘F’, or ‘<space>’ if the mark was not built.

SerializationFormat.Json

This represents a two dimensional JSON array (see http://json.org). The values stored in the array range from 0-15 (205 if the mark was not built). These are the numerical equivalent of the OMRLevel enumerated type. The array is indexed by 0-based timing mark and 0-based cell index. Use MaxCell to determine how many cells are returned and Front[Back]TimingMarks to determine how many timing marks were found.

In JavaScript, you can use eval to parse the OMR buffer into a JavaScript array object:

var a = eval(omrBuffer.FrontBuffer)

alert(a) // display entire array

alert(a[4+1][5+1]) // mark value at timing mark 5, cell 6

SerializationFormat.Xml

The representation is an XML fragment with a root element named ‘omrbuffer’ containing a list of child elements named ‘Mark’. Each ‘Mark’ element has attributes for the timing mark, cell number and mark value. The timing mark and cell numbers are 1-based. OMR values are numbers (0-15).

An example of the XML representation:

<omrbuffer >

<mark tm=”4” cell=”5” value=”14” />

<mark tm=”5” cell=”5” value=”3” />

</omrbuffer>