Clear
Clears one or all frames from within DS9.
Syntax
void Clear( dFrame );
Parameters
int dFrame
[ Optional ] The index of the frame to clear. The default value is to clear all frames. Default: -1
Returns
None
Required Headers
CDisplay.h
Namespace
arc
Throws
std::runtime_error
Remarks
This class requires that SAOImage DS9 and XPA be installed.
Example
        // This code demonstrates how to launch DS9 and clear
        // the frame before the next display.

        #include <iostream>
        #include "CController.h"
        #include "CDisplay.h"

        using namespace std;
        using namespace arc;

        int main()
        {
            CController cController;
            CDisplay cDisplay;

            try {
                cDisplay.Launch();

                // .... previously exposed image that resides
                // .... in kernel buffer at CController.mapFd

                cDisplay.Clear();
                cDisplay.Show( cController.mapFd, 1024, 1200 );
            }
            catch ( std::exception &e )
            {
                cerr << "Exception Occurred: " << e.what() << endl;
            }
        }

© Astronomical Research Cameras, Inc.