IltmmConvert::put_SelectionEndModifier

#include "ltmm.h"

C Syntax	HRESULT IltmmConvert_put_SelectionEndModifier(pConvert, newVal)
C++ Syntax	HRESULT put_SelectionEndModifier(newVal)

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

Sets a value specifying how the selection end 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_SelectionEnd 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 for 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++

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:	IltmmConvert::get_SelectionEndModifier,IltmmConvert::get_SelectionStartModifier, IltmmConvert::put_SelectionEndModifier, IltmmConvert::put_SelectionStart, IltmmConvert::put_SelectionEnd
Topics:	Multimedia Function Group