DCX - Dialog Control Xtension
v1.4.0
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
Returnnofile 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

Contact 2005-2007 Last Updated: 25th December, 07

Valid XHTML 1.0 Transitional Valid CSS!