Describes an input video file. More...

Inheritance diagram for QtlMovieInputFile:

Signals
void	mediaInfoChanged ()
	Emitted when the media info have changed. More...

Signals inherited from QtlFile
void	fileNameChanged (const QString &fileName)
	Emitted when the file name has changed. More...

Public Member Functions
	QtlMovieInputFile (const QString &fileName, const QtlMovieSettings settings, QtlLogger log, QObject *parent=0)
	Constructor. More...

	QtlMovieInputFile (const QtlMovieInputFile &other, QObject *parent=0)
	Copy constructor. More...

QtlDataPull *	dataPull (QObject *parent=0) const
	Get an instance of QtlDataPull to transfer the content of the input file. More...

float	durationInSeconds () const
	Try to evaluate the duration of the media file in seconds. More...

QString	externalSubtitleFileName () const
	Get the external subtitle file name. More...

QString	ffmpegInputFileFormat () const
	Get the name to specify as input file format to ffmpeg when this object is used as input to ffmpeg. More...

QString	ffmpegInputFileSpecification () const
	Get the name to specify as input to ffmpeg when this object is used as input to ffmpeg. More...

QtlMovieFFprobeTags	ffProbeInfo () const
	Get the list of tags from FFprobe output. More...

QtlMediaStreamInfoPtr	firstStream (QtlMediaStreamInfo::StreamType streamType) const
	Get the information about the first stream in the file matching a given type. More...

bool	isDvdCompliant () const
	Check if the file seems to be DVD-compliant. More...

bool	isIsoImage () const
	Check if the file seems to be a DVD ISO image. More...

bool	isM2tsFile () const
	Check if the input file has M2TS format. More...

bool	isSubtitleFile () const
	Check if the input file is a pure subtitle file. More...

bool	isTsFile () const
	Check if the input file is an MPEG transport stream. More...

QtlLogger *	log () const
	Get the associated error logger. More...

QtlByteBlock	palette () const
	Get the DVD palette in RGB format. More...

bool	pipeInput () const
	Check if the input file content must be piped from QtlMovie. More...

void	selectDefaultStreams (const QStringList &audienceLanguages=QStringList())
	Select the default video, audio and subtitle streams. More...

int	selectedAudioStreamIndex () const
	Get the index of audio stream to transcode. More...

QtlMediaStreamInfoPtr	selectedAudioStreamInfo () const
	Get the information about the selected audio stream. More...

int	selectedSubtitleStreamIndex () const
	Get the index of subtitle stream to transcode. More...

QtlMediaStreamInfoPtr	selectedSubtitleStreamInfo () const
	Get the information about the selected subtitle stream. More...

int	selectedVideoStreamIndex () const
	Get the index of video stream to transcode. More...

QtlMediaStreamInfoPtr	selectedVideoStreamInfo () const
	Get the information about the selected video stream. More...

bool	selectedVideoStreamIsDvdCompliant () const
	Check if the selected video stream is DVD-compliant. More...

void	setExternalSubtitleFileName (const QString &subtitleFileName)
	Set an external subtitle file name. More...

void	setSelectedAudioStreamIndex (int index)
	Set the index of audio stream to transcode. More...

void	setSelectedSubtitleStreamIndex (int index)
	Set the index of subtitle stream to transcode. More...

void	setSelectedVideoStreamIndex (int index)
	Set the index of video stream to transcode. More...

int	streamCount () const
	Get the number of streams in the file. More...

int	streamCount (QtlMediaStreamInfo::StreamType streamType) const
	Get the number of streams in the file matching a given type. More...

QtlMediaStreamInfoPtr	streamInfo (int streamIndex) const
	Get the information about a stream in input file. More...

Public Member Functions inherited from QtlFile
	QtlFile (const QString &fileName, QObject *parent=0)
	Constructor. More...

	QtlFile (const QtlFile &other, QObject *parent=0)
	Copy constructor. More...

QString	directoryName () const
	Get the directory name of the file. More...

QString	fileName () const
	Get the file name. More...

