In This Topic ▼

IltmmDVDTitle::put_SelectedSubpictureStream

#include "ltmm.h"

C Syntax	HRESULT IltmmDVDTitle_put_SelectedSubpictureStream(pDVDTitle, newVal)
C++ Syntax	HRESULT put_SelectedSubpictureStream(newVal)

IltmmDVDTitle *pDVDTitle;	pointer to an interface
long newVal;	Subpicture stream index

Sets the subpicture stream index to be selected.

Parameter	Description
pDVDTitle	Pointer to an IltmmDVDTitle interface.
newVal	The subpicture stream index to be selected. This is 0 based index.

Returns

S_OK	The function was successful.
<> S_OK	An error occurred. Refer to the Error Codes or the HRESULT error codes in the DirectShow documentation.

Comments

This property selects a subpicture stream. To get the count of available subpicture streams in the current title , call the IltmmDVDTitle::get_SubpictureStreamCount property.

To examine each subpicture stream use the IltmmDVDTitle::GetSubpictureStream to get each ltmmDVDSubpictureStream interface. To examine the subpicture stream information, decide which stream you want to use and then select it using the IltmmDVDSubpictureStream::put_Selected property.

It is best to include the LEAD Video Subpicture Mixer with your application if you want to convert DVDs with subpicture information. This filter is needed during conversion if the DVD decoder does not combine the subpicture information with the video. If the DVD decoder does not combine the subpicture information with the video and the LEAD Video Subpicture Mixer is not present, it will appear as if you never selected any subpicture stream during conversion. This is especially true for Vista and Windows 7.

Required DLLs and Libraries

LTMM

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

Platforms

Win32, x64

See Also

Functions:	IltmmDVDTitle::GetSubpictureStream, IltmmDVDTitle::put_Selected, IltmmDVDTitle::get_TotalDuration, IltmmDVDTitle::get_ChapterCount, IltmmDVDTitle::get_Selected, IltmmDVDTitle::put_Selected, IltmmDVDTitle::get_SelectedDuration, IltmmDVDTitle::get_AudioStreamCount, IltmmDVDTitle::get_SubpictureStreamCount, IltmmDVDTitle::get_SelectedAudioStream, IltmmDVDTitle::put_SelectedAudioStream, IltmmDVDTitle::get_SelectedSubpictureStream, IltmmDVDTitle::get_PanscanPermitted, IltmmDVDTitle::get_LetterboxPermitted, IltmmDVDTitle::get_AspectX, IltmmDVDTitle::get_AspectY, IltmmDVDTitle::get_FrameRate, IltmmDVDTitle::get_FrameHeight, IltmmDVDTitle::get_Compression, IltmmDVDTitle::get_Line21Field1InGOP, IltmmDVDTitle::get_Line21Field2InGOP, IltmmDVDTitle::get_SourceResolutionX, IltmmDVDTitle::get_SourceResolutionY, IltmmDVDTitle::get_IsSourceLetterboxed, IltmmDVDTitle::get_IsFilmMode
Topics:	IltmmDVDSubpictureStream Interface
	Multimedia Function Groups

Example

For C example, refer to DVD Source for C or Convert DVD with Subtiitles for C

For C++ example, refer to DVD Source for C++ or Convert DVD with Subtiitles for C++

Download our FREE evaluation

Help Version 20.0.2020.4.2

Products | Support | Contact Us | Intellectual Property Notices
© 1991-2020 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Multimedia C API Help

Multimedia Files You Must Include With Your Application (Redistributables)

Frequently Asked Questions

LEADTOOLS Multimedia Features

Add-on Modules

Programming with LEADTOOLS Multimedia

Appendix

LEADTOOLS Licensing