About This Guide

    What's new in Photon 1.14 (as of August 16, 2000)

      Corrections

Basic Installation

    Installing Photon Runtime onto a hard disk

    Adding additional network licenses

    Installing additional software

    Starting Photon

     Selecting initial graphics settings

      Display configuration

     Input manager

     Solving startup problems

    Technical support

     Supported hardware

    A word about Photon files

     User application configuration files

Configuring Photon

    Environment variables

    Booting directly into Photon

     Logging in at startup

      Suppressing phlogin

     Disabling the Desktop Manager

     Launching a Photon application at startup

    Setting up a pointing device

     Creating an input.node file

     Calibrating touchscreens

    Allowing for more Terminal windows

     Increasing Device Manager limits

     Increasing pseudo-tty driver limits

    Viewing/using remote Photon sessions

     Dittoing remote QNX Photon sessions

     Connecting to a remote Photon session

     Starting Photon sessions on other QNX nodes

     Spanning a single Photon session across multiple screens

     Sharing a Photon session (workgroup computing)

      Input group

Unicode Multilingual Support

    UTF-8 encoding

    Character set translation files

    Keyboard tables

     Creating new keyboard tables

      Creating a keyboard table from a text file

      Converting a keyboard table into a text file

     Selecting an international keyboard

     Composing international characters

    PhAB multilingual applications

Printing Support

    Printer installation and configuration

    Step 1. Configure parallel and network connections

      Connecting through a parallel port:

      Connecting through a TCP/IP network connection:

    Step 2. Set up phfont

    Step 3. Identify and test your printer and filter

    Step 4. Set up lpsrvr

     Spooler example

      If lpsrvr is running

      If lpsrvr isn't running

    Step 5. Set up your printer definition file

     Editing the printers file

      Device

       Filename

      Location

      NonPrintable

      Supported Options

     Alternate print filters

    Step 6. Select printers for a user

    Troubleshooting

Font Support

    Scalable fonts

     Font sets

      Core Latin set

      Mono-space fonts

      Extended Latin set

     Languages supported

     Japanese language support

    Photon font configuration

     Global vs local

     User configuration files

     Configuration utility

     Fonts tab

      Installing fonts

      Removing fonts

      Displaying font types

     Mappings tab

      Creating, modifying, and deleting aliases

      Unknown fonts

      Creating, modifying, and deleting substitution rules

      Bitstream scalable fonts

     Extensions tab

      Creating, modifying, and deleting extension rules

     Options tab

     Script Files

Photon in Embedded Systems

    Assumptions

    Introduction

      Steps to boot into Photon

    Step 1. Export the PHOTON_PATH environment variable

    Step 2. Start Photon server

     Files needed

    Step 3. Start input driver

     Files needed

    Step 4. Start font manager

     mkfontsys utility

     Font Manager

      Using QNX 4 to configure fonts

      Starting the font server

     Files needed

    Step 5. Switch into graphics mode

     Getting the card in the right mode

      Using vesabios

      Programming the registers directly

      Initializing the card before the OS starts

    Step 6. Start graphics driver

     Useful basic modeswitchers

      Syntax (for vesabios)

      Options

      Syntax (for vgadir)

      Options

     Files needed

    Step 7. Start window manager

     Files needed

    Step 8. Start your application

     Files needed

    Boot process

     QNX 4 file list

     Sample QNX 4 buildfile

     Sample QNX 4 boot program

     Neutrino file list

     Sample Neutrino buildfile

    Caveats

     Flash filesystems

     Graphics

     Misc

