Defining Custom Fonts

Overview

When designing graphical images in APPX there are 9 fonts pre-configured with the Desktop Client that are part of the Java installation within the client. In order to use custom fonts not included with the installation, such as bar codes, there are a few steps that must be taken. Follow these steps and you should be able to make use of custom fonts on your PDF outputs. Again, not all custom fonts will work and you may have to try more that one font to find one that does work

Custom Fonts on a Windows Server

The easiest way to include a custom font is to install the font on your Windows server. The steps to install the font will be different depending on the desktop OS release. The steps below are for Windows XP Professional.

• Save the font to somewhere on your desktop
• Open the Windows Control Panel
• Open the Fonts folder
• From the File menu, choose "Install New Font..."
• Use the Add Fonts selector to find the font
• Click on OK. This will install the font.

After you have installed a font you must tell Appx the name of the font, not the name of the font file. For example, the "Free 3 of 9" font is distributed in a file named "free3of9.ttf", but the name of the font is actually "Free 3 of 9 Regular". (you can also use "Free 3 of 9"). To find the font name, open the font file (free3of9.ttf) with Font Viewer (the easiest way to do that is to simply double-click on the font file in the Windows file manager).

• Log into APPX and select Application Design for the app you where you will be using the custom font.
• Select Name Resources and define a resource with:
  • Select the ROLLOVER SELECTED state
  • Set the Location Type to SERVER FILE
  • Enter the font name (not .ttf file name) as the Location Data (Free 3 of 9 Regular, for example)
• On you image define an alpha field with GUI Attributes:
  • Select the Control Type of Label
  • In Resource enter the application and name you set in the above step
  • Leave the Font blank
  • Enter a name in the Name field (VENDOR BAR CODE in this example)
• In the Pre-Display event point enter the following code:

      SET      --- WIDGET NAME                =      VENDOR BAR CODE
      READ     --- WIDGET                 HOLD 1 FT 0 BY WIDGET NAME
T     SET      --- II                         =      10
T     SET      --- WIDGET FONT                =  --- II
T     REWRITE  --- WIDGET                 FAIL 0

Custom Fonts on a Unix or Linux Server

• Place the font file (Free3of9.ttf) in the Resource directory for one of your applications.
• Log into APPX and select Application Design for the app you where you will be using the custom font.
• Select Name Resources and define a resource with:
  • Select the ROLLOVER SELECTED state
  • Set the Location Type to DESIGN FILE
  • Enter the font file name without the extension as the Location Data (free3of9, for example)
• On you image define an alpha field with GUI Attributes:
  • Select the Control Type of Label
  • In Resource enter the application and name you set in the above step
  • Leave the Font blank
  • Enter a name in the Name field (VENDOR BAR CODE in this example)
• In the Pre-Display event point enter the following code:

      SET      --- WIDGET NAME                =      VENDOR BAR CODE
      READ     --- WIDGET                 HOLD 1 FT 0 BY WIDGET NAME
T     SET      --- II                         =      10
T     SET      --- WIDGET FONT                =  --- II
T     REWRITE  --- WIDGET                 FAIL 0

Defining Custom Fonts

When designing graphical images in APPX there are 9 fonts pre-configured with the Desktop Client that are part of the Java installation within the client. In order to use custom fonts, such as bar codes, there are a few steps that must be taken. Follow these steps and you should be able to make use of custom fonts on your PDF outputs.

Disclaimer: While these steps work in most cases this implimentation of custom fonts is not supported in APPX (not in 4.x or 5.x).

Custom Fonts on a Windows Server

The easiest way is to install the font on your Windows server.

1) Open the Windows Control Panel

2) Open the Fonts folder
From the File menu, choose "Install New Font..." and then choose the font file (for example, free3of9.ttf)

When you install a font, you must tell Appx the name of the font, not the name of the font file. For example, the "Free 3 of 9" font is distributed in a file named "free3of9.ttf", but the name of the font is actually "Free 3 of 9 Regular". (you can also use "Free 3 of 9"). To find the font name, open the font file (free3of9.ttf) with Font Viewer (the easiest way to do that is to simply double-click on the font file in the Windows file manager).

Once you've installed the font, use the font name when referring to the font, not the .ttf file name.

Log into APPX and go to Application Design.

1) Select Name Resources and define a resource with:

State will be ROLLOVER SELECTED

Location Type will be SERVER FILE

Location Data will be the font name as described above (Free 3 of 9 Regular in this example)

2) On you image define an alpha field with as a Label widget

Enter the Named Resource defined above

Leave the Font Name field blank

3) In the Pre-Display event point enter the following code:

SET --- WIDGET NAME = VENDOR BAR CODE
READ --- WIDGET HOLD 1 FT 0 BY WIDGET NAME
T SET --- II = 10
T SET --- WIDGET FONT = --- II
T REWRITE --- WIDGET FAIL 0

The font will be embedded in the PDF document so the custom font should be viewable and printable on all systems whether the font is installed on the system or not.

Custom Fonts on a Unix or Linux Server

Follow these instructions to install a custom font. This example will refer to the Free3of9.ttf bar code font.

1) Place the font file (Free3of9.ttf) in the Resource directory for one of your applications.

2) Log into APPX and go to application disign for that applications. Add a Named Resource.

The State will be ROLLOVER SELECTED

The Location Type will be DESIGN FILE

The Location Data with be Free3of9 (the font file name without the extension)

3) On your output define an alpha field and make it a Label widget.

Enter the resource name you created above

Leave the Font Name field blank

Enter a name for the widget

4) In the Pre-Display event point enter the following code. Replace VENDOR NUMBER with the name of your widget.

SET --- WIDGET NAME = VENDOR NUMBER
READ --- WIDGET HOLD 1 FT 0 BY WIDGET NAME
T SET --- II = 10
T SET --- WIDGET FONT = --- II
T REWRITE --- WIDGET FAIL 0

The font will be embedded in the PDF document so the custom font should be viewable and printable on all systems whether the font is installed on the system or not.

-- GaryRogers - 2010-03-01