DCX - Dialog Control Xtension Home | Translations | Download | Forum | Bug Tracker
v1.3.7
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, notheme, tabstop and transparent apply to all DCX controls.
fixratio The content maintains its aspect ratio. By default, the content fills the control.

/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 Play loop away.
FILENAME Previous filename.

/xdid -c
This lets you control playback of the file.
Syntax:
/xdid -c [DNAME] [ID] [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() 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().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().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().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.

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

Contact © 2005-2006 Last Updated: 14th January, 07

Valid XHTML 1.0 Transitional Valid CSS!