Table of Contents Generator object

Table of Contents Generator (TOC Generator) is a DirectX Media Object (DMO) that can analyze a video stream and generate a table of contents based on detected shots and clusters of shots. TOC Generator can also detect the best frames to use for thumbnail images.

For information about creating and using a TOC Generator object, see Generating a Table of Contents Automatically.

CLSID

CLSID_CTocGeneratorDmo

Interfaces

Properties

The TOC Generator DMO supports the following properties, which are available through the IPropertyStore interface.

Note  Properties of type VT_BOOL have values of 0 or 1, where 0 represents false and 1 represents true. True is not represented by VARIANT_TRUE, which is equal to 0xFFFF.
 
PropertyDescription
MFPKEY_CLUSTERDETECTOR_MAXCLUSTERDURATION

Maximum cluster duration in seconds.

VT_UI4, Read/write
Minimum: 1, Maximum: any
Default: 300
MFPKEY_CLUSTERDETECTOR_MAXCLUSTERS

Maximum number of clusters to be generated.

VT_UI4, Read/write
Minimum: 1, Maximum: any
Default: 12
MFPKEY_CLUSTERDETECTOR_MINCLUSTERDURATION

Minimum cluster duration in seconds.

VT_UI4, Read/write
Minimum: 1, Maximum: any
Default: 60
MFPKEY_SHOTDETECTOR_ADAPTIVETHRESHOLD

Threshold ratio between the max and second max candidates for selecting shot boundaries. The higher the value, the fewer the shot boundaries. Used only by method A2.

VT_R4, Read/write
Minimum: 1, Maximum: any
Default: 2
MFPKEY_SHOTDETECTOR_ADAPTIVEWINDOWSIZE

Sliding window size in terms of number of frames for the shot detector. All clips must have higher weight than this value.

VT_UI4, Read/write
Minimum: 1, Maximum: any
Default: 10
MFPKEY_SHOTDETECTOR_CLASSIFICATIONMETHOD

Shot detector classification method. 0 = A1 method. 1 = A2 method.

VT_UI2, Read/write
Default: 1
MFPKEY_SHOTDETECTOR_GLOBALTHRESHOLD

Threshold for selecting shot boundaries. The higher the value, the fewer the shot boundaries. Used only by method A1.

VT_R4, Read/write
Minimum: 0, Maximum: any
Default: 0.2
MFPKEY_SHOTDETECTOR_MAXCLIPDURATION

Maximum clip duration in seconds.

VT_R4, Read/write
Minimum: 1, Maximum: any
Default: 300
MFPKEY_SHOTDETECTOR_MAXCLIPSPERHOUR

Maximum number of clips per hour.

VT_UI4, Read/write
Minimum: 1, Maximum: any
Default: 50
MFPKEY_SHOTDETECTOR_MINCLIPDURATION

Minimum clip duration in seconds.

VT_R4, Read/write
Minimum: 0, Maximum: any
Default: 60
MFPKEY_SHOTDETECTOR_MINCLIPWEIGHT

Minimum clip weight.

VT_R4, Read/write
Minimum: 0, Maximum: any
Default: 0.2
MFPKEY_SHOTDETECTOR_PRESERVEMONOCLIPS

Whether to preserve monochrome clips in shot detection. 1 = yes. 0 = no.

VT_BOOL, Read/write
Default: 0
MFPKEY_SHOTDETECTOR_TYPE

Not used.

MFPKEY_THUMBNAILGENERATOR_MAXMOTIONACTIVITY

Maximum motion activity for the thumbnail frame.

VT_R4, Read/write
Minimum: 0, Maximum: any
Default: 20
MFPKEY_THUMBNAILGENERATOR_MINCOLORENTROPY

Minimum color entropy for the thumbnail frame.

VT_R4, Read/write
Minimum:0, Maximum: any
Default: 3
MFPKEY_THUMBNAILGENERATOR_SEARCHWINDOWSIZE

Window size for searching for the thumbnail frame.

VT_UI4, Read/write
Minimum: 1, Maximum: any
Default: 60
MFPKEY_TOCGENERATOR_CLUSTERDETECTOR_ON

Whether the cluster detector is on (1) or off (0).

VT_BOOL, Read/write
Default: 1
MFPKEY_TOCGENERATOR_CURRENTTIME

The time stamp, in 100-nano-second units, of the frame currently being processed.

VT_I8, Read-only
MFPKEY_TOCGENERATOR_FEATUREEXTRACTOR_ON

Whether the feature extractor is on (1) or off (0).

VT_BOOL, Read/write
Default: 0
MFPKEY_TOCGENERATOR_PROCESSEDFRAMES

The number of the frame currently being processed. Frame numbers start at 0 and wrap around to 0 after DWORD - 1.

VT_UI4, Read-only
MFPKEY_TOCGENERATOR_SHOTDETECTOR_ON

Whether the shot detector is on (1) or off (0).

VT_BOOL, Read/write
Default: 1
MFPKEY_TOCGENERATOR_THUMBNAILGENERATOR_ON

Whether the thumbnail generator is on (1) or off (0).

VT_BOOL, Read/write
Default: 1
MFPKEY_TOCGENERATOR_TOCOBJECT

An IToc interface to the generated table of contents.

VT_UNKNOWNL, Read-only
MFPKEY_TOCGENERATOR_TOCREADY

Whether the table of contents is completely generated and ready to retrieve.

VT_BOOL, Read-only
Default: 0

 

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

Wmcodecdsp.h

Library

Wmcodecdspuuid.lib

DLL

Wmvdspa.dll

See also

Table of Contents Parser Objects

 

 

Show: