Show TOC Start of Content Area

This graphic is explained in the accompanying text Installing New Media to the Emulator Printer  Locate the document in its SAP Library structure

Use

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 graphic is explained in the accompanying text

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 graphic is explained in the accompanying text

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 graphic is explained in the accompanying text

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 graphic is explained in the accompanying text

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 graphic is explained in the accompanying text

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 graphic is explained in the accompanying text

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.

This graphic is explained in the accompanying text

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 graphic is explained in the accompanying text

This key should be used instead of the Preprint key.

 

 

Procedure

  1. Make a backup copy of the file named SupportedMedia.username, where username refers to the logon name of the user.

This graphic is explained in the accompanying text

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.

 This graphic is explained in the accompanying text

Changes made to the default file affect any user who launches the emulator for the first time after these changes are done.

  1. Open the file named SupportedMedia.username in a text editor.
  2. Create a descriptive name for the media.
  3. Add the name to list of supported media.
  4. Create detail lines for the media. The only media detail line required is Size. If desired Margin and Preprint may be added for non-continuous paper. (Refer to before and after example below.)

 

Result

The media has been added to the emulator printer.

 

Example

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

 

 

End of Content Area