Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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