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