This software is distributed under the terms of the GNU General Public license, version 2 or later. See http://www.gnu.org/licenses/gpl.html for details.
This documentation is distributed under the terms of the GNU Free Documentation License, version 1.2 or later. The documentation has no invariant sections, no Front-Cover Texts and no Back-Cover Texts. See http://www.gnu.org/licenses/fdl.html for details.
This software is a utility for adding a custom paper size to PPD files for CUPS (Common Unix Printing System) which is shipped with the Linux driver for Epson serial impact dot matrix printers (SIDM) and Epson TM series miniprinters.
This editor consists of 2 RPM packages.
Package Name | Description |
---|---|
cpse | Base package The Command Line Mode can be used with just the base package. |
cpse-gtk | GUI package Install this with the base package if you want to use the GUI Mode. |
Note: The base package must be installed if you want to install the GUI package.
i386 architecture GNU/Linux
Note: Operation has been confirmed with the following distributions.
Refer to the documentation that comes with your distribution for installation of the RPM package. In many graphical environments, you can install the RPM package simply by double clicking it.
If you cannot install the RPM file by double clicking it on the screen, enter the following strings in the command line as the root user.
# rpm -U cpse-1.0.1-0.i386.rpm # rpm -U cpse-gtk-1.0.1-0.i386.rpm
During installation, a message may be displayed asking you to install additional packages. In this case, install the appropriate additional packages for your distribution.
Enter the following strings in the command line as the root user.
# rpm -e cpse-gtk # rpm -e cpse
To start the program, enter the following string in the command line as a user with CUPS administrator and PPD file editing privileges.
# cpse --gui &
Note:
# cpse
List of options at startup
Option | Description |
---|---|
--gui | Startup in the GUI Mode |
--version | Shows the version |
--help --usage | Shows a simple manual |
Note:
When you register a printer in CUPS, a PPD file for that printer is required. When a printer is registered, CUPS saves a copy of the specified PPD file and reads the printing conditions such as paper size from the copied PPD file.
The following two methods can be used to register paper sizes that are not included as standard in the PPD file.
The editor enables you to perform both tasks easily.
See 5.1 Adding a custom paper size to the PPD file for the procedure for adding or editing a custom paper size definition in the PPD file.
See 5.2 Adding a custom paper size to a printer registered in CUPS for the procedure for adding a custom paper size definition to the copy of the PPD file saved by CUPS.
See 5.3 Adding a custom paper size to the PPD file and applying it to CUPS for the procedure for first adding the custom paper size to the PPD file, then registering the printer in CUPS using that PPD file.
Note: For details about CUPS, see the CUPS website.
If the printer administrator adds a custom paper size to the PPD file and distributes it to users, with the following procedure it is only possible to edit the custom paper size in the PPD file.
With the following procedure, you can add a custom paper size to a printer registered in CUPS
Note: The added custom paper size is effective until the CUPS printer definition is deleted. To save the added custom paper size permanently, it is necessary to save the edited content in the PPD file of each printer. See 5.3 Adding a custom paper size to the PPD file and applying it to CUPS.
With the following procedure, you can add a custom paper size to a printer registered in CUPS, and save the settings in the PPD file.
When the editor starts in the GUI Mode, the following window is displayed.
No. | Description | Note |
---|---|---|
(1) | Model name | The model name of the printer and PPD file being edited is displayed. |
(2) | Printer selection button | Select a printer registered in CUPS. |
(3) | PPD file path input field | Select a PPD file to edit. The file selected in the file selection dialog box is displayed. |
(4) | Unit button | Select the display and input units for values. |
(5) | Minimum/maximum paper size | Displays the minimum/maximum values for settable paper width/paper height. |
(6) | Paper list | Displays the registered custom paper sizes. |
(7) | Paper name input field | Enter a paper name up to 72 ASCII characters. |
(8) | Paper width input field | Enter a paper width within the range of the minimum and maximum paper width. |
(9) | Paper height input field | Enter a paper height within the range of the minimum and maximum paper height. |
Click the printer selection button (2) and select a printer registered in CUPS from the pulldown list displayed.
Click the , navigate to the directory containing the PPD files, and select a PPD file. button (3)
Note:
The minimum/maximum values for settable paper width/paper height are shown in the window (5).
Enter a paper name (7), paper width (8), and paper height (9) within the correct range, and click .
To change the paper settings, select the paper from the paper list (6), enter the item to change, and click .
To remove paper settings, select the paper from the paper list (6) and click .
Note:
You can change the display/input units for paper size with the . button (4)
When entering paper width and paper height, use the units set.
To save changes to the PPD file, click
. The following dialog box is displayed.If you click unintentionally, click in the dialog box above. This returns to the editing screen.
Note:
Before applying the changes to CUPS, first stop the receipt of print jobs and printing in CUPS (http://localhost:631).
To apply the changes to CUPS, click
If you click unintentionally, click in the dialog box above. This returns to the editing screen.
After applying the changes to CUPS, restart the receipt of print jobs and printing in CUPS (http://localhost:631).
Note:
When the editor starts in the Command Line Mode, the following window is displayed.
Note: See 4 Starting the Program for starting in the Command Line Mode.
Custom Paper Size Editor (P) Select Printer / (F) Select PPD File / (Q) Quit >
The processes that can be selected are shown on the bottom line. Enter a single character in the brackets and press the Enter key. The character entered can be upper or lower case.
Here you can select the following items.
Key | Description |
---|---|
P or p | Select Printer |
F or f | Select PPD File |
Q or q | Quit |
To quit the program, enter q and press the Enter key.
If you select a printer with p or a PPD file with f, the Select Menu is displayed.
If you select the Main Menu with p, a list of the printers registered in CUPS is displayed.
Custom Paper Size Editor No. Printer 1 lq2680k 2 tmt88iv Select Printer (1-2) / Cancel (C) >
Enter the number of a printer to add or edit the custom paper size.
Select Printer (1-2) / Cancel (C) > 1 Read a different PPD file for this printer? [y/N] n
If you enter y for "Read a different PPD file for this printer? [y/N] ", you can then select a PPD file. Entering n displays the Select Menu.
Note:
Select a PPD file to add or edit the custom paper size.
(P) Select Printer / (F) Select PPD File / (Q) Quit > Filename >
To specify a PPD file name, specify the full path or a relative path from the directory shown when the editor starts up. To cancel selection of a PPD file, enter only Enter.
Note:
Printer: lq2680k / File: eplq2680k-custom.ppd No. Name [Units: cm] Width Height 1 A4 Wide 22.00 29.70 2 A4 Long 21.00 30.00 (E) Edit / (S) Save / (A) Apply to Printer / (U) Units / (Q) Quit > e
Here you can select the following items.
Key | Description |
---|---|
E or e | To the Edit Menu |
S or s | Save changes to the PPD file |
A or a | Apply changes to the printer |
U or u | Switch display units |
Q or q | Return to the Main Menu |
To edit the custom paper size, enter e. The Edit Menu is displayed, and you can edit the custom paper size.
To save the changes in the PPD file, enter s. The changes up to that point overwrite the relevant parts of the PPD file.
To apply the changes to CUPS, enter a. The changes up to that point are applied to the printer registered in CUPS.
Note:
Printer: lq2680k / File: eplq2680k-custom.ppd No. Name [Units: cm] Width Height 1 A4 Wide 22.00 29.70 2 A4 Long 21.00 30.00 (A) Add / (C) Change / (R) Remove / (U) Units / (F) Finish >
Here you can select the following items.
Key | Description |
---|---|
A or a | Add a custom paper size |
C or c | Edit the custom paper size |
R or r | Remove a custom paper size |
U or u | Switch display units |
F or f | Return to the Select Menu |
Note:
Enter the paper name and paper size.
If you enter only Enter, the values in the square brackets are used.
(A) Add / (C) Change / (R) Remove / (U) Units / (F) Finish > a Name > A4 Wide Width (min 2.54, max 42.00) [42.00 cm] > 21.5 Height (min 2.54, max 55.88) [55.88 cm] > 29.7 Name: A4 Wide W: 21.50 cm H: 29.70 cm Register? [y/N] y
When you have finished entering items, the items entered are displayed again.
Entering y for "Register? [y/N] " applies the changes to the paper list.
Entering n cancels the changes and returns to the Edit Menu.
Enter the number of a custom paper size to change. Enter the paper name and paper size.
If you enter only Enter, the currently set values in the square brackets are used. Enter only values that you want to change.
(A) Add / (C) Change / (R) Remove / (U) Units / (F) Finish > c (1-2) Custom paper / (C) Cancel > 1 Name [A4 Wide] > Width (min 2.54, max 42.00) [21.50 cm] > 22 Height (min 2.54, max 55.88) [29.70 cm] > Name: A4 Wide W: 22.00 cm H: 29.70 cm Register? [y/N] y
When you have finished entering items, the items entered are displayed again.
Entering y for "Register? [y/N] " applies the changes to the paper list.
Entering n cancels the changes and returns to the Edit Menu.
Enter the number of a custom paper size to remove.
(A) Add / (C) Change / (R) Remove / (U) Units / (F) Finish > r (1-2) Custom paper / (C) Cancel > 1 Really delete the selected entry? [y/N] y
Entering y for "Really delete the selected entry? [y/N] " removes the specified custom paper size from the paper list.
Entering n cancels the changes and returns to the Edit Menu.
Note: The content of the PPD file is not updated until you Save in the Select Menu.
You can select the display and input units for paper size.
(E) Edit / (S) Save / (A) Apply to Printer / (U) Units / (Q) Quit > u (C) cm / (I) inch > i
Keyword | Note |
---|---|
*MaxMediaWidth | The maximum value that can be set for paper width |
*MaxMediaHeight | The maximum value that can be set for paper height |
The values for paper size are shown on the screen up to only 2 decimal places, but when saving the paper size in the PPD file, convert them to PostScript standard units to save the values in the form that they are entered as far as possible.
Custom paper sizes added with the editor will use zero margins.
— Copyright © SEIKO EPSON CORPORATION 2008.