ILTDvdWriter::put_TitleBreak
#include " ILTDvdWriter2.h"
|
C Syntax |
HRESULT ILTDvdWriter__put_TitleBreak(pDVDWriter, TitleBreak) |
|
C++ Syntax |
HRESULT put_TitleBreak(TitleBreak) |
|
ILTDvdWriter *pDVDWriter; |
/* pointer to an interface */ |
|
VARIANT_BOOL TitleBreak; |
/* title The name for a group of related video files (called "Chapters") on your DVD. For example, for a DVD called "My Summer Vacation," you might have the titles "Water Skiing," "New Friends," and "Hiking." For each of those titles, you might have one or more different video files. break */ |
Sets a value that determines whether a title is closed immediately after a write operation.
|
Parameter |
Description |
|
|
pDVDWriter |
Pointer to an ILTDvdWriter interface. |
|
|
TitleBreak |
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 TitleBreak 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 The name for each individual video file on a DVD. For example, under the title "Water Skiing", you might have the chapters "My first try," "My first wreck," and "My first jump." in the current title. The chapters are stored in temporary files in a different folder than the DVD image A set of files that contain all of the video and audio content for a DVD, organized with a table of contents (optional). See also: Title, Chapter, ISO Image An ISO image (.iso) is a disk image of a file system. It includes data files that are contained in the ISO image along with filesystem metadata. ISO images are an alternative to physical media for distribution of a "DVD" over the Internet. Most operating systems allow ISO images images to be "played" as if they were physical discs. See also: 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 For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application. |
See Also
|
Elements: |
ILTDvdWriter::getTempPath, ILTDvdWriter::put_TempPath, ILTDvdWriter::ClearTitleSet, ILTDvdWriter::get_Overwrite, ILTDvdWriter::put_Overwrite, ILTDvdWriter::getTitleBreak |
|
Topics: |
|
|
|
|
|
|
|
|
|
|
|
|
Example
For an example, refer to Creating DVD Images for C.
For an example, refer to Creating DVD Images for C++.