A collection of static functions that refer to the entire package (like version getters). More...

#include <Global.h>

Inheritance diagram for com::avpkit::core::Global:

Collaboration diagram for com::avpkit::core::Global:

Static Public Member Functions
static int64_t	getVersion ()
	Returns a 64 bit version number for this library. More...

static int32_t	getVersionMajor ()
	Get the major version number of this library. More...

static int32_t	getVersionMinor ()
	Get the minor version number of this library. More...

static int32_t	getVersionRevision ()
	Get the revision number of this library. More...

static const char *	getVersionStr ()
	Get a string representation of the version of this library. More...

static int	getAVFormatVersion ()
	Get the version of the FFMPEG libavformat library we are compiled against. More...

static const char *	getAVFormatVersionStr ()
	Get the version of the FFMPEG libavformat library we are compiled against. More...

static int	getAVCodecVersion ()
	Get the version of the FFMPEG libavcodec library we are compiled against. More...

static const char *	getAVCodecVersionStr ()
	Get the version of the FFMPEG libavcodec library we are compiled against. More...

static void	lock ()
	Performs a global-level lock of the AVPKIT library. More...

static void	unlock ()
	Unlock the global lock. More...

static int	avioInterruptCB (void *)
	Internal Only. More...

static void	deinit ()
	Internal Only. More...

static void	init ()
	Internal Only. More...

static void	setFFmpegLoggingLevel (int32_t level)
	Internal Only. More...

Static Public Attributes
static const int64_t	NO_PTS =0x8000000000000000LL
	A value that means no time stamp is set for a given object. More...

static const int64_t	DEFAULT_PTS_PER_SECOND =1000000
	The default time units per second that we use for decoded IAudioSamples and IVideoPicture objects. More...

Additional Inherited Members
Public Member Functions inherited from com::avpkit::ferry::RefCounted
virtual int32_t	acquire ()
	Internal Only. More...

virtual int32_t	release ()
	Internal Only. More...

virtual RefCounted *	copyReference ()
	Create a new Java object that refers to the same native object. More...

virtual int32_t	getCurrentRefCount ()
	Return the current reference count on this object. More...

void	setJavaAllocator (void *allocator)
	This method is public but not part of the standard API. More...

void *	getJavaAllocator ()
	This method is public but not part of the standard API. More...

Protected Member Functions inherited from com::avpkit::ferry::RefCounted
virtual void	destroy ()
	This method is called by RefCounted objects when their Ref Count reaches zero and they are about to be destroyed.

Protected Attributes inherited from com::avpkit::ferry::RefCounted
AtomicInteger *	mRefCount
	This is the internal reference count, represented as an AtomicInteger to make sure it is thread safe.

void *	mAllocator
	Not part of public API.

Detailed Description

A collection of static functions that refer to the entire package (like version getters).

Definition at line 42 of file Global.h.

Member Function Documentation

◆ avioInterruptCB()

int com::avpkit::core::Global::avioInterruptCB ( void * )

static

Internal Only.

Do not call. Checks to determine if there is

Definition at line 115 of file Global.cpp.

   {
     JNIHelper* helper = JNIHelper::getHelper();
     int retval = 0;
     if (helper) {
       retval = helper->isInterrupted();
     }
     return retval;
   }

◆ deinit()

void com::avpkit::core::Global::deinit ( )

static

Internal Only.

Call to relese globals.

Definition at line 177 of file Global.cpp.

   {
     avformat_network_deinit();
   }

◆ getAVCodecVersion()

int com::avpkit::core::Global::getAVCodecVersion ( )

static

Get the version of the FFMPEG libavcodec library we are compiled against.

Returns: the version.

Definition at line 265 of file Global.cpp.

   {
     Global::init();
     return LIBAVCODEC_VERSION_INT;
   }

References init().

◆ getAVCodecVersionStr()

const char * com::avpkit::core::Global::getAVCodecVersionStr ( )

static

