MAXScript Tools and Interaction with 3ds Max > Creating MAXScript Tools > ActiveX Controls in MAXScript Rollouts > Typical ActiveX Controls > Windows Media Player ActiveX Control >

# Windows Media Player ActiveX Control

    "AMovie (Microsoft ActiveMovie Control)?-0" {05589FA1-C356-11CE-BF01-00AA0055595A}

Note

ActiveX Controls have been deprecated by Microsoft in the latest versions of the Windows operating system in favor of the DotNet framework and its controls.

While MAXScript still supports ActiveX controls, these have to be installed and registered on the system to be accessible to MAXScript.

As a replacement of ActiveX controls, MAXScript supports DotNet controls in 3ds Max 9 and higher.

Properties

    .ImageSourceWidth : integer, read-only

Returns the width of the image source as integer.

    .ImageSourceHeight : integer, read-only

Returns the height of the image source as integer.

    .Author : string, read-only

Returns the name of the author of the of source as string.

    .Title : string, read-only

Returns the title if the image source as string.

    .Copyright : string, read-only

Returns the copyright notice of the image source as string.

    .Description : string, read-only

Returns the description of the image source as string.

    .Rating : string, read-only

Returns the rating of the image source as string.

    .FileName : string

Returns the file name of the image source as string.

    .Duration : float, read-only

Returns the duration of the video stream as float.

    .CurrentPosition : float

Get/Set the current position of the video stream as float.

    .PlayCount : integer

Get/Set the play count (number of times to repeat the playback) as integer.

    .SelectionStart : float

Get/Set the selection start as float.

    .SelectionEnd : float

