/*

    File:       DisplayVideo.h

    Description:DisplayVideo will display all info about all video modes supported

                by each installed video card with their attached monitor. The purpose

                of this code is to provide a sample of how developers can discover the

                bit depths and timings of multisync displays.

    Author:     EWA

    Copyright:  Copyright: © 1995-1999 by Apple Computer, Inc.

                all rights reserved.

    Disclaimer: You may incorporate this sample code into your applications without

                restriction, though the sample code has been provided "AS IS" and the

                responsibility for its operation is 100% yours.  However, what you are

                not permitted to do is to redistribute the source as "DSC Sample Code"

                after having made changes. If you're going to re-distribute the source,

                we require that you make it clear in the source that the code was

                descended from Apple Sample Code, but that you've made changes.

    Change History (most recent first):

                6/24/99 Updated for Metrowerks Codewarror Pro 2.1(KG)

                5/24/95 New today(EWA)

*/

// requestFlags bit values in VideoRequestRec (example use: 1<<kAbsoluteRequestBit)

enum {

    kBitDepthPriorityBit        = 0,    // Bit depth setting has priority over resolution

    kAbsoluteRequestBit         = 1,    // Available setting must match request

    kShallowDepthBit            = 2,    // Match bit depth less than or equal to request

    kMaximizeResBit             = 3,    // Match screen resolution greater than or equal to request

    kAllValidModesBit           = 4     // Match display with valid timing modes (may include modes which are not marked as safe)

};

// availFlags bit values in VideoRequestRec (example use: 1<<kModeValidNotSafeBit)

enum {

    kModeValidNotSafeBit        = 0     //  Available timing mode is valid but not safe (requires user confirmation of switch)

};

// video request structure

struct VideoRequestRec  {

    GDHandle        screenDevice;       // <in/out> nil will force search of best device, otherwise search this device only

    short           reqBitDepth;        // <in>     requested bit depth

    short           availBitDepth;      // <out>    available bit depth

    unsigned long   reqHorizontal;      // <in>     requested horizontal resolution

    unsigned long   reqVertical;        // <in>     requested vertical resolution

    unsigned long   availHorizontal;    // <out>    available horizontal resolution

    unsigned long   availVertical;      // <out>    available vertical resolution

    unsigned long   requestFlags;       // <in>     request flags

    unsigned long   availFlags;         // <out>    available mode flags

    unsigned long   displayMode;        // <out>    mode used to set the screen resolution

    unsigned long   depthMode;          // <out>    mode used to set the depth

    VDSwitchInfoRec switchInfo;         // <out>    DM2.0 uses this rather than displayMode/depthMode combo

};

typedef struct VideoRequestRec VideoRequestRec;

typedef struct VideoRequestRec *VideoRequestRecPtr;

// Routine defines