bool	isSet () const
	Check if the file name is set. More...

QtlByteBlock	readBinary (int maxSize=-1) const
	Read the binary content of the file. More...

QString	readText () const
	Read the text content of the file. More...

QStringList	readTextLines (int maxSize=-1) const
	Read the text content of the file. More...

virtual bool	setFileName (const QString &fileName)
	Set the file name. More...

QString	shortPath (bool keepOnError) const
	Get the "short path name" of the file. More...

bool	writeBinary (const QtlByteBlock &content)
	Write the binary content of the file. More...

bool	writeText (const QString &text)
	Write the text content of the file. More...

bool	writeTextLines (const QStringList &lines)
	Write the text content of the file. More...

Private Slots
void	closedCaptionsSearchTerminated (bool success)
	Invoked when a search for Closed Captions completes. More...

void	ffprobeTerminated (const QtlBoundProcessResult &result)
	Invoked when the ffprobe process completes. More...

void	foundClosedCaptions (QtlMediaStreamInfoPtr stream)
	Invoked when a Closed Captions stream is found. More...

void	foundTeletextSubtitles (QtlMediaStreamInfoPtr stream)
	Invoked when a Teletext subtitle stream is found. More...

void	teletextSearchTerminated (bool success)
	Invoked when the search for Teletext subtitles completes. More...

void	updateMediaInfo (const QString &fileName)
	Invoked when the file name has changed, update file info. More...

Private Member Functions
	QtlMovieInputFile () Q_DECL_EQ_DELETE

QtlBoundProcess *	ffprobeProcess (int probeTimeDivisor, int ffprobeTimeout)
	Create and start a ffprobe process. More...

void	newMediaInfo ()
	Report that new media info has been found. More...

Private Attributes
int	_ccSearchCount
	Number of Closed Captions research in progress. More...

int	_dvdAngle
	Angle number when demuxing DVD content. More...

QtsDvdProgramChainPtr	_dvdPgc
	Smart pointer to PGC inside the DVD VTS. More...

int	_dvdProgramChain
	PGC number when demuxing DVD content. More...

QtsDvdTitleSet	_dvdTitleSet
	DVD title set access (when the input file comes from a DVD). More...

bool	_dvdTranscodeRawVob
	On DVD, transcode raw VOB files, don't demux. More...

QString	_externalSubtitleFileName
	Subtitle file name, can be empty. More...

QtlMovieFFprobeTags	_ffInfo
	Media info in ffprobe flat format. More...

QString	_ffmpegFormat
	Name to specify as input file format to ffmpeg. More...

QString	_ffmpegInput
	Name to specify as input to ffmpeg. More...

int	_ffprobeCount
	Number of ffprobe in progress. More...

bool	_isM2ts
	File has M2TS format. More...

bool	_isSubtitle
	File is a pure subtitle file, no container format. More...

bool	_isTs
	File is a transport stream (TS or M2TS format). More...

QtlLogger *	_log
	Where to log errors. More...

bool	_pipeInput
	Input file content shall be piped from QtlMovie. More...

bool	_selectedAudioExplicit
	Audio stream explicitly selected (vs. default choice). More...

int	_selectedAudioStreamIndex
	Index of audio stream to transcode. More...

bool	_selectedSubtitleExplicit
	Subtitle stream explicitly selected (vs. default choice). More...

int	_selectedSubtitleStreamIndex
	Index of subtitle stream to transcode. More...

bool	_selectedVideoExplicit
	Video stream explicitly selected (vs. default choice). More...

int	_selectedVideoStreamIndex
	Index of video stream to transcode. More...

const QtlMovieSettings *	_settings
	Application settings. More...

QtlMediaStreamInfoList	_streams
	Stream information. More...

QtlMovieTeletextSearch *	_teletextSearch
	Search for Teletext subtitles in MPEG-TS files. More...

Additional Inherited Members
Static Public Member Functions inherited from QtlFile
static QString	absoluteNativeFilePath (const QString &path, bool removeSymLinks=false)
	Build an absolute file path with native directory separators. More...

