video.h

Go to the documentation of this file.

/*
 *  video.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 2002-2015 ARToolworks, Inc.
 *
 *  Author(s): Hirokazu Kato, Atsishi Nakazawa, Philip Lamb
 *
 */
/*
 *
 * Author: Hirokazu Kato, Atsishi Nakazawa
 *
 *         kato@sys.im.hiroshima-cu.ac.jp
 *         nakazawa@inolab.sys.es.osaka-u.ac.jp
 *
 * Revision: 4.3
 * Date: 2002/01/01
 *
 */
 
#ifndef AR_VIDEO_H
#define AR_VIDEO_H
 
#include <ARX/AR/ar.h>
#include <ARX/ARVideo/videoConfig.h>
#include <limits.h>
 
#ifdef  __cplusplus
extern "C" {
#endif
 
typedef enum {
    AR_VIDEO_MODULE_DUMMY              = 0,
    AR_VIDEO_MODULE_RESERVED1          = 1,
    AR_VIDEO_MODULE_RESERVED2          = 2,
    AR_VIDEO_MODULE_1394               = 3,
    AR_VIDEO_MODULE_RESERVED4          = 4,
    AR_VIDEO_MODULE_RESERVED5          = 5,
    AR_VIDEO_MODULE_RESERVED6          = 6,
    AR_VIDEO_MODULE_RESERVED7          = 7,
    AR_VIDEO_MODULE_RESERVED8          = 8,
    AR_VIDEO_MODULE_RESERVED9          = 9,
    AR_VIDEO_MODULE_RESERVED10         = 10,
    AR_VIDEO_MODULE_GSTREAMER          = 11,
    AR_VIDEO_MODULE_AVFOUNDATION       = 12,
    AR_VIDEO_MODULE_RESERVED13         = 13,
    AR_VIDEO_MODULE_IMAGE              = 14,
    AR_VIDEO_MODULE_ANDROID            = 15,
    AR_VIDEO_MODULE_WINDOWS_MEDIA_FOUNDATION = 16,
    AR_VIDEO_MODULE_WINDOWS_MEDIA_CAPTURE = 17,
    AR_VIDEO_MODULE_V4L2               = 18,
    AR_VIDEO_MODULE_EMSCRIPTEN         = 19,
    AR_VIDEO_MODULE_MAX                = 19,
} AR_VIDEO_MODULE;
 
//
// arVideoParamGet/arVideoParamSet names.
//
 
#define  AR_VIDEO_1394_BRIGHTNESS                      65
#define  AR_VIDEO_1394_BRIGHTNESS_FEATURE_ON           66
#define  AR_VIDEO_1394_BRIGHTNESS_AUTO_ON              67
#define  AR_VIDEO_1394_BRIGHTNESS_MAX_VAL              68
#define  AR_VIDEO_1394_BRIGHTNESS_MIN_VAL              69
#define  AR_VIDEO_1394_EXPOSURE                        70
#define  AR_VIDEO_1394_EXPOSURE_FEATURE_ON             71
#define  AR_VIDEO_1394_EXPOSURE_AUTO_ON                72
#define  AR_VIDEO_1394_EXPOSURE_MAX_VAL                73
#define  AR_VIDEO_1394_EXPOSURE_MIN_VAL                74
#define  AR_VIDEO_1394_WHITE_BALANCE                   75
#define  AR_VIDEO_1394_WHITE_BALANCE_UB                76
#define  AR_VIDEO_1394_WHITE_BALANCE_VR                77
#define  AR_VIDEO_1394_WHITE_BALANCE_FEATURE_ON        78
#define  AR_VIDEO_1394_WHITE_BALANCE_AUTO_ON           79
#define  AR_VIDEO_1394_WHITE_BALANCE_MAX_VAL           80
#define  AR_VIDEO_1394_WHITE_BALANCE_MIN_VAL           81
#define  AR_VIDEO_1394_SHUTTER_SPEED                   82
#define  AR_VIDEO_1394_SHUTTER_SPEED_FEATURE_ON        83
#define  AR_VIDEO_1394_SHUTTER_SPEED_AUTO_ON           84
#define  AR_VIDEO_1394_SHUTTER_SPEED_MAX_VAL           85
#define  AR_VIDEO_1394_SHUTTER_SPEED_MIN_VAL           86
#define  AR_VIDEO_1394_GAIN                            87
#define  AR_VIDEO_1394_GAIN_FEATURE_ON                 88
#define  AR_VIDEO_1394_GAIN_AUTO_ON                    89
#define  AR_VIDEO_1394_GAIN_MAX_VAL                    90
#define  AR_VIDEO_1394_GAIN_MIN_VAL                    91
#define  AR_VIDEO_1394_FOCUS                           92
#define  AR_VIDEO_1394_FOCUS_FEATURE_ON                93
#define  AR_VIDEO_1394_FOCUS_AUTO_ON                   94
#define  AR_VIDEO_1394_FOCUS_MAX_VAL                   95
#define  AR_VIDEO_1394_FOCUS_MIN_VAL                   96
#define  AR_VIDEO_1394_GAMMA                           97
#define  AR_VIDEO_1394_GAMMA_FEATURE_ON                98
#define  AR_VIDEO_1394_GAMMA_AUTO_ON                   99
#define  AR_VIDEO_1394_GAMMA_MAX_VAL                  100
#define  AR_VIDEO_1394_GAMMA_MIN_VAL                  101
 
#define  AR_VIDEO_PARAM_GET_IMAGE_ASYNC               200 
#define  AR_VIDEO_PARAM_DEVICEID                      201 
#define  AR_VIDEO_PARAM_NAME                          202 
 
#define  AR_VIDEO_FOCUS_MODE                          301 
#define  AR_VIDEO_FOCUS_MANUAL_DISTANCE               302 
#define  AR_VIDEO_FOCUS_POINT_OF_INTEREST_X           303 
#define  AR_VIDEO_FOCUS_POINT_OF_INTEREST_Y           304 
 
#define  AR_VIDEO_PARAM_AVFOUNDATION_IOS_DEVICE                400 
#define  AR_VIDEO_PARAM_AVFOUNDATION_FOCUS_PRESET              401 
#define  AR_VIDEO_PARAM_AVFOUNDATION_CAMERA_POSITION           402 
#define  AR_VIDEO_PARAM_AVFOUNDATION_WILL_CAPTURE_NEXT_FRAME   403 
 
#define  AR_VIDEO_PARAM_ANDROID_CAMERA_INDEX          500 
#define  AR_VIDEO_PARAM_ANDROID_CAMERA_FACE           501 
#define  AR_VIDEO_PARAM_ANDROID_INTERNET_STATE        502 
#define  AR_VIDEO_PARAM_ANDROID_FOCAL_LENGTH          503 
 
#define  AR_VIDEO_GET_VERSION                     INT_MAX
 
// For arVideoParamGet(AR_VIDEO_FOCUS_MODE, ...)
#define  AR_VIDEO_FOCUS_MODE_FIXED                    0
#define  AR_VIDEO_FOCUS_MODE_AUTO                     1
#define  AR_VIDEO_FOCUS_MODE_POINT_OF_INTEREST        2
#define  AR_VIDEO_FOCUS_MODE_MANUAL                   3
 
typedef enum {
    AR_VIDEO_SIZE_PREFERENCE_ANY = 0,                   
    AR_VIDEO_SIZE_PREFERENCE_EXACT,                     
    AR_VIDEO_SIZE_PREFERENCE_CLOSEST_SAME_ASPECT,       
    AR_VIDEO_SIZE_PREFERENCE_CLOSEST_PIXEL_COUNT,       
    AR_VIDEO_SIZE_PREFERENCE_SAME_ASPECT,               
    AR_VIDEO_SIZE_PREFERENCE_LARGEST_WITH_MAXIMUM,      
    AR_VIDEO_SIZE_PREFERENCE_SMALLEST_WITH_MINIMUM,     
    AR_VIDEO_SIZE_PREFERENCE_LARGEST,                   
    AR_VIDEO_SIZE_PREFERENCE_SMALLEST                   
} ARVideoSizePreference;
 
 
typedef enum {
    AR_VIDEO_AVFOUNDATION_IOS_DEVICE_IPHONE3G = 1,
    AR_VIDEO_AVFOUNDATION_IOS_DEVICE_IPHONE3GS,
    AR_VIDEO_AVFOUNDATION_IOS_DEVICE_IPHONE4,
    AR_VIDEO_AVFOUNDATION_IOS_DEVICE_IPODTOUCH4,
    AR_VIDEO_AVFOUNDATION_IOS_DEVICE_IPAD2,
    AR_VIDEO_AVFOUNDATION_IOS_DEVICE_IPAD3,
    AR_VIDEO_AVFOUNDATION_IOS_DEVICE_IPHONE_GENERIC,
    AR_VIDEO_AVFOUNDATION_IOS_DEVICE_IPOD_GENERIC,
    AR_VIDEO_AVFOUNDATION_IOS_DEVICE_IPAD_GENERIC,
    AR_VIDEO_AVFOUNDATION_IOS_DEVICE_IPHONE4S,
    AR_VIDEO_AVFOUNDATION_IOS_DEVICE_APPLETV_GENERIC,
    AR_VIDEO_AVFOUNDATION_IOS_DEVICE_IPHONE5,
    AR_VIDEO_AVFOUNDATION_IOS_DEVICE_IPODTOUCH5,
    AR_VIDEO_AVFOUNDATION_IOS_DEVICE_IPAD4,
    AR_VIDEO_AVFOUNDATION_IOS_DEVICE_IPADMINI,
    AR_VIDEO_AVFOUNDATION_IOS_DEVICE_IPHONE5C,
    AR_VIDEO_AVFOUNDATION_IOS_DEVICE_IPHONE5S,
    AR_VIDEO_AVFOUNDATION_IOS_DEVICE_IPADAIR,
    AR_VIDEO_AVFOUNDATION_IOS_DEVICE_IPADMINI2,
    AR_VIDEO_AVFOUNDATION_IOS_DEVICE_IPADMINI3,
    AR_VIDEO_AVFOUNDATION_IOS_DEVICE_IPADMINI4,
    AR_VIDEO_AVFOUNDATION_IOS_DEVICE_IPADAIR2,
    AR_VIDEO_AVFOUNDATION_IOS_DEVICE_IPHONE6,
    AR_VIDEO_AVFOUNDATION_IOS_DEVICE_IPHONE6PLUS,
    AR_VIDEO_AVFOUNDATION_IOS_DEVICE_IPHONE6S,
    AR_VIDEO_AVFOUNDATION_IOS_DEVICE_IPHONE6SPLUS,
    AR_VIDEO_AVFOUNDATION_IOS_DEVICE_IPHONESE,
    AR_VIDEO_AVFOUNDATION_IOS_DEVICE_IPADPRO129,
    AR_VIDEO_AVFOUNDATION_IOS_DEVICE_IPHONE7,
    AR_VIDEO_AVFOUNDATION_IOS_DEVICE_IPHONE7PLUS,
    AR_VIDEO_AVFOUNDATION_IOS_DEVICE_IPADPRO97,
} AR_VIDEO_AVFOUNDATION_IOS_DEVICE;
 
typedef enum {
    AR_VIDEO_AVFOUNDATION_FOCUS_NONE = 0,   
    AR_VIDEO_AVFOUNDATION_FOCUS_MACRO,      
    AR_VIDEO_AVFOUNDATION_FOCUS_0_3M,       
    AR_VIDEO_AVFOUNDATION_FOCUS_1_0M,       
    AR_VIDEO_AVFOUNDATION_FOCUS_INF         
} AR_VIDEO_AVFOUNDATION_FOCUS_PRESET;
 
typedef enum {
    AR_VIDEO_AVFOUNDATION_CAMERA_POSITION_UNKNOWN = -1,
    AR_VIDEO_AVFOUNDATION_CAMERA_POSITION_UNSPECIFIED = 0,
    AR_VIDEO_AVFOUNDATION_CAMERA_POSITION_REAR,
    AR_VIDEO_AVFOUNDATION_CAMERA_POSITION_FRONT,
    AR_VIDEO_AVFOUNDATION_CAMERA_POSITION_REAR_STEREO_LEFT,
    AR_VIDEO_AVFOUNDATION_CAMERA_POSITION_REAR_STEREO_RIGHT,
    AR_VIDEO_AVFOUNDATION_CAMERA_POSITION_FRONT_STEREO_LEFT,
    AR_VIDEO_AVFOUNDATION_CAMERA_POSITION_FRONT_STEREO_RIGHT
} AR_VIDEO_AVFOUNDATION_CAMERA_POSITION;
 
typedef enum {
    AR_VIDEO_ANDROID_CAMERA_FACE_REAR = 0,
    AR_VIDEO_ANDROID_CAMERA_FACE_FRONT,
} AR_VIDEO_ANDROID_CAMERA_FACE;
 
#define AR_VIDEO_POSITION_UNKNOWN     0x0000 
#define AR_VIDEO_POSITION_FRONT       0x0008 
#define AR_VIDEO_POSITION_BACK        0x0010 
#define AR_VIDEO_POSITION_LEFT        0x0018 
#define AR_VIDEO_POSITION_RIGHT       0x0020 
#define AR_VIDEO_POSITION_TOP         0x0028 
#define AR_VIDEO_POSITION_BOTTOM      0x0030 
#define AR_VIDEO_POSITION_OTHER       0x0038 
 
#define AR_VIDEO_STEREO_MODE_MONO                        0x0000 
#define AR_VIDEO_STEREO_MODE_LEFT                        0x0040 
#define AR_VIDEO_STEREO_MODE_RIGHT                       0x0080 
#define AR_VIDEO_STEREO_MODE_FRAME_SEQUENTIAL            0x00C0 
#define AR_VIDEO_STEREO_MODE_SIDE_BY_SIDE                0x0100 
#define AR_VIDEO_STEREO_MODE_OVER_UNDER                  0x0140 
#define AR_VIDEO_STEREO_MODE_HALF_SIDE_BY_SIDE           0x0180 
#define AR_VIDEO_STEREO_MODE_OVER_UNDER_HALF_HEIGHT      0x01C0 
#define AR_VIDEO_STEREO_MODE_ROW_INTERLACED              0x0200 
#define AR_VIDEO_STEREO_MODE_COLUMN_INTERLACED           0x0240 
#define AR_VIDEO_STEREO_MODE_ROW_AND_COLUMN_INTERLACED   0x0280 
#define AR_VIDEO_STEREO_MODE_ANAGLYPH_RG                 0x02C0 
#define AR_VIDEO_STEREO_MODE_ANAGLYPH_RB                 0x0300 
#define AR_VIDEO_STEREO_MODE_RESERVED0                   0x0340 
#define AR_VIDEO_STEREO_MODE_RESERVED1                   0x0380 
#define AR_VIDEO_STEREO_MODE_RESERVED2                   0x03C0 
 
#define AR_VIDEO_SOURCE_INFO_FLAG_OFFLINE       0x0001      
#define AR_VIDEO_SOURCE_INFO_FLAG_IN_USE        0x0002      
#define AR_VIDEO_SOURCE_INFO_FLAG_OPEN_ASYNC    0x0004      
#define AR_VIDEO_SOURCE_INFO_POSITION_MASK      0x0038      
#define AR_VIDEO_SOURCE_INFO_STEREO_MODE_MASK   0x03C0      
 
typedef struct {
    char *name;             
    char *model;            
    char *UID;              
    uint32_t flags;
    char *open_token;       
} ARVideoSourceInfoT;
 
typedef struct {
    int count;
    ARVideoSourceInfoT *info;
} ARVideoSourceInfoListT;
 
typedef void (*AR_VIDEO_FRAME_READY_CALLBACK)(void *);
 
#ifdef _WIN32
#  ifdef ARVIDEO_STATIC
#    define ARVIDEO_EXTERN
#  else
#    ifdef ARX_EXPORTS
#      define ARVIDEO_EXTERN __declspec(dllexport)
#    else
#      define ARVIDEO_EXTERN __declspec(dllimport)
#    endif
#  endif
#else
#  define ARVIDEO_EXTERN
#endif
 
#include <ARX/ARVideo/videoLuma.h>
 
typedef struct {
    int module;
    void *moduleParam;
    ARVideoLumaInfo *lumaInfo;
} AR2VideoParamT;
 
// AR2VideoBufferT is defined in <ARX/AR/ar.h>
 
ARVIDEO_EXTERN AR_VIDEO_MODULE   arVideoGetDefaultModule(void);
 
ARVIDEO_EXTERN int               arVideoOpen            (const char *config);
 
ARVIDEO_EXTERN int               arVideoOpenAsync       (const char *config, void (*callback)(void *), void *userdata);
 
ARVIDEO_EXTERN int               arVideoClose           (void);
ARVIDEO_EXTERN int               arVideoDispOption      (void);
ARVIDEO_EXTERN AR_VIDEO_MODULE   arVideoGetModule       (void);
ARVIDEO_EXTERN int               arVideoGetId           (ARUint32 *id0, ARUint32 *id1);
ARVIDEO_EXTERN int               arVideoGetSize         (int *x, int *y);
ARVIDEO_EXTERN int               arVideoGetPixelSize    (void);
ARVIDEO_EXTERN AR_PIXEL_FORMAT   arVideoGetPixelFormat  (void);
 
ARVIDEO_EXTERN AR2VideoBufferT  *arVideoGetImage        (void);
 
ARVIDEO_EXTERN int               arVideoCapStart        (void);
 
ARVIDEO_EXTERN int               arVideoCapStartAsync   (AR_VIDEO_FRAME_READY_CALLBACK callback, void *userdata);
 
 
ARVIDEO_EXTERN int               arVideoCapStop         (void);
 
ARVIDEO_EXTERN int               arVideoGetParami       (int paramName, int *value);
 
ARVIDEO_EXTERN int               arVideoSetParami       (int paramName, int  value);
 
ARVIDEO_EXTERN int               arVideoGetParamd       (int paramName, double *value);
 
ARVIDEO_EXTERN int               arVideoSetParamd       (int paramName, double  value);
 
ARVIDEO_EXTERN int               arVideoGetParams       (const int paramName, char **value);
 
ARVIDEO_EXTERN int               arVideoSetParams       (const int paramName, const char  *value);
 
ARVIDEO_EXTERN int               arVideoSaveParam       (char *filename);
ARVIDEO_EXTERN int               arVideoLoadParam       (char *filename);
ARVIDEO_EXTERN int               arVideoSetBufferSize   (const int width, const int height);
ARVIDEO_EXTERN int               arVideoGetBufferSize   (int *width, int *height);
 
ARVIDEO_EXTERN int               arVideoGetCParam       (ARParam *cparam);
ARVIDEO_EXTERN int               arVideoGetCParamAsync  (void (*callback)(const ARParam *, void *), void *userdata);
 
ARVIDEO_EXTERN int               arVideoUtilGetPixelSize(const AR_PIXEL_FORMAT arPixelFormat);
ARVIDEO_EXTERN const char       *arVideoUtilGetPixelFormatName(const AR_PIXEL_FORMAT arPixelFormat);
#if !AR_ENABLE_MINIMIZE_MEMORY_FOOTPRINT
ARVIDEO_EXTERN int               arVideoSaveImageJPEG(int w, int h, AR_PIXEL_FORMAT pixFormat, ARUint8 *pixels, const char *filename, const int quality /* 0 to 100 */, const int flipV);
#endif // !AR_ENABLE_MINIMIZE_MEMORY_FOOTPRINT
 
typedef enum {
    AR_VIDEO_ASPECT_RATIO_1_1,       
    AR_VIDEO_ASPECT_RATIO_11_9,      
    AR_VIDEO_ASPECT_RATIO_5_4,       
    AR_VIDEO_ASPECT_RATIO_4_3,       
    AR_VIDEO_ASPECT_RATIO_3_2,       
    AR_VIDEO_ASPECT_RATIO_14_9,      
    AR_VIDEO_ASPECT_RATIO_8_5,       
 
    AR_VIDEO_ASPECT_RATIO_5_3,       
    AR_VIDEO_ASPECT_RATIO_16_9,      
    AR_VIDEO_ASPECT_RATIO_9_5,       
    AR_VIDEO_ASPECT_RATIO_17_9,      
    AR_VIDEO_ASPECT_RATIO_21_9,      
    AR_VIDEO_ASPECT_RATIO_UNIQUE,    
    AR_VIDEO_ASPECT_RATIO_INVALID    
} AR_VIDEO_ASPECT_RATIO;
 
AR_VIDEO_ASPECT_RATIO arVideoUtilFindAspectRatio(int w, int h);
 
char *arVideoUtilFindAspectRatioName(int w, int h);
 
#define  arVideoGetVersion() arVideoGetParami(AR_VIDEO_GET_VERSION, NULL)
 
ARVIDEO_EXTERN ARVideoSourceInfoListT *ar2VideoCreateSourceInfoList(const char *config);
 
ARVIDEO_EXTERN void              ar2VideoDeleteSourceInfoList(ARVideoSourceInfoListT **p);
 
ARVIDEO_EXTERN AR2VideoParamT   *ar2VideoOpen            (const char *config);
 
ARVIDEO_EXTERN AR2VideoParamT   *ar2VideoOpenAsync       (const char *config, void (*callback)(void *), void *userdata);
 
ARVIDEO_EXTERN int               ar2VideoClose           (AR2VideoParamT *vid);
ARVIDEO_EXTERN int               ar2VideoDispOption      (AR2VideoParamT *vid);
ARVIDEO_EXTERN AR_VIDEO_MODULE   ar2VideoGetModule       (AR2VideoParamT *vid);
ARVIDEO_EXTERN int               ar2VideoGetId           (AR2VideoParamT *vid, ARUint32 *id0, ARUint32 *id1);
ARVIDEO_EXTERN int               ar2VideoGetSize         (AR2VideoParamT *vid, int *x,int *y);
ARVIDEO_EXTERN int               ar2VideoGetPixelSize    (AR2VideoParamT *vid);
ARVIDEO_EXTERN AR_PIXEL_FORMAT   ar2VideoGetPixelFormat  (AR2VideoParamT *vid);
ARVIDEO_EXTERN AR2VideoBufferT  *ar2VideoGetImage        (AR2VideoParamT *vid);
ARVIDEO_EXTERN int               ar2VideoCapStart        (AR2VideoParamT *vid);
ARVIDEO_EXTERN int               ar2VideoCapStartAsync   (AR2VideoParamT *vid, AR_VIDEO_FRAME_READY_CALLBACK callback, void *userdata);
ARVIDEO_EXTERN int               ar2VideoCapStop         (AR2VideoParamT *vid);
ARVIDEO_EXTERN int               ar2VideoGetParami       (AR2VideoParamT *vid, int paramName, int *value);
ARVIDEO_EXTERN int               ar2VideoSetParami       (AR2VideoParamT *vid, int paramName, int  value);
ARVIDEO_EXTERN int               ar2VideoGetParamd       (AR2VideoParamT *vid, int paramName, double *value);
ARVIDEO_EXTERN int               ar2VideoSetParamd       (AR2VideoParamT *vid, int paramName, double  value);
ARVIDEO_EXTERN int               ar2VideoGetParams       (AR2VideoParamT *vid, const int paramName, char **value);
ARVIDEO_EXTERN int               ar2VideoSetParams       (AR2VideoParamT *vid, const int paramName, const char  *value);
ARVIDEO_EXTERN int               ar2VideoSaveParam       (AR2VideoParamT *vid, char *filename);
ARVIDEO_EXTERN int               ar2VideoLoadParam       (AR2VideoParamT *vid, char *filename);
ARVIDEO_EXTERN int               ar2VideoSetBufferSize   (AR2VideoParamT *vid, const int width, const int height);
ARVIDEO_EXTERN int               ar2VideoGetBufferSize   (AR2VideoParamT *vid, int *width, int *height);
ARVIDEO_EXTERN int               ar2VideoGetCParam       (AR2VideoParamT *vid, ARParam *cparam);
ARVIDEO_EXTERN int               ar2VideoGetCParamAsync  (AR2VideoParamT *vid, void (*callback)(const ARParam *, void *), void *userdata);
 
 
#if ARX_TARGET_PLATFORM_ANDROID
// JNI interface.
jint ar2VideoPushInit(AR2VideoParamT *vid, JNIEnv *env, jobject obj, jint width, jint height, const char *pixelFormat, jint camera_index, jint camera_face);
jint ar2VideoPush1(AR2VideoParamT *vid, JNIEnv *env, jobject obj, jbyteArray buf, jint bufSize);
jint ar2VideoPush2(AR2VideoParamT *vid, JNIEnv *env, jobject obj,
                   jobject buf0, jint buf0PixelStride, jint buf0RowStride,
                   jobject buf1, jint buf1PixelStride, jint buf1RowStride,
                   jobject buf2, jint buf2PixelStride, jint buf2RowStride,
                   jobject buf3, jint buf3PixelStride, jint buf3RowStride);
jint ar2VideoPushFinal(AR2VideoParamT *vid, JNIEnv *env, jobject obj);
#endif // ARX_TARGET_PLATFORM_ANDROID
 
#ifdef  __cplusplus
}
#endif
#endif // !AR_VIDEO_H