- Home
- General Usage
- DCX Controls
- DCX Features
- About DCX
|
Directshow |
The DirectShow control allows playback of media files. Formats which can be played will depend upon the codecs avaiable on the system.
|
Control Styles |
These control styles are available when creating a Directshow control. Remember that the general styles disabled, group, hidden, notheme, tabstop and transparent apply to all DCX controls except the embedded Dialog and Window controls. |
fixratio |
The content maintains its aspect ratio. By default, the content fills the control. |
hgradient |
Draws a horizontal gradient with the colors specified. |
vgradient |
Draws a vertical gradient with the colors specified. |
/xdid flags |
Control commands are input to the control with the /xdid command. |
/xdid -a |
This command lets you load and unload any previous file. |
Syntax: |
/xdid -a [DNAME] [ID] [+FLAGS] [FILENAME] |
Example: |
/xdid -a dcx 4 + fileCopy.mpeg |
Parameters: |
+FLAGS |
Previous flags. |
p |
Play right away. |
l |
Loop playback. |
a |
Specifies audio only, no VMR is loaded, no video rendered. |
FILENAME |
Previous filename. |
/xdid -c |
This lets you control playback of the file. |
Syntax: |
/xdid -c [DNAME] [ID] [COMMAND] [ARGS] |
Example: |
/xdid -c dcx 4 play /xdid -c dcx 4 seek 3500
|
Parameters: |
COMMAND |
DirectShow commands. |
play |
Plays the loaded file. |
pause |
Pauses the playback. |
stop |
Stops the playback. |
close |
Close the playback and unload it. |
seek |
Seeks to the millisecond of the clip specified. |
Variable parameters ARGS: |
play |
[FILENAME] |
seek |
[TIME] |
TIME |
The time to seek to, specified in milliseconds. |
/xdid -V |
This command sets the volume or speakerbalance |
Syntax: |
/xdid -V [DNAME] [ID] [+FLAG] [VALUE] |
Example: |
/xdid -V dcx 4 +v 80.00 |
Parameters: |
+FLAG |
Command switches. |
v |
Sets the volume level as a percentage between 0.00 & 100.00 (fractions are valid values). |
$xdid() Properties |
The $xdid identifier is a given mIRC alias that communicates with the DCX DLL to extract information in DCX controls. |
$xdid().brange |
This property returns the range of values that the video brightness can be set to. |
Syntax: |
$xdid(dialog, ID).brange |
Example: |
$xdid(dcx, 4).brange |
Parameters: |
DEFAULT |
The default value. |
MIN |
The minimum value. |
MAX |
The maximum value. |
STEP |
The value to use when changing this property. |
$xdid().crange |
This property returns the range of values that the video contrast can be set to. |
Syntax: |
$xdid(dialog, ID).crange |
Example: |
$xdid(dcx, 4).crange |
Parameters: |
DEFAULT |
The default value. |
MIN |
The minimum value. |
MAX |
The maximum value. |
STEP |
The value to use when changing this property. |
$xdid().currentpos |
This property returns the current position of the content. |
Syntax: |
$xdid(dialog, ID).currentpos |
Example: |
$xdid(dcx, 4).currentpos |
Parameters: |
STATE |
This is D_OK if the command succeeded. Otherwise STATE is D_ERROR. |
RESULT |
The time in milliseconds. If STATE was not D_OK, then RESULT will be the appropriate error message. (ie. Method Not Supported) |
$xdid().duration |
This property returns the length of the media clip. |
Syntax: |
$xdid(dialog, ID).duration |
Example: |
$xdid(dcx, 4).duration |
Parameters: |
STATE |
This is D_OK if the command succeeded. Otherwise STATE is D_ERROR. |
RESULT |
The time in milliseconds. If STATE was not D_OK, then RESULT will be the appropriate error message. (ie. Method Not Supported) |
$xdid().fname |
This property returns the filename of the loaded media (if any). |
Syntax: |
$xdid(dialog, ID).fname |
Example: |
$xdid(dcx, 4).fname |
$xdid().hrange |
This property returns the range of values that the video hue can be set to. |
Syntax: |
$xdid(dialog, ID).hrange |
Example: |
$xdid(dcx, 4).hrange |
Parameters: |
DEFAULT |
The default value. |
MIN |
The minimum value. |
MAX |
The maximum value. |
STEP |
The value to use when changing this property. |
$xdid().isloaded |
This property returns if a file is loaded or not. |
Syntax: |
$xdid(dialog, ID).isloaded |
Example: |
$xdid(dcx, 4).isloaded |
$xdid().size |
This property returns the media size. |
Syntax: |
$xdid(dialog, ID).size |
Example: |
$xdid(dcx, 4).size |
Parameters: |
WIDTH |
Original width of the content. |
HEIGHT |
Original height of the content. |
ARWIDTH |
Aspect ratio width of the content. |
ARHEIGHT |
Aspect ratio height of the content. |
| Note. This returns the media size, not the control size. |
$xdid().srange |
This property returns the range of values that the video saturation can be set to. |
Syntax: |
$xdid(dialog, ID).srange |
Example: |
$xdid(dcx, 4).srange |
Parameters: |
DEFAULT |
The default value. |
MIN |
The minimum value. |
MAX |
The maximum value. |
STEP |
The value to use when changing this property. |
$xdid().state |
This property returns the state of the media file, if any. |
Syntax: |
$xdid(dialog, ID).state |
Example: |
$xdid(dcx, 4).state |
Return | nofile No file has been specified. stopped Stopped state. paused Paused state. playing Currently playing state. unknown Unknown media state. D_ERROR Message Error in determining state of control. |
$xdid().video |
This property returns properties on the video media which can be altered. |
Syntax: |
$xdid(dialog, ID).video |
Example: |
$xdid(dcx, 4).video |
Parameters: |
+FLAGS |
Flags can be any combination of the following. |
b |
The brightness of the video. |
c |
The contrast of the video. |
h |
The hue of the video. |
s |
The saturation of the video. |
$xdid().volume |
This property returns volume percentage as a value between 0.00 and 100.00. |
Syntax: |
$xdid(dialog, ID).volume |
Example: |
$xdid(dcx, 4).volume |
Directshow Events |
These events are fired when activity occurs in the Directshow control. |
help |
Launched when you click on a control using the ? contexthelp button. |
Syntax: |
/cb_alias DNAME help ID |
Example: |
/cb_alias dcx help 4 |
rbdown |
When the right mouse button is pressed. |
Syntax: |
/cb_alias DNAME rbdown ID |
Example: |
/cb_alias dcx rbdown 4 |
rbup |
When the right mouse button is released. |
Syntax: |
/cb_alias DNAME rbup ID |
Example: |
/cb_alias dcx rbup 4 |
rclick |
When the right mouse button is clicked. |
Syntax: |
/cb_alias DNAME rclick ID |
Example: |
/cb_alias dcx rclick 4 |
|