home *** CD-ROM | disk | FTP | other *** search
/ Gold Fish 2 / goldfish_vol2_cd1.bin / files / util / cli / monitorinfo / monitorinfo.doc < prev    next >
Encoding:
Text File  |  1994-04-09  |  4.4 KB  |  103 lines
  1. MONITORINFO - The Monitor Peek Utility, V37.4
  2. =============================================
  3.  
  4. MonitorInfo is a small utility that allows to view some important properties
  5. of an AMIGA monitor specification as introduced with Release 2 of the Amiga
  6. Operating System.
  7.  
  8. MonitorInfo can only be used from CLI or Shell. Its Usage is quite simple:
  9. just enter
  10.  
  11.    MONITORINFO <monitor-name> [<monitor-name>] [RAW]
  12.  
  13. where <monitor-name> is the name of the monitor whose properties you wish to
  14. inspect. The ".monitor" extension must be given, and upper/lowercase is also
  15. important (not my fault, but the FindName() library function doesn't support
  16. case independent search 8-[.)
  17. Until Release 2.1 (V38), all the monitor names are lower case. The new modes
  18. introduced with Release 3.0 (V39), however, are mixed case. You must type
  19. "DoublePAL.monitor" and "DoubleNTSC.monitor" in order that these names be
  20. recognized.
  21.  
  22. If you don't know how to spell the monitor's name, or have no idea of what
  23. monitors are installed in your system, enter MONITORINFO LIST (new V37.3
  24. feature), to get a list of all monitors currently installed. Type the monitor
  25. name exactly as it is written in this list.
  26.  
  27. If the monitor you specified could be found in the database, a lot of
  28. information will pour over your screen, starting with perhaps the most
  29. interesting values: the horizontal and vertical scan rates. They might look
  30. a bit odd, but they are accurate. Their values are calculated directly from
  31. the custom chip's DMA timebase, rather than using a rough average.
  32. The "lowres pixel aspect ratio" is the width to height ratio of a lowres,
  33. non-interlace pixel on the given monitor. E.g. a value of 2.00 means that a
  34. pixel is twice as wide as high, and a value of 0.75 means that a pixel has
  35. an aspect ration of 3:4.
  36.  
  37. If your monitor is not one of the video modes (PAL or NTSC), the timings of
  38. the horizontal and vertical synchronisation and blanking intervals will also
  39. be displayed. The "delay" value after the horizontal and vertical sync
  40. interval values is the "offset" of the sync pulse from the beginning of the
  41. corresponding blanking interval. If your entered the keyword "RAW" on the
  42. command line, the hardware register's values are displayed instead of the
  43. signal intervals in microseconds (µs).
  44.  
  45. After that, the signal properties of this monitor are displayed. This value is
  46. exactly what is written into the BeamCon0 register when this monitor is used.
  47. The following flags are defined under both ECS and AA:
  48.  
  49. HSYNCTRUE - vertical sync signal has positive polarity ("true" logical level)
  50.  
  51. VSYNCTRUE - horizontal sync signal has positive polarity ("true" log. level)
  52.  
  53. CSYNCTRUE - composite sync signal has positive polarity
  54.  
  55. CSBLANK - composite blank output to CSY pin (ECS), unused (AA)
  56.  
  57. VARCSYNC - variable composite sync enabled. By default, the graphics chip
  58.    uses fixed values for PAL or NTSC modes
  59.  
  60. DISPLAYPAL - if set, tells graphics chip to use PAL color encoding
  61.  
  62. DISPLAYDUAL - uses UHRES pointers and standard pointers
  63.  
  64. VARBEAM - enables custom scan rates other than 15 kHz
  65.  
  66. VARHSYNC - enables custom horizontal sync settings
  67.  
  68. VARVSYNC - enables custom vertical sync settings
  69.  
  70. CSCBLANKEN - redirect composite sync to HSY pin, and composite blank to
  71.    VSY pin. (both sync and blank still come out of the CSY pin however)
  72.  
  73. VARVBLANK - enables custom vertical blanking settings
  74.  
  75. LPENDIS - disable lightpen latched values in VPOSR, VHPOSR and HHPOSR, and
  76.    read actual beam counter value even if lightpen is triggered (AA only)
  77.  
  78. HARDDIS - disable hardwire display window limits. This bit is automatically
  79.    set when VARBEAM is enabled (set) (AA only)
  80.  
  81. (For more information about these values, I recommend the AGA Guide document
  82. found on the FreshFish CDROM, December 1993 Edition.)
  83.  
  84. NOTE: It should be possible to inspect non-native (RTG) modes as well, if 
  85. they link into the GfxBase monitor list, as the PICASSO and EGS/Spectrum
  86. cards do. However, I do not know whether the values returned will be of any
  87. use. Some, like the sweep rates, might be reasonable; others, like
  88. the signal properties, might not be. There is no information about how the
  89. RTG (Re-Targetable Graphics) will actually be implemented. However, if anybody
  90. sends me information about his graphics board, I might well enhance this
  91. little utility.
  92.  
  93.  
  94. If you have any bug reports, improvements etc., write to
  95.  
  96.    Gregor S. M. Kuhlmann
  97.    Friedhofsallee 4/5
  98.    A-2451 Hof am Leithaberge
  99.    AUSTRIA
  100.    EUROPE
  101.    
  102. (sorry no email yet, but I'm working on it ...)
  103.