1.1 --- a/src/ptouch.h Wed Aug 05 15:15:47 2009 +0100 1.2 +++ b/src/ptouch.h Wed Aug 05 16:03:03 2009 +0100 1.3 @@ -18,19 +18,31 @@ 1.4 * 1.5 * This is used to store the state of the printer as of the last call to 1.6 * pt_GetStatus(), the current job settings, and other details required 1.7 - * by the printer driver. 1.8 + * by the printer driver. User code should not change any parameters inside 1.9 + * a pt_Device struct under any circumstances. For further information on 1.10 + * the various fields, see the Brother PT-9500PC Command Reference. 1.11 */ 1.12 typedef struct { 1.13 /// Reference to the printer device 1.14 FILE *fp; 1.15 /// Error information 1.16 int errorInfo[2]; 1.17 - /// Label width, type and length 1.18 - int mediaWidth, mediaType, mediaLength; 1.19 + /// Label width (in millimetres) 1.20 + int mediaWidth; 1.21 + /// Label type 1.22 + int mediaType; 1.23 + /// Label length (in millimetres) 1.24 + int mediaLength; 1.25 /// Label width in pixels 1.26 int pixelWidth; 1.27 - /// Status type, phase type, and phase number 1.28 - int statusType, phaseType, phaseHi, phaseLo; 1.29 + /// Printer status type 1.30 + int statusType; 1.31 + /// Printing phase type 1.32 + int phaseType; 1.33 + /// Printing phase, high byte 1.34 + int phaseHi; 1.35 + /// Printing phase, low byte 1.36 + int phaseLo; 1.37 /// Notification number 1.38 int notification; 1.39 1.40 @@ -38,9 +50,8 @@ 1.41 int autocut; 1.42 /// Print parameter: mirror printing enable 1.43 int mirror; 1.44 - /// Print parameter: half-cut enable 1.45 - /// Print parameter: chainprint enable 1.46 - /// Print parameter: label end cut 1.47 + // TODO: add support for half-cut (when I get a printer that supports it) 1.48 + // TODO: add support for printing a separator line when autocut is off 1.49 } pt_Device; 1.50 1.51 /* 1.52 @@ -70,7 +81,7 @@ 1.53 * Job options 1.54 */ 1.55 typedef enum { 1.56 -/// Mirror -- mirror the printed label along the long edge 1.57 +/// Mirror -- mirror the printed label vertically 1.58 PT_OPTION_MIRROR, 1.59 /// Auto-cutter -- enable or disable automatic label cutting 1.60 PT_OPTION_AUTOCUT