static QStringList	commandSearchPath ()
	Return the list of directories in the system search path. More...

static bool	createDirectory (const QString &path, bool createOnly=false)
	Create a directory and all parent directories if necessary. More...

static QString	enforceSuffix (const QString &path, const QString &suffix, Qt::CaseSensitivity cs=Qt::CaseInsensitive)
	Enforce a suffix in a file name. More...

static QStringList	expandFilePath (const QString &path, QtlFilePathFilterInterface *filter=0)
	Expand a file path containing wildcards to all existing files matching the specification. More...

static QString	parentPath (const QString &path, int upLevels=1)
	Get the absolute file path of the parent directory of a file. More...

template<typename T >
static bool	readBigEndianAt (QIODevice &device, qint64 position, T &data)
	Read a big endian integer in a binary file at a given position. More...

static bool	readBinary (QIODevice &device, QtlByteBlock &data, int maxSize=-1)
	Read a portion of a binary file at the current position. More...

static bool	readBinaryAt (QIODevice &device, qint64 position, QtlByteBlock &data, int maxSize=-1)
	Read a portion of a binary file at a given position. More...

static QtlByteBlock	readBinaryFile (const QString &fileName, int maxSize=-1)
	Read the content of a binary file. More...

static QString	readTextFile (const QString &fileName)
	Read the content of a text file. More...

static QStringList	readTextLinesFile (const QString &fileName, int maxSize=-1)
	Read the content of a text file. More...

static QString	search (const QString &baseName, const QStringList &searchPath, const QString &extension=QString(), QFile::Permissions permissions=QFile::Permissions())
	Search a file in a list of directories. More...

static QString	searchExecutable (const QString &baseName, const QStringList &searchPath)
	Search an executable file in a list of directories. More...

static QString	searchParentSubdirectory (const QString &dir, const QString &subdir, int maxLevels=128)
	Search a subdirectory in the parent path. More...

static QString	shortPath (const QString &path, bool keepOnError)
	Get the "short path name" of a file path. More...

static QString	toFileName (const QUrl &url)
	Format the content of an URL into a file path if the URL scheme is file: More...

static bool	writeBinary (QIODevice &file, const QtlByteBlock &data)
	Write binary data into an open file. More...

static bool	writeBinary (QIODevice &file, const void *data, int size, bool processEvents=false)
	Write binary data into an open file. More...

static bool	writeBinaryFile (const QString &fileName, const QtlByteBlock &content)
	Write the content of a binary file. More...

static bool	writeTextFile (const QString &fileName, const QString &text)
	Write the content of a text file. More...

static bool	writeTextLinesFile (const QString &fileName, const QStringList &lines)
	Write the content of a text file. More...

Detailed Description

Describes an input video file.

Constructor & Destructor Documentation

◆ QtlMovieInputFile() [1/3]

QtlMovieInputFile::QtlMovieInputFile	(	const QString &	fileName,
		const QtlMovieSettings *	settings,
		QtlLogger *	log,
		QObject *	parent = `0`
	)

Constructor.

Parameters

[in]	fileName	Input file name.
[in]	settings	Application settings.
[in]	log	Where to log errors.
[in]	parent	Optional parent widget.

◆ QtlMovieInputFile() [2/3]

QtlMovieInputFile::QtlMovieInputFile	(	const QtlMovieInputFile &	other,
		QObject *	parent = `0`
	)

explicit

Copy constructor.

Parameters

[in]	other	Other instance to copy (except parent).
[in]	parent	Optional parent widget.

◆ QtlMovieInputFile() [3/3]

QtlMovieInputFile::QtlMovieInputFile ( )

private

Member Function Documentation

◆ log()

QtlLogger* QtlMovieInputFile::log ( ) const

inline

Get the associated error logger.

Returns: The associated error logger.

◆ ffmpegInputFileSpecification()

QString QtlMovieInputFile::ffmpegInputFileSpecification ( ) const

inline

Get the name to specify as input to ffmpeg when this object is used as input to ffmpeg.

This may differ from the file name when the input file is a DVD IFO or VOB.

Returns: A string to specify as input to ffmpeg. This may not be a valid file name.

◆ ffmpegInputFileFormat()

QString QtlMovieInputFile::ffmpegInputFileFormat ( ) const

inline

Get the name to specify as input file format to ffmpeg when this object is used as input to ffmpeg.

Returns: A string to specify as input file format to ffmpeg. Empty is ffmpeg is able to figure it out.

◆ streamCount() [1/2]

int QtlMovieInputFile::streamCount ( ) const

inline

Get the number of streams in the file.

Returns: Number of streams in the file.

◆ streamCount() [2/2]

int QtlMovieInputFile::streamCount ( QtlMediaStreamInfo::StreamType streamType ) const

Get the number of streams in the file matching a given type.

Parameters

[in] streamType Stream type to look for.

Returns: Number of streams in the file for that type.

◆ firstStream()

QtlMediaStreamInfoPtr QtlMovieInputFile::firstStream ( QtlMediaStreamInfo::StreamType streamType ) const

Get the information about the first stream in the file matching a given type.

Parameters

[in] streamType Stream type to look for.

Returns: A smart pointer to the stream information data or a null pointer if not found.

◆ streamInfo()

QtlMediaStreamInfoPtr QtlMovieInputFile::streamInfo ( int streamIndex ) const

Get the information about a stream in input file.

Parameters

[in] streamIndex Index of the stream to query, from 0 to streamCount()-1.

Returns: A smart pointer to the stream information data or a null pointer on error.

◆ durationInSeconds()

float QtlMovieInputFile::durationInSeconds ( ) const

Try to evaluate the duration of the media file in seconds.

Returns: Duration of media in seconds or zero if unknown.

◆ isDvdCompliant()

bool QtlMovieInputFile::isDvdCompliant ( ) const

Check if the file seems to be DVD-compliant.

More precisely, check if the file looks like one of our DVD-compliant MPEG files, one of those we generate for output type QtlMovieOutputFile::DvdFile. Note that other MPEG files may also be DVD-compliant but it is difficult to check. We simply want to filter a simple use case: We first transcoded to a DVD MPEG file to see the result and we later want to create the ISO image without retranscoding.

Returns: True if the file seems DVD-compliant, false otherwise.

◆ selectedVideoStreamIsDvdCompliant()

bool QtlMovieInputFile::selectedVideoStreamIsDvdCompliant ( ) const

Check if the selected video stream is DVD-compliant.

To generate a DVD from this kind of file, we can simply copy the audio stream without re-encoding. This saves much time.

Returns: True if the selected video stream is DVD-compliant, false otherwise.

◆ isIsoImage()

bool QtlMovieInputFile::isIsoImage ( ) const

Check if the file seems to be a DVD ISO image.

In fact, check that the file name ends in ".iso".

Returns: True if the file seems to be a DVD ISO image.

◆ isTsFile()

bool QtlMovieInputFile::isTsFile ( ) const

inline

Check if the input file is an MPEG transport stream.

This include TS and M2TS files.

Returns: True if the input file is an MPEG transport stream.

◆ isM2tsFile()

bool QtlMovieInputFile::isM2tsFile ( ) const

inline

Check if the input file has M2TS format.

Returns: True if the input file has M2TS format.

◆ isSubtitleFile()

bool QtlMovieInputFile::isSubtitleFile ( ) const

inline

Check if the input file is a pure subtitle file.

This means that the file is for instance a .srt or .ass file, not included into some container file format.

Returns: True if the input file is a pure subtitle file.

◆ pipeInput()

bool QtlMovieInputFile::pipeInput ( ) const

inline

Check if the input file content must be piped from QtlMovie.

Some input files cannot be read directly from the file system. This is the case for encrypted DVD's: you can browse files, you can read metadata files (.IFO) but you cannot read the content of video files (.VOB). For that kind of files, ffmpeg or ffprobe cannot directly read the file. They must read the content from their standard input and QtlMovie will pipe the extracted file content into it.

