Table of Contents Generator
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.
| Property | Description |
|---|---|
| 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 |
| 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 |
Minimum supported server |
Windows Server 2008 |
Header |
Wmcodecdsp.h |
Library |
Wmcodecdspuuid.lib |
DLL |
Wmvdspa.dll |
See Also
Table of Contents Parser Objects
Send comments about this topic to Microsoft
Build date: 4/7/2010