ILTDvdWriter::put_TitleBreak

#include " ILTDvdWriter2.h"

C Syntax	HRESULT ILTDvdWriter_put_TitleBreak(pDVDWriter, newVal)
C++ Syntax	HRESULT put_TitleBreak(newVal)

ILTDvdWriter *pDVDWriter;	pointer to an interface
VARIANT_BOOL newVal;	title break

Sets a value that determines whether a title is closed immediately after a write operation.

Parameter	Description
pDVDWriter	Pointer to an ILTDvdWriter interface.
newVal	Value that indicates whether a title is closed immediately after a write operation. Possible values are:
	Value	Meaning
	VARIANT_TRUE	The title will be closed immediately after the write operation.
	VARIANT_FALSE	The title will remain open immediately after the write operation.

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

Once all chapters have been added to a title, close the title by calling ILTDvdWriter::put_TitleBreak with the newVal parameter set to VARIANT_TRUE.

To get the current setting, call ILTDvdWriter::get_TitleBreak.

If TitleBreak is set to VARIANT_FALSE, the current title will stay open, and each conversion will create a chapter in the current title. The chapters are stored in temporary files in a different folder than the DVD image folder. The temporary files will not be copied to the DVD image folder until the TitleBreak property is set to VARIANT_TRUE. If the convert object is destroyed or the output type changed before TitleBreak is set to VARIANT_TRUE, the temporary files will be deleted and nothing will be written to the DVD image folder.

If TitleBreak is set to VARIANT_TRUE each conversion will create a new title at the end of the conversion. Also, the moment TitleBreak is set to VARIANT_TRUE, any temporary files created by previous conversions will be merged into the same title. Each converted file will appear as a different chapter in the same title.

For example, this sequence:

TitleBreak = VARIANT_FALSE
Convert File 1 convert file 1 as Chapter 1
Convert File 2 convert file 2 as Chapter 2
TitleBreak = VARIANT_TRUE Create Title 1
Destroy the converter object

will create a DVD with 1 title containing 2 chapters

But this sequence:

TitleBreak = VARIANT_FALSE
Convert File 1 convert file 1 as Chapter 1
Convert File 2 convert file 2 as Chapter 2
Destroy the converter object

will not create anything.

Required DLLs and Libraries

LTDVDWRT
DSKernel

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

Example

For an example, refer to Creating DVD Images for C.

For an example, refer to Creating DVD Images for C++.

Help Version 19.0.2017.10.27

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

Elements:	ILTDvdWriter::getTempPath, ILTDvdWriter::put_TempPath, ILTDvdWriter::ClearTitleSet, ILTDvdWriter::get_Overwrite, ILTDvdWriter::put_Overwrite, ILTDvdWriter::getTitleBreak
Topics:	Multimedia Function Group
	The LEAD DVD Writer and Menus Titles and Chapters
	How to Use the DVD Writer to Write a DVD Image
	DVD Function Groups
	Streaming Function Groups