Returns: True if the input file content must be piped from QtlMovie.

See also: dataPull(); ffmpegInputFileSpecification()

◆ dataPull()

QtlDataPull * QtlMovieInputFile::dataPull ( QObject * parent = 0 ) const

Get an instance of QtlDataPull to transfer the content of the input file.

Returns: An instance of QtlDataPull which can transfer the content of the input file into a QIODevice. This object will delete itself at the end of the transfer. Return a null pointer if the file shall be read directly from the file system.

Parameters

parent Optional parent object of the QtlDataPull instance.

See also: pipeInput()

◆ palette()

QtlByteBlock QtlMovieInputFile::palette ( ) const

Get the DVD palette in RGB format.

Returns: The DVD palette in RGB format or an empty array if the file is not a DVD.

◆ selectedVideoStreamIndex()

int QtlMovieInputFile::selectedVideoStreamIndex ( ) const

Get the index of video stream to transcode.

Returns: Index of video stream to transcode or -1 if none.

◆ selectedVideoStreamInfo()

QtlMediaStreamInfoPtr QtlMovieInputFile::selectedVideoStreamInfo ( ) const

inline

Get the information about the selected video stream.

Returns: A smart pointer to the stream information data or a null pointer if no stream is selected.

◆ setSelectedVideoStreamIndex()

void QtlMovieInputFile::setSelectedVideoStreamIndex ( int index )

Set the index of video stream to transcode.

Parameters

[in] index Index of video stream to transcode or -1 if none.

◆ selectedAudioStreamIndex()

int QtlMovieInputFile::selectedAudioStreamIndex ( ) const

Get the index of audio stream to transcode.

Returns: Index of audio stream to transcode or -1 if none.

◆ selectedAudioStreamInfo()

QtlMediaStreamInfoPtr QtlMovieInputFile::selectedAudioStreamInfo ( ) const

inline

Get the information about the selected audio stream.

Returns: A smart pointer to the stream information data or a null pointer if no stream is selected.

◆ setSelectedAudioStreamIndex()

void QtlMovieInputFile::setSelectedAudioStreamIndex ( int index )

Set the index of audio stream to transcode.

Parameters

[in] index Index of audio stream to transcode or -1 if none.

◆ selectedSubtitleStreamIndex()

int QtlMovieInputFile::selectedSubtitleStreamIndex ( ) const

Get the index of subtitle stream to transcode.

Returns: Index of subtitle stream to transcode or -1 if none.

◆ selectedSubtitleStreamInfo()

QtlMediaStreamInfoPtr QtlMovieInputFile::selectedSubtitleStreamInfo ( ) const

inline

Get the information about the selected subtitle stream.

Returns: A smart pointer to the stream information data or a null pointer if no stream is selected.

◆ setSelectedSubtitleStreamIndex()

void QtlMovieInputFile::setSelectedSubtitleStreamIndex ( int index )

Set the index of subtitle stream to transcode.

Parameters

[in] index Index of subtitle stream to transcode or -1 if none.

◆ externalSubtitleFileName()

QString QtlMovieInputFile::externalSubtitleFileName ( ) const

Get the external subtitle file name.

Returns: The subtitle file name. Empty if no subtitle file is specified.

◆ setExternalSubtitleFileName()

void QtlMovieInputFile::setExternalSubtitleFileName ( const QString & subtitleFileName )

Set an external subtitle file name.

If not empty, clear the selected stream index.

Parameters

[in] subtitleFileName The subtitle file name. Can be empty.

◆ selectDefaultStreams()

void QtlMovieInputFile::selectDefaultStreams ( const QStringList & audienceLanguages = QStringList() )

Select the default video, audio and subtitle streams.

Default video stream selection: We try to determine the one with "best quality". In theory, this should be some evaluation of the combination of size, bitrate, encoding options. Currently, we just keep the video stream with the largest frame size. If we cannot compute the frame sizes, keep the first video stream.