Applications and Utilities

    bdf_2_phf

     Syntax:

     Options:

     Description:

     Examples:

      Creating a .phf family

     Caveats:

    crttrap

     Syntax:

     Options:

     Description:

      Video card detection modules (Trapper modules)

      Mode-setting modules (modeswitchers)

      Options for Hydra.ms

      Graphics drivers

      Driver descriptions

     Examples:

     See also:

    dayminder

     Syntax:

     Options:

     Description:

     Examples:

    fontcfg

     Syntax:

     Options:

     Description:

    helpviewer

     Syntax:

     Options:

     Description:

      Creating help files

      Supported elements

      Supported entities

      Creating topic files

       Publishing your topic file

     Files:

    Input

     Syntax:

     Options:

      protocol [protocol_opts...]

      device [device_opts...]

      filter [filter_opts...]

     Description:

     Examples:

     See also:

    inputtrap

     Syntax:

     Options:

     Description:

     Examples:

     See also:

    kbcvt

     Syntax:

     Options:

     Description:

     Examples:

    kbsel

     Syntax:

     Options:

     Description:

      Adding keyboard mappings

     Examples:

     Files:

    mkfontsys

     Syntax:

     Options:

     Description:

     Examples:

     See also:

    mkkbd

     Syntax:

     Options:

     Description:

     Examples:

    msgpad

     Syntax:

     Options:

     Description:

     Examples:

    palette

     Syntax:

     Options:

     Description:

    pdm

     Syntax:

     Options:

     Description:

      Configuring the desktop

       Adding an application icon

       Deleting an application icon

       Updating startup options

       Setting up a Jump Gate

       Creating a folder

       Selecting a backdrop

       Selecting/Disabling a screen saver

       Viewing/Changing the graphics display configuration

     Files:

     Environment variables:

    ped

     Syntax:

     Options:

     Description:

      Cursor movement commands

      Deletion commands

      Formatting commands

      Centering commands

      Clipboard commands

      Special commands

      File menu operations

      Search menu operations

      Options menu operations

      Type menu operations

     Examples:

     Files:

    pfm

     Syntax:

     Options:

     Description:

     Examples:

    ph

     Syntax:

     Options:

     Description:

     Examples:

     Files:

     Environment variables:

    ph.boot

     Syntax:

     Options:

     Description:

    phcalc

     Syntax:

     Options:

     Description:

     Examples:

    phcd

     Syntax:

     Options:

     Description:

     Examples:

     Files:

    phditto

     Syntax:

     Options:

     Description:

      Remote connectivity via modem

      Remote connectivity via TCP/IP

     Examples:

     See also:

    phfont

     Syntax:

     Options:

     Description:

     Examples:

     Files:

       Synonym entries

       Scaling entries

     Caveats:

     See also:

    phgrafx

     Syntax:

     Options:

     Description:

     Changing the graphics resolution

     Selecting the refresh rate

     Selecting the color palette

     Examples:

     Files:

     See also:

    phin

     Syntax:

     Options:

     Description:

     Examples:

    phlogin

     Syntax:

     Options:

     Description:

     Environment variables:

     Caveats:

     See also:

    Photon

     Syntax:

     Options:

     Description:

     Examples:

     Environment variables:

    phrelay

     Syntax:

     Options:

     Description:

      Remote connectivity via modem

      Remote connectivity via TCP/IP

       Configuring for TCP/IP

      Using predefined Photon services

       phrelay configuration file format

      Data compression options

      Data caching options

     Examples:

     See also:

    phsac

     Syntax:

     Options:

     Description:

    ph.smallscreen

     Syntax:

     Options:

     Description:

     Examples:

    phspool

     Syntax:

     Options:

     Description:

     Examples:

    Pp.bmp

     Syntax:

     Options:

     Description:

     Examples:

     Files:

    Pp.canon

     Syntax:

     Options:

     Description:

     Examples:

     Files:

    Pp.escp2.*

     Syntax:

     Options:

     Description:

     Examples:

     Files:

    Pp.pcl

     Syntax:

     Options:

     Description:

     Examples:

     Files:

    Pp.ps

     Syntax:

     Options:

     Description:

     Examples:

     Files:

    preview

     Syntax:

     Options:

     Description:

     Examples:

    prsetup

     Syntax:

     Options:

     Description:

     Examples:

     Files:

    pterm

     Syntax:

     Options:

     Description:

      Keys and keychords

      Customizing your font list

     Examples:

     Files:

    ptermcs

     Syntax:

     Options:

     Description:

      Terminal charset setup

     Examples:

    pv

     Syntax:

     Options:

     Description:

     Examples:

    pwm

     Syntax:

     Options:

     Description:

       PWM Options

       Configuring the PWM Workspace Menu

     Examples:

     Files:

     Environment variables:

     See also:

    pwmclock

     Syntax:

     Options:

     Description:

     Examples:

    show_vesa

     Syntax:

     Options:

     Description:

    smallscreen

     Syntax:

     Options:

     Description:

     Files:

    snapshot

     Syntax:

     Options:

     Description:

       Switching consoles

     Examples:

     Environment variables:

    test_vesa2

     Syntax:

     Options:

     Description:

    vsin

     Syntax:

     Options:

     Description:

    winview

     Syntax:

     Options:

     Description:

     Examples:

Troubleshooting

Small-Screen Demo

    Photon for small screens

    What you need to run the demo

     Photon Runtime

      Startup scripts

     Voyager 2.0 Runtime

     Photon Toolkit

     Voyager 2.0 SDK

    What you get in the demo

     Photon Runtime

      Programs

      Startup scripts

       Script to run when not in Photon (ph.smallscreen)

       Script to run within Photon (smallscreen)

       Audio support

      Config and other files

     Photon Toolkit

      Source code

     Voyager 2.0

      Config and other files

Glossary