Frame Class Reference

#include <frame.h>

List of all members.

Public Member Functions
	Frame ()
	constructor
	~Frame ()
Frame &	operator= (const Frame &)
bool	GetSSYBPack (int packNum, Pack &pack) const
	gets a subcode data packet
bool	GetVAUXPack (int packNum, Pack &pack) const
	gets a video auxiliary data packet
bool	GetAAUXPack (int packNum, Pack &pack) const
	gets an audio auxiliary data packet
bool	GetTimeCode (TimeCode &timeCode) const
	gets the timecode information of this frame
bool	GetRecordingDate (struct tm &recDate) const
	gets the date and time of recording of this frame
std::string	GetRecordingDate (void) const
bool	GetAudioInfo (AudioInfo &info) const
	gets the audio properties of this frame
bool	GetVideoInfo (VideoInfo &info) const
int	GetFrameSize (void) const
	gets the size of the frame
float	GetFrameRate (void) const
	gets the frame rate of the video
bool	IsPAL (void) const
	checks whether the frame is in PAL or NTSC format
bool	IsNewRecording (void) const
	checks whether this frame is the first in a new recording
bool	IsNormalSpeed (void) const
	checks whether this frame is playing at normal speed
bool	IsComplete (void) const
	check whether we have received as many bytes as expected for this frame
int	ExtractAudio (void *sound) const
	retrieves the audio data from the frame
Public Attributes
unsigned char *	data
int	bytesInFrame
	the number of bytes written to the frame
int16_t *	audio_buffers [4]
Static Private Attributes
static bool	maps_initialized = false
	flag for initializing the lookup maps once at startup
static int	palmap_ch1 [2000]
	lookup tables for collecting the shuffled audio data
static int	palmap_ch2 [2000]
static int	palmap_2ch1 [2000]
static int	palmap_2ch2 [2000]
static int	ntscmap_ch1 [2000]
static int	ntscmap_ch2 [2000]
static int	ntscmap_2ch1 [2000]
static int	ntscmap_2ch2 [2000]
static short	compmap [4096]

---

Constructor & Destructor Documentation

Frame::Frame (   )

