Installing New Media to the Emulator
Printer
To add media to the Emulator you must edit the file named SupportedMedia.username.
This file stores the following information:
A description of the file is given below:
Key |
Value Description |
CurrentPrintHeadWidth |
It is set to the value of the selected print head width. This value must be listed in SupportedPrintHeadWidth.
This value can also be set via the Printer Capability… window: Media tab → Print Head Width dropdown box |
Continuous |
1 means the emulated printer will use continuous paper. 0 means the emulated printer will use non-continuous paper. The emulated printer can only have one type of media active at any given time.
This value can also be set via the Printer Capability… window: Media tab → Type dropdown box |
PaperLength |
This value is used to set the length of the continuous media. The valid range for this key starts at 163 cm/64 inches and ends at 1626 cm/640 inches.
This value can also be set via the Printer Setup… window: Media tab → Paper Length text box This text box is displayed only if the continuous media is selected as the type (in Printer Capability…). |
SupportedMedia |
Lists the media currently supported by the emulator. Any media that is added to the emulator should be added here. |
CurrentMedia |
It is set to the name of the current media loaded.
This value can also be set via the Printer Setup… window: List on the left under the Media tab. |
SupportedPrintHeadWidth |
Lists all the print head widths the emulator supports. |
PaperCount |
The number of pages for non-continuous media. This key supports a minimum value of 1 and goes up to 1000.
This value can also be set via the Printer Setup… window: Media tab → Paper Count text box This text box is displayed only if the non-continuous media is selected as the type (in Printer Capability…). |
PaperLengthDispalyUnit |
Sets the unit to be used for the paper length. This can have one of two values: 0 means that paper length will be given in inches. 1 means that paper length will be given in centimeters.
This value can also be set via the Printer Capability… window: Media tab → Unit System dropdown box |
Media details: (for a media named medianame)
Key |
Value Description |
medianame.Size |
Description: This value contains the media dimensions in inches. Required: Yes Format: The format of this key is “width, height”. The unit of measure for this value is “inches”. Further Notes: It is important to know that continuous media has zero as its length. |
medianame.Margin |
Description: Holds the margin between printable area and the edge of the media. Required: No (optional) Format: It is specified in format of “top, left, bottom, right” and the unit of measure is “inches”. Further Notes: Although it is visible on the virtual printout area, it is not enforced by the emulated printer. It is just a visual help. This key is only supported for non-continuous media. |
medianame.Preprint |
Description: Used for predefined areas settings in the media, like labels in the media, for example. Required: No (optional) Format: It is specified in format of “columns, rows, horizontal gap, vertical gap” in the unit of measure of “inches”. The columns and rows entries must be integer values. Further Notes: Like the margin, it is just another visual help. The Emulator will calculate the width of the column and the height of the row. This key is only supported for non-continuous media.
The use of this key will be discontinued. The "Label" key should be used in its place. |
medianame.Label |
Description: Used for predefined areas settings in the media, like labels in the media, for example. Required: No (optional) Format: It is specified in format of "label width, label height, vertical gap, columns" and the unit of measure is "inches". The columns entry must be an integer value. Further Notes: Like the margin, it is just another visual help. The Emulator will calculate the width of the column.
This key should be used instead of the Preprint key. |

The developer can modify the default configuration by editing the file named SupportedMedia.dft. For the changes to take effect in the developer’s emulator, delete the file named SupportedMedia.username. The next time the Emulator opens it will be configured based on the default file.

Changes made to the default file affect any user who launches the emulator for the first time after these changes are done.
The media has been added to the emulator printer.
The following is a sample of the file. The sequence of lines has been adjusted and blank lines are added for ease of reading.
#
#Thu Jul 15 11:33:43 VET 2004
continuous=0
CurrentMedia=A4
CurrentPrintHeadWidth=8.5
PaperCount=100
PaperLength=320
PaperLengthDispalyUnit=0
SupportedMedia=Letter,Legal,A3,A4,B4,B5,Plain11x17,Plain4x8,2x4_in_4x8,Continuous_1,Continuous_2,Continuous_3,Continuous_4,Continuous_8.5
SupportedPrintHeadWidth=1,2,3,4,8.27,8.5,12
2x4_in_4x8.Margin=0.2,0.2,0.2,0.2
2x4_in_4x8.Preprint=2,4,0.05,0.05
2x4_in_4x8.Size=4,8
A3.Size=11.69,16.54
A4.Size=8.27,11.67
B4.Size=10.12,14.33
B5.Size=7.17,10.12
Continuous_1.Size=1,0
Continuous_2.Size=2,0
Continuous_3.Size=3,0
Continuous_4.Size=4,0
Continuous_8.5.Size=8.5,0
Legal.Size=8.5,14
Letter.Size=8.5,11
Plain11x17.Size=11,17
Plain4x8.Margin=0.2,0.2,0.2,0.2
Plain4x8.Size=4,8
Below is the file after the new media has been added. For visualization purposes the changes are colored red.
#
#Thu Jul 15 11:33:43 VET 2004
continuous=0
CurrentMedia=A4
CurrentPrintHeadWidth=8.5
PaperCount=100
PaperLength=320
PaperLengthDispalyUnit=0
SupportedMedia=Letter,Legal,A3,A4,B4,B5,Plain11x17,Plain4x8,2x4_in_4x8,Continuous_1,Continuous_2,Continuous_3,Continuous_4,Continuous_8.5,New Media
SupportedPrintHeadWidth=1,2,3,4,8.27,8.5,12
2x4_in_4x8.Margin=0.2,0.2,0.2,0.2
2x4_in_4x8.Label=2.0,4.0,0.05,2
2x4_in_4x8.Size=4,8
New\ Media.Margin=0.2,0.2,0.2,0.2
New\ Media.Label=2.0,4.0,0.05,2
New\ Media.Size=8,10
A3.Size=11.69,16.54
A4.Size=8.27,11.67
B4.Size=10.12,14.33
B5.Size=7.17,10.12
Continuous_1.Size=1,0
Continuous_2.Size=2,0
Continuous_3.Size=3,0
Continuous_4.Size=4,0
Continuous_8.5.Size=8.5,0
Legal.Size=8.5,14
Letter.Size=8.5,11
Plain11x17.Size=11,17
Plain4x8.Margin=0.2,0.2,0.2,0.2
Plain4x8.Size=4,8