In This Topic ▼

IltmmConvert::put_SelectionStartModifier

#include "ltmm.h"

C Syntax	HRESULT IltmmConvert_put_SelectionStartModifier(pConvert, newVal)
C++ Syntax	HRESULT put_SelectionStartModifier(newVal)

IltmmConvert *pConvert;	pointer to an interface
ltmmSelectionModifier newVal;	modifier value

Sets a value specifying how the selection start value will be modified when set.

Parameter	Description
pConvert	Pointer to an IltmmConvert interface.
newVal	New selection start modifier.
	Value	Meaning
	ltmmSelectionModifier_None	No automatic adjustment
	ltmmSelectionModifier_NearestKeyFrame	Adjust the time either forward or backward to the nearest key frame
	ltmmSelectionModifier_NextKeyFrame	Adjust the time forward to the next key frame
	ltmmSelectionModifier_PreviousKeyFrame	Adjust the time backward to the previous key frame

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

The default value is ltmmSelectionModifier_None.

When this property is set to any other valid ltmmSelectionModifier value, the value passed to IltmmConvert::put_SelectionStart will be automatically adjusted based on the value of this property.

The SelectionStartModifier and SelectionEndModifer properties allow you to specify whether LEADTOOLS should automatically adjust the selection points to be on a key frame (key frame is a synonym to a sync point). Moving the selection point to a key frame allows for faster compression and is better for concatenation applications, since you can concatenate video clips if the second section starts with a key frame.

Automatic adjustment of the selection points is supported only for MPEG-2 Program and MPEG-2 Transport files.

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

Example

For a C example, refer to .IltmmConvert::put_SelectionStartModifier Example for C

For a C++ example, refer to .IltmmConvert::put_SelectionStartModifier Example for C++

Download our FREE evaluation

Help Version 21.0.2021.7.19

Products | Support | Contact Us | Intellectual Property Notices
© 1991-2021 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

Elements:	IltmmConvert::get_SelectionStartModifier,IltmmConvert::get_SelectionEndModifier, IltmmConvert::put_SelectionEndModifier, IltmmConvert::put_SelectionStart, IltmmConvert::put_SelectionEnd
Topics:	Multimedia Function Group