SMPTE Wipe Transition
[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]
Note
[Deprecated. This API may be removed from future releases of Windows.]
The SMPTE Wipe transition produces any of the standard wipes defined by the Society of Motion Picture and Television Engineers (SMPTE) in SMPTE document 258M-1993, with the exception of the quad split.
Class ID (CLSID): {DE75D012-7A65-11D2-8CEA-00A0C9441E20}
CLSID Variable Name: CLSID_DxtJpeg
Friendly Name: "DxtJpeg"
Properties
| Property | Type | Default | Description |
|---|---|---|---|
| BorderColor | long | 0x000000 | Color of the border around the edges of the wipe pattern. The value of this attribute is a hexadecimal number with the format 0xRRGGBB, where RR is the red value, GG is the green value, and BB is the blue value. (Thus, pure red, green, and blue are 0xFF000, 0x00FF00, and 0x0000FF, respectively.) |
| BorderSoftness | long | 0 | Width of the blurry region around the edges of the wipe pattern. Specify zero for no blurry region. |
| BorderWidth | long | 0 | Width of the solid border along the edges of the wipe pattern. Specify zero for no border. |
| MaskName | BSTR | NULL | If not NULL, specifies the name of a JPEG file to use as the wipe mask instead of a standard, built-in wipe. The file must contain a monochrome, 8-bits-per-pixel gradient. The gradient is used as a mask to define the wipe's progression. |
| MaskNum | long | 1 | Standard SMPTE wipe code specifying the style of wipe to use. For a list of wipe codes and their associated schematics, see SMPTE document 258M-1993. |
| OffsetX | long | 0 | Horizontal offset of the wipe origin from the center of the image. Valid only for values of MaskNum from 101 to 131. |
| OffsetY | long | 0 | Verical offset of the wipe origin from the center of the image. Valid only for values of MaskNum from 101 to 131. |
| ReplicateX | long | 0 | Number of times to replicate the wipe pattern horizontally. Valid only for values of MaskNum from 101 to 131. |
| ReplicateY | long | 0 | Number of times to replicate the wipe pattern vertically. Valid only for values of MaskNum from 101 to 131. |
| ScaleX | double | 1.0 | Amount by which to stretch the wipe horizontally, as a percentage of the original wipe definition. Valid only for values of MaskNum from 101 to 131. |
| ScaleY | double | 1.0 | Amount by which to stretch the wipe vertically, as a percentage of the original wipe definition. Valid only for values of MaskNum from 101 to 131. |
Remarks
This transition supports the following standard SMPTE wipes:
| Number | Description | Number | Description |
|---|---|---|---|
| 1 | Horizontal | 211 | Radial, left-right, top |
| 2 | Vertical | 212 | Radial, up-down, right |
| 3 | Upper left | 213 | Radial, left-right, top-bottom |
| 4 | Upper right | 214 | Radial, up-down, left-right |
| 5 | Lower right | 221 | Radial, top |
| 6 | Lower left | 222 | Radial, right |
| 7 | Four corners | 223 | Radial, bottom |
| 8 | Four squares | 224 | Radial, left |
| 21 | Barn doors, vertical | 225 | Radial, top clockwise, bottom clockwise |
| 22 | Barn doors, horizontal | 226 | Radial, left clockwise, right clockwise |
| 23 | Top center | 227 | Radial, top clockwise, bottom anticlockwise |
| 24 | Right center | 228 | Radial, left clockwise, right anticlockwise |
| 25 | Bottom center | 231 | Radial, top split |
| 26 | Left center | 232 | Radial, right split |
| 41 | Diagonal, NW to SE | 233 | Radial, bottom split |
| 42 | Diagonal, NE to SW | 234 | Radial, left split |
| 43 | Triangles, top/bottom | 235 | Radial, top-bottom split |
| 44 | Triangles, left/right | 236 | Radial, left-right split |
| 45 | Diagonal stripe, SW to NE | 241 | Radial, top-left corner |
| 46 | Diagonal stripe, NW to SE | 242 | Radial, bottom-left corner |
| 47 | Cross | 243 | Radial, bottom-right corner |
| 48 | Diamond Box | 244 | Radial, top-right corner |
| 61 | Wedge, top | 245 | Radial, top-left, bottom-right |
| 62 | Wedge, right | 246 | Radial, bottom-left, top-right |
| 63 | Wedge, bottom | 251 | Center radial, top |
| 64 | Wedge, left | 252 | Center radial, left |
| 65 | V | 253 | Center radial, bottom |
| 66 | V, right | 254 | Center radial, right |
| 67 | V, inverted | 261 | Box radial, right |
| 68 | V, left | 262 | Box radial, top |
| 71 | Sawtooth, left | 263 | Center radial, top, bottom |
| 72 | Sawtooth, top | 264 | Center radial, left, right |
| 73 | Sawtooth, vertical | 301 | Matrix, horizontal |
| 74 | Sawtooth, horizontal | 302 | Matrix, vertical |
| 101 | Box | 303 | Matrix, diagonal, top-left |
| 102 | Diamond | 304 | Matrix, diagonal, top-right |
| 103 | Triangle, up | 305 | Matrix, diagonal, bottom-right |
| 104 | Triangle, right | 306 | Matrix, diagonal, bottom-left |
| 105 | Triangle, bottom | 310 | Matrix, clockwise top-left |
| 106 | Triangle, left | 311 | Matrix, clockwise top-right |
| 107 | Arrow head, up | 312 | Matrix, clockwise bottom-right |
| 108 | Arrow head, right | 313 | Matrix, clockwise bottom-left |
| 109 | Arrow head, down | 314 | Matrix, anticlockwise top-left |
| 110 | Arrow head, left | 315 | Matrix, anticlockwise top-right |
| 111 | Pentagon, up | 316 | Matrix, anticlockwise bottom-right |
| 112 | Pentagon, down | 317 | Matrix, anticlockwise bottom-left |
| 113 | Hexagon | 320 | Matrix, vertical top-left, top-right |
| 114 | Hexagon, rotated | 321 | Matrix, vertical bottom-left, bottom-right |
| 119 | Circle | 322 | Matrix, vertical top-left, bottom-right |
| 120 | Oval, horizontal | 323 | Matrix, vertical bottom-left, top-right |
| 121 | Oval, vertical | 324 | Matrix, horizontal top-left, bottom-left |
| 122 | Eye, horizontal | 325 | Matrix, horizontal top-right, bottom-right |
| 123 | Eye, vertical | 326 | Matrix, horizontal top-left, bottom-right |
| 124 | Rounded rectangle, horizontal | 327 | Matrix, horizontal top-right, bottom-left |
| 125 | Rounded rectangle, vertical | 328 | Matrix, diagonal bottom-left, top-right |
| 127 | 4-point star | 329 | Matrix, diagonal top-left, bottom-right |
| 128 | 4-point star | 340 | Matrix, top double spiral |
| 129 | 6-point star | 341 | Matrix, bottom double spiral |
| 130 | Heart | 342 | Matrix, left double spiral |
| 131 | Keyhole | 343 | Matrix, right double spiral |
| 201 | Radial, 12 o'clock | 344 | Matrix, quad spiral, top-bottom |
| 202 | Radial, 3 o'clock | 345 | Matrix, quad spiral, left-right |
| 203 | Radial, 6 o'clock | 350 | Waterfall, left |
| 204 | Radial, 9 o'clock | 351 | Waterfall, right |
| 205 | Radial, 12 + 6 o'clock | 352 | Waterfall, horizontal, left |
| 206 | Radial, 3 + 9 o'clock | 353 | Waterfall, horizontal, right |
| 207 | Radial, 4-way | 409 | Random mask |