ILTDvdWriter::put_TitleBreak

Summary

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

Syntax

#include "ILTDvdWriter2.h"

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

Parameters

ILTDvdWriter *pDVDWriter

Pointer to an ILTDvdWriter interface.

VARIANT_BOOL 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

Value Meaning
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

Platforms

Win32, x64.

See Also

Functions

Topics

Example

Language Example
C Creating DVD Images
C++ Creating DVD Images
Help Version 22.0.2023.1.26
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Multimedia C API Help

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