MMcM
October 13th, 2002, 12:55 PM
An upcoming release of DVDSpy for Girder 3.1 will split the distribution into two archives, one with the sources as now, and one with only the binaries. This will be slightly more work for me and Ron, but should make there be fewer things to keep track of.
This release will also have a new readme file that is more operational than descriptive. I have included excerpts from that file here, adjusted for the older release and its use of text registers. This, together with the current readme file, may be enough to get you unstuck. In particular, where is says see below, look in that file.
Files
These are the files contained in this archive and what purpose they serve.
readme.htm
This file.
DVDSpy.dll
The Girder plug-in proper.
This file must be placed in the Plugins/Hardware/ folder beneath where Girder is installed.
DisplaySpyHook.dll
The Windows hook DLL.
This file must be placed in the same folder where Girder is installed.
DVDSpy.reg
Registry settings for the plug-in.
Run this file to merge its settings into the Windows registry. This will inform the Learn command of DVDSpy Girder events that are not defined within the plug-in itself.
It will also point to the default DVD titles CSV file (see below).
ROTEnable.reg
A registry setting which will allow the DirectX GraphEdit tool to Connect to any application's filter graph.
This file is not needed for normal Girder operation.
event-changes.txt
An outline of the changes to the event naming convention over various releases of this plug-in.
This file is only needed for converting old Girder scripts to a newer version of the plug-in.
MediaSpy.dll
An ActiveX wrapper for DirectShow objects.
This file is needed for spying on DirectShow-based applications, such as Zoom Player, TheaterTek, ShowShifter, and ATI Player. It should be copied to any convenient folder (the Girder installation folder is fine) and self-registered by running regsvr32 MediaSpy.dll.
WMPSpy.dll
A Windows Media Player skins control extension.
This file is needed for spying on Windows Media Player. It should be copied to any convenient folder (the Girder installation folder is fine) and self-registered by running regsvr32 WMPSpy.dll. See below for more information.
WMPSpy.wmz
A Windows Media Player skin that sends events to DVDSpy.
This file (or one like it) is needed for spying on Windows Media Player. It should be copied to the Windows Media Player skins folder, which is usually c:Program FilesWindows Media PlayerSkins. See below for more information.
gen_DVDSpy.dll
A Winamp plugin that sends events to DVDSpy.
This file is needed for spying on Winamp. It should be copied to the Winamp plugins folder, which is usually C:Program FilesWinampPlugins
DVDTitles.csv
A sample DVD titles CSV file.
This file is the database of DVD titles returned by the disc insert event. See below for more information.
DVD2LCD.GIR
A sample Girder script.
This file shows how to use the DVDSpy plug-in with the LCD plug-in to display player status on a 4x20 display.
Getting Started
If you have an LCD or VFD display and the LCD plug-in is installed and working, you can try to display events from player applications using the included same script.
Otherwise, here is a step-by-step procedure for use with an on-screen display.
Copy the DVDSpy files that you see need from the list above.
Download and install the pop-up OSD plug-in if you have not already done so.
Launch Girder.
From the File>Settings... dialog, enable DVDSpy under Hardware Plugins and OSD PopUp under Action Plugins.
Add a new command with Edit>Add Command.
Assign a DVDSpy event to this command.
[list:edbe1061c5]
Do File>Enable Input Devices.
Select DVDSpy from the combo-box to the left of Learn Event.
Click Learn Event.
From the DVDSpy learn list, select an event for a player application that is installed and working. Elapsed time events are a good choice. See below for a list of DVDSpy events.
Click Learn and then Close.
The event that you chose should appear in the "LED" display.
Assign an OSD PopUp action to this command.
Select the Plugins tab from the actions at the bottom of the screen.
Select OSD PopUp from the list beneath that tab.
Click Settings to display the OSD PopUp action settings for the command.
Replace Place text here with [treg5] (or whatever text register is associated with the chosen event -- the same as the digit at the end of the event name).
Click OK.
Launch the chosen player application and start it playing something. You should see a pop-up display when the state changes. If you chose an elapsed time event, this will be every second.
If you do not see anything, you can install the Logger action plugin to see each event. If you do not see any DVDSpy events, then double check the installation of the plug-in and its support files. If you do see events, then double check the OSD PopUp settings.
[/list:u:edbe1061c5]
This release will also have a new readme file that is more operational than descriptive. I have included excerpts from that file here, adjusted for the older release and its use of text registers. This, together with the current readme file, may be enough to get you unstuck. In particular, where is says see below, look in that file.
Files
These are the files contained in this archive and what purpose they serve.
readme.htm
This file.
DVDSpy.dll
The Girder plug-in proper.
This file must be placed in the Plugins/Hardware/ folder beneath where Girder is installed.
DisplaySpyHook.dll
The Windows hook DLL.
This file must be placed in the same folder where Girder is installed.
DVDSpy.reg
Registry settings for the plug-in.
Run this file to merge its settings into the Windows registry. This will inform the Learn command of DVDSpy Girder events that are not defined within the plug-in itself.
It will also point to the default DVD titles CSV file (see below).
ROTEnable.reg
A registry setting which will allow the DirectX GraphEdit tool to Connect to any application's filter graph.
This file is not needed for normal Girder operation.
event-changes.txt
An outline of the changes to the event naming convention over various releases of this plug-in.
This file is only needed for converting old Girder scripts to a newer version of the plug-in.
MediaSpy.dll
An ActiveX wrapper for DirectShow objects.
This file is needed for spying on DirectShow-based applications, such as Zoom Player, TheaterTek, ShowShifter, and ATI Player. It should be copied to any convenient folder (the Girder installation folder is fine) and self-registered by running regsvr32 MediaSpy.dll.
WMPSpy.dll
A Windows Media Player skins control extension.
This file is needed for spying on Windows Media Player. It should be copied to any convenient folder (the Girder installation folder is fine) and self-registered by running regsvr32 WMPSpy.dll. See below for more information.
WMPSpy.wmz
A Windows Media Player skin that sends events to DVDSpy.
This file (or one like it) is needed for spying on Windows Media Player. It should be copied to the Windows Media Player skins folder, which is usually c:Program FilesWindows Media PlayerSkins. See below for more information.
gen_DVDSpy.dll
A Winamp plugin that sends events to DVDSpy.
This file is needed for spying on Winamp. It should be copied to the Winamp plugins folder, which is usually C:Program FilesWinampPlugins
DVDTitles.csv
A sample DVD titles CSV file.
This file is the database of DVD titles returned by the disc insert event. See below for more information.
DVD2LCD.GIR
A sample Girder script.
This file shows how to use the DVDSpy plug-in with the LCD plug-in to display player status on a 4x20 display.
Getting Started
If you have an LCD or VFD display and the LCD plug-in is installed and working, you can try to display events from player applications using the included same script.
Otherwise, here is a step-by-step procedure for use with an on-screen display.
Copy the DVDSpy files that you see need from the list above.
Download and install the pop-up OSD plug-in if you have not already done so.
Launch Girder.
From the File>Settings... dialog, enable DVDSpy under Hardware Plugins and OSD PopUp under Action Plugins.
Add a new command with Edit>Add Command.
Assign a DVDSpy event to this command.
[list:edbe1061c5]
Do File>Enable Input Devices.
Select DVDSpy from the combo-box to the left of Learn Event.
Click Learn Event.
From the DVDSpy learn list, select an event for a player application that is installed and working. Elapsed time events are a good choice. See below for a list of DVDSpy events.
Click Learn and then Close.
The event that you chose should appear in the "LED" display.
Assign an OSD PopUp action to this command.
Select the Plugins tab from the actions at the bottom of the screen.
Select OSD PopUp from the list beneath that tab.
Click Settings to display the OSD PopUp action settings for the command.
Replace Place text here with [treg5] (or whatever text register is associated with the chosen event -- the same as the digit at the end of the event name).
Click OK.
Launch the chosen player application and start it playing something. You should see a pop-up display when the state changes. If you chose an elapsed time event, this will be every second.
If you do not see anything, you can install the Logger action plugin to see each event. If you do not see any DVDSpy events, then double check the installation of the plug-in and its support files. If you do see events, then double check the OSD PopUp settings.
[/list:u:edbe1061c5]