vPedal Windows SDK
Version 1.0 ( jan 2008 )
Basic Introduction
The vPedal SDK consists of the following components:
1. vpedalsdk.pdf - This basic user documentation. ( the same as this web page )
2. vpedalax.ocx – The standalone ActiveX/COM component that interacts with the vPedal
3. vPedalSDKIEExample.htm – An example of the vPedal SDK used to control a Windows Media Player session from within an IE HTML page. This example makes use of ActiveX events and Javascript.
The SDK has been tested to operate in a Windows 2000, XP and/or Vista environments.
As with all ActiveX/COM components it is required that the component be registered on the end-users machine. You may use the REGSVR32.EXE command to achieve this. Please note the user should be either an Administrator or the REGSVR32.EXE command should beexecuted as an Administrator.
Platforms:
As ActiveX is a widely used platform, the SDK should operate on a vast majority of languages that support event driven ActiveX components including but not limited to VC++, VB.NET, C#, VB5, VB6, IE, Netscape etc. It is also important to note that various platforms have additional security requirements. Internet Explorer does require the user to either accept or override ActiveX security warnings to successfully use this control.
Supported pedals:
USB vPedal - it has been designed only to work with vPedal
ActiveX Events:
The following ActiveX events are exposed to the programmer:
a) OnPlayDown – Gets fired when the play pedal is pushed down.
b) OnPlayUp – Gets fired when the play pedal is released.
c) OnRewindDown – Gets fired when the rewind pedal is pushed down.
d) OnRewindUp – Gets fired when the rewind pedal is released.
e) OnFastForwardDown – Gets fired when the fast forward pedal is pushed down.
f) OnFastForwardUp – Gets fired when the fast forward pedal is released.
g) FastForwardNow – Gets fired ever 500ms if in fast forwarding mode. This is useful to inform the outside application that it should process a fast forwarding incremenet.
h) RewindNow - Gets fired ever 500ms if in rewinding mode. This is useful to inform the outside application that it should process a rewinding increment.
i) FootDown – (Advanced) - Gets fired when any pedal is down specifying the pedal.
j) FootUp – (Advanced) – Gets fired when any pedal is up specifying the pedal.
ActiveX properties:
The following ActiveX properties are exposed to the programmer:
a) Interval – Defaults at 250ms. This is the interval which the control checks for events.
b) isPlaying –(Read Only) - Is True when playing, False when not playing.
c) isRewinding – (Read Only) - Is True when rewinding, False when not rewinding.
d) isFastForwarding (Read Only) – Is True when fast forwarding, False when not fast forwarding.
e) Visible – (Read/Write) – Turns the visible control box on or off.
To list the WMP properties. http://msdn2.microsoft.com/en-us/library/aa917499.aspx
see also http://msdn2.microsoft.com/en-us/library/aa908337.aspx
Disclaimer:
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
Click to get a free copy of the vPedal SDK - by downloading the SDK you are agreeing to the conditions stated above. ( to install rename to .exe - 439kb )
to contact us for further support
sdk@vpedal.com
Notes:
On Streaming Media:
If you are linking to Streamed Media content only the "play / pause" control will operate until ALL of the file has been buffered. Then the pause back / rewind & fast forward controls will begin to operate. This is a how WMP is designed by MS.
An Alternate solution - " Capture Live Streams" for USD$36.00
Total Recorder Professional Edition can automatically
and periodically "split" the recording, as the recorded file
is being created. So, your user could set Total Recorder to "Split"
the file every 15 minutes. A new split file would then become available
every 15 minutes for typing.
A number of firms that use this feature now, for this exact purpose. It
allows them to finish a transcription just a few minutes after a webcast
is complete.
Total Recorder creates standard wav file (compressed or uncompressed).They
would just use a foot pedal package to playback the file and transcribe.
Total Recorder Professional Edition costs $35.95 USD. It is available
from the site http:// www.HighCriteria.com
and may be tested, prior to purchase.
C++ Example Code
vPedals are a device that can be used for control of playback and it is easily configured. It is easy to program as you do not need to have any knowledge about physical device interface. vPedals are seem by the OS as a games joystick device
I am providing some codes based on Microsoft Visual C++ 6.0.
1. These codes include “mmsystem.h” to support MultiMedia in your project.
2.You can overwrite WindowProc() function in the window where you want to use FootPedal. (WindowProc function can process all messages that occur in the program)
3. The vPedals only use buttons 1 & 2 , button 1 for Rewind and button 2 for Fast Forward. If you Press the center part of the vPedal the buttons 1 & 2 are engaged simultaneously, for the play command.
The Program is as follows:
WindowProc(UINT message, WPARAM wParam, LPARAM lParam)
{
switch(message)
{
case MM_JOY1BUTTONDOWN: //one of the key is press
if ( (wParam & JOY_BUTTON1) && (wParam & JOY_BUTTON2) )
{
//to perform the play function
}
else if ( (UINT) wParam & JOY_BUTTON1 )
{
//to perform the rewind function
}
else if ( (UINT) wParam & JOY_BUTTON2 )
{
//to perform the fast forward function
}
break;
case WM_DESTROY:
// before closing the program window, Release capture on the joystick joyReleaseCapture( JOYSTICKID1 );
break;
}
}
