#include <SFBCamera.h.hpp>

class SFBCamera : public SFBQuery;

SFMTYPEDEFWRAPPER(SFBCamera)

[ public ]
SFCError AddOverlay(
    SFBBitmapSmpConstRef bmp   // SFBBitmap Interface representing the overlay
);

[ public ]
SFCError ClearOverlay(Void);

[ public ]
SFCError DeferEncode(
    Bool defer   // true implies the encoding will be done by user
);

[ public ]
SFCError EncodeSnapshot(Void);

[ public ]
SFCError GetDisplaySizeList(
    AEESize** list   // when input *List contains CAM_MODE_PREVIEW/CAM_MODE_MOVIE.
                     // when output it is a pointer to null- terminated size list 
    BoolPtr range    // pointer to boolean when true indicates the passed list is a null-terminated 
                     // paired list (that is, a multiple of 2) of ranges
);

[ public ]
SFCError GetFrame(
    SFBBitmapSmpPtr frame   // frame SFBBitmap returned
);

[ public ]
SFCError GetMode(
    SInt16Ptr mode   // pointer to mode. CAM_MODE_XXX 
    BoolPtr paused   // true / false => Paused/Resumed 
);

[ public ]
SFCError GetParm(
    SInt16 parmId   // CAM_PARM_XXX
    SInt32Ptr p1    // depends on the nParmID parameter 
    SInt32Ptr p2    // depends on the nParmID parameter 
);

[ public ]
SFCError GetSizeList(
    AEESize** list   // when input List contains CAM_MODE_SNAPSHOT/CAM_MODE_MOVIE 
                     // when output it is a pointer to null- terminated size list
    BoolPtr range    // pointer to boolean.
                     // when true indicates the passed list is a null-terminated paired list (multiple of 2) of ranges
);

[ public ]
SFCError IsBrightness(
    BoolPtr support   // pointer to boolean.
                      // true / false => Supported / Unsupported
);

[ public ]
SFCError IsContrast(
    BoolPtr support   // pointer to boolean.
                      // true / false => Supported / Unsupported
);

[ public ]
SFCError IsMovie(
    BoolPtr support   Pointer to boolean.
                      // true / false => Supported / Unsupported
);

[ public ]
SFCError IsSharpness(
    BoolPtr support   // pointer to boolean.
                      // true / false => Supported / Unsupported
);

[ public ]
SFCError IsSupport(
    SInt16 parmId     // CAM_PARM_XXX parameter ID.See Camera Control Parameters
        
    BoolPtr support   // pointer to boolean.
                      // true / false => Supported / Unsupported
);

[ public ]
SFCError IsZoom(
    BoolPtr support   // pointer to boolean.
                      // true / false => Supported / Unsupported
);

[ public, static ]
SFBCameraSmp NewInstance(
    SFCErrorPtr exception = null   // Error
);

[ public, static ]
SFBCameraSmp NewInstance(
    AEECLSID id                    // Class ID
    SFCErrorPtr exception = null   // Error
);

[ public ]
SFCError Pause(Void);

[ public ]
SFCError Preview(Void);

[ public ]
SFCError RecordMovie(Void);

[ public ]
SFCError RecordSnapshot(Void);

[ public ]
SFCError RegisterNotify(
    PFNCAMERANOTIFY notify   // user callback function pointer
    VoidPtr data             // user data to be used when calling notify() 
);

[ public ]
SFCError Resume(Void);

[ public ]
SFCError RotateEncode(
    SInt32 value   // rotation angle
);

[ public ]
SFCError RotatePreview(
    SInt32 value   // rotation angle
);

[ public ]
SFCError SetAudioEncode(
    AEECLSID clsid   // encoding class ID.
                     // e.g. AEECLSID_MEDIAQCP, etc
    UInt32 extra     // extra info regarding the encoding like sub formats.
                     // example:For AEECLSID_MEDIAQCP, sub-format can be specified as MM_QCP_FORMAT_FIXED_FULL_EVRC
);

[ public ]
SFCError SetBrightness(
    SInt32 value   // brightness value
);

[ public ]
SFCError SetContrast(
    SInt32 value   // contrast value
);

[ public ]
SFCError SetDisplaySize(
    AEESize* size   // frame display size within the main display/off-srceen buffer area
);

[ public ]
SFCError SetFramesPerSecond(
    UInt32 fps   // frames per second. See dwFPS format in CAM_PARM_FPS documentation
);

[ public ]
SFCError SetMediaData(
    AEEMediaData* pmd    // pointer to media data
    ACharConstPtr mime   // optional MIME type of the media
);

[ public ]
SFCError SetMediaData(
    AEEMediaData* pmd            // pointer to media data
    SFXAnsiStringConstRef mime   // optional MIME type of the media
);

[ public ]
SFCError SetParm(
    SInt16 parmId   // CAM_PARM_XXX. 
                    // see Camera Control Parameters
    SInt32 p1       // depends on the nParmID parameter
    SInt32 p2       // depends on the nParmID parameter
);

[ public ]
SFCError SetQuality(
    SInt16 quality   // picture quality
);

[ public ]
SFCError SetSharpness(
    SInt32 value   // sharpness value
);

[ public ]
SFCError SetSize(
    AEESize* size   // size of the picture
);

[ public ]
SFCError SetVideoEncode(
    AEECLSID clsid   // encoding class ID: 
                     // CAM_ENCODE_RAW, AEECLSID_JPEG, AEECLSID_MEDIAMPEG4, etc
    UInt32 extra     // extra info regarding the encoding like sub formats
);

[ public ]
SFCError SetZoom(
    SInt32 value   // zoom value
);

[ public ]
SFCError Start(
    SInt16 mode    // CAM_MODE_PREVIEW / CAM_MODE_SNAPSHOT / CAM_MODE_MOVIE
    UInt32 param   // reserved
);

[ public ]
SFCError Stop(Void);

[ public ]
SFCError UnregisterNotify(Void);