AMC-ANNOTE(1)						       Auto Multiple Choice						     AMC-ANNOTE(1)

NAME

       AMC-annote - completed answer sheets annotation after marking for AMC multiple choice exams.

SYNOPSIS

       auto-multiple-choice annote --projet project-dir --data project-data-dir --fich-assoc assoc.xml [annotation options...]

DESCRIPTION

       The AMC-annote.pl command annotates papers scans with scores for all questions, global score and mark, resulting in JPEG files (one for
       each page).

       --projet project-dir
	   sets the project directory.

       --data project-data-dir
	   gives the directory where data files are (see for example AMC-prepare(1)).

       --cr project-cr-dir
	   sets the project reports directory, where to find data capture reports prepared by AMC-analyse(1), and where to output annotated scans.
	   Default value is project-dir/cr.

       --fich-noms students-list.csv
	   sets the students list file name.

       --noms-encodage encoding
	   selects an encoding for file students-list.csv (default is utf-8).

       --qualite qual
	   sets JPEG quality for output files. Default value is 65.

       --taille-max maxsize
	   sets the maximal size for output files (in the format widthxheight, in pixels). Default value is 1000x1500.

       --pointsize-nl lines
	   sets the size of texts requiring that with this size, the number of text lines that fits on the page height must be lines. Default
	   value is 60.

       --verdict header
	   sets the text header to be printed on each first page of the students copies. This text may contain CR characters for multi-line
	   headers. Some sequences are substituted in it:

	   %S
	       is replaced by the student total score.

	   %M
	       is replaced by the maximum total score.

	   %s
	       is replaced by the student mark.

	   %m
	       is replaced by the maximum mark.

	   %(ID)
	       is replaced by the student's name.

	   %(COL)
	       is replaced by the value of column COL in the students list for the curent student.

       --ch-sign nc
	   Sets the number nc of significant digits to use when printing global mark.

       --symbols symbols-definition
	   defines how boxes will be annotated. symbols-definition is a comma separated list of H-A:shape:colour constructs, where H is 0 or 1
	   depending on wether the box has to be checked or not, A is 0 or 1 depending on wether the box is actually checked or not, shape is one
	   of none, circle, mark, box and coulour is a colour (name or #RGB, see ImageMagick or GraphicsMagick documentation for details). Default
	   value is "0-0:none,0-1:circle:red,1-0:mark:red,1-1:mark:blue".

       --position pos
	   sets the position of individual questions scores.  pos may be 'none' (do dot write individual scores), 'marge' (write scores in the
	   margin) or 'case' (write scores at the left of the left-most box for the question.

       --ecart dx
	   sets the horizontal space to let between individual question score and the leftmost box when --position case is used.

       --ecart-marge x
	   sets the x position for individual questions scores when written in the margin (in em units).

       --line-width lw
	   sets the line width for symbols drwan on the scans (in pixels). Default value is 2.

       --indicatives bool
	   say if indicative questions are to be annotated (use 1 for a true value; default is false).

       --debug file.log
	   gives a file to fill with debugging information.

AUTHORS

       Alexis Bienvenue <paamc@passoire.fr>
	   Main author

       Jean Berard
	   Translation from French

       Georges Khaznadar
	   Translation from French

COPYRIGHT

       Copyright (C) 2008-2012 Alexis Bienvenue

       This document can be used according to the terms of the GNU General Public License, version 2 or later.

Auto Multiple Choice 1.1.1					    06/19/2012							     AMC-ANNOTE(1)