Version 3.1

Multimission Image Processing Laboratory

VRDI User's Reference Guide

Paul Bartholomew

1 January 1990

National Aeronautics and Space Administration
Jet Propulsion Laboratory

California Institute of Technology
Pasadena, California 91109

D-5100

Contents

  1. Introduction
  2. VRDI Overview
    1. Allocation of Display Hardware
    2. Workstations
    3. Display Devices
    4. Coordinate System
    5. Image Memory Planes
    6. Look-Up Tables
    7. Graphics Overlay Plane
    8. Cursors
    9. Subroutine Naming Convention
    10. Subroutine Parameters
      1. C Interface
      2. FORTRAN Interface
    11. Subroutine Returned Status Codes
    12. Text Generation
    13. Access Window
    14. Display Window
    15. Virtual Display Device
  3. VRDI Application Program Guidelines
    1. Never Assume Anything
    2. Check the Flags
    3. Allow User Flexibility
    4. Graphics Plane
    5. Coordinates
  4. VRDI Routines
    1. Alphanumeric Font Generator
      1. XDACLEAR - Clear Alphanumeric Font Generator
      2. XDAOFF - Turn Off Display of Alphanumeric Font Generator
      3. XDAON - Turn On Display of Alphanumeric Font Generator
      4. XDATEXT - Write Text to Alphanumeric Font Generator
    2. Cursor Routines
      1. XDCAUTOTRACK - Set Cursor/Device Tracking
      2. XDCILOCATION - Get Cursor Location in Image Plane Coordinates
      3. XDCIMP2RAW - Translate from Image Plane Coordinates to Raw
      4. XDCISET - Set Cursor Location in Image Plane Coordinates
      5. XDCCOLOR - Set Cursor Color
      6. XDCLOCATION - Get Cursor Location in Raw Coordinates
      7. XDCOFF - Turn Cursor Off
      8. XDCON - Turn Cursor On
      9. XDCRAW2IMP - Translate from Raw Coordinates to Image Plane
      10. XDCSET - Set Cursor Location in Raw Coordinates
      11. XDCSHOW - Turn Cursor On
      12. XDCSIZE - Set Cursor Size
    3. Device Configuration Routines
      1. XDDACTIVATE - Active/deactivate a Device
      2. XDDALLOCATE - Allocate a Device
      3. XDDCLOSE - Close Device
      4. XDDCONFIGURE - Configure a Device
      5. XDDFREE - Free (Deallocate) a Device
      6. XDDINFO - Get Device Information
      7. XDDMOVE - Move Window Device
      8. XDDNAME - Get Device Name
      9. XDDNAMEDUNIT - Get Device Unit Number
      10. XDDOPCLS - Open or Iconify a Window Device
      11. XDDOPEN - Open a Device
      12. XDDRESIZE - Resize a Window Device
      13. XDDSMARTOPEN - Open a Device
      14. XDDUNIT - Assign Device Unit Number
      15. XDDUNITNAMES - Get Device Names
    4. Error Handling Routines
      1. XDEACTION - Set Error Action
      2. XDELEVEL - Get Error Security Level
      3. XDESIGNAL - Display a System Error Message
    5. Flag Routines
      1. XDFCONFIG - Check Device Configuration Flag
      2. XDFGLUT - Check Graphics Look-Up Table Flag
      3. XDFIMAGE - Check Image Memory Plane Flag
      4. XDFLUT - Check Look-Up Table Flag
      5. XDFREGISTER - Select Group of Flags
    6. Graphics Overlay Plane Routines
      1. XDGCOLOR - Get DN Value Corresponding to Named Color
      2. XDGCONNECT - Connect Image Plane to Graphics LUT
      3. XDGLCONSTANT - Set Graphics Look-up Table to a Constant
      4. XDGLINIT - Initialize Graphics Look-up Table
      5. XDGLREAD - Read Graphics Look-up Table
      6. XDGLWRITE - Write Graphics Look-up Table
      7. XDGOFF - Turn Off the Graphics Overlay
      8. XDGON - Turn On the Graphics Overlay
      9. XDGRGB - Get DN Value Corresponding to Given RGB Triplet
    7. Image Memory Plane Routines
      1. XDIAREAFILL - Fill an Area with a Constant Value
      2. XDIAWLOCATION - Get Access Window Location
      3. XDIAWREAD - Read from Image Plane Access Window
      4. XDIAWSET - Set Access Window Location
      5. XDIAWWRITE - Write to Image Plane Access Window
      6. XDICIRCLE - Draw a Circle
      7. XDIDWLOCATION - Get Display Window Location
      8. XDIDWSET - Set Display Window Location
      9. XDIFILL - Fill Image Plane with a Constant
      10. XDIHISTOGRAM - Collect a Histogram for an Image Plane
      11. XDIIARITHMETIC - Perform an Arithmetic Operation
      12. XDIICOPY - Copy from One Image Plane to Another
      13. XDIILOGICAL - Perform a Logical Operation
      14. XDIISHIFT - Logical Bit Shift of Image Plane
      15. XDILINEREAD - Read a Line from an Image Plane
      16. XDILINEWRITE - Write a Line to an Image Plane
      17. XDIMAWWRITE - XDIAWWRITE - with Mask
      18. XDIMCIRCLE - XDICIRCLE with Mask
      19. XDIMFILL - XDIFILL with Mask
      20. XDIMLINEWRITE - XDILINEWRITE with Mask
      21. XDIMPIXELWRITE - Masked XDIPIXELWRITE
      22. XDIMPOLYLINE - XDIPOLYLINE with Mask
      23. XDIPIXELREAD - Read Pixel from Image Plane
      24. XDIPIXELWRITE - Write a Pixel to an Image Plane
      25. XDIPOLYLINE - Draw a Series of Vectors
      26. XDIROTATE - Rotate an Image Plane
      27. XDIZOOM - Set Zoom for an Image Plane
    8. LUT Routines
      1. XDLCONNECT - Connect Image Plane to Look-up Table
      2. XDLRAMP - Set Look-up Table to a Linear Ramp
      3. XDLREAD - Read Look-up Table
      4. XDLWRITE - Write Look-up Table
    9. Device Status Routines
      1. XDSBYPASS - Get Look-Up Table Bypass Status
      2. XDSDWLINE - Get Upper Left Corner Line Number For Image Plane
      3. XDSDWSAMP - Get Upper Left Corner Sample Number For Image Plane
      4. XDSGBYPASS - Get Graphics Look-Up Table Bypass Status
      5. XDSGRAPH - Get Image Plane Connected to the Graphics Plane
      6. XDSGSECTION - Get Section Number of the Graphics LUT in Use
      7. XDSIMP - Get Image Plane Number
      8. XDSMODE - Get Video Display Mode
      9. XDSNL - Get Number of Lines in the Image Planes
      10. XDSNS - Get Number of Samples in the Image Planes
      11. XDSSECTION - Get Look-Up Table Section Number
      12. XDSVNL - Get Number of Lines On Video Screen
      13. XDSVNS - Get Number of Samples on Video Screen
      14. XDSZOOM - Get Hardware Zoom Factor For Image Plane
    10. Text Generation Routines
      1. XDTCOLOR - Set Font Color and Precision
      2. XDTFONT - Set Font Style
      3. XDTLENGTH - Get Length of a String
      4. XDTMASK - Set Text Mask
      5. XDTROTATE - Set Font Rotation
      6. XDTSIZE - Set Font Height and Scaling
      7. XDTTEXT - Write Text
    11. Interactive IO Device Routines
      1. XDX2D - Get Two-Dimensional User Input
      2. XDXSWITCH - Get User Input from Switch Box

