gstreamer/sys/applemedia/vtapi.h
Ole André Vadla Ravnås 0e4e351b83 applemedia: New plugin for Apple multimedia APIs
Provides the following elements:

qtkitvideosrc: OS X video source relying on the QTKit API. Comes with
hard-coded caps as the API does not provide any way of querying for
formats supported by the hardware. Hasn't been tested a lot, but seems
to work.

miovideosrc: OS X video source which uses the undocumented/private
CoreMediaIOServices API, which is also the one used by iChat.
Present on latest version of Leopard and all versions of Snow Leopard.
Has been tested extensively with built-in cameras and TANDBERG's
PrecisionHD USB camera.

vtenc, vtdec: Generic codec wrappers which make use of the undocumented/
private VideoToolbox API on OS X and iOS. List of codecs are currently
hard-coded to H.264 for vtenc, and H.264 + JPEG for vtdec. Can easily be
expanded by adding new entries to the lists, but haven't yet had time to
do that. Should probably also implement probing as available codecs depend
on the OS and its version, and there doesn't seem to be any way to
enumerate the available codecs.

vth264decbin, vth264encbin: Wrapper bins to make it easier to use
vtdec_h264/vtenc_h264 in live scenarios.

iphonecamerasrc: iPhone camera source relying on the undocumented/private
Celestial API. Tested on iOS 3.1 running on an iPhone 3GS. Stops working
after a few minutes, presumably because of a resource leak. Needs some
love.

Note that the iOS parts haven't yet been ported to iOS 4.x.
2010-10-28 15:08:08 +02:00

146 lines
5.1 KiB
C

/*
* Copyright (C) 2010 Ole André Vadla Ravnås <oravnas@cisco.com>
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Library General Public
* License as published by the Free Software Foundation; either
* version 2 of the License, or (at your option) any later version.
*
* This library 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
* Library General Public License for more details.
*
* You should have received a copy of the GNU Library General Public
* License along with this library; if not, write to the
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
* Boston, MA 02111-1307, USA.
*/
#ifndef __GST_VT_API_H__
#define __GST_VT_API_H__
#include "cmapi.h"
G_BEGIN_DECLS
typedef struct _GstVTApi GstVTApi;
typedef struct _GstVTApiClass GstVTApiClass;
typedef enum _VTStatus VTStatus;
typedef guint32 VTFormatId;
typedef struct _VTCompressionSession VTCompressionSession;
typedef struct _VTDecompressionSession VTDecompressionSession;
typedef struct _VTCompressionOutputCallback VTCompressionOutputCallback;
typedef struct _VTDecompressionOutputCallback VTDecompressionOutputCallback;
typedef VTStatus (* VTCompressionOutputCallbackFunc) (void * data, int a2,
int a3, int a4, FigSampleBuffer * sbuf, int a6, int a7);
typedef void (* VTDecompressionOutputCallbackFunc) (void * data, gsize unk1,
VTStatus result, gsize unk2, CVBufferRef cvbuf);
enum _VTStatus
{
kVTSuccess = 0
};
enum _VTFormat
{
kVTFormatH264 = 'avc1',
kVTFormatJPEG = 'jpeg'
};
struct _VTCompressionOutputCallback
{
VTCompressionOutputCallbackFunc func;
void * data;
};
struct _VTDecompressionOutputCallback
{
VTDecompressionOutputCallbackFunc func;
void * data;
};
struct _GstVTApi
{
GstDynApi parent;
VTStatus (* VTCompressionSessionCompleteFrames)
(VTCompressionSession * session, FigTime completeUntilDisplayTimestamp);
VTStatus (* VTCompressionSessionCopyProperty)
(VTCompressionSession * session, CFTypeRef key, void* unk,
CFTypeRef * value);
VTStatus (* VTCompressionSessionCopySupportedPropertyDictionary)
(VTCompressionSession * session, CFDictionaryRef * dict);
VTStatus (* VTCompressionSessionCreate)
(CFAllocatorRef allocator, gint width, gint height, VTFormatId formatId,
gsize unk1, CFDictionaryRef sourcePixelBufferAttributes, gsize unk2,
VTCompressionOutputCallback outputCallback,
VTCompressionSession ** session);
VTStatus (* VTCompressionSessionEncodeFrame)
(VTCompressionSession * session, CVPixelBufferRef pixelBuffer,
FigTime displayTimestamp, FigTime displayDuration,
CFDictionaryRef frameOptions, void * sourceTrackingCallback,
void * sourceFrameRefCon);
void (* VTCompressionSessionInvalidate)
(VTCompressionSession * session);
void (* VTCompressionSessionRelease)
(VTCompressionSession * session);
VTCompressionSession * (* VTCompressionSessionRetain)
(VTCompressionSession * session);
VTStatus (* VTCompressionSessionSetProperty)
(VTCompressionSession * session, CFStringRef propName,
CFTypeRef propValue);
VTStatus (* VTDecompressionSessionCreate)
(CFAllocatorRef allocator, FigFormatDescription * videoFormatDescription,
CFTypeRef sessionOptions, CFDictionaryRef destinationPixelBufferAttributes,
VTDecompressionOutputCallback * outputCallback,
VTDecompressionSession ** session);
VTStatus (* VTDecompressionSessionDecodeFrame)
(VTDecompressionSession * session, FigSampleBuffer * sbuf, gsize unk1,
gsize unk2, gsize unk3);
void (* VTDecompressionSessionInvalidate)
(VTDecompressionSession * session);
void (* VTDecompressionSessionRelease)
(VTDecompressionSession * session);
VTDecompressionSession * (* VTDecompressionSessionRetain)
(VTDecompressionSession * session);
VTStatus (* VTDecompressionSessionWaitForAsynchronousFrames)
(VTDecompressionSession * session);
CFStringRef * kVTCompressionPropertyKey_AllowTemporalCompression;
CFStringRef * kVTCompressionPropertyKey_AverageDataRate;
CFStringRef * kVTCompressionPropertyKey_ExpectedFrameRate;
CFStringRef * kVTCompressionPropertyKey_ExpectedDuration;
CFStringRef * kVTCompressionPropertyKey_MaxKeyFrameInterval;
CFStringRef * kVTCompressionPropertyKey_MaxKeyFrameIntervalDuration;
CFStringRef * kVTCompressionPropertyKey_ProfileLevel;
CFStringRef * kVTCompressionPropertyKey_Usage;
CFStringRef * kVTEncodeFrameOptionKey_ForceKeyFrame;
CFStringRef * kVTProfileLevel_H264_Baseline_1_3;
CFStringRef * kVTProfileLevel_H264_Baseline_3_0;
CFStringRef * kVTProfileLevel_H264_Extended_5_0;
CFStringRef * kVTProfileLevel_H264_High_5_0;
CFStringRef * kVTProfileLevel_H264_Main_3_0;
CFStringRef * kVTProfileLevel_H264_Main_3_1;
CFStringRef * kVTProfileLevel_H264_Main_4_0;
CFStringRef * kVTProfileLevel_H264_Main_4_1;
CFStringRef * kVTProfileLevel_H264_Main_5_0;
};
struct _GstVTApiClass
{
GstDynApiClass parent_class;
};
GType gst_vt_api_get_type (void);
GstVTApi * gst_vt_api_obtain (GError ** error);
G_END_DECLS
#endif