PanoAnnotation.h

浏览该文件的文档.

 
#pragma once
 
#include "PanoRtcDefs.h"
#include "PanoRtcDevice.h"
#include "PanoWhiteboard.h"
 
#include <stddef.h>
 
PANORTC_NS_BEGIN
 
using WBScalingMode = VideoScalingMode;
 
// Values are platform-specific for Window type:
//   - On Windows: HWND.
//   - On macOS: CGWindowID.
using AnnoWindowID = uintptr_t;
 
enum class AnnoOption
{
    ENABLE_LOCAL_RENDER         = 1, // type: bool
    ENABLE_SHOW_DRAWS           = 2, // type: bool
    ENABLE_UI_RESPONSE          = 3, // type: bool
    ENABLE_CURSORPOS_SYNC       = 4, // type: bool
    ENABLE_SHOW_REMOTE_CURSOR   = 5, // type: bool
};
 
enum class ExternalAnnoMode
{
    DEFAULT         = 1,
    AUTO_SYNC       = 2,
    SCREENSHARE_SEND     = 3,
    SCREENSHARE_RECV     = 4,
};
 
class PanoAnnotation
{
public:
    class Callback
    {
    public:
        virtual void onAnnoRoleChanged(WBRoleType newRole) {}
 
        virtual void onSnapshotComplete(QResult result, const char *filename) {}
 
        virtual void onAnnoWindowCreated(AnnoWindowID windowId)  {}
 
        virtual void onAnnoWindowDestroyed(AnnoWindowID windowId) {}
 
        virtual ~Callback() = default;
    };
 
    virtual QResult setCallback(Callback *callback) = 0;
 
    virtual QResult setRoleType(WBRoleType type) = 0;
 
    virtual QResult startAnnotation(void *window) = 0;
 
    virtual QResult stopAnnotation() = 0;
 
    virtual QResult setVisible(bool visible) = 0;
 
    virtual QResult addToolboxView(void *window) = 0;
 
    virtual QResult removeToolboxView(void *window) = 0;
 
    virtual QResult setToolType(WBToolType type) = 0;
 
    virtual QResult setLineWidth(int size) = 0;
 
    virtual QResult setColor(WBColor color) = 0;
 
    virtual QResult setFillType(WBFillType type) = 0;
 
    virtual QResult setFillColor(WBColor color) = 0;
 
    virtual QResult setFontStyle(WBFontStyle style) = 0;
 
    virtual QResult setFontSize(int size) = 0;
 
    virtual QResult undo() = 0;
 
    virtual QResult redo() = 0;
 
    virtual QResult clearUserContents(uint64_t userId) = 0;
    
    virtual QResult clearContents() = 0;
 
    virtual QResult snapshot(const char *outputDir) = 0;
 
    virtual WBToolType getToolType() = 0;
 
    virtual QResult setAspectSize(int32_t w, int32_t h) = 0;
 
    virtual QResult setScalingMode(WBScalingMode mode) = 0;
 
    virtual QResult setWindowPos(WBRect rect) = 0;
 
    virtual QResult setOption(AnnoOption option, void *param, size_t size) = 0;
 
    virtual QResult setExtAnnoMode(ExternalAnnoMode mode) = 0;
 
protected:
    virtual ~PanoAnnotation() = default;
};
 
class AnnotationManager
{
public:
    class Callback
    {
    public:
        virtual void onVideoAnnotationStart(uint64_t userId, int streamId) {}
        virtual void onVideoAnnotationStop(uint64_t userId, int streamId) {}
 
        virtual void onShareAnnotationStart(uint64_t userId) {}
        virtual void onShareAnnotationStop(uint64_t userId) {}
 
        virtual void onExternalAnnotationStart(const char* annotationId) {}
        virtual void onExternalAnnotationStop(const char* annotationId) {}
 
        virtual ~Callback() = default;
    };
 
    virtual QResult setCallback(Callback *callback) = 0;
 
    virtual PanoAnnotation* getVideoAnnotation(uint64_t userId, int streamId) = 0;
 
    virtual PanoAnnotation* getShareAnnotation(uint64_t userId) = 0;
 
    virtual PanoAnnotation* getExternalAnnotation(const char* annotationId) = 0;
 
protected:
    virtual ~AnnotationManager() = default;
};
 
PANORTC_NS_END