Graphics Administration Guide for HP-UX 11.x

Embed Size (px)

Citation preview

  • 8/2/2019 Graphics Administration Guide for HP-UX 11.x

    1/89

    graphics administration guide

    for HP-UX 11.x

    Manufacturing Part Number: B2355-IE003

    Edition E0206

    Copyright 2006 by Hewlett-Packard

  • 8/2/2019 Graphics Administration Guide for HP-UX 11.x

    2/89

    2

    legal noticeThe inform at ion cont ained in th is document is subject to chan ge without n otice.

    Hewlett-Packar d a ssumes no responsibility for th e use or reliability of its

    software on equipment th at is not fur nished by Hewlett -Packar d.

    This docum ent contains proprietar y inform at ion t ha t is pr otected by copyright.All right s reser ved. No par t of th is docum ent ma y be photocopied, repr oduced or

    tr an slated to another langua ge without th e prior writt en consent of

    Hewlett-Packar d Compa ny.

    restricted rights legendUse, duplication, or disclosur e by the U.S. Govern men t Depa rt men t of Defense is

    subject to restrictions as set forth in paragraph (b)(3)(ii) of the Rights in

    Technical Data and Software clause in DFARS

    252.227.7013.

    This docum ent contains proprietar y inform at ion t ha t is pr otected by copyright.

    All right s ar e reser ved. No par t of th is docum ent ma y be photocopied, repr oducedor tr an slated to another langua ge without th e prior writt en consent of

    Hewlett-Packar d Compa ny.

    UNIX is a registered tr adema rk in t he United St at es of America and other

    coun tr ies, licensed exclusively th rough X/Open Compa ny Limit ed.

    This software an d docum enta tion is based in par t on th e Four th Berkeley

    Softwar e Distribut ion un der license from th e Regent s of the Un iversity of

    California.

    Fire GL is a r egistered t ra demar k of ATI

    Copyright 2006 Hewlett -Packar d Compan y. All Right s Reserved.

    Copyr ight 1980, 1984 AT&T, In c.

    Copyrigh t 1979, 1980, 1983 The Regent s of th e Un iversity of Californ ia.

  • 8/2/2019 Graphics Administration Guide for HP-UX 11.x

    3/89

    Contents

    1

    1. preface

    docum en t conven t ions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

    2. con figuring X Wind ow s on HP -UX (HP Visua lize graph ics card s)

    X Server configur a t ion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

    X*screen s file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

    descrip tion of th e X*screen s configur at ion file . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

    syn tax guidelin es . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

    the X*screen s file format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

    ser ver opt ions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13screen en t r ies. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

    sa mple X*screens files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

    miscella neous topics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

    double bu ffer ext en sions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

    per form ing bu ffer s wap s on vert ical blan k . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

    det ermin ing swa p per forma nce . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

    su ppor ted devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21displa y power m ana gement signa ling (DPMS) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

    sh ar ed m emory exten sion (MIT_SHM) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

    su ppor ted devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

    su pport ed X configur at ions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

    mult i-disp lay su ppor t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

    mult i-screen s upport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

    sin gle logical screen (SLS) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

    3D a ccelera tion a nd single logica l screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

    hp CDE an d sin gle logical screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

    hp Visualize- FXE, FX5 an d FX10 device-depend ent information . . . . . . . . . . . . . . . . 28

    su pport ed vis ua ls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

    su pport ed screen opt ions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

    hp VISUALIZE-FXE/5/10 configura t ion hin t s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

    overlay visu als an d overlay t ra ns pa rency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

    disa bling t he GLX visua ls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

    hp VISU ALIZE-F XE/5/10 colorm aps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

    cha nging the monit or t ype. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

    3. con figuring X Wind ow s on HP -UX (othe r graphic s cards )

    usin g SAM to configur e X Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33us ing se tm on t o configure th e monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

  • 8/2/2019 Graphics Administration Guide for HP-UX 11.x

    4/89

    Contents

    2

    the XF86Config file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

    the XF86Config file format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

    Ser ver Layout sect ion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

    File s section . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

    Modu le section . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

    In pu tDevice section . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

    Screen sect ion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

    Disp lay subsect ion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

    Monit or section . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

    Device section . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

    sa mple XF86Con fig file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

    ext en sions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

    double bu ffer ext ension (DBE ) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

    det erminin g swap per form an ce . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

    displa y power m an agemen t s igna ling (DPMS) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

    dyn amic libra ry loading . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

    feat ures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58cur sor sca ling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

    Glx visu a l su ppress ion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

    visu als suppress ion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

    techn ical pr in t ser vice (TPS) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

    vir tual fra me bu ffer (Xvfb) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

    secu r ity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

    connectin g to th e net work . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60grant ing access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

    sign als . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

    sta rt ing th e X Server from t he comm an d line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

    ma pping options from th e previous h p X Server t o the curren t h p X Server . . . . . . 61

    defa ultVisua l opt ion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61

    minim um monitor power sa ve level opt ion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

    HPCu rs orScaleFa ctor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

    NoServer Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

    Disa bleGlxVisua ls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

    DPMSSt an dbyTime

    DPMSSu spend Time

    DP MSOffTim e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

    HideDu plicat eGlxVisua ls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

  • 8/2/2019 Graphics Administration Guide for HP-UX 11.x

    5/89

    Contents

    3

    inpu t devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64

    keyboar ds . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64

    su pport ed keyboard dr ivers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64

    su pport ed k eyboard opt ions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64

    poin ter s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64

    su pport ed point er dr ivers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64

    su pport ed point er options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64

    out pu t devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65

    hp Fir e GL-UX device-depen den t in form at ion . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65

    su ppor ted visua ls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65

    su ppor ted device opt ions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65

    su pport ed m onitor configur at ions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66

    ATI FireGL X1/T2/X3 device-depen den t in form at ion . . . . . . . . . . . . . . . . . . . . . . . 67

    su ppor ted visua ls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67

    su pport ed d evice opt ions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68

    su pport ed m onitor configur at ions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

    hp Fir e GL-UX configura tion hin ts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71overlay visu a ls an d overlay tr ans pa rency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71

    syst em requir ement s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73

    ha rdware comp a tibilit y ta ble . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73

    monit or compa t ibilit y . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73

    compa tibilit y ma t rix wit h p revious relea ses . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74

    miscella neous . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

    font s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

    ATI Fir eGL X1/T2/X3 configura tion hin ts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77

    overlay visu a ls an d overlay tr ans pa rency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77

    colorm aps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77

    gamma correct ion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77

    4. X Wind ow s con figuratio n de tails

    makin g an x*.host s file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80

    usin g an /et c/hosts file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80

    st oppin g the X Window sys tem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

    cust omizing t he mouse a nd keyboar d . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

    changin g mous e bu t ton actions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

    modifying modifier key bindin gs with xmodm ap . . . . . . . . . . . . . . . . . . . . . . . . . . 82

    specifying k ey rema ppin g expressions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82

  • 8/2/2019 Graphics Administration Guide for HP-UX 11.x

    6/89

    Contents

    4

    exa mples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84

    pr in t ing a k ey map . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84

  • 8/2/2019 Graphics Administration Guide for HP-UX 11.x

    7/89

    Chapter 1 5

    1 preface

    The purpose of this document is to collect, in one place, all the information

    necessary to configure and administer graphics cards supported in HP-UX

    workstations and servers running the 11.00 and 11i version 1 (11.11) OperatingSystems.

  • 8/2/2019 Graphics Administration Guide for HP-UX 11.x

    8/89

    preface

    Chapter 16

    NOTE Pr evious ver sions of th is documen t cont ain ed inform at ion for 3D

    graph ics Applicat ion P rogra mm ing Int erfaces (APIs) tha t ar e now

    obsolete. The following APIs were d iscont inu ed, th en obsoleted, on t he

    indicat ed dates:

    For detailed inform at ion on HP 's supported 3D gra phics API, OpenGL,

    please r efer t o th e "OpenGL Im plemen ta tion Guide", which can be found

    on th e World Wide Web at:

    http://www.hp.com/support/OpenGL_Imp_Guide_PA

    Table 1-1

    Product

    Name

    Product

    Number

    Discont inued

    On Obsoleted On

    Sta rbase B2374A October 1,

    1997

    October 1,

    2002

    PEXlib B3176B May 1, 1998 August 31,

    2003

    PHIGS B1685L October 1,

    1997

    October 1,

    2002

    http://www.hp.com/support/OpenGL_Imp_Guide_PAhttp://www.hp.com/support/OpenGL_Imp_Guide_PA
  • 8/2/2019 Graphics Administration Guide for HP-UX 11.x

    9/89

    preface

    document conventions

    Chapter 1 7

    document conventions

    Below is a list of the typographical conventions used in this document:

    ls /usr/include

    Verbatim computer literals are in computer font. Text in this style is letter-for-letter

    verbatim and, depending on the context, should be typed in exactly as specified, or

    is named exactly as specified.

    In every case...

    Emphasized words are in italic type.

    . . .to configure a Single Logical Screen. . .

    New terms being introduced are in bold-faced type.

    . . .the

    Conceptual values are in italic type, enclosed in angle brackets. These items are not

    verbatim values, but are descriptors of the type of item it is, and the user should

    replace the conceptual item with whatever value is appropriate for the context.

  • 8/2/2019 Graphics Administration Guide for HP-UX 11.x

    10/89

    preface

    document conventions

    Chapter 18

  • 8/2/2019 Graphics Administration Guide for HP-UX 11.x

    11/89

    Chapter 2 9

    2 configuring X Windows on HP-UX(HP Visualize graphics cards)

    This chap ter docum ent s inform at ion specific to th e HP X Server. Itdescribes feat ur es th at ar e un ique to HP s X Server, provides inform at ion

  • 8/2/2019 Graphics Administration Guide for HP-UX 11.x

    12/89

    configuring X Windows on HP-UX (HP Visualize graphics cards)

    Chapter 210

    on how to configure t he X Server a nd in cludes a list of sup ported

    configura tions. For ea ch supp orted gr aph ics device, device-depen dentconfigura tion inform at ion is pr ovided.

    Informa tion specific to a new relea se of th e X Server, beyond th e scope of

    th e general inform at ion in t his docum ent, can be foun d in th e HP-UX

    Release Notes locat ed in /usr/share/doc.

    NOTE This chapter deals with configuration information for HP Visualize graphicscards (fxe, fx5, fx10, etc.) ONLY. For configuration information for other

    graphics cards, see Chapter 3 in this document.

  • 8/2/2019 Graphics Administration Guide for HP-UX 11.x

    13/89

    configuring X Windows on HP-UX (HP Visualize graphics cards)

    X Server configuration

    Chapter 2 11

    X Server configuration

    Configuration of the X Server is supported through SAM via an icon titled X

    Server Configuration. This icon resides either at SAMs top level or under the

    top-level Display icon. This location is determined by the version of the HP-UX

    operating system (later HP-UX releases will place X Server Configuration under

    the Display folder).

    There are several X*screens files used to configure the operation of the X Server.

    The SAM graphical user interface for X Server configuration is provided to simplify

    complexity and facilitate ease of use. While it is still possible to modify these files

    manually (see below), using the SAM interface greatly simplifies the process for

    creating Multi-Display and Single Logical Screen configurations.

    Our SAM component has the following actions:

    Configure Print Server Modify Multi-Screen Layout

    Modify Server Options

    Single Logical Screen (SLS)

    --------------------------------

    Describe Screen

    Identify Screen

    Modify Default Visual

    Modify Screen Options Add Screen to Configuration

    Remove Screen from Configuration

    The first group of actions can be thought of as global actions. They will typically

    be active regardless of what has been selected. If any of these menu items is not

    visible, it is because it is not supported under the current configuration. For

    example, on systems containing only one graphics screen, the last three menu items

    will not be visible.The second group of actions can be thought of as screen actions. They will be

    activated depending on which screens have been chosen. It is also possible that the

    last two actions (Add and Remove) will be absent. When only one graphics screenis present, SAM will treat this screen as though it is always configured. Preselecting

    both configured and unconfigured screens will result in only the first two screen

    menu options being active.

  • 8/2/2019 Graphics Administration Guide for HP-UX 11.x

    14/89

    configuring X Windows on HP-UX (HP Visualize graphics cards)

    X Server configuration

    Chapter 212

    X*screens file

    For manual changes, please refer to the sample files in the /etc/X11/ directory.Three files of particular interest are the X0screens, X0devices, and X0pointerkeys

    files.

    description of the X*screens configuration file

    This file belongs in /etc/X11/X*screens, where * is the display number of

    the server. For example, the X0screens file is used when the $DISPLAYenvironment variable is set to hostname:0.screen and the server is invokedusing the :0 option.

    The X*screens file is used to specify:

    Device-independent server options, and

    For each screen:

    what device file to use (required), the default visual,

    monitor size, and

    device-dependent screen options.

    Note that all of the items above, except for device-independent server options, are

    specified on a per-screen basis.

    The X Server supports up to four screens at a time. Specifying more than four

    screens will cause a server error message.

    syntax guidelines

    Blank lines and comments (text following #) are ignored.

    Entries can occupy more than a single line.

    All symbols in the file are recognized case-insensitive.

    the X*screens file format

    Items must appear in the X*screens file in the order that they are specified below.

    [ServerOptions...

    ]{Screen } ||

  • 8/2/2019 Graphics Administration Guide for HP-UX 11.x

    15/89

    configuring X Windows on HP-UX (HP Visualize graphics cards)

    X Server configuration

    Chapter 2 13

    {SingleLogicalScreen

    . . .< device_nameN>}[DefaultVisual

    [Class ][Depth ][Layer ][Transparent]]

    [MonitorSize < units>][MinimumMonitorPowerSaveLevel ][ScreenOptions

    ...

    ]

    Brackets ([and ]) denote optional items. Italicized items in angle brackets () denote values to be specified. The double vertical line (||) denotes that

    one of the ored values (items surrounded by braces, {and }) must be included.

    The block from the Screen line to the final

    line is referred to as a either a Screen Entry or as a Single Logical Screen entry.

    As shown above, the X*screens format is composed of an optional block specifying

    device-independent server options followed by one or more either Screen or Single

    Logical Screen entries (maximum of four graphics devices).

    The minimum X*screens file is a line with the keyword Screen followed by a

    screen device file. For example:

    Screen /dev/crt

    server options

    For more information about server options, or about additional server options, look

    in an information file (for example,

    /usr/lib/X11/Xserver/info/screens/hp).

    GraphicsSharedMemorySize

    Specify the size of the graphics shared memory region. The size must be specified in

    bytes and must be in hexadecimal.

    Defau lt valu e: 0x580000

    ImmediateLoadDles

  • 8/2/2019 Graphics Administration Guide for HP-UX 11.x

    16/89

    configuring X Windows on HP-UX (HP Visualize graphics cards)

    X Server configuration

    Chapter 214

    The X Server delays loading of some X extensions until the first protocol request to

    the given extension is received. Specifying this server option forces all extensions tobe loaded at X Server startup. The 11.00 X Server patches shipped after July, 1997

    perform delayed loading of X extensions.

    screen entries

    The minimum screen entry is a line with the keyword Screen followed by a screen

    device file.

    Optional specifications for default visual, monitor size, and device-dependent

    screen options may follow this minimal screen description line.

    DefaultVisual

    This optional part of the format specifies the default visual that the screen uses.

    Valid keywords following the DefaultVisual keyword are Class, Depth,

    Layer, and Transparent.

    If no default visual is specified, then the standard default visual class, depth, layer,and transparency for the graphics device is used.

    Not all default visual specifications will work on all devices.

    If there is an error in a specification, look in an information file for more details (for

    example, /usr/lib/X11/Xserver/info/screens/hp), in case it is newerthan the document youre now reading.

    Class | | | |

    |

    Specify the class of the default visual.

    Depth

    Specify the depth of the default visual (for example 8, 12, or 24).

    Layer |

    Specify the layer of the default visual.

    Transparent

    Specify that a visual with an application-accessible transparent entry in the default

    colormap be used.

    MonitorSize Inches | MM

    Specify the diagonal size of the monitor. After the MonitorSize keyword, you

    must specify the diagonal length of the monitor and then the units. Use this entryonly if you are using a non-standard monitor.

  • 8/2/2019 Graphics Administration Guide for HP-UX 11.x

    17/89

    configuring X Windows on HP-UX (HP Visualize graphics cards)

    X Server configuration

    Chapter 2 15

    MinimumMonitorPowerSaveLevel

    Specify the minimum power save level to be used by the monitor during screen

    blanking. You must specify a level of 0 -3 If the option is not used, the default is

    level 0. On devices that do not support DPMS, this option will be ignored.

    ScreenOptions

    Screen options are device-dependent options that are documented in a file in the X

    Server information directory (for example,

    /usr/lib/X11/Xserver/info/screens/hp).

    sample X*screens files

    Below are several sample X*screens files that illustrate the new format.

    This is the minimum legal X*screens file, the Screen keyword followed by

    the screen device. Since no other information is given, the X Server will assume

    default values for other options and settings.

    Screen /dev/crt

    Fi gu re 2-1 Re su lt s o f m in im al le ga l X*s cre e ns fi le

    This is the minimum specification for a two-screen configuration. The

    maximum number of screens supported on the X Server is four. Here, the

    displays associated with /dev/crt0 and /dev/crt1 are referred to as:0.0 and :0.1, respectively.

    Screen /dev/crt0

    Screen /dev/crt1

    :0.0/dev/crt

  • 8/2/2019 Graphics Administration Guide for HP-UX 11.x

    18/89

    configuring X Windows on HP-UX (HP Visualize graphics cards)

    X Server configuration

    Chapter 216

    Figure 2-2 Two physical displays, two separate screens

    This sample X*screens file could be used on a system using HP

    VISUALIZE-FXE with a 17-inch monitor. In this example, the

    GraphicsSharedMemorySize is decreased to 1 Mbyte in order to reduce theswap space requirements of the system. Decreasing

    GraphicsSharedMemorySize is appropriate when you do not intend to run any

    3D graphics applications.

    ServerOptionsGraphicsSharedMemorySize 0x100000

    Screen /dev/crt

    MonitorSize 17 inches

    The display diagram would be the same as that of the Results of Minimal

    Legal X*screens File configuration, above.

    This sample X*screens file could be used on a system with a HP

    VISUALIZE-FX5 graphics device. The overlay visual is selected as the default.

    There are 255 overlay colormap entries available on the HP VISUALIZE-FX5.

    The 256th entry is hard-wired to transparent. Having less than 256 colormap

    entries should not cause a problem for most applications, but for thoseapplications that require 256 colormap entries, the

    CountTransparentInOverlayVisual screen option should be used as shown

    below. Note that any attempts to modify the 256th entry will have no effect on

    the colormap.

    Screen /dev/crtScreenOptionsCountTransparentInOverlayVisual

    The display diagram would be the same as that of the Results of Minimal

    Legal X*screens File configuration, above.

    This sample X*screens file could be used on a system with a HP

    VISUALIZE-FX10 graphics device. The default visual on the HP

    VISUALIZE-FX10 is the opaque overlay visual. All 256 colormap entries are

    opaque and allocable. If an application requires transparency in the default

    visual, the Transparent keyword can be used to select the transparent overlay

    visual as shown below.

    :0.0/dev/crt0

    :0.1/dev/crt1

  • 8/2/2019 Graphics Administration Guide for HP-UX 11.x

    19/89

    configuring X Windows on HP-UX (HP Visualize graphics cards)

    X Server configuration

    Chapter 2 17

    Screen /dev/crt

    DefaultVisualTransparent

    The display diagram would be the same as that of the Results of Minimal

    Legal X*screens File configuration, above.

    This sample X*screens file could be used on a system with a HP

    VISUALIZE-FXE graphics device. By default on the HP VISUALIZE-FXE,

    the overlay visual does not have a transparent entry available to applications for

    rendering transparency. If an application requires overlay transparency, anoptional X Server mode is available, but it is restrictive. In this optional mode,

    only one hardware colormap is available in the overlays (instead of two) and

    only one hardware colormap is available in the image planes (instead of two).

    The optional X Server mode can be set via the EnableOverlayTransparency

    screen option as shown below.

    Screen /dev/crtScreenOptionsEnableOverlayTransparency

    The display diagram would be the same as that of the Results of Minimal

    Legal X*screens File configuration, above.

    These sample X*screens file entries could be used on a system with two

    homogeneous graphics devices. Assuming the first device is associated with the

    device file /dev/crt0 and the second device is associated with the devicefile /dev/crt1, both examples specify a horizontal Single Logical Screenconfiguration.

    SingleLogicalScreen 1 2/dev/crt0 /dev/crt1

    orSingleLogicalScreen 1 2/dev/crt0

    /dev/crt1

  • 8/2/2019 Graphics Administration Guide for HP-UX 11.x

    20/89

    configuring X Windows on HP-UX (HP Visualize graphics cards)

    X Server configuration

    Chapter 218

    Figure 2-3 Two physical displays, single logical screen (1x2)

    These sample X*screens entr ies could be used on a system with four

    homogeneous gra phics devices. Assum ing th e first device isass ociat ed with th e device file /dev/crt0, th e second device isass ociat ed with th e device file /dev/crt1, etc. The followingexam ples specify valid Sin gle Logical Screen configur at ions.

    SingleLogicalScreen 1 4/dev/crt0 /dev/crt1 /dev/crt2 /dev/crt3

    F ig u re 2-4 Fo u r p h ys ic al d is pl ay s, s in g le lo gi ca l s cre e n (1x 4)

    SingleLogicalScreen 4 1

    /dev/crt0/dev/crt1/dev/crt2/dev/crt3

    /dev/crt0 /dev/crt1:0.0

    :0.0

    /dev/crt0 /dev/crt1 /dev/crt2 /dev/crt3

  • 8/2/2019 Graphics Administration Guide for HP-UX 11.x

    21/89

    configuring X Windows on HP-UX (HP Visualize graphics cards)

    X Server configuration

    Chapter 2 19

    Fi gu re 2-5 Fo u r p h ys ic al d is pl ay s, s in g le lo gi ca l s cre e n (4x 1)

    SingleLogicalScreen 2 2/dev/crt0 /dev/crt1/dev/crt2 /dev/crt3

    F ig u re 2-6 Fo u r p h ys ic al d is pl ay s, s in g le lo gi ca l s cre e n (2x 2)

    I t is possible to include a Screen Entr y and an SLS Screen Entry in

    th e same X*screens File. This crea tes a situa tion where th ere ar e

    two X Screen s (e.g.< host>:0.0 and :1.0), one of wh ich ha ppen s

    to be a Single Logical Screen . Below is a n exa mple of this:

    :0.0

    /dev/crt0

    /dev/crt1

    /dev/crt2

    /dev/crt3

    :0.0

    /dev/crt0 /dev/crt1

    /dev/crt2 /dev/crt3

  • 8/2/2019 Graphics Administration Guide for HP-UX 11.x

    22/89

    configuring X Windows on HP-UX (HP Visualize graphics cards)

    X Server configuration

    Chapter 220

    Screen /dev/crt0

    SingleLogicalScreen 1 2/dev/crt1 /dev/crt2

    F ig u re 2-7 Th re e p hy si ca l d is pla ys , s cre e n pl us si ng le lo gi ca l s cre e n (1x 2)

    miscellaneous topics

    double buffer extensions

    DBE is an extension t o the X Server th at provides a double-buffering

    Application Pr ogra mm ing Int erface (API). For m ore informa tion aboutDBE an d th e API, consult t he DBE ma n pages:

    DBE

    XdbeQueryExtension

    XdbeGetVisualInfo

    XdbeFreeVisualInfo

    XdbeAllocateBackBufferName

    XdbeDeallocateBackBufferName

    XdbeSwapBuffers

    XdbeBeginIdiom

    XdbeEndIdiom

    XdbeGetBackBufferAttributes

    performing buffer swaps on vertica l blank

    For perform an ce rea sons, th e default DBE behavior is to not synchronize

    buffer swap s with t he m onit ors vertical ret ra ce period. In someinsta nces, ther efore, image tear ing (seeing part of the old image a nd pa rt

    of th e new ima ge on t he display at th e sam e time) could be visible while

    swapping large DBE windows. For t hose instan ces where tear ing would

    occur a nd is u ndesir able, an optiona l X Server mode is available to allow

    for syn chr onization of buffer swa ps with vert ical r etr ace. To activat e th is

    optiona l X Server m ode, set t he following screen option in th e X*screens

    File before t he X Server is sta rt ed:

    SwapBuffersOnVBlank

    :0.0

    /dev/crt0 /dev/crt1 /dev/crt2:0.0

  • 8/2/2019 Graphics Administration Guide for HP-UX 11.x

    23/89

    configuring X Windows on HP-UX (HP Visualize graphics cards)

    X Server configuration

    Chapter 2 21

    determining swap performance

    The DBE API does not a llow user s to deter min e if double-bufferin g in a

    visual is th rough softwa re or ha rdwa re. However, the API does provide a

    way to determ ine relat ive swapping perform an ce on a per-visua l basis.

    Th e XdbeScreenVisualInfo() fun ction ret ur ns inform at ion about th eswappin g perform an ce levels for t he d ouble-bufferin g visuals on a

    display. A visual with a h igher per form an ce level is likely to ha ve betterdouble-buffer gra phics perform an ce t ha n a visua l with a lower

    perform an ce level. Noth ing can be d educed from an y of the following: the

    ma gnitu de of th e difference of two performa nce levels, a perform an ce

    level in isolat ion, or compa rin g perform an ce levels from d ifferen t server s.

    For m ore inform at ion, refer to th e DBE m an page on

    XdbeScreenVisualInfo().

    supported devices

    The X Server sup ports DBE on t he following devices:

    HP VISUALIZE-FX5 and FX10

    H P VISUALIZE -F XE

    display power ma nagement signaling (DPMS)

    Monitors const itut e a large percenta ge of the power used by aworkst at ion even wh en n ot a ctively in use (i.e., dur ing screen blan king).

    In order t o redu ce th e power consu mpt ion, th e Video Electr onic

    Sta nda rds Associat ion (VESA) ha s defined a Display Power Man agem ent

    Signa ling (DPMS) sta nda rd wh ich can be u sed to grea tly reduce the

    am oun t of power being used by a monitor dur ing screen blanking.

    The X Server featu res t he a bility t o ma ke u se of DPMS on t he following

    gra phics devices:

    HP VISUALIZE-FX5 and FX10

    H P VISUALIZE -F XE

  • 8/2/2019 Graphics Administration Guide for HP-UX 11.x

    24/89

    configuring X Windows on HP-UX (HP Visualize graphics cards)

    X Server configuration

    Chapter 222

    The following table is a description of the st at es th at ar e defined by

    VESA. The Power Sa vings colum n indicates (roughly) th e level of powersavings achieved in th e given st at e. The Recovery Time is t he a mount of

    time tha t t he screen tak es to retur n t o a usa ble state when t he screen

    saver is t ur ned off (by pressin g a key or t he m oving th e mouse).

    The a ctu al a mount of power saved a nd th e recovery time for ea ch of the

    sta tes is m onitor-dependent an d m ay vary widely. The customer cancompensa te for th is by choosing an appr opriat e level for th e m onitor t ha t

    is cur rent ly in u se.

    By defau lt, th e DPMS level used is t he Screen Saver (i.e. no power

    savings). If you wish t o use power saving du rin g screen blan king, set th e

    following X*screen s file ent ry before st ar tin g th e server :

    MinimumMonitorPowerSaveLevel

    wher e level is repla ced with th e single digit 0, 1, 2, or 3 as specified in th e

    Level colum n in t he a bove ta ble.

    shared memory extension (MIT_SHM)

    The MIT sha red m emory extension provides both sha red-memory

    XIma ges and sha red-memory pixmaps based on th e SYSV sha red

    memory pr imitives.

    Sha red m emory XIma ges are essent ially a version of the XImage

    interface where t he actual ima ge data is stored in a shared m emory

    segment, an d th us n eed not be moved th rough th e Xlib int erprocess

    comm un icat ion cha nn el. For la rge ima ges, use of th is facility can r esult

    in increased perform an ce.

    Sha red mem ory pixma ps ar e a similar concept implemented for t he

    pixma p interface. Shared m emory pixmaps a re t wo-dimensiona l arr aysof pixels in a form at specified by the X Server, where t he pixma p dat a is

    Table 2-1 Pow er saving s tate s de fined by VESA

    Le ve l StateDPMS Compliance

    Requirements

    Pow e r

    SavingsRecove ry Time

    0 Screen Saver Not Applicable None Very Shor t (

  • 8/2/2019 Graphics Administration Guide for HP-UX 11.x

    25/89

    configuring X Windows on HP-UX (HP Visualize graphics cards)

    X Server configuration

    Chapter 2 23

    stored in the sha red mem ory segment . In all oth er respects, sha red

    memory pixma ps behave the sam e as ordina ry pixma ps and can bemodified by the u sua l Xlib rout ines. In ad dition, it is possible to cha nge

    th e cont ents of these pixmaps directly without th e use of Xlib rout ines

    merely by modifying the pixmap dat a.

    supported devices

    The X Server supports t he MIT shar ed memory extension on t he

    following devices:

    HP VISUALIZE-FX5 and FX10

    H P VISUALIZE -F XE

    supported X configurations

    multi-display support

    The following definit ions a re in cluded t o reduce confusion bet ween t he

    te rm s mu lti-displa y, mu lti-screen , and single logica l screen .

    Multi-Display

    A configura tion with mu ltiple gra phics devices used concur ren tly. Any

    mu lti-screen or sin gle logical screen configura tion is referr ed to as a

    multi-display configuration.

    configuring X Windows on HP UX (HP Visualize graphics cards)

  • 8/2/2019 Graphics Administration Guide for HP-UX 11.x

    26/89

    configuring X Windows on HP-UX (HP Visualize graphics cards)

    X Server configuration

    Chapter 224

    Multi-Screen

    A configura tion in which a single X Server wit h a m ouse an d keyboar d

    drives mu ltiple grap hics devices (wher e each display is a differen t X

    Screen) concur ren tly wh ile only a llowing t he cur sor, not wind ows, to be

    moved between displays.

    Single logical screenA configura tion in which a single X Server wit h a s ingle mouse an d

    keyboard drives multiple homogeneous graphics devices concurrently

    while allowing th e displays to emu lat e a lar ge single screen . This differs

    from a m ult i-screen environm ent by allowing windows to be moved and

    displayed across displays. See th e section in t his docum ent on Sin gle

    Logical Screen.

    Note tha t different monitor resolutions a re not supported with t he

    multi-display configurations unless stated otherwise in the table below.

    Device #1 Device #2SPU

    host:0.0(1280x1024)

    host:0.1(1280x1024)

    KeyboardMouse

    Device #1 Device #2

    SPU

    KeyboardMouse

    host:0.0

    (2560x1024)

    configuring X Windows on HP-UX (HP Visualize graphics cards)

  • 8/2/2019 Graphics Administration Guide for HP-UX 11.x

    27/89

    configuring X Windows on HP-UX (HP Visualize graphics cards)

    X Server configuration

    Chapter 2 25

    multi-screen support

    The list of support ed mu lti-display configura tions is ra th er la rge, and it

    chan ges whenever a new gra phics device is intr oduced. Thu s, if you a re

    consider ing a Sin gle Logical Screen or a ny other mu lti-display

    configura tion, we recomm end consult ing your HP Sales Represent at ive

    an d inquiring wheth er th e configura tion you h ave in mind is indeed

    supported.

    Ther e ar e genera l guidelines, however. For exam ple:

    Multi-display configurations may be limited by available power.

    Depend ing on th e capacity of your compu ter s power su pply, an d t he

    power dema nds of th e combinat ion of gra phics car ds you a re

    considering, there m ay or ma y not be enough power t o operat e th em

    all.

    Single Logical Screen configurations must use identical graphics

    devices (see th e n ext section).

    single logical screen (SLS)

    SLS is a m echa nism for t reat ing homogeneous m ulti-display

    configura tions a s a single logical screen . This a llows t he

    moving/spa nn ing of windows across mult iple physical m onit ors. The

    word homogeneous is included because SLS only work s if th e gra phics

    devices included in t he SLS Configura tion ar e of th e sam e type.

    SLS is enabled by using SAM (th e System Administra tion Ma na ger tool,

    /usr/sbin/sam). To ena ble an SLS configura tion, sta rt SAM, an dfollow t he inst ru ctions below:

    1. Double-click on the X Server Configuration button. A window

    ent itled Gra phics app ear s, conta ining a n icon for ever y graph ics device

    on your system.

    2. Select th e devices you wa nt to combin e int o an S LS (click t he m ouse onth e first device, and [Ctr l]-click on t he oth ers). At t his point , all th e

    devices you wa nt to combine int o an SLS configura tion sh ould be

    highlighted.

    3.From th e Actions menu , choose th e m enu item Modify Mult i-Screen

    Layout . A dia log box appea rs, a llowing you t o specify exactly how you

    wan t your SLS configura tion to be.

    configuring X Windows on HP-UX (HP Visualize graphics cards)

  • 8/2/2019 Graphics Administration Guide for HP-UX 11.x

    28/89

    configuring X Windows on HP UX (HP Visualize graphics cards)

    X Server configuration

    Chapter 226

    Note t ha t if your ma chine ha s only one gr aph ics device, the Modify

    Mult i-Screen Layout men u option does not even app ear, since mult ipledevices can not occur in a single-device cont ext.

    Note also tha t DHA (Direct Ha rdwar e Access) is su pport ed in a window

    tha t spans m ultiple screens.

    Spa nn ing, in t his cont ext, includes a window th at is two or m ore

    screens in size, as well as a window th at is part ially on one screen an d

    par tially on an oth er (even t hough it would fit on a single screen if it were

    moved).

    SLS can also be ena bled via th e /etc/X11/X*screen s file via t he syn ta x:

    SingleLogicalScreen n m/dev/crt0 ... /dev/crtk

    where:

    n = t he n um ber of rows in t he ph ysical configura tion,

    m = t he n um ber of colum ns in t he ph ysical configura tion,an d th e product of n x m is less th an or equa l to four.

    For example, to crea te a logical screen t ha t is one m onitor t all by two

    monit ors wide, th e following synt ax would be used:

    SingleLogicalScreen 1 2/dev/crt0 /dev/crt1

    Wher eas for a logical screen th at is two monit ors t all by one monitorwide, the synta x is:

    SingleLogicalScreen 2 1/dev/crt0 /dev/crt1

    3D acceleration and single logical screen

    Cur ren tly, SLS does n ot t ak e adva nt age of 3D accelera tion (e.g. Visua lize

    FX5). 3D applicat ions (from a ny su pported HP 3D API) will continu e toru n wit h SLS; However, 3D performa nce with SLS will be much slower

    tha n it is without SLS.

    hp CDE and single logica l screen

    Please note tha t H P CDE ha s not been modified to ta ke advan ta ge of th e

    Single Logical Screen capability. When pr esent ing inform at ion on your

    display, HP CDE ma y split a wind ow across physical screen s. Exa mples

    include:

    configuring X Windows on HP-UX (HP Visualize graphics cards)

  • 8/2/2019 Graphics Administration Guide for HP-UX 11.x

    29/89

    g g ( g p )

    X Server configuration

    Chapter 2 27

    Th e login scr een .

    The Front Panel. Window move and res ize boxes.

    The s creen lock dia log.

    This behavior is t he r esult of HP CDEs na ive assu mpt ion t ha t it is

    running against one large screen; it centers these windows accordingly.

    If you ar e using t he default H P CDE key bindings, you can easily

    reposition th e Front Pan el so th at it is completely cont ained with in one

    physical screen:

    1. With the input focus on the Fr ont Panel, press Alt and Space.

    2. With t he Front Pa nel menu posted and th e Move menu item

    selected, pres s Enter (on older k eyboar ds ,Return) to star t t he move.

    3. Use the mouse or th e arr ow keys to reposition the Front Pa nel to th e

    desired location.

    4. P res s Enter (or Return) to complet e th e move. You ma y inst ead p ress Esc to cancel the m ove.

    Afterwa rds, this sett ing will be remem bered and r estored at your next

    login. If you ha ve previously set a H ome session, you will need to re-set

    th e Home session in th e Style Mana ger to register th e new Front Pan el

    position.

    Note th at th ere is no mecha nism in HP CDE for r epositioning th e login

    screen, window move/resize boxes, or the screen lock dialog.

    configuring X Windows on HP-UX (HP Visualize graphics cards)

  • 8/2/2019 Graphics Administration Guide for HP-UX 11.x

    30/89

    g g ( g p )

    hp Visualize- FXE, FX5 and FX10 device-dependent information

    Chapter 228

    hp Visualize- FXE, FX5 and FX10

    device-dependent information

    This section includes inform at ion on t he H P VISUALIZE-FXE/5/10

    gra phics devices.

    The H P VISUALIZE-FXE/5/10 ha s 8 overlay plan es, 48 ima ge planes a

    24-bit z buffer a nd 4 ha rdwa re colorm aps.

    HP VISUALIZE-FXE/5/10 grap hics devices cont ain 2D ha rdwa re

    acceleration similar to th at in other HP VISUALIZE devices, as well as

    3D acceleration for lighting, shading an d t exture ma pping.

    supported visuals

    HP VISUALIZE-FXE/5/10 gra phics devices su pport all of th e following

    visuals:

    Class PseudoColor Depth 8 Layer Image

    Class PseudoColor Depth 8 Layer Over lay

    Class PseudoColor Depth8 Layer Overlay Transparent

    Class DirectColor Depth 24 Layer Image

    Class TrueColor Depth 24 Layer Image

    The following visuals ar e ena bled by default on t he H PVISUALIZE-FXE/5/10:

    Class PseudoColor Depth 8 Layer Image

    supports DBE h ar dware double-buffering

    Class PseudoColor Depth 8 Layer Over lay

    sup ports DBE softwar e double-buffering

    Class PseudoColor Depth 8 Layer Overlay Transparent

    sup ports DBE softwar e double-buffering Class DirectColor Depth 24 Layer Image

    does not support DBE h ar dware or softwar e double-buffering

    Class TrueColor Depth 24 Layer Image

    does not support DBE h ar dware or softwar e double-buffering

    NOTE When ru nn ing xdpyinfo or calling th e XGetVisua lInfo() Xlib

    fun ction, some extr a du plicat e visua ls may appea r in th e visua l list.

    These extra visua ls are creat ed on beha lf of the OpenGL extension t o

    configuring X Windows on HP-UX (HP Visualize graphics cards)

  • 8/2/2019 Graphics Administration Guide for HP-UX 11.x

    31/89

    hp Visualize- FXE, FX5 and FX10 device-dependent information

    Chapter 2 29

    X (GLX). If necessa ry, th e extr a visu als can be disabled u sing th e

    DisableGLxVisua ls screen option. See th e Disabling t he GLXVisua ls section for more inform at ion.

    supported screen options

    The following screen options ar e support ed:

    Coun tTransparent InOverlayVis ual Im a geText Via Bit Ma p

    EnableIncludeIn fer ior s Fix

    Disa bleGlxVisu als

    hp VISUALIZE-FXE/ 5/ 10 configuration hints

    overlay visuals and overlay transparency

    HP VISUALIZE-FXE/5/10 devices h ave t wo visua ls in t he overlay

    plan es, both dept h-8 Pseu doColor. The first (defau lt) overlay visua l ha s

    256 entr ies per colorma p an d no tr an spa ren cy. The second overla y visua l

    ha s 255 entr ies per colorm ap a nd supports t ra nspa rency.

    To allow app licat ions t o deter min e which visua ls ar e in th e overlay

    planes, both overlay visuals a re listed in t he

    SERVER_OVERLAY_VISUALS pr operty a tt ached to t he root window.The default overlay visua l has a tr an spa ren t t ype of 0 (None), while th e

    tr an spar ent overlay visual ha s a tr an spar ent t ype of 1

    (TransparentPixel).

    If you n eed an overlay colorm ap t ha t su pport s tr an spar ency, creat e th e

    colorm ap using the visua l that h as tr an spar ency in its

    SE RVER_OVERLAY_VISUALS pr opert y.

    disabling the GLX visuals

    The H P VISUALIZE-FXE/5/10 products sup port t he Open GL extension

    to X (GLX). If HP OpenGL is inst alled on a n HP VISUALIZE-FXE/5/10

    system, then the GLX extension offers new entry points for obtaining

    more inform at ion a bout X visuals. As pa rt of offerin g exten ded visua l

    inform at ion, some extra X visuals appea r in t he X visua l list. The extr a

    configuring X Windows on HP-UX (HP Visualize graphics cards)

  • 8/2/2019 Graphics Administration Guide for HP-UX 11.x

    32/89

    hp Visualize- FXE, FX5 and FX10 device-dependent information

    Chapter 230

    visua ls are simply duplicat es of visuals t ha t would normally appear in

    th e X visua l list. In case tha t t he extra visua ls cau se problems withapplicat ions, a screen option can be used t o disable th em.

    To disable th e GLX visuals, add t he Disa bleGlxVisua lsScreen Opt ion t o

    th e X*screens file.For exam ple:

    Screen /dev/crt/ScreenOption

    DisableGlxVisuals

    hp VISUALIZE-FXE/ 5/ 10 colormaps

    HP VISUALIZE-FXE/5/10 devices ha ve a t otal of 4 ha rdwa re colorm aps.

    2 of the colorm aps a re dedicat ed to th e overlay planes. The rem aining 2

    colorm aps a re dedicat ed to th e image plan es.

    Of th e two overlay colorma ps, one is perm an ent ly reser ved for th e

    default colorm ap. The oth er overlay colorma p is available t o app licat ions.

    changing the monitor type

    A configura tion t ool is available t o cha nge t he m onit or type on HP

    VISUALIZE-FXE/5/10 devices. This tool perm its u sers to chan ge th e

    monit ors refresh r at e, fram e buffer res olut ion, an d fra me buffer memory

    configura tion (e.g., Ster eo, Double Buffer), when th e device support s

    mu ltiple options. To cha nge th e monitor t ype, th e setm on comm an d canbe execut ed directly or done t hr ough t he SAM system a dministr at ion

    tool.

    The set mon executa ble is located a t /opt/gra phics/comm on/bin/setm on.

    Un der SAM th is component is located u nder th e top-level Display

    folder, next to the X Server Configuration icon.

    NOTE Chan ging th e monitor t ype while th e X Server is run ning will necessitat e

    killing and resta rt ing the X Server.

  • 8/2/2019 Graphics Administration Guide for HP-UX 11.x

    33/89

    Chapter 3 31

    3 configuring X Windows on HP-UX(other graphics cards)

    This cha pter docum ent s inform at ion sp ecific to the H P Xf86 X Server.

    The Xf86 X Server is bas ed on t he XFr ee86 version 4.2.0 X Server. This

    configuring X Windows on HP-UX (other graphics cards)

  • 8/2/2019 Graphics Administration Guide for HP-UX 11.x

    34/89

    Chapter 332

    section describes featu res u nique t o HP's implementa tion of the X

    Server, provides inform at ion on h ow to configure t he X Server a ndincludes a list of supp orted X configura tions. For ea ch support ed

    gra phics device, device-depen dent configura tion informa tion is pr ovided.

    NOTE This cha pter deals with configura tion r equirement s for gra phics cards

    OTH ER TH AN HP Visu alize car ds (fxe, fx5, fx10, et c.). For configur at ion

    inform at ion for a ll HP Visualize car ds, refer t o Cha pter 2 in t his

    document.

    configuring X Windows on HP-UX (other graphics cards)

    using SAM to configure X Windows

  • 8/2/2019 Graphics Administration Guide for HP-UX 11.x

    35/89

    using SAM to configure X Windows

    Chapter 3 33

    using SAM to configure X Windows

    Configura tion of th e X Server is support ed th rough SAM via an icon

    tit led X Server Configura tion. This icon resides eith er at SAMs

    top-level or under the top-level Display icon.

    The SAM gra phical user int erface for X Server configura tion is provided

    to simplify complexity a nd facilitat e ease of use in m odifying or creat ing

    th e X Server configura tion file, XF86Config. The Xf86 server uses th eXF86Config file for its configur at ions. While it is st ill possible to modify

    th is file man ua lly (see below), usin g the SAM inter face can grea tly

    simplify the process.

    The SAM component ha s th e following actions:

    Configure P rint S erver...

    Configu re How X Starts ...

    Modify Multi-Scree n Layo ut...

    Single Logical Scree n (SLS) ->

    --------------------------------------------------

    Desc ribe Screen. ..

    Identify Screen

    Modify De fault Visual.. .

    Modify Sc reen Options.. .

    Modify Serve r Option s...

    Add Screen to Configuration

    Remove Screen from Configurat ion

    The first group of Actions m enu s can be t hought of as global actions.

    They will typically be active regar dless of wha t h as been selected. If any

    of these menu items a re n ot visible it is becau se th ey are n ot su pport ed

    un der th e cur rent configura tion.

    Th e Configure P rint Server item a llows you t o mana ge print ser vers.From t his menu item you can creat e, stop or r emove print servers.

    On systems t ha t cont ain a mix of HP Visualize an d oth er H P gra phics

    car ds, th e Configure How X Starts item allows you to choose on wh ich

    graph ics devices th e X Server should sta rt . From t his a ction, you can

    ass ign which of your configura tion files t o use a s a display conn ection -

    th e X* screens file for HP gra phics cards or th e XF86Config file with

    configuring X Windows on HP-UX (other graphics cards)

    using SAM to configure X Windows

  • 8/2/2019 Graphics Administration Guide for HP-UX 11.x

    36/89

    using SAM to configure X Windows

    Chapter 334

    oth er gra phics car ds. Runn ing independent X Servers on an HP

    Visua lize gra phics device an d an y oth er device simult an eously is notsupported.

    SLS is a m echa nism for tr eat ing homogeneous m ulti-display

    configura tions a s a s ingle logical screen . This allows the

    moving/spa nn ing of windows across mult iple physical m onit ors. The

    word homogeneous is in cluded becau se SLS only work s if th e gra phics

    devices included in t he SLS Configura tion ar e of th e sam e type.

    To ena ble an SLS configura tion, sta rt SAM, select t he "Display" icon, a ndfollow t he inst ru ctions below:

    1. Double-click on t he "X Server Configura tion" but ton. A window

    ent itled "X Server Configur at ion" appea rs, conta ining a n icon for every

    gra phics device on your syst em.

    2. Select t he devices you wa nt to combin e int o an SLS configura tion. To

    select t he devices, click t he m ouse on t he first device, and [Ctrl]-click on

    th e others. At t his point , all the devices you want to combine int o an SLSconfiguration should be highlighted.

    3. Fr om th e "Actions" m enu , choose th e it "Single Logical Screen (SLS)"

    -> "Creat e SLS..."

    4. In th e "Crea te SLS" screen , select t he desir ed layout (horizonta l or

    vert ical) an d screen m ap ping, and click "OK".

    5. The "X Server Configura tion" window should n ow sh ow a sin gle icon

    denoting an SLS confgur at ion.

    6. Select "File -> Exit". This will save th e new SLS configura tion an d

    give you t he option t o rest ar t t he Xserver. The Xserver will need t o be

    resta rt ed for t he n ew SLS configura tion settings t o take effect.

    Specific Xf86 server options can be s et wit h t he Modify Serve r Options

    men u it em. See th e item for in form at ion on specific options.

    The s econd group of Actions men us can be th ough t of as screen a ctions.They will be activat ed dependin g on wh ich screens h ave been chosen.

    The win dows tha t r esult from choosing on of th ese actions differ

    depending upon wheth er t he selected screen is an HP Visualize gra phics

    car d or other HP graph ics car ds.

    Th e Describe Screen and Identify Screen men u selections pr ovide

    inform at ion a bout t he device. Identify Screen flashes th e monitor tha t

    is connected t o the gr aph ics device.

    configuring X Windows on HP-UX (other graphics cards)

    using SAM to configure X Windows

  • 8/2/2019 Graphics Administration Guide for HP-UX 11.x

    37/89

    using SAM to configure X Windows

    Chapter 3 35

    Th e Modify De fault Visual menu item lets you set t he defau lt visua ls,

    dept h a nd r esolut ion on a gr ap hics device. It lets you ident ify which ofth ese should be the default sett ings.

    Th e Modify Screen s Options item cont ains options t ha t ar e specific to

    each gra phics device. This list m ight be differen t for car ds depen ding on

    th e cap abilities of each card.

    Grayed out screen icons r epresent screens th at ha ve not been configur ed

    for use by th e X Server. You can select th ese gra yed out icons a nd choose

    the Add Screen to Configuration menu item to add screens to theconfigura tion file. HP Visua lize gra phics devices ar e add ed to th e

    X*screens file and other HP graph ics devices ar e added t o the

    XF86Config file.

    More in form at ion on configura tion of th e X Server an d each of th e above

    actions can be obta ined from SAMs on-line Help.

    using setmon to configure the monitorsetmon is a configura tion tool used to cha nge th e monitor set tin gs for amonit or a tt ached t o a gra phics device. This tool permit s you t o cha nge

    th e monitor's refresh ra te, fra me buffer r esolution, and fram e buffer

    mem ory configura tion (e.g., Ster eo, Double Buffer), when th e device

    supports mu ltiple options. To cha nge th e monitor t ype, th e setmon

    comm an d can be execut ed directly or done th rough SAM.

    Th e setmon execut able is located a t/opt/graphics/common/bin/setmon. Under S AM th is componen t islocated under the top-level Display folder, next to the X Server

    Configuration icon.

    NOTE Chan ging th e monitor t ype while th e X Server is run ning will necessitat e

    killing and resta rt ing the X Server. In order to cha nge th e monitor

    sett ings, the X Server needs t o be ru nn ing on t he device specified. For

    th ese grap hics car ds, it m ay not be possible to test some of th e monitor

    settin gs before ma king the cha nge perm an ent.

    configuring X Windows on HP-UX (other graphics cards)

    the XF86Config file

  • 8/2/2019 Graphics Administration Guide for HP-UX 11.x

    38/89

    g

    Chapter 336

    the XF86Config file

    The XF86Config file is locat ed in /etc/X11/XF86Config. It can begenera ted a ut omat ically or m odified usin g SAM. A working

    configura tion file is a lso delivered on t he syst em. You mu st be root to

    creat e or edit th is file. The XF86Config ma n pa ge provides ad ditional

    inform at ion regarding th e configura tion file. It is necessary t o re-sta rt

    th e X Server for cha nges m ad e to th e XF86Config file to tak e effect.

    the XF86Config file format

    Most of th e conten t in t his section ha s been copied from t he

    XF86Config(5) man page listed on The XFree86 Project, Inc. web site

    (http://www.xfree86.org). The ma n pages ar e available from

    http://www.xfree86.org/4.2.0

    Config file keywords ar e case-insen sitive, and un ders core _ cha ra cters

    are ignored. Most strings (including Option nam es) are a lso

    case-insen sitive, an d insens itive to white space an d un derscore _

    characters.

    Ea ch config file ent ry us ua lly ta kes u p a sin gle line in t he file. They

    cons ist of a k eyword, wh ich is p ossibly followed by one or m ore

    argument s, with t he nu mber an d types of the ar guments depending on

    th e keyword. The argum ent t ypes ar e:

    Integer - an int eger n um ber in decima l, hex or octa l

    Real - a float ing point n um ber

    String - a str ing enclosed in double quote m ar ks ()

    NOTE Hex int eger values mu st be pr efixed with 0x, an d octa l values wit h 0.

    A special keyword called Option ma y be used to provide free-form da ta

    to var ious componen ts of the ser ver. The Option keyword t akes eith er

    one or two str ing argum ents. The first is th e option n am e, an d th e

    optiona l second a rgu men t is th e option value. Some comm only used

    option valu e types include:

    Intege r - an integer nu mber in decimal, hex or octa l

    Real - a float ing point nu mber

    configuring X Windows on HP-UX (other graphics cards)

    the XF86Config file

  • 8/2/2019 Graphics Administration Guide for HP-UX 11.x

    39/89

    Chapter 3 37

    String - a sequ ence of char acter s

    Boolean - a boolean va lue (see below) Frequency - a frequ ency value (see below)

    NOTE All Option values, not just st rings, must be enclosed in qu otes.

    Boolean options m ay optiona lly ha ve a valu e specified. When no value is

    specified, th e option's value is TRUE. The following boolean option

    values are recognized as TRUE :

    1, on, true, yes

    an d t he following boolean option va lues a re r ecognized as FALSE:

    0, off, false, no

    If an option na me is pr efixed with No, then th e option value is n egat ed.

    Frequency option va lues consist of a rea l nu mber th at is optionallyfollowed by one of the following frequency un its :

    Hz, k, kHz, M, MHz

    When th e un it na me is omitt ed, the corr ect u nits will be determ ined from

    th e value an d th e expectations of the appr opriat e ra nge of the value. It is

    recomm ended th at th e un its always be specified when using frequency

    option values t o avoid any err ors in determ ining the value.

    ServerLayout section

    Th e ServerLayout section is used to ident ify which Screen sections ar e

    to be used in a mu lti-headed configura tion, t he r elative layout of those

    screens, and wh ich InputDevice sections a re t o be used. Ea ch

    ServerLayout section h as a n Identif ier, a list ofScreen section

    ident ifiers, and a list ofInputDevice section ident ifiers. Options may

    also be included in th e ServerLayout section. A ServerLayout sectionma y be made a ctive by referencing (via its Identif ier) on t he comm an d

    line tha t st ar ts X. In t he a bsence of this, th e first one foun d in t he file

    will be chosen by defau lt, as t here m ay be mu ltiple ServerLayout

    sections in t he config file. The form at of th e ServerLayout section is a s

    follows:

    configuring X Windows on HP-UX (other graphics cards)

    the XF86Config file

  • 8/2/2019 Graphics Administration Guide for HP-UX 11.x

    40/89

    Chapter 338

    Section ServerLayout

    Identifier ServerLayoutNameScreen [ScreenNumber] ScreenID [Position] [Xcoor] [Ycoor]. . .

    InputDevice InputDeviceID InputDeviceOption

    . . .

    [Option ]. . .

    EndSection

    Keywords, options an d valu es enclosed in [ ] ar e optiona l.

    A nu mber specifying the preferr ed screen n um ber for t ha t screen ma y

    optiona lly follow ea ch Screen . When no screen nu mber is specified, it is

    nu mbered a ccording to th e order in which it is listed. Next comes t he

    ScreenID, a r equired field tha t m ust be enclosed in double quotes. The

    ScreenID must mat ch an Identif ier in a Screen section. Th e

    rema ining inform at ion on th e line is optiona l. Next comes t he ph ysical

    position of the screen, eith er in absolut e ter ms or relat ive to an oth er

    screen (or screen s). Fin ally th e XY coordina tes of the screen ma y be

    specified.

    The position keywords ar e:

    AbsoluteRightOfLeftOfAboveBelowRelative

    The p referr ed m eth od of specifying th e layout is t o explicitly specify th e

    screen's locat ion in absolut e ter ms or r elative to another screen.

    The examples are ba sed on t he examples listed in the DE SIGN document

    from XFr ee86.

    In t he a bsolute case, the u pper left corn er's coordina tes a re given a fter

    the Absolute keyword. If th e coordina tes a re omit ted, a value of (0,0) is

    ass um ed. An exam ple of absolut e positionin g follows:

    configuring X Windows on HP-UX (other graphics cards)

    the XF86Config file

  • 8/2/2019 Graphics Administration Guide for HP-UX 11.x

    41/89

    Chapter 3 39

    Section ServerLayout

    Identifier MainLayout

    Screen 0 Screen 1" Absolute

    Screen 1 Screen 2" Absolute 1024 0

    Screen Screen 3" Absolute 2048 0

    . . .

    EndSection

    When the Relative keyword is used, th e coordina tes of th e new screen's

    origin r elat ive to referen ce screen follow th e reference screen na me. The

    following exam ple shows h ow t o use some of th e rela tive positionin g

    options:

    Section ServerLayout

    Identifier Main Layout

    Screen 0 Screen 1"

    Screen 1 Screen 2 RightOf Screen 1"

    Screen Screen 3" Relative Screen 1" 2048 0. . .

    EndSection

    Each InputDevice is followed by an Inp ut DeviceID, a r equired field

    th at mu st be enclosed in double quotes. The Input DeviceID must ma tch

    an Identif ier in an InputDevice section. Last , an option may be

    provided. The option can also be specified in t he InputDevice section.

    Typical options specified her e ar e: CorePointer, CoreKeyboard, and

    SendCoreEvents. The option m ust be enclosed in d ouble qu otes. See

    the InputDevice section for m ore informa tion regar ding th e options.

    Normally, at least t wo Inpu tDevices ar e present : a keyboar d an d a

    mouse.

    Options t ha t a pply to th e X Server m ay also be specified in th is section.The following table lists all options t ha t ma y be set in t he

    ServerLayout section.

    configuring X Windows on HP-UX (other graphics cards)

    the XF86Config file

  • 8/2/2019 Graphics Administration Guide for HP-UX 11.x

    42/89

    Chapter 340

    Table 3-1

    Option Value De fau lt De scription

    DontZap Boolean Off This disa llows the use of the

    Ctrl+S hift+Breaksequence. Tha t

    sequence is norm ally used to

    term inat e the X Server. When t his

    option is enabled, tha t k ey sequence

    has n o special meaning an d is passed

    to clients. Sour ce: XF86Config ma npage.

    Dont Zoom Boolean Off This disa llows the use of the

    Ctrl+Alt+Keypad-Plus and

    Ctrl+Alt+Keypad-Minus sequences.

    These sequ ences allow you t o switch

    between video modes. When t his

    option is enabled, th ose key sequen ces

    have no special meaning an d ar epass ed t o clients. S ource: XF86Config

    man page.

    AllowMouseOpenFail Boolean fa lse This a llows the server to sta r t up even

    if th e mouse device can 't be

    opened/initialized.Source: XF86Config

    man page.

    P ixmap Bpp 32 This sets the pixmap format to use fordepth 24. Allowed valu es for bpp are

    24 and 32. Default: 32 unless driver

    const ra ints don't allow t his (which is

    rare). Note: some clients don't behave

    well when t his value is set t o 24.

    Source: XF86Config man page.

    Verbose Integer -1 See the sect ion on Features: Logging

    an d Verbosity for more d eta ilsregarding t hese options.

    NoLogging NA NA See the sect ion on Features: Logging

    an d Verbosity for more d eta ils

    regarding t hese options.

    LogVerbose Integer -1 See the sect ion on Features: Logging

    an d Verbosity for more d eta ils

    regarding t hese options.

    configuring X Windows on HP-UX (other graphics cards)

    the XF86Config file

  • 8/2/2019 Graphics Administration Guide for HP-UX 11.x

    43/89

    Chapter 3 41

    Files section

    Th e Files section is used t o specify pat hs t o where font s an d m odules ar e

    located a nd t he locat ion of th e rgb dat aba se an d th e user specified logfile.Th e Files section form at is:

    Files Section

    [FontPath PathName ]

    .

    .

    [ModulePath PathName ].

    .

    [RgbPath PathName ]

    [LogPath PathName ]

    Endsection

    Multiple Font Paths and Module Path s ma y be specified in two ways,either by multiple lines or by using a , delimiter between pat hs on t he

    sam e line.

    Font Path elements m ay be either a bsolute directory path s, or a font

    server identifier. Font server identifiers have the form:

    /:

    CursorScaleFactor Integer 1 See the sect ion in Features: for more

    details regar ding th ese options.

    MaxCursorSize Integer 64 See the sect ion in Features: Cursor

    Scaling for more details regarding

    these options.

    Aceler at eI ndir ect Ren der in g Boolea n Tr ue Th is opt ion is u sed t o sp ecify wh et her

    or not Open GL is to do softwar e

    ren derin g. A value of False forces

    software rendering. The default is for

    OpenGL to use accelerated r endering.

    Table 3-1 (Continued)

    configuring X Windows on HP-UX (other graphics cards)

    the XF86Config file

  • 8/2/2019 Graphics Administration Guide for HP-UX 11.x

    44/89

    Chapter 342

    where is the t ra nsport t ype to use to conn ect t o the font server

    (e.g.,Unix

    for UNIX-domain sockets ortcp

    for a TCP/IP connection), is the hostna me of th e ma chine ru nn ing the font server, and

    is th e port nu mber t ha t t he font server is listening on

    (usua lly 7000). The default Font Pat h is:

    tcp:/7000,/usr/lib/X11/fonts/hp_roman8/75dpi/,/usr/lib/X11/fonts/iso_8859.1/100dpi/,/usr/lib/X11/fonts/iso_8859.1/75dpi/,

    /usr/lib/X11/fonts/hp_kana8/,/usr/lib/X11/fonts/hp_japanese/100dpi/,/usr/lib/X11/fonts/hp_japanese/75dpi/,/usr/lib/X11/fonts/hp_korean/75dpi/,/usr/lib/X11/fonts/hp_chinese_s/75dpi/,/usr/lib/X11/fonts/hp_chinese_t/75dpi/,/usr/lib/X11/fonts/iso_8859.2/75dpi/,/usr/lib/X11/fonts/iso_8859.5/75dpi/,/usr/lib/X11/fonts/iso_8859.6/75dpi/,

    /usr/lib/X11/fonts/iso_8859.7/75dpi//usr/lib/X11/fonts/iso_8859.8/75dpi/,/usr/lib/X11/fonts/iso_8859.9/75dpi/,/usr/lib/X11/fonts/misc/

    Xf86 u ses ModulePaths as locations t o look for load able m odules. The

    default ModulePath is :

    /usr/lib/X11/Xserver/modules/xf86/,

    /opt/graphics/common/lib/RgbPath can be used to specify the RGB dat abase pa th . Norm ally it is

    never cha nged. If it is not specified th e built-in pat h /etc/X11/rgb isused.

    In addition, th e LogPath can be specified, if server logging information

    is to be sent s omewher e oth er t ha n t he defau lt log file. The defau lt logfile

    is located a t /var/X11/Xserver/logs/Xf86.n.log, where n is the

    display n um ber.

    All nam es mu st be enclosed with in double quotes. Ther e ma y be only one

    Files section in th e config file. This section does n ot recognize Option as

    a keyword.

    configuring X Windows on HP-UX (other graphics cards)

    the XF86Config file

  • 8/2/2019 Graphics Administration Guide for HP-UX 11.x

    45/89

    Chapter 3 43

    Module section

    Th e Module section is u sed t o specify which X Server m odules should be

    loaded . The types of modules n orma lly load ed in t his section ar e X Server

    extension modules, and font ra sterizer m odules. Most oth er m odule types

    ar e loaded au tomat ically when t hey are n eeded via oth er mechan isms.

    Ther e ma y only be one Module section in th e config file. The form at of

    the Module section is a s follows:

    Section Module

    Load ModuleName

    . . .

    [SubSection ModuleName

    Option . . .

    . . .

    EndSubSection]

    . . .

    EndSection.

    Load instr ucts th e server to load t he m odule called ModuleName . The

    module nam e given should be the module's extension n am e, not t he

    module file nam e. The exten sion n am e is case-sensit ive, and does not

    include t he lib pr efix, or the .1 su ffix.

    Exa mp le: th e Double Buffered E xten sion (DBE) can be loaded wit h t he

    following entry:

    Load dbe

    SubSect ion also inst ru cts t he server to load t he m odule called

    ModuleName . The module na me given sh ould be t he m odule's

    extension n am e, not t he m odule file na me. The extension n am e is

    case-sen sit ive, and d oes not include the lib pr efix, or th e .1 su ffix. Thedifference is tha t th e listed Options ar e passed to the module when it is

    loaded.

    Modules a re sea rched for in ea ch directory specified in th e ModulePath

    search pat h (or t he defau lt ModulePath if one is not specified in t he

    Files section) and in th e drivers, input, extensions, font s, and HP -UX

    subdir ectories of each directory in t he ModulePath .

    configuring X Windows on HP-UX (other graphics cards)

    the XF86Config file

  • 8/2/2019 Graphics Administration Guide for HP-UX 11.x

    46/89

    Chapter 344

    InputDevice section

    An InputDevice section is consider ed active if th ere is a referen ce to it

    in th e active ServerLayout section. Ther e m ay be m ultiple

    InputDevice sections. Ther e will norm ally be at lea st t wo: one for th e

    core (prim ar y) keyboard, a nd one for t he core point er. InputDevice

    sections ha ve th e following form at :

    Section InputDevice

    Identifier InputDeviceID

    Driver DriverName

    [Option ]

    . . .EndSection

    Th e Identif ier ent ry specifies the un ique nam e for t his input device an d

    must mat ch an InputDeviceID in th e active ServerLayout section in

    order t o be active.

    Th e Driver entr y specifies the na me of th e driver t o use for t his input

    device.

    InputDevice sections recognize some driver-independen t Options,

    which a re described here. See the individua l input dr iver ma nu al pages

    for a description of th e device-specific options t ha t can be ent ered h ere.

    Table 3-2

    Option Valu e De scription

    Cor ePoin ter NA When t his is set , t he input device is

    insta lled as th e core (prima ry) pointer

    device. There mu st be no more th an one

    core point er. If th is option is n ot set h ere, or

    in the ServerLayout section, or from th e

    -pointer comm an d line option, then th e first

    input device th at is capable of being used asa core point er will be selected a s th e core

    pointer. Source: XF86Config man page.

    configuring X Windows on HP-UX (other graphics cards)

    the XF86Config file

  • 8/2/2019 Graphics Administration Guide for HP-UX 11.x

    47/89

    Chapter 3 45

    The following t wo examples s how an InputDevice section for a

    keyboar d an d mouse:

    Section InputDevice

    Identifier Keyboard0Driver keyboard

    EndSection

    Section InputDevice

    Identifier Mouse0Driver mouseOption Protocol PS/2

    EndSection

    Screen section

    The configura tion file may ha ve mult iple Screen sections. There mu st

    be at least one, for th e screen being u sed. A screen binds a gr aph ics

    device (Device section) an d a monitor (Monitor section) together. A

    Screen section is consider ed active if it is r eferen ced by a n active

    CoreKeyboard NA When th is is set , the input device is to be

    insta lled as th e core (prima ry) keyboard

    device. There mu st be no more th an one

    core keyboar d. If th is option is not set h ere,

    or in th e ServerLayout section, then t he

    first input device th at is capable of being

    used a s a core keyboar d will be selected a s

    th e core k eyboar d. Source: XF86Config man

    page.

    AlwaysCore

    SendCoreEvents

    boolean Both of these op t ions a re equiva lent , and

    when ena bled cause t he input device to

    always report core events. This can be used,

    for exa mple, to allow additiona l point er

    devices to generate core pointer events

    (such as m oving t he cur sor, etc). Source:

    XF86Config man page.

    His torySize number Sets the mot ion his tory s ize. Default : 0 .

    Source: XF86Config man page.

    Table 3-2 (Continued)

    configuring X Windows on HP-UX (other graphics cards)

    the XF86Config file

  • 8/2/2019 Graphics Administration Guide for HP-UX 11.x

    48/89

    Chapter 346

    ServerLayout section. If neit her of th ese is present , the first Screen

    section foun d in t he configur at ion file is consider ed th e active one.

    Screen sections h ave t he following form at :

    Section Screen

    Identifier ScreenID

    Device DeviceID

    Monitor MonitorID

    DefaultDepth

    Option ...

    .

    .

    SubSection Display

    .

    .

    EndSubSection

    .

    EndSection

    Th e Identif ier entr y specifies the u nique na me for t his screen. The

    Identif ier generally mu st ma tch a ScreenID listed in the active

    ServerLayout section. Th e Screen section provides inform at ion

    specific to the whole screen, including screen-specific Options. I nmu lti-screen configura tions, ther e will be mu ltiple active Screen

    sections, one for ea ch h ead.

    Th e Device keyword specifies which Device section t o be used for t his

    screen. This is what binds a sp ecific gra phics car d to a screen. The

    DeviceID must mat ch the Identif ier of a Device section in t he

    configuration file.

    Th e Monitor keyword specifies which Monitor section is to be used forth is screen. This is wh at binds a specific monitor to th e screen. The

    MonitorID must match the Identif ier of a Monitor section in th e

    configuration file.

    Th e DefaultDepth keyword specifies wh ich color dept h t he ser ver

    should use by default. The -depth comm an d line option can be used t ooverr ide th is. If neith er is specified, the d efault dept h is dr iver-specific,

    but in most cases is 8.

    configuring X Windows on HP-UX (other graphics cards)

    the XF86Config file

  • 8/2/2019 Graphics Administration Guide for HP-UX 11.x

    49/89

    Chapter 3 47

    Various Option flags m ay be specified in t he Screen section. Some ar e

    driver-specific and are described in the driver documentation.

    Driver-independent options a re described h ere.

    Each Screen section mu st cont ain one or m ore Display subsections.

    Those subsections provide depth configuration information, and the one

    chosen depends on t he depth th at is being used for t he screen. The

    Display subsection form at is described in t he section below.

    Display subsection

    Th e Screen sections include one or more Display subsections. One

    Display subsection m ay be provided for ea ch dept h t ha t t he server

    sup ports. The size of th e virt ua l screen th e server m ay also be specified.

    Table 3-3

    EntryEntry

    PositionDescr ipt ion

    Accel NA E na bles XAA (X Acceler at ion

    Architectu re), a mechanism t ha t

    ma kes video car ds' 2D hardwar e

    accelera tion available to t he

    Xserver. This option is on by

    defau lt, but it ma y be necessar y to

    tu rn it off if there ar e bugs in t he

    driver. There ar e man y options to

    disable specific accelera ted

    operat ions, listed below. Note th at

    disabling an operat ion will have noeffect if the opera tion is n ot

    accelera ted (wheth er du e to lack of

    support in t he har dware or in th e

    dr iver). Sour ce: XF86Config man

    page.

    SuppressVisuals st r ing See the sect ion in Features: Glx

    Visua l Supp ression for m ore

    deta ils. Sour ce: XF86Config manpage.

    SuppressGlxVisuals st r ing See the sect ion in Features: Visual

    Sup press ion for m ore deta ils.

    Source: XF86Config man page.

    configuring X Windows on HP-UX (other graphics cards)

    the XF86Config file

  • 8/2/2019 Graphics Administration Guide for HP-UX 11.x

    50/89

    Chapter 348

    The virtu al screen a llows you t o have a root window larger t ha n wh at

    can be displa yed on t he m onitor. (e.g. th e monit or ma y be 800x600

    display, but h ave a 1280x1024 virt ua l size). The Virtual keyword is used

    to specify this size. Note th at ma ny of th e new accelera ted gra phics

    drivers u se non-displayed mem ory for caching. It is not desira ble to use

    all ava ilable mem ory for t he virt ua l display, as th is leaves none for

    caching, an d t his can decrease server perform an ce. Display subsections

    ha ve th e following form at :

    SubSection Display

    Depth depth

    Visual visual

    Modes ModeName

    ViewPort x0 y0

    Option

    ...

    EndSubSection

    Th e Depth entr y specifies what color depth th e Display subsection is to

    be used for. Only Depth s of 8 an d 24 ar e support ed.

    Th e Modes ent ry specifies th e list of video modes t o use. Ea ch

    ModeName specified mu st be in double quotes. They mu st corr espond to

    th ose specified or referenced in th e a ppropriate Monitor section. Th e

    server will delete m odes from t his list wh ich don't sa tisfy var iousrequiremen ts. The first valid mode in t his list will be th e defau lt display

    mode for st ar tu p. The list of valid modes is converted in ter na lly int o a

    circula r list. It is possible to switch t o th e next m ode with

    Ctrl+Alt+Keypad-Plus an d to th e previous m ode with

    Ctrl+Alt+Keypad-Minus . When t his entr y is omitt ed, the largest valid

    mode referenced by the a ppropriate Monitor section will be us ed.

    Th e Visual entr y is optiona l and sets t he default r oot visual t ype.

    The visua l type availa ble for t he dept h 8 is: PseudoColor

    The visua l type ava ilable for d epth 24 is: Tru eColor

    Th e ViewPort optiona l entr y sets th e upper left corn er of th e initial

    display. This is only relevant when the virtual screen resolution is

    differen t from th e resolution of th e initia l video mode. If th is ent ry is not

    given, then t he initial display will be center ed in th e virt ua l display ar ea.

    Source: XF86Config ma n page.

    configuring X Windows on HP-UX (other graphics cards)

    the XF86Config file

  • 8/2/2019 Graphics Administration Guide for HP-UX 11.x

    51/89

    Chapter 3 49

    Option flags ma y be specified in t he Display subsections. These may

    include dr iver-specific options or driver-independen t options. Th e form er

    ar e described in th e driver-specific docum ent at ion. Some of th e latt er a re

    described above in th e section about th e Screen section, an d th ey may

    also be included h ere. However, options set in t he Display subsection

    ma y be overr idden in t he Screen section.

    Monitor section

    The configura tion file may ha ve mult iple Monitor sections. Th eMonitor section pr ovides inform at ion a bout th e specifications of th e

    mon itor, monitor-specific Options, and inform at ion a bout th e video

    modes to use with t he monitor. There must be at least one Monitor

    section, for t he m onit or being used. A Monitor section is consider ed

    active if it is r eferen ced by an active Screen section. Monitor sections

    ha ve th e following form at :

    Section Monitor

    Identifier MonitorID

    VendorName Vname

    ModelName Mname

    HorizSync horizsync-range

    VertRefresh vertrefresh-range

    DisplaySize width height

    Gamma [gamma-value|{red-gamma green-gamma blue-gamma}]

    GammaAllLayers [on | true | 1]

    EndSection

    Th e Identif ier ent ry specifies the u nique n am e for t his monitor.

    Th e VendorName is an optional entr y and is used to specify the

    monitor's ma nu factur er.This ModelName is an optiona l entr y tha t is u sed to specify the m onitor

    model.

    HorizSync gives th e ra nge(s) of horizonta l sync frequ encies support ed

    by the m onitor. horizsync-range ma y be a comm a sepa ra ted list of either

    discrete valu es or r an ges of values. A ra nge of values is t wo values

    separa ted by a dash . By defau lt th e values are in u nits of kHz. They may

    be specified in MH z or Hz ifMHz or Hz is added t o the end of the line.

    configuring X Windows o