HP Visualize J5000 hp workstations - hp-ux 10.20 graphics administration guide - Page 2

ABOUT THIS GUIDE

..............................................................................................................................................................

6

PREFACE

..................................................................................................................................................................................

8

W

HY

T

HIS

D

OCUMENT

?

..........................................................................................................................................................

8

D

OCUMENT

C

ONVENTIONS

......................................................................................................................................................

9

CHAPTER 1: PATHNAMES

.................................................................................................................................................

10

U

SING

“

WHENCE

”

..................................................................................................................................................................

10

U

SING

“

FIND

”

........................................................................................................................................................................

10

S

TARBASE

..............................................................................................................................................................................

11

HP-PHIGS

............................................................................................................................................................................

12

HP

PEX

.................................................................................................................................................................................

13

CHAPTER 2: COMPILING YOUR APPLICATION

.........................................................................................................

14

C

OMPILING

S

TARBASE

A

PPLICATIONS

...................................................................................................................................

14

Compiling with Shared Libraries

.....................................................................................................................................

14

Compiling with Archive Libraries

....................................................................................................................................

14

C

OMPILING

HP-PHIGS

A

PPLICATIONS

.................................................................................................................................

15

Compiling with Shared Libraries

.....................................................................................................................................

15

Compiling with Archive Libraries

....................................................................................................................................

16

D

EVICE

D

RIVER

L

IBRARIES

...................................................................................................................................................

17

C

OMPILING

HP

PEX

A

PPLICATIONS

......................................................................................................................................

21

C

OMPILING

O

PEN

GL

A

PPLICATIONS

.....................................................................................................................................

21

CHAPTER 3: X WINDOWS: HP-UX 10.20

.........................................................................................................................

22

X

S

ERVER

C

ONFIGURATION

..................................................................................................................................................

22

X*screens File

..................................................................................................................................................................

23

Description of the X*screens Configuration File

.............................................................................................................

23

The X*screens File Format

..............................................................................................................................................

23

Sample X*screens Files

....................................................................................................................................................

25

M

ISCELLANEOUS

T

OPICS

.......................................................................................................................................................

30

Double Buffer Extension (DBE)

.......................................................................................................................................

30

Display Power Management Signaling (DPMS)

..............................................................................................................

31

MBX

.................................................................................................................................................................................

32

Shared Memory Extension (MIT_SHM)

...........................................................................................................................

33

Shared Memory Transport (SMT)

....................................................................................................................................

34

Performance Tuning of SMT

............................................................................................................................................

35

Enabling and Disabling of SMT

.......................................................................................................................................

37

HP Color Recovery

..........................................................................................................................................................

38

Dynamic Loading

.............................................................................................................................................................

39

Include Inferiors Fix

........................................................................................................................................................

39

Shared Memory Usage With 3D Graphics

.......................................................................................................................

40

Count Transparent In Overlay Visual

..............................................................................................................................

41

Enable Overlay Transparency

.........................................................................................................................................

41

3-Bit Center Color

...........................................................................................................................................................

41

Image Text Via BitMap

....................................................................................................................................................

42

Obsolete Environment Variables

.....................................................................................................................................

42

Special Device Files

.........................................................................................................................................................

42

S

UPPORTED

X

C

ONFIGURATIONS

...........................................................................................................................................

43

Multi-Display Support

......................................................................................................................................................

43

Multi-Screen Support

.......................................................................................................................................................

45

Single Logical Screen (SLS)

.............................................................................................................................................

45

Distributed Single Logical Screen (SLS/d)

.......................................................................................................................

48

I

NTEGRATED

C

OLOR

G

RAPHICS

D

EVICE

-D

EPENDENT

I

NFORMATION

....................................................................................

51

Graphics Administration Guide for HP-UX 10.20

HP Visualize J5000 hp workstations - hp-ux 10.20 graphics administration guide - Page 2

About This Guide, Preface, Pathnames, Compiling Your Application

Page 2 highlights