Default audio stream selection: Try to determine "original version". If not possible, keep first audio track not matching any language in audienceLanguages (supposed to be the original audio, considering any language in audienceLanguages as dubbing). Otherwise, keep first audio without visual/hearing impaired.

Default subtitle stream selection: In all cases, consider only subtitle in audienceLanguages. If this list is empty, there will be no default subtitle. Within the subtitle in audienceLanguages, the following criteria apply.

If the audio stream is in audienceLanguages, keep the first "forced" subtitle (the "forced" subtitle are used only when the audio track of the same language contains dialogues in another language).
If the audio stream is not in audienceLanguages, keep subtitle which are either (in order of preference) 1) complete, 2) for hearing/visual impaired, 3) other.

Parameters

[in] audienceLanguages List of languages of the intended audience.

◆ ffProbeInfo()

QtlMovieFFprobeTags QtlMovieInputFile::ffProbeInfo ( ) const

inline

Get the list of tags from FFprobe output.

Low-level method, dependent on ffprobe output.

Returns: A map of tag/value.

private

Report that new media info has been found.

If no more operation in progress, emit mediaInfoChanged().

◆ ffprobeProcess()

QtlBoundProcess * QtlMovieInputFile::ffprobeProcess	(	int	probeTimeDivisor,
		int	ffprobeTimeout
	)

private

Create and start a ffprobe process.

Parameters

[in]	probeTimeDivisor	If positive, this value is used to reduce the probe time duration. The actual probe time is the value from settings, divided by probeTimeDivisor.
[in]	ffprobeTimeout	Timeout of process execution in seconds.

Returns: A new instance of QtlBoundProcess.

Angle number when demuxing DVD content.

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

Signals

Public Member Functions

Private Slots

Private Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ QtlMovieInputFile() [1/3]

◆ QtlMovieInputFile() [2/3]

◆ QtlMovieInputFile() [3/3]

Member Function Documentation

◆ log()

◆ ffmpegInputFileSpecification()

◆ ffmpegInputFileFormat()

◆ streamCount() [1/2]

◆ streamCount() [2/2]

◆ firstStream()

◆ streamInfo()

◆ durationInSeconds()

◆ isDvdCompliant()

◆ selectedVideoStreamIsDvdCompliant()

◆ isIsoImage()

◆ isTsFile()

◆ isM2tsFile()

◆ isSubtitleFile()

◆ pipeInput()

◆ dataPull()

◆ palette()

◆ selectedVideoStreamIndex()

◆ selectedVideoStreamInfo()

◆ setSelectedVideoStreamIndex()

◆ selectedAudioStreamIndex()

◆ selectedAudioStreamInfo()

◆ setSelectedAudioStreamIndex()

◆ selectedSubtitleStreamIndex()

◆ selectedSubtitleStreamInfo()

◆ setSelectedSubtitleStreamIndex()

◆ externalSubtitleFileName()

◆ setExternalSubtitleFileName()

◆ selectDefaultStreams()

◆ ffProbeInfo()

◆ mediaInfoChanged

◆ updateMediaInfo

◆ ffprobeTerminated

◆ foundTeletextSubtitles

◆ foundClosedCaptions

◆ teletextSearchTerminated

◆ closedCaptionsSearchTerminated

◆ newMediaInfo()

◆ ffprobeProcess()

Member Data Documentation

◆ _log

◆ _settings

◆ _ffmpegInput

◆ _ffmpegFormat

◆ _ffInfo

◆ _streams

◆ _dvdTitleSet

◆ _dvdPgc

◆ _teletextSearch

◆ _ffprobeCount

◆ _ccSearchCount

◆ _selectedVideoStreamIndex

◆ _selectedAudioStreamIndex

◆ _selectedSubtitleStreamIndex

◆ _selectedVideoExplicit

◆ _selectedAudioExplicit

◆ _selectedSubtitleExplicit

◆ _externalSubtitleFileName

◆ _isTs

◆ _isM2ts

◆ _isSubtitle

◆ _pipeInput

◆ _dvdTranscodeRawVob

◆ _dvdProgramChain

◆ _dvdAngle