Appendices:

  1. VRDI Error Messages
    1. Warning Messages
    2. Error Messages
    3. Fatal Messages
    4. VRDI Error Codes
  2. XDDINFO Configuration Information
  3. Notes on Supported Display Devices
    1. Gould DeAnza IP-8500, Low Resolution
    2. Gould DeAnza IP-8500, High Resolution
    3. Gould DeAnza IP-9000
    4. International Imaging Systems IVAS
    5. Ramtek RM-9460
    6. ADAGE Graphics System
  4. Hardware Selection Criteria
    1. Control Registers
    2. LUT/DACs
    3. Graphics Overlay
    4. Image Memory Planes
    5. Cursor
    6. Alphanumeric Font Generator
    7. Interactice IO Devices
    8. Special Hardware
    9. Other Considerations
  5. Fonts Available on MIPL System
    1. Standard Fonts
    2. Special and Combination Fonts
    3. Description of Some Special Fonts
      1. Font 102: Cartographic Special Characters
      2. Font 105: Simplex Roman Special Character, Geometry, Cards and Weather Symbols
      3. Font 106: Circuit and Map Symbols
      4. Font 107: Circles and Highway Signs
      5. Font 111: Math Symbols (Normal Size)
      6. Font 114: Complex Roman Special Characters and Astrology
      7. Font 115: Zodiac and Music Symbols
      8. Font 116: Math Symbols (Large Size)
      9. Font 119: Duplex Roman and Complex Script Special Characters
      10. Font 124: Triplex Roman and Italic Special Characters
      11. Font 129: Gothic Special Characters
  6. Creating User Defined Text Fonts
    1. History
    2. User Defined Fonts
    3. Defining Characters
    4. Font File Description
  7. Sample Application Programs
    1. Non-Interactive Sample Program
    2. Simple Interactive Sample Program
    3. Better Interactive Sample Program
HTML formatting by Elizabeth.Duxbury@jpl.nasa.gov.
Last modified May 15, 1995.