Section	Page
About this Guide	6
Notices	6
Warranty	6
Restricted Rights Legend	6
Printing History	7
Preface	8
Why This Document?	8
Document Conventions	9
Chapter 1: Pathnames	10
Using “whence”	10
Using “find”	10
Starbase	11
HP-PHIGS	12
HP PEX	13
Compiling Starbase Applications	14
Compiling with Shared Libraries	14
Examples	14
Compiling with Archive Libraries	14
Examples	15
Compiling HP-PHIGS Applications	15
Compiling with Shared Libraries	15
Compiling with Archive Libraries	16
Device Driver Libraries	17
Compiling HP PEX Applications	21
Compiling OpenGL Applications	21
Chapter 3: X Windows: HP-UX 10.20	22
X Server Configuration	22
X*screens File	23
Description of the X*screens Configuration File	23
Syntax Guidelines	23
The X*screens File Format	23
Server Options	24
Screen Entries	24
Sample X*screens Files	25
Miscellaneous Topics	30
Double Buffer Extension (DBE)	30
Performing Buffer Swaps On Vertical Blank	30
Determining Swap Performance	30
Supported Devices	31
Display Power Management Signaling (DPMS)	31
MBX	32
Shared Memory Extension (MIT_SHM)	33
Supported Devices	34
Shared Memory Transport (SMT)	34
Performance Tuning of SMT	35
Enabling and Disabling of SMT	37
HP Color Recovery	38
Dynamic Loading	39
Include Inferiors Fix	39
Shared Memory Usage With 3D Graphics	40
Changing Graphics Shared Memory Size	40
Count Transparent In Overlay Visual	41
Enable Overlay Transparency	41
3-Bit Center Color	41
Image Text Via BitMap	42
Obsolete Environment Variables	42
Special Device Files	42
Supported X Configurations	43
Multi-Display Support	43
Multi-Screen Support	45
Single Logical Screen (SLS)	45
3D Acceleration and Single Logical Screen	47
HP VUE/CDE and Single Logical Screen	47
Distributed Single Logical Screen (SLS/d)	48
To Configure the SLS/d Slave X Servers	48
To Configure the SLS/d Master X Server	49
Integrated Color Graphics Device-Dependent Information	51
Supported Visuals	51
Supported Screen Options	51
Colormaps and Colormap Management	51
Default Colormap Management Scheme	51
Accessing HP Color Recovery Technology via Xlib	52
Internal Color Graphics, Internal Grayscale Graphics, CRX, G	54
Supported Visuals	54
Supported Screen Options	54
CRX-24[Z] Device-Dependent Information	55
Supported Visuals	55
Supported Screen Options	55
CRX-24[Z] Transparent Overlay Visuals	55
CRX-48Z Device-Dependent Information	56
Supported Visuals	56
Supported Screen Options	56
CRX-48Z Transparent Overlay Visuals	56
HCRX and HP VISUALIZE Device-Dependent Information	57
Supported Visuals	58
Supported Screen Options	59
HP VISUALIZE-EG Modes	59
HCRX Configuration Hints	60
HCRX-8[Z], HP [Dual] VISUALIZE-EG and HP VISUALIZE-8 Visuals	60
Implications and Suggestions for HCRX-8[Z], HP [Dual] VISUAL	60
HCRX Overlay Visuals and Overlay Transparency	61
Overlay Transparency on the HCRX-8[Z], HP [Dual] VISUALIZE-E	61
Overlay Transparency on the HCRX-24[Z], HP VISUALIZE-24, and	62
HCRX Colormaps	63
HP VISUALIZE-EG(8): 8 Image planes	63
HCRX-8[Z], HP [Dual] VISUALIZE-EG and HP VISUALIZE-8: Eight	63
HCRX-24[Z] and HP VISUALIZE-24: Eight Overlay Planes and 24	64
HP VISUALIZE-48[XP]: Eight Overlay Planes and 48 Image Plane	64
Accessing HP Color Recovery Technology via Xlib	64
HP VISUALIZE-FX (FX2, FX4 and FX6) Device-Dependent Informat	67
Supported Visuals	67
Supported Screen Options	70
HP VISUALIZE-FX Configuration Hints	70
Overlay Visuals and Overlay Transparency	70
Disabling the GLX Visuals	72
HP VISUALIZE-FX2/4/6 Colormaps	72
Changing the Monitor Type	72
HP VISUALIZE-FXE, FX5 and FX10 Device-Dependent Information	73
Disable 12 Bit Direct Color Visual	73
Supported Visuals	73
HP VISUALIZE-FXE/5/10 Configuration Hints	74
Overlay Visuals and Overlay Transparency	74
Disabling the GLX Visuals	74
Changing the Monitor Type	75
Freedom Series Graphics Device-Dependent Information	75
Supported Visuals	75
Supported Screen Options	76
Freedom Video Formats	76
VRX Device-Dependent Information	77
Supported Visuals	77
VRX Device Files	77
Chapter 4: X Windows Configuration Details	79
Making an X*.hosts File	79
X0.hosts and X0screens Relation	79
Using an /etc/hosts File	80
Using Special Input Devices	80
How the X Server Chooses the Default Keyboard and Pointer	80
X*devices File	81
Explicitly Specifying Input Device Use	82
Explicitly Specifying RS-232 Input Device Use	82
Examples	84
Specifying hp-HIL Input Device Use by Device File Name	85
Redefining the hp-HIL Search Path	86
Stopping the X Window System	86
Initializing the Colormap with xinitcolormap	87
Customizing the Mouse and Keyboard	88
Going Mouseless with the X*pointerkeys File	89
Configuring X*devices for Mouseless Operation	90
The Default Values for the X*pointerkeys File	90
Creating a Custom X*pointerkeys File	91
Syntax	91
Assigning Mouse Functions to Keyboard Keys	91
Modifier Keys	95
Specifying Pointer Keys	95
Examples	95
Customizing Keyboard Input	97
Modifying Modifier Key Bindings with xmodmap	97
Specifying Key Remapping Expressions	98
Examples	99
Printing a Key Map	100
Using the Keyboards	100
Understanding the Keyboards	100
Default Keyboard Mapping	101
Equivalent Keys	101
Changing Key Mapping	101
C1429 Keyboard	102
46021 Keyboard	102
Comparing the Keyboards	102
Compatibility Considerations	103
Re-Installing PowerShade	104
3D Graphics Performance	104
Texture Mapping	105
hp PEX Graphics Performance	106
hp-PHIGS Graphics Performance	109
3D Thread-Safing	115
General Information	115
SIGALRM Details	116
SIGCHLD and the GRM Daemon	117
SIGCHLD and the Starbase Input Daemon	118
SIGPIPE Details	118
Gamma Correction	118
Why Is Gamma Correction Needed?	119
Monitor Brightness and Contrast	120
How to Install the Gamma Icon Into your CDE Front Panel	120
Using the Gamma Correction Tool	123
Gamma Value Slider	123
Scope of Gamma Correction	123
Selecting All Windows	123
Selecting Individual Windows	123
Save as Screen Default	124
Remove Screen Default	124
hp CDE and hp VUE	124
Shared Memory Usage	124
Reference Documentation	125
Synopsis	126
Description	126
Starting Up	127
Display Names	128
Access Control	129
Geometry Specifications	130
Window Managers	131
Font Names	131
Font Server Names	133
Color Names	133
Keyboards	135
Options	136
Resources	137
Examples	141
Diagnostics	141
See Also	142
Copyright	142
Trademarks	142
Authors	142
Appendix B: X Server Reference Page	143
Name	143
Synopsis	143
Description	143
Options	144
Security File Format	147
Running From INIT	151
Granting Access	151
Signals	152
Fonts	153
Diagnostics	153
Files	154
Notes	154
Copyright	154
Origin	154
See Also	155
Appendix C: Low BandWidth X Proxy	156
Name	156
Synopsis	156
Description	156
Atom Control	159
Notes	159
Origin	159
See Also	159
Appendix D: RX Netscape Navigator Plug-in	160
Name	160
Description	160
Installation	160
Resources	161
Environment	162
Notes	162
Origin	162
See Also	162
Appendix E: Proxy Manager Service	163
Name	163
Synopsis	163
Description	163
Proxy Manager Config File	164
Example	165
Proxy Manager Details	165
Notes	165
Origin	166
See Also	166
Appendix F: Locate Proxy Services	167
Name	167
Synopsis	167
Description	167
Origin	168
See Also	168
Appendix G: RX Helper Program	169
Name	169
Synopsis	169
Description	169
Installation	169
Options	170
Resources	170
Environment	170
Notes	171
Origin	171