Get/Set the selection end as float.

    .CurrentState : StateConstants( #amvNotLoaded | #amvStopped | #amvPaused | #amvRunning), read-only

Returns the current state of the Media Player.

    .Rate : float

Get/Set the playback rate as a float.

    .Volume : integer

Get/Set the audio volume as float.

    .Balance : integer

Get/Set the audio balance as integer.

    .EnableContextMenu : Boolean

Enable/Disable the context menu.

    .ShowDisplay : Boolean

Enable/Disable the display.

    .ShowControls : Boolean

Enable/Disable the controls display.

    .ShowPositionControls : Boolean

Enable/Disable the position controls display.

    .ShowSelectionControls : Boolean

Enable/Disable the selection controls display.

    .ShowTracker : Boolean

Enable/Disable the tracker display.

    .EnablePositionControls : Boolean

Enable/Disable the position controls.

    .EnableSelectionControls : Boolean

Enable/Disable the selection controls.

    .EnableTracker : Boolean

Enable/Disable the Tracker.

    .AllowHideDisplay : Boolean

Enable/Disable the display hiding.

    .AllowHideControls : boolean

Enable/Disable the controls hiding.

    .DisplayMode : DisplayModeConstants( #amvTime | #amvFrames )

Get/Set the time/frames display mode.

    .AllowChangeDisplayMode : Boolean

Enable/Disable the changing of the time.frames display mode.

    .FilterGraph : undefined .FilterGraphDispatch : DActiveMovieEvents, read-only .DisplayForeColor : integer

Get/Set the display foreground color as integer.

    .DisplayBackColor : integer

Get/Set the display background color as integer.

    .MovieWindowSize : WindowSizeConstants( #amvOriginalSize | #amvDoubleOriginalSize | #amvOneSixteenthScreen | #amvOneFourthScreen | #amvOneHalfScreen )

Get/Set the movie window size.

    .FullScreenMode : Boolean

Enable/Disable fullscreen mode.

    .AutoStart : boolean

Enable/Disable Auto Start. When true, the movie will repeat playback when the last frame is reached. When false, the movie will not restart.

    .AutoRewind : Boolean

Enable/Disable Auto Rewind. When true, the movie will automatically jump back to the first frame when playback is finished. When false, the movie will remain on the last frame.

    .hWnd : integer, read-only

Returns the Windows handle of the ActiveX control.

    .Appearance : AppearanceConstants( #amvFlat | #amv3D )

Get/Set the appearance of the WMP control.

    .BorderStyle : BorderStyleConstants( #amvNone | #amvFixedSingle )

Get/Set the border style of the WMP control when .Appearance is set to #amvFlat .

    .Enabled : Boolean

Enable/Disable the WMP control.

    .ReadyState : ReadyStateConstants( #amvUninitialized | #amvLoading | #amvInteractive | #amvComplete ), read-only

Returns the Ready state of the WMP control.

    .MediaPlayer : DActiveMovieEvents

Returns a DActiveMovieEvents object with the following methods:

## .MediaPlayer DActiveMovieEvents Methods

    .StateChange oldState:integer newState:integer

Change the state of the Player.

    .PositionChange oldPosition:float newPosition:float

Change the position of the Player.

    .Timer()

Call the timer.

    .OpenComplete()

Set the open state to complete.

    .Click()

Call the click event handler.

    .DblClick()

Call the double-click event handler.

    .KeyDown KeyCode:integer Shift:integer

Causes the keyDown event handler to be executed.

    .KeyUp KeyCode:integer Shift:integer

Causes the keyUp event handler to be executed.

    .KeyPress KeyAscii:integer

Causes the keyPress event handler to be executed.

    .MouseDown Button:integer Shift:integer x:OLE_XPOS_PIXELS y:OLE_YPOS_PIXELS

Causes the MouseDown event handler to be executed.

    .MouseMove Button:integer Shift:integer x:OLE_XPOS_PIXELS y:OLE_YPOS_PIXELS

Causes the MouseMove event handler to be executed.

    .MouseUp Button:integer Shift:integer x:OLE_XPOS_PIXELS y:OLE_YPOS_PIXELS

Causes the MouseUp event handler to be executed.

    .Error SCode:integer Description:string Source:string CancelDisplay:Boolean

Causes the Error event handler to be executed.

Methods

    .AboutBox()

Open the About box.

    .Run()

Start Playback.

    .Pause()

Pause Playback.

    .Stop()

Stop Playback.

    .IsSoundCardEnabled()

Returns true if the Sound Card is enabled, false otherwise.

Events

    on <control_name> StateChange oldState:integer newState:integer do ( ... )

Called when the Player's state has changed. The arguments oldState and newState will contain the state before and after the change.

    on <control_name> PositionChange oldPosition:float newPosition:float do ( ... )

Called when the Player's position has changed. The arguments oldState and newState will contain the position before and after the change.

    on <control_name> Timer do ( ... )

Called when the Timer has changed.

    on <control_name> OpenComplete do ( ... )

Called when the a loading of a new video stream has finished.

    on <control_name> Click do ( ... )

Called when the user clicked the control.

    on <control_name> DblClick do ( ... )

Called when the user double-clicked the control.

    on <control_name> KeyDown KeyCode:integer Shift:integer do ( ... )

Called when the user pressed down a key.

    on <control_name> KeyUp KeyCode:integer Shift:integer do ( ... )

Called when the user released a key.

    on <control_name> KeyPress KeyAscii:integer do ( ... )

Called when the user pressed a key.

    on <control_name> MouseDown Button:integer Shift:integer x:OLE_XPOS_PIXELS y:OLE_YPOS_PIXELS do ( ... )

Called when the user pressed a mouse button over the Control.

    on <control_name> MouseMove Button:integer Shift:integer x:OLE_XPOS_PIXELS y:OLE_YPOS_PIXELS do ( ... )

Called when the user moved the mouse over the Control.

    on <control_name> MouseUp Button:integer Shift:integer x:OLE_XPOS_PIXELS y:OLE_YPOS_PIXELS do ( ... )

Called when the user released a mouse button over the Control.

    on <control_name> Error SCode:integer Description:string Source:string CancelDisplay:boolean do ( ... )

Called when an error has occurred.

    on <control_name> DisplayModeChange do ( ... )

Called when the display mode has changed.

    on <control_name> ReadyStateChange ReadyState:ReadyStateConstants( #amvUninitialized | #amvLoading | #amvInteractive | #amvComplete ) do ( ... )

Called when the ready state has changed.

    on <control_name> ScriptCommand bstrType:string bstrText:string do ( ... )

#### See Also

- Windows Media Player ActiveX Control Example

- ActiveX Controls in MAXScript Rollouts