constructor All Frame objects share a set of lookup maps, which are initalized once (we are using a variant of the Singleton pattern). Definition at line 94 of file frame.cc. References audio_buffers, avcodec_mutex, compmap, data, DV_AUDIO_MAX_SAMPLES, Preferences::getInstance(), maps_initialized, ntscmap_2ch1, ntscmap_2ch2, ntscmap_ch1, ntscmap_ch2, palmap_2ch1, palmap_2ch2, palmap_ch1, and palmap_ch2. : bytesInFrame( 0 ) { #if defined(HAVE_LIBAVCODEC) pthread_mutex_lock( &avcodec_mutex ); av_register_all(); libavcodec = avcodec_alloc_context(); libavcodec->thread_count = 2; avcodec_open( libavcodec, &dvvideo_decoder ); pthread_mutex_unlock( &avcodec_mutex ); data = ( unsigned char* ) av_mallocz( 144000 ); #if defined(HAVE_SWSCALE) imgConvertRgbCtx = NULL; imgConvertYuvCtx = NULL; #endif #else data = ( unsigned char* ) calloc( 1, 144000 ); #endif #ifdef HAVE_LIBDV decoder = dv_decoder_new( FALSE, Preferences::getInstance().dvDecoderClampLuma, Preferences::getInstance().dvDecoderClampChroma ); decoder->audio->arg_audio_emphasis = 2; this->SetPreferredQuality( ); dv_set_audio_correction ( decoder, DV_AUDIO_CORRECT_AVERAGE ); dv_set_error_log( decoder, NULL ); encoder = NULL; #else if ( maps_initialized == false ) { for ( int n = 0; n < 1944; ++n ) { int sequence1 = ( ( n / 3 ) + 2 * ( n % 3 ) ) % 6; int sequence2 = sequence1 + 6; int block = 3 * ( n % 3 ) + ( ( n % 54 ) / 18 ); block = 6 + block * 16; { register int byte = 8 + 2 * ( n / 54 ); palmap_ch1[ n ] = sequence1 * 150 * 80 + block * 80 + byte; palmap_ch2[ n ] = sequence2 * 150 * 80 + block * 80 + byte; byte += ( n / 54 ); palmap_2ch1[ n ] = sequence1 * 150 * 80 + block * 80 + byte; palmap_2ch2[ n ] = sequence2 * 150 * 80 + block * 80 + byte; } } for ( int n = 0; n < 1620; ++n ) { int sequence1 = ( ( n / 3 ) + 2 * ( n % 3 ) ) % 5; int sequence2 = sequence1 + 5; int block = 3 * ( n % 3 ) + ( ( n % 45 ) / 15 ); block = 6 + block * 16; { register int byte = 8 + 2 * ( n / 45 ); ntscmap_ch1[ n ] = sequence1 * 150 * 80 + block * 80 + byte; ntscmap_ch2[ n ] = sequence2 * 150 * 80 + block * 80 + byte; byte += ( n / 45 ); ntscmap_2ch1[ n ] = sequence1 * 150 * 80 + block * 80 + byte; ntscmap_2ch2[ n ] = sequence2 * 150 * 80 + block * 80 + byte; } } for ( int y = 0x700; y <= 0x7ff; ++y ) compmap[ y ] = ( y - 0x600 ) << 6; for ( int y = 0x600; y <= 0x6ff; ++y ) compmap[ y ] = ( y - 0x500 ) << 5; for ( int y = 0x500; y <= 0x5ff; ++y ) compmap[ y ] = ( y - 0x400 ) << 4; for ( int y = 0x400; y <= 0x4ff; ++y ) compmap[ y ] = ( y - 0x300 ) << 3; for ( int y = 0x300; y <= 0x3ff; ++y ) compmap[ y ] = ( y - 0x200 ) << 2; for ( int y = 0x200; y <= 0x2ff; ++y ) compmap[ y ] = ( y - 0x100 ) << 1; for ( int y = 0x000; y <= 0x1ff; ++y ) compmap[ y ] = y; for ( int y = 0x800; y <= 0xfff; ++y ) compmap[ y ] = -1 - compmap[ 0xfff - y ]; maps_initialized = true; } #endif for ( int n = 0; n < 4; n++ ) audio_buffers[ n ] = ( int16_t * ) malloc( 2 * DV_AUDIO_MAX_SAMPLES * sizeof( int16_t ) ); }

Frame::~Frame (   )

Definition at line 182 of file frame.cc. References audio_buffers, avcodec_mutex, and data. { #if defined(HAVE_LIBAVCODEC) pthread_mutex_lock( &avcodec_mutex ); avcodec_close( libavcodec ); av_free( libavcodec ); /* if ( avformatEncoder ) { av_write_trailer( avformatEncoder ); av_destruct_packet( &avpacketEncoder ); avcodec_close( avformatEncoder->streams[0]->codec ); av_free( avformatEncoder->streams[0]->codec ); av_free( avformatEncoder->streams[0] ); av_free( avformatEncoder ); }*/ pthread_mutex_unlock( &avcodec_mutex ); av_free( data ); #if defined(HAVE_SWSCALE) if ( imgConvertRgbCtx ) sws_freeContext( imgConvertRgbCtx ); if ( imgConvertYuvCtx ) sws_freeContext( imgConvertYuvCtx ); #endif #else free( data ); #endif #ifdef HAVE_LIBDV dv_decoder_free( decoder ); if ( encoder ) dv_encoder_free( encoder ); #endif for ( int n = 0; n < 4; n++ ) free( audio_buffers[ n ] ); }

---

Member Function Documentation

int Frame::ExtractAudio (  void *  sound  )  const

retrieves the audio data from the frame The DV frame contains audio data mixed in the video data blocks, which can be retrieved easily using this function. The audio data consists of 16 bit, two channel audio samples (a 16 bit word for channel 1, followed by a 16 bit word for channel 2 etc.) Parameters: sound  a pointer to a buffer that holds the audio data Returns: the number of bytes put into the buffer, or 0 if no audio data could be retrieved Definition at line 785 of file frame.cc. References audio_buffers, AudioInfo::channels, compmap, data, AudioInfo::frequency, GetAudioInfo(), info, IsPAL(), ntscmap_2ch1, ntscmap_ch1, ntscmap_ch2, palmap_2ch1, palmap_ch1, palmap_ch2, and AudioInfo::samples. Referenced by PageMagick::AudioThread(), FXSelectedFrames::GetAudio(), AsyncAudioResample< input_t, output_t >::ReadAudio(), AudioResample< int16_ne_t, int16_ne_t >::Resample(), and AVI2File::WriteFrame(). { AudioInfo info; #ifdef HAVE_LIBDV if ( GetAudioInfo( info ) == true ) { int n, i; int16_t* s = ( int16_t * ) sound; if ( dv_decode_full_audio( decoder, data, ( int16_t ** ) audio_buffers ) == TRUE ) { for ( n = 0; n < info.samples; ++n ) for ( i = 0; i < info.channels; i++ ) *s++ = audio_buffers[ i ][ n ]; } else { info.samples = 0; } } else info.samples = 0; #else /* Collect the audio samples */ char* s = ( char * ) sound; GetAudioInfo( info ); switch ( info.frequency ) { case 32000: /* This is 4 channel audio */ if ( IsPAL() ) { short * p = ( short* ) sound; for ( int n = 0; n < info.samples; ++n ) { register int r = ( ( unsigned char* ) data ) [ palmap_2ch1[ n ] + 1 ]; // LSB *p++ = compmap[ ( ( ( unsigned char* ) data ) [ palmap_2ch1[ n ] ] << 4 ) + ( r >> 4 ) ]; // MSB *p++ = compmap[ ( ( ( unsigned char* ) data ) [ palmap_2ch1[ n ] + 1 ] << 4 ) + ( r & 0x0f ) ]; } } else { short* p = ( short* ) sound; for ( int n = 0; n < info.samples; ++n ) { register int r = ( ( unsigned char* ) data ) [ ntscmap_2ch1[ n ] + 1 ]; // LSB *p++ = compmap[ ( ( ( unsigned char* ) data ) [ ntscmap_2ch1[ n ] ] << 4 ) + ( r >> 4 ) ]; // MSB *p++ = compmap[ ( ( ( unsigned char* ) data ) [ ntscmap_2ch1[ n ] + 1 ] << 4 ) + ( r & 0x0f ) ]; } } break; case 44100: case 48000: /* this can be optimized significantly */ if ( IsPAL() ) { for ( int n = 0; n < info.samples; ++n ) { *s++ = ( ( char* ) data ) [ palmap_ch1[ n ] + 1 ]; /* LSB */ *s++ = ( ( char* ) data ) [ palmap_ch1[ n ] ]; /* MSB */ *s++ = ( ( char* ) data ) [ palmap_ch2[ n ] + 1 ]; /* LSB */ *s++ = ( ( char* ) data ) [ palmap_ch2[ n ] ]; /* MSB */ } } else { for ( int n = 0; n < info.samples; ++n ) { *s++ = ( ( char* ) data ) [ ntscmap_ch1[ n ] + 1 ]; /* LSB */ *s++ = ( ( char* ) data ) [ ntscmap_ch1[ n ] ]; /* MSB */ *s++ = ( ( char* ) data ) [ ntscmap_ch2[ n ] + 1 ]; /* LSB */ *s++ = ( ( char* ) data ) [ ntscmap_ch2[ n ] ]; /* MSB */ } } break; /* we can't handle any other format in the moment */ default: info.samples = 0; } #endif return info.samples * info.channels * 2; }

bool Frame::GetAAUXPack (  int  packNum, Pack &  pack )  const

gets an audio auxiliary data packet Every DIF block in the audio section contains 5 bytes audio auxiliary data and 72 bytes of audio data. The function searches through all DIF blocks although AAUX packets are only allowed in certain defined DIF blocks. Parameters: packNum  the AAUX package id to return pack  a reference to the variable where the result is stored Returns: true for success, false if no pack could be found Definition at line 371 of file frame.cc. References data, Pack::data, and IsPAL(). Referenced by GetAudioInfo(), and IsNewRecording(). { #ifdef HAVE_LIBDV bool done = false; switch ( packNum ) { case 0x50: memcpy( pack.data, &decoder->audio->aaux_as, 5 ); done = true; break; case 0x51: memcpy( pack.data, &decoder->audio->aaux_asc, 5 ); done = true; break; case 0x52: memcpy( pack.data, &decoder->audio->aaux_as1, 5 ); done = true; break; case 0x53: memcpy( pack.data, &decoder->audio->aaux_asc1, 5 ); done = true; break; } if ( done ) return true; #endif /* number of DIF sequences is different for PAL and NTSC */ int seqCount = IsPAL() ? 12 : 10; /* process all DIF sequences */ for ( int i = 0; i < seqCount; ++i ) { /* there are nine audio DIF blocks */ for ( int j = 0; j < 9; ++j ) { /* calculate address: 150 DIF blocks per sequence, 80 bytes per DIF block, audio blocks start at every 16th beginning with block 6, block has 3 bytes header, followed by one packet. */ const unsigned char *s = &data[ i * 150 * 80 + 6 * 80 + j * 16 * 80 + 3 ]; if ( s[ 0 ] == packNum ) { // printf("aaux %d: %2.2x %2.2x %2.2x %2.2x %2.2x\n", // j, s[0], s[1], s[2], s[3], s[4]); pack.data[ 0 ] = s[ 0 ]; pack.data[ 1 ] = s[ 1 ]; pack.data[ 2 ] = s[ 2 ]; pack.data[ 3 ] = s[ 3 ]; pack.data[ 4 ] = s[ 4 ]; return true; } } } return false; }

bool Frame::GetAudioInfo (  AudioInfo &  info  )  const

gets the audio properties of this frame get the sampling frequency and the number of samples in this particular DV frame (which can vary) Parameters: info  the AudioInfo record Returns: true, if audio properties could be determined Definition at line 583 of file frame.cc. References Pack::data, GetAAUXPack(), and IsPAL(). Referenced by ExportPipe::doExport(), ExportMJPEG::doExport(), ExportAVI::doExport(), ExportAudio::doExport(), Export1394::doExport(), ExtractAudio(), FXSelectedFrames::GetAudio(), PageMagickAudioTransition::GetFrame(), PageMagickOverwrite::GetFrame(), KinoCommon::importFile(), PageMagickInfo::Initialise(), kino2raw(), AsyncAudioResample< input_t, output_t >::ReadAudio(), AudioResample< int16_ne_t, int16_ne_t >::Resample(), and FileHandler::WriteFrame(). { #ifdef HAVE_LIBDV info.frequency = dv_get_frequency( decoder ); info.samples = dv_get_num_samples( decoder ); info.frames = IsPAL() ? 50 : 60; info.channels = dv_get_num_channels( decoder ); info.quantization = ( decoder->audio->aaux_as.pc4.qu == 0 ) ? 16 : 12; return true; #else int af_size; int smp; int flag; Pack pack50; info.channels = 2; /* Check whether this frame has a valid AAUX source packet (header == 0x50). If so, get the audio samples count. If not, skip this audio data. */ if ( GetAAUXPack( 0x50, pack50 ) == true ) { /* get size, sampling type and the 50/60 flag. The number of audio samples is dependend on all of these. */ af_size = pack50.data[ 1 ] & 0x3f; smp = ( pack50.data[ 4 ] >> 3 ) & 0x07; flag = pack50.data[ 3 ] & 0x20; if ( flag == 0 ) { info.frames = 60; switch ( smp ) { case 0: info.frequency = 48000; info.samples = 1580 + af_size; break; case 1: info.frequency = 44100; info.samples = 1452 + af_size; break; case 2: info.frequency = 32000; info.samples = 1053 + af_size; break; } } else { // 50 frames (PAL) info.frames = 50; switch ( smp ) { case 0: info.frequency = 48000; info.samples = 1896 + af_size; break; case 1: info.frequency = 44100; info.samples = 0; // I don't know break; case 2: info.frequency = 32000; info.samples = 1264 + af_size; break; } } return true; } else { return false; } #endif }

float Frame::GetFrameRate (  void   )  const

gets the frame rate of the video Depending on the type (PAL or NTSC) of the frame, the frame rate is returned Returns: frames per second Definition at line 691 of file frame.cc. References IsPAL(). Referenced by Export::calculateAdjustedRate(), convertFramesToSmilTime(), convertSmilTimeToFrames(), FXSelectedFrames::GetAudio(), kino2raw(), SrtContext::printEntry(), PageMagick::showFrameInfo(), PageCapture::showFrameInfo(), showScenesThread(), and PageTimeline::Thread(). { return IsPAL() ? 25.0 : 30000.0 / 1001.0; }

int Frame::GetFrameSize (  void   )  const

gets the size of the frame Depending on the type (PAL or NTSC) of the frame, the length of the frame is returned Returns: the length of the frame in Bytes Definition at line 679 of file frame.cc. References IsPAL(). Referenced by IsComplete(), kino2raw(), operator=(), RawHandler::Write(), FileHandler::WriteFrame(), AVI2File::WriteFrame(), and AVI1File::WriteFrame(). { return IsPAL() ? 144000 : 120000; }

string Frame::GetRecordingDate (  void   )  const

Definition at line 499 of file frame.cc. Referenced by GetVideoInfo(). { string recDate; #ifdef HAVE_LIBDV char s[ 64 ]; if ( dv_get_recording_datetime( decoder, s ) ) recDate = s; else recDate = "0000-00-00 00:00:00"; #else struct tm date; ostringstream sb; if ( GetRecordingDate( date ) == true ) { sb << setfill( '0' ) << setw( 4 ) << date.tm_year + 1900 << '.' << setw( 2 ) << date.tm_mon + 1 << '.' << setw( 2 ) << date.tm_mday << '_' << setw( 2 ) << date.tm_hour << '-' << setw( 2 ) << date.tm_min << '-' << setw( 2 ) << date.tm_sec; sb >> recDate; } else { recDate = "0000.00.00_00-00-00"; } #endif return recDate; }

bool Frame::GetRecordingDate (  struct tm &  recDate  )  const

gets the date and time of recording of this frame Returns a struct tm with date and time of recording of this frame. This code courtesy of Andy (http://www.videox.net/) Parameters: recDate  the time and date of recording of this frame Returns: true for success, false if no date or time information could be found Definition at line 445 of file frame.cc. References Pack::data, and GetSSYBPack(). Referenced by PlayList::AutoSplit(), and FileHandler::WriteFrame(). { #ifdef HAVE_LIBDV return dv_get_recording_datetime_tm( decoder, ( struct tm * ) &recDate ); #else Pack pack62; Pack pack63; if ( GetSSYBPack( 0x62, pack62 ) == false ) return false; int day = pack62.data[ 2 ]; int month = pack62.data[ 3 ]; int year = pack62.data[ 4 ]; if ( GetSSYBPack( 0x63, pack63 ) == false ) return false; int sec = pack63.data[ 2 ]; int min = pack63.data[ 3 ]; int hour = pack63.data[ 4 ]; sec = ( sec & 0xf ) + 10 * ( ( sec >> 4 ) & 0x7 ); min = ( min & 0xf ) + 10 * ( ( min >> 4 ) & 0x7 ); hour = ( hour & 0xf ) + 10 * ( ( hour >> 4 ) & 0x3 ); year = ( year & 0xf ) + 10 * ( ( year >> 4 ) & 0xf ); month = ( month & 0xf ) + 10 * ( ( month >> 4 ) & 0x1 ); day = ( day & 0xf ) + 10 * ( ( day >> 4 ) & 0x3 ); if ( year < 25 ) year += 2000; else year += 1900; recDate.tm_sec = sec; recDate.tm_min = min; recDate.tm_hour = hour; recDate.tm_mday = day; recDate.tm_mon = month - 1; recDate.tm_year = year - 1900; recDate.tm_wday = -1; recDate.tm_yday = -1; recDate.tm_isdst = -1; /* sanity check of the results */ if ( mktime( &recDate ) == -1 ) return false; return true; #endif }

bool Frame::GetSSYBPack (  int  packNum, Pack &  pack )  const

gets a subcode data packet This function returns a SSYB packet from the subcode data section. Parameters: packNum  the SSYB package id to return pack  a reference to the variable where the result is stored Returns: true for success, false if no pack could be found Definition at line 239 of file frame.cc. References data, Pack::data, and IsPAL(). Referenced by GetRecordingDate(), and GetTimeCode(). { #ifdef HAVE_LIBDV pack.data[ 0 ] = packNum; dv_get_ssyb_pack( decoder, packNum, &pack.data[ 1 ] ); return true; #else /* number of DIF sequences is different for PAL and NTSC */ int seqCount = IsPAL() ? 12 : 10; /* process all DIF sequences */ for ( int i = 0; i < seqCount; ++i ) { /* there are two DIF blocks in the subcode section */ for ( int j = 0; j < 2; ++j ) { /* each block has 6 packets */ for ( int k = 0; k < 6; ++k ) { /* calculate address: 150 DIF blocks per sequence, 80 bytes per DIF block, subcode blocks start at block 1, block and packet have 3 bytes header, packet is 8 bytes long (including header) */ const unsigned char *s = &data[ i * 150 * 80 + 1 * 80 + j * 80 + 3 + k * 8 + 3 ]; // printf("ssyb %d: %2.2x %2.2x %2.2x %2.2x %2.2x\n", // j * 6 + k, s[0], s[1], s[2], s[3], s[4]); if ( s[ 0 ] == packNum ) { // printf("GetSSYBPack[%x]: sequence %d, block %d, packet %d\n", packNum,i,j,k); pack.data[ 0 ] = s[ 0 ]; pack.data[ 1 ] = s[ 1 ]; pack.data[ 2 ] = s[ 2 ]; pack.data[ 3 ] = s[ 3 ]; pack.data[ 4 ] = s[ 4 ]; return true; } } } } return false; #endif }

bool Frame::GetTimeCode (  TimeCode &  timeCode  )  const

gets the timecode information of this frame Returns a string with the timecode of this frame. The timecode is the relative location of this frame on the tape, and is defined by hour, minute, second and frame (within the last second). Parameters: timeCode  the TimeCode struct Returns: true for success, false if no timecode information could be found Definition at line 543 of file frame.cc. References Pack::data, TimeCode::frame, GetSSYBPack(), TimeCode::hour, TimeCode::min, and TimeCode::sec. Referenced by captureThread(), GetVideoInfo(), and FileHandler::WriteFrame(). { #ifdef HAVE_LIBDV int timestamp[ 4 ]; dv_get_timestamp_int( decoder, timestamp ); timeCode.hour = timestamp[ 0 ]; timeCode.min = timestamp[ 1 ]; timeCode.sec = timestamp[ 2 ]; timeCode.frame = timestamp[ 3 ]; #else Pack tc; if ( GetSSYBPack( 0x13, tc ) == false ) return false; int frame = tc.data[ 1 ]; int sec = tc.data[ 2 ]; int min = tc.data[ 3 ]; int hour = tc.data[ 4 ]; timeCode.frame = ( frame & 0xf ) + 10 * ( ( frame >> 4 ) & 0x3 ); timeCode.sec = ( sec & 0xf ) + 10 * ( ( sec >> 4 ) & 0x7 ); timeCode.min = ( min & 0xf ) + 10 * ( ( min >> 4 ) & 0x7 ); timeCode.hour = ( hour & 0xf ) + 10 * ( ( hour >> 4 ) & 0x3 ); #endif return true; }

bool Frame::GetVAUXPack (  int  packNum, Pack &  pack )  const

gets a video auxiliary data packet Every DIF block in the video auxiliary data section contains 15 video auxiliary data packets, for a total of 45 VAUX packets. As the position of a VAUX packet is fixed, we could directly look it up, but I choose to walk through all data as with the other routines. Parameters: packNum  the VAUX package id to return pack  a reference to the variable where the result is stored Returns: true for success, false if no pack could be found Definition at line 302 of file frame.cc. References data, Pack::data, and IsPAL(). { #ifdef HAVE_LIBDV pack.data[ 0 ] = packNum; dv_get_vaux_pack( decoder, packNum, &pack.data[ 1 ] ); //cerr << "VAUX: 0x" //<< setw(2) << setfill('0') << hex << (int) pack.data[0] //<< setw(2) << setfill('0') << hex << (int) pack.data[1] //<< setw(2) << setfill('0') << hex << (int) pack.data[2] //<< setw(2) << setfill('0') << hex << (int) pack.data[3] //<< setw(2) << setfill('0') << hex << (int) pack.data[4] //<< endl; return true; #else /* number of DIF sequences is different for PAL and NTSC */ int seqCount = IsPAL() ? 12 : 10; /* process all DIF sequences */ for ( int i = 0; i < seqCount; ++i ) { /* there are three DIF blocks in the VAUX section */ for ( int j = 0; j < 3; ++j ) { /* each block has 15 packets */ for ( int k = 0; k < 15; ++k ) { /* calculate address: 150 DIF blocks per sequence, 80 bytes per DIF block, vaux blocks start at block 3, block has 3 bytes header, packets have no header and are 5 bytes long. */ const unsigned char *s = &data[ i * 150 * 80 + 3 * 80 + j * 80 + 3 + k * 5 ]; //printf("vaux %d: %2.2x %2.2x %2.2x %2.2x %2.2x\n", // j * 15 + k, s[0], s[1], s[2], s[3], s[4]); if ( s[ 0 ] == packNum ) { pack.data[ 0 ] = s[ 0 ]; pack.data[ 1 ] = s[ 1 ]; pack.data[ 2 ] = s[ 2 ]; pack.data[ 3 ] = s[ 3 ]; pack.data[ 4 ] = s[ 4 ]; return true; } } } } return false; #endif }

bool Frame::GetVideoInfo (  VideoInfo &  info  )  const

Definition at line 664 of file frame.cc. References GetRecordingDate(), GetTimeCode(), and IsPAL(). { GetTimeCode( info.timeCode ); GetRecordingDate( info.recDate ); info.isPAL = IsPAL(); return true; }

bool Frame::IsComplete (  void   )  const

check whether we have received as many bytes as expected for this frame Returns: true if this frames is completed, false otherwise Definition at line 768 of file frame.cc. References bytesInFrame, and GetFrameSize(). { return bytesInFrame >= GetFrameSize(); }

bool Frame::IsNewRecording (  void   )  const

checks whether this frame is the first in a new recording To determine this, the function looks at the recStartPoint bit in AAUX pack 51. Returns: true if this frame is the start of a new recording Definition at line 723 of file frame.cc. References Pack::data, data, and GetAAUXPack(). Referenced by FileHandler::WriteFrame(). { #ifdef HAVE_LIBDV return dv_is_new_recording( decoder, data ); #else Pack aauxSourceControl; /* if we can't find the packet, we return "no new recording" */ if ( GetAAUXPack( 0x51, aauxSourceControl ) == false ) return false; unsigned char recStartPoint = aauxSourceControl.data[ 2 ] & 0x80; return recStartPoint == 0 ? true : false; #endif }

bool Frame::IsNormalSpeed (  void   )  const

checks whether this frame is playing at normal speed To determine this, the function looks at the speed bit in AAUX pack 51. Returns: true if this frame is playing at normal speed Definition at line 751 of file frame.cc. Referenced by captureThread(), and PageCapture::startCapture(). { bool normal_speed = true; #ifdef HAVE_LIBDV /* don't do audio if speed is not 1 */ return dv_is_normal_speed( decoder ); #endif return ( normal_speed ); }

bool Frame::IsPAL (  void   )  const

checks whether the frame is in PAL or NTSC format Todo: function can't handle "empty" frame Returns: true for PAL frame, false for a NTSC frame Definition at line 703 of file frame.cc. References data. Referenced by _getOneSecond(), PlayList::AutoSplit(), ExportStills::doExport(), ExportPipe::doExport(), ExportMJPEG::doExport(), Export1394::doExport(), ExtractAudio(), GetAAUXPack(), GetAudioInfo(), FindDisplayer::getDisplayer(), GetFrameRate(), GetFrameSize(), getOneSecond(), GetSSYBPack(), GetVAUXPack(), GetVideoInfo(), KinoCommon::importFile(), PageMagickInfo::Initialise(), kino2raw(), DVPipeTool::output(), PageCapture::saveFrame(), KinoCommon::saveFrame(), KinoCommon::savePlayListAs(), and KinoCommon::setPreviewSize(). { unsigned char dsf = data[ 3 ] & 0x80; bool pal = ( dsf == 0 ) ? false : true; #ifdef HAVE_LIBDV if ( !pal ) pal = dv_is_PAL( decoder ); #endif return pal; }

Frame & Frame::operator= (  const Frame &   )

Definition at line 220 of file frame.cc. References bytesInFrame, data, and GetFrameSize(). { bytesInFrame = rhs.GetFrameSize(); if ( bytesInFrame > 144000 ) bytesInFrame = 144000; memcpy( data, rhs.data, bytesInFrame ); ExtractHeader(); return *this; }

---

Member Data Documentation

int16_t* Frame::audio_buffers[4]

Definition at line 122 of file frame.h. Referenced by ExtractAudio(), Frame(), and ~Frame().

int Frame::bytesInFrame

the number of bytes written to the frame Definition at line 107 of file frame.h. Referenced by IsComplete(), and operator=().

static short Frame::compmap [static, private]

Definition at line 72 of file frame.cc. Referenced by ExtractAudio(), and Frame().

unsigned char* Frame::data

Definition at line 105 of file frame.h. Referenced by ExtractAudio(), Frame(), GetAAUXPack(), AVIFile::GetDVFrame(), RawHandler::GetFrame(), GetSSYBPack(), GetVAUXPack(), IsNewRecording(), IsPAL(), kino2raw(), operator=(), DVPipeTool::output(), PageMagick::StartRender(), RawHandler::Write(), AVI2File::WriteFrame(), AVI1File::WriteFrame(), and ~Frame().

static bool Frame::maps_initialized = false [static, private]

flag for initializing the lookup maps once at startup Definition at line 63 of file frame.cc. Referenced by Frame().

static int Frame::ntscmap_2ch1 [static, private]

Definition at line 70 of file frame.cc. Referenced by ExtractAudio(), and Frame().

static int Frame::ntscmap_2ch2 [static, private]

Definition at line 71 of file frame.cc. Referenced by Frame().

static int Frame::ntscmap_ch1 [static, private]

Definition at line 68 of file frame.cc. Referenced by ExtractAudio(), and Frame().

static int Frame::ntscmap_ch2 [static, private]

Definition at line 69 of file frame.cc. Referenced by ExtractAudio(), and Frame().

static int Frame::palmap_2ch1 [static, private]

Definition at line 66 of file frame.cc. Referenced by ExtractAudio(), and Frame().

static int Frame::palmap_2ch2 [static, private]

Definition at line 67 of file frame.cc. Referenced by Frame().

static int Frame::palmap_ch1 [static, private]

lookup tables for collecting the shuffled audio data Definition at line 64 of file frame.cc. Referenced by ExtractAudio(), and Frame().

static int Frame::palmap_ch2 [static, private]

Definition at line 65 of file frame.cc. Referenced by ExtractAudio(), and Frame().

---

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

• frame.h
• frame.cc

---