SED navigation bar go to SED home page go to Dataplot home page go to NIST home page SED Home Page SED Staff SED Projects SED Products and Publications Search SED Pages
Dataplot Vol 1 Vol 2

AQUA

Name:
    AQUA
Type:
    Output Device Command
Purpose:
    Generate screen graphics using the Aquaterm library for Mac OSX.
Description:
    For Unix/Linux platforms, Dataplot typically uses the X Window System to generate screen graphics. If you have X11 installed on your Mac OSX system, this option is available (initiate Dataplot from an xterm window and enter the command DEVICE 1 X11 to open the graphics window).

    The native mode windowing/graphics system under Mac OSX is referrred to as Aqua. In addition to X11, Dataplot supports an Aqua driver. If you initiate Dataplot from a regular Mac OSX terminal session, you use the Aqua driver for screen graphics rather than the X11 driver.

Syntax:
    DEVICE <1/2/3> AQUA <xsize> <ysize>
    where <xsize> and <ysize> are the size of the graphics window in pixels.

    This form designates one of DATAPLOT's 3 devices (typically device 1) as an AQUA device.

    The and arguments are optional and default to 600 and 450, respectively.

Examples:
    DEVICE 1 AQUA
    DEVICE 1 AQUA 800 600
Note:
    Dataplot implements the Aqua driver using the Aquaterm library. For more information about Aquaterm, see

    You need to install Aquaterm on your Mac OSX system before installing Dataplot.

Note:
    The Aquaterm graphics window will become visible when you generate the first plot after the DEVICE 1 AQUA command, not when the DEVICE 1 AQUA command is initiated.

    The Aquaterm graphics window persists even after you complete the Dataplot session. You can delete this window manually.

Note:
    Several SET commands were added to support AQUA specific features.

    1. SET AQUA FONT <font name>

      The AQUA font name can be up to 80 characters long. The default is "Helvetica".

      The list of available fonts is typically quite long and not given here. To see the list of available fonts, intitiate Dataplot and enter a DEVICE 1 AQUA command. Click on the graphics window (you may need to generate a plot before this becomes visible). This will switch the top menus on the Mac OSX screen to the Aquaterm menus. From this menu bar, select HELP and then select "Show Fonts".

      These Aquaterm menus will also allow you to save or print the contents of the graphics window.

    2. SET AQUA CAP <BUTT/ROUND/SQUARE>

      The cap style determines how the end of lines are drawn (referred to as end-caps). We suggest that you experiment with these options to see which you prefer.

    3. SET AQUA HARDWARE FILL <ON/OFF>

      This command specifies whether solid regions are filled in hardware (i.e., Aquaterm library) or software (i.e., Dataplot draws the lines to fill the area).

      The default is ON (i.e., Aquaterm does the fill). This is typically the most efficient method. However, if the hardware fill has a problem, you can try setting this switch to OFF.

Note:
    The CROSS HAIR command (used to read the current coordinates when you click the mouse) is not currently supported with this driver.

    Also, the SAVE PLOT/REPEAT PLOT/CYCLE PLOT commands are not currently supported for Aqua.

Default:
    Off
Synonyms:
    None
Related Commands:
    X11 = Direct graphical output to an X11 window.
    POSTSCRIPT = Direct graphical output to a Postscript device.
    DEVICE = Specify certain actions for the graphics output.
    SET AQUA FONT = Specify the Aqua font to use.
    SET AQUA CAP = Specify the Aqua cap style to use.
    SET AQUA HARDWARE FILL = Specify how solid fills are performed.
Applications:
    Graphics
Implementation Date:
    2007/10
Program: 
     
DEVICE 1 AQUA
PLOT SIN(X) FOR X = 0  0.01  6

Privacy Policy/Security Notice
Disclaimer | FOIA

NIST is an agency of the U.S. Commerce Department.

Date created: 01/15/2008
Last updated: 10/07/2016
Please email comments on this WWW page to alan.heckert@nist.gov.