Get the version of the FFMPEG libavcodec library we are compiled against.

Returns: the version.

Definition at line 271 of file Global.cpp.

   {
     Global::init();
     return AV_STRINGIFY(LIBAVCODEC_VERSION);
   }

References init().

◆ getAVFormatVersion()

int32_t com::avpkit::core::Global::getAVFormatVersion ( )

static

Get the version of the FFMPEG libavformat library we are compiled against.

Returns: the version.

Definition at line 253 of file Global.cpp.

   {
     Global::init();
     return LIBAVFORMAT_VERSION_INT;
   }

References init().

◆ getAVFormatVersionStr()

const char * com::avpkit::core::Global::getAVFormatVersionStr ( )

static

Get the version of the FFMPEG libavformat library we are compiled against.

Returns: the version.

Definition at line 259 of file Global.cpp.

   {
     Global::init();
     return AV_STRINGIFY(LIBAVFORMAT_VERSION);
   }

References init().

◆ getVersion()

int64_t com::avpkit::core::Global::getVersion ( )

static

Returns a 64 bit version number for this library.

Returns: a 64-bit integer version number for this library. The top 16 bits is the getVersionMajor() value. The next 16-bits are the getVersionMinor() value, and the last 32-bits are the getVersionRevision() value.

Definition at line 223 of file Global.cpp.

   {
     return ((int64_t)getVersionMajor())<<48 | ((int64_t)getVersionMinor())<<32 | (int64_t)getVersionRevision();
   }

◆ getVersionMajor()

int32_t com::avpkit::core::Global::getVersionMajor ( )

static

Get the major version number of this library.

Returns: the major version number of this library or 0 if unknown.

Definition at line 228 of file Global.cpp.

   {
     Global::init();
     return VS_LIB_MAJOR_VERSION;
   }

References init().

◆ getVersionMinor()

int32_t com::avpkit::core::Global::getVersionMinor ( )

static

Get the minor version number of this library.

Returns: the minor version number of this library or 0 if unknown.

Definition at line 234 of file Global.cpp.

   {
     Global::init();
     return VS_LIB_MINOR_VERSION;
   }

References init().

◆ getVersionRevision()

int32_t com::avpkit::core::Global::getVersionRevision ( )

static

Get the revision number of this library.

Returns: the revision number of this library, or 0 if unknown.

Definition at line 240 of file Global.cpp.

   {
     Global::init();
     return VS_REVISION;
   }

References init().

◆ getVersionStr()

const char * com::avpkit::core::Global::getVersionStr ( )

static

Get a string representation of the version of this library.

Returns: the version of this library in string form.

Definition at line 247 of file Global.cpp.

   {
     Global::init();
     return PACKAGE_VERSION "."  VS_STRINGIFY(VS_REVISION);
   }

References init().

◆ init()

void com::avpkit::core::Global::init ( )

static

Internal Only.

Do not call. Methods using the C++ interface that will not necessarily create other Global object should call this. In general, unless you're extending core directly yourself, ordinary users of this library don't need to call this.

It's main purpose is to ensure any FFmpeg required environment initialization functions are called, and any AVPKit required environmental contexts are set up.

Definition at line 157 of file Global.cpp.

   {
     if (!sGlobal)
     {
       av_lockmgr_register(core_lockmgr_cb);
       av_log_set_callback(core_log_callback);
       av_log_set_level(AV_LOG_ERROR); // Only log errors by default
       av_register_all();
       avformat_network_init();
       // and set up filter support
       avfilter_register_all();
  
       // and set up the device library for webcam support
       avdevice_register_all();
  
       // turn down logging
       sGlobal = new Global();
     }
   }

◆ lock()

void com::avpkit::core::Global::lock ( )

static

Performs a global-level lock of the AVPKIT library.

While this lock() is held, every other method that calls lock() in the same DLL/SO will block.

Use this sparingly. FFMPEG's libraries have few real global objects, but when they do exist, you must lock.

Lastly, if you lock, make damn sure you call unlock()

Definition at line 207 of file Global.cpp.

   {
     Global::init();
     if (sGlobal && sGlobal->mLock)
       sGlobal->mLock->lock();
   }

References init().

◆ setFFmpegLoggingLevel()

void com::avpkit::core::Global::setFFmpegLoggingLevel ( int32_t level )

static

Internal Only.

This method can be used to turn up or down FFmpeg's logging level.

Parameters

level An integer value for level. Lower numbers mean less logging. A negative number tells FFmpeg to shut up.

Definition at line 278 of file Global.cpp.

   {
     Global::init();
     if (level < AV_LOG_PANIC)
       av_log_set_level(AV_LOG_QUIET);
     else if (level < AV_LOG_FATAL)
       av_log_set_level(AV_LOG_PANIC);
     else if (level < AV_LOG_ERROR)
       av_log_set_level(AV_LOG_FATAL);
     else if (level < AV_LOG_WARNING)
       av_log_set_level(AV_LOG_ERROR);
     else if (level < AV_LOG_INFO)
       av_log_set_level(AV_LOG_WARNING);
     else if (level < AV_LOG_VERBOSE)
       av_log_set_level(AV_LOG_INFO);
     else if (level < AV_LOG_DEBUG)
       av_log_set_level(AV_LOG_VERBOSE);
     else
       av_log_set_level(AV_LOG_DEBUG);
 //    fprintf(stderr, "FFmpeg logging level = %d\n", av_log_get_level());
   }

References init().

◆ unlock()

void com::avpkit::core::Global::unlock ( )

static

Unlock the global lock.

See also: lock()

Definition at line 215 of file Global.cpp.

   {
     Global::init();
     if (sGlobal && sGlobal->mLock)
       sGlobal->mLock->unlock();
   }

References init().

Member Data Documentation

◆ DEFAULT_PTS_PER_SECOND

const int64_t com::avpkit::core::Global::DEFAULT_PTS_PER_SECOND =1000000

static

The default time units per second that we use for decoded IAudioSamples and IVideoPicture objects.

This means that 1 tick of a time stamp is 1 Microsecond.

Definition at line 57 of file Global.h.

Referenced by com::avpkit::core::IAudioSamples::defaultPtsToSamples(), and com::avpkit::core::IAudioSamples::samplesToDefaultPts().

◆ NO_PTS

const int64_t com::avpkit::core::Global::NO_PTS =0x8000000000000000LL

static

A value that means no time stamp is set for a given object.

if the IMediaData#getTimeStamp() method of an object returns this value it means the time stamp wasn't set.

Definition at line 50 of file Global.h.

Referenced by com::avpkit::core::IAudioSamples::defaultPtsToSamples(), com::avpkit::core::Stream::getCurrentDts(), com::avpkit::core::Stream::getDuration(), com::avpkit::core::AudioSamples::getNextPts(), com::avpkit::core::Stream::getStartTime(), com::avpkit::core::AudioResampler::resample(), com::avpkit::core::IAudioSamples::samplesToDefaultPts(), com::avpkit::core::Stream::stampOutputPacket(), and com::avpkit::core::MediaDataWrapper::wrap().

The documentation for this class was generated from the following files:

csrc/com/avpkit/core/Global.h
csrc/com/avpkit/core/Global.cpp

Static Public Member Functions

Static Public Attributes

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ avioInterruptCB()

◆ deinit()

◆ getAVCodecVersion()

◆ getAVCodecVersionStr()

◆ getAVFormatVersion()

◆ getAVFormatVersionStr()

◆ getVersion()

◆ getVersionMajor()

◆ getVersionMinor()

◆ getVersionRevision()

◆ getVersionStr()

◆ init()

◆ lock()

◆ setFFmpegLoggingLevel()

◆ unlock()

Member Data Documentation

◆ DEFAULT_PTS_PER_SECOND

◆ NO_PTS