ARVideoSource.h

Go to the documentation of this file.

/*
 *  ARVideoSource.h
 *  artoolkitX
 *
 *  This file is part of artoolkitX.
 *
 *  artoolkitX is free software: you can redistribute it and/or modify
 *  it under the terms of the GNU Lesser General Public License as published by
 *  the Free Software Foundation, either version 3 of the License, or
 *  (at your option) any later version.
 *
 *  artoolkitX is distributed in the hope that it will be useful,
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 *  GNU Lesser General Public License for more details.
 *
 *  You should have received a copy of the GNU Lesser General Public License
 *  along with artoolkitX.  If not, see <http://www.gnu.org/licenses/>.
 *
 *  As a special exception, the copyright holders of this library give you
 *  permission to link this library with independent modules to produce an
 *  executable, regardless of the license terms of these independent modules, and to
 *  copy and distribute the resulting executable under terms of your choice,
 *  provided that you also meet, for each linked independent module, the terms and
 *  conditions of the license of that module. An independent module is a module
 *  which is neither derived from nor based on this library. If you modify this
 *  library, you may extend this exception to your version of the library, but you
 *  are not obligated to do so. If you do not wish to do so, delete this exception
 *  statement from your version.
 *
 *  Copyright 2018 Realmax, Inc.
 *  Copyright 2015-2016 Daqri, LLC.
 *  Copyright 2010-2015 ARToolworks, Inc.
 *
 */
 
#ifndef VIDEOSOURCE_H
#define VIDEOSOURCE_H
 
#include <ARX/Platform.h>
 
#include <ARX/AR/ar.h>
#include <ARX/ARVideo/video.h>
 
#include <mutex>
#include <pthread.h>
 
class ARX_EXTERN ARVideoSource {
 
private:
 
    typedef enum {
        DEVICE_CLOSED,                  
        DEVICE_OPEN,                    
        DEVICE_GETTING_READY,           
        DEVICE_RUNNING                  
    } DeviceState;
    
    DeviceState deviceState;            
 
    AR2VideoParamT *m_vid;
    bool m_noCpara;
    char* cameraParam;                  
    char* cameraParamBuffer;
    size_t cameraParamBufferLen;
    ARParamLT *cparamLT;                
    ARParam cparamAdjusted;             
 
    char* videoConfiguration;           
 
    int videoWidth;                     
    int videoHeight;                    
 
    AR_PIXEL_FORMAT pixelFormat;        
    
    int m_captureFrameWaitCount;        
 
    AR2VideoBufferT *m_frameBuffer;     
    
    AR2VideoTimestampT m_getFrameTextureTime; 
    
    int m_error;
    void setError(int error);
    
    pthread_rwlock_t m_frameBufferLock;
 
    static void openCallback(void *userData);
    bool open2();
    static void open2CparamCallback(const ARParam *cparam_p, void *userdata);
    bool open3(const ARParam *cparam_p);
    
public:
 
    ARVideoSource();
    
    ~ARVideoSource();
 
    int getError();
 
    bool isOpen()  const;
 
    bool isRunning()  const;
    
    void configure(const char* vconf, bool noCpara, const char* cparaName, const char* cparaBuff, size_t cparaBuffLen);
 
    ARParamLT* getCameraParameters() const;
 
    struct Size {
        int width;
        int height;
    };
    
    enum class ScalingMode {
        SCALE_MODE_STRETCH,
        SCALE_MODE_FIT,
        SCALE_MODE_FILL,
        SCALE_MODE_1_TO_1
    };
 
    static const std::string ScalingModeName(const ScalingMode scalingMode)
    {
       switch (scalingMode) {
            case ScalingMode::SCALE_MODE_STRETCH: return "stretch";
            case ScalingMode::SCALE_MODE_FIT: return "fit";
            case ScalingMode::SCALE_MODE_FILL: return "fill";
            case ScalingMode::SCALE_MODE_1_TO_1: return "1 to 1";
            default: return "";
        }
    }
 
    ARParam* getCameraParametersForViewportSizeAndFittingMode(const Size viewportSize, const ScalingMode scalingMode);
 
    int getVideoWidth() const;
    
    int getVideoHeight() const;
 
    AR_PIXEL_FORMAT getPixelFormat() const;
 
    bool open();
    
    bool close();
 
    bool captureFrame();
 
    AR2VideoBufferT* checkoutFrameIfNewerThan(const AR2VideoTimestampT time);
 
     void checkinFrame(void);
 
     AR2VideoParamT *getAR2VideoParam(void);
    
    bool getFrameTextureRGBA32(uint32_t *buffer);
    
    int videoPushInit(int width, int height, const char *pixelFormat, int cameraIndex, int cameraPosition);
    int videoPush(ARUint8 *buf0p, int buf0Size, int buf0PixelStride, int buf0RowStride,
                  ARUint8 *buf1p, int buf1Size, int buf1PixelStride, int buf1RowStride,
                  ARUint8 *buf2p, int buf2Size, int buf2PixelStride, int buf2RowStride,
                  ARUint8 *buf3p, int buf3Size, int buf3PixelStride, int buf3RowStride);
    int videoPushFinal(void);
 
};
 
#endif // !VIDEOSOURCE_H