| Home | Download | Forum | Bug Tracker

|  | 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
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

Control Styles
fixratio
hgradient
vgradient
/xdid Flags
-a
-c
-V
$xdid() Properties
brange
crange
currentpos
duration
fname
hrange
isloaded
size
srange
state
video
volume
Events
help
rbdown
rbup
rclick

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