YADTV/2 version 1.25 -------------------- *************************************************** PLEASE NOTE - my E-Mail address has changed to lsunley@mb.sympatico.ca *************************************************** Known Problems --------------- When the application is used with the Fast Movie Machine card and the Kirchhoff&Grill driver, there is no sound output from the application. The Ampmix sound control code does not work with SoundBlaster cards. I believe that is caused by the SoundBlaster card driver not supporting the MCI mixer command set. The following two limitations are caused by the standard Warp 4 "Digitalvideo Media Control Device" A replacement for this Media Control Device called "Digital TV" has resolved the problems. Please use the "Digital TV" MCD rather than the standard IBM "Digitalvideo" ------------------------------------------------------ Occasionally the program will not appear to process the event for "TV ON" or "Tuner On" or turn on the TV when a preset station is selected. There is a problem with the application obtaining a valid instance of the TV card driver. When this happens the "turn on" action is aborted and nothing happens. The text in the button will change to "Try Again". If this occurs just press the button again and the TV or Tuner should turn on. If the MCI button is pressed while the TV or the Tuner are turned on the number of video in connectors will not be reported correctly. This is related to the problem with occasional failures to turn on the TV or Tuner when the other function is active. ------------------------------------------------------- Revision Notes -------------- CHANGES in version 1.28 Corrected handling of "Finetune" setting so that saved tuning settings take effect when the channel is selected from the saved list. CHANGES in version 1.26 Corrected an error where the current instance of the TV was not obtained prior to issue of a command to Mute/UnMute the TV sound output. "Hints" were missing for the Audio Connector (AC) control and for the "Volume Device" controls. CHANGES in version 1,25 Corrected an error that caused multiple versions of channel settings to be saved in the yadtv2.ini file. (introduced in version 1.24) CHANGES in version 1.24 A new control for the Audio Connector in the Hauppauge Wincast/TV cards has been added. CHANGES in version 1.23 Miscellaneous code clean up and support for the new "Digital TV" Media Control Device CHANGES in version 1.22 The MCI information has been expanded to include a test for the presence of AFC capability and the presence of TELETEX capability. CHANGES in version 1.21 A new button "Video ON/OFF" has been added to the screen. This button lets you turn the video display off and on when the TV is turned on. The button has no effect when the TV is turned off or when the Tuner is on. The dialog screen now has "Minimize" and "Maximize" control buttons on the top right corner. The program will now reset the Hauppauge cards to the "test pattern" connector when the TV is turned off. This depends on the capability in driver version 1.040B and later that provides access to the "Test pattern" video in connector number 4. When the TV or the Tuner is turned on the window title now shows the product name for the video capture card. All controls now test for an active connection to the video device. If one is not present the controls do not operate. CHANGES in version 1.20 "Hints" are now displayed in a field at the bottom of the dialog box when the cursor is held over a control on the dialog box. If the application does not obtain a valid driver instance during the "open device" processing the open action is terminated without an error message. The button text will change to "TRY Again". CHANGES in version 1.19 The program now has an "MCI" button that will display the MCI interface capability information for the digitalvideo device selected. CHANGES in version 1.18 The program now generates a random alias name for the Digitalvideo device each time the TV or the TUNER are turned on. This eliminated some errors with assigning the video in connectors. The Channel Selector spin wheel now cycles through the channels when the high and low channels are passed. The Frequency field now shows the tuned frequency when the channel is changed. CHANGES in version 1.17 The program will now scan for ALL the Digitalvideo devices installed that support a TV tuner. This may correct some problems when people have more than one tuner capable device installed. Earlier versions of the program stopped scanning after locating the first tuner capable device. The sound volume handling has been changed to use the Ampmix device that is connected to the Wincast/TV card through the default wave stream connection. There is now a 'check box' for 'Use MasterAudio' just below the volume slider. When this box is checked the volume control and 'Mute' button use the Master Audio Volume control for setting the volume and muting the sound output. CHANGES in version 1.16 The program dialog will stay open when the "TV Off" or "Tuner Off" button is pressed. The "Channel" control will now allow the entry of the channel number for the tuner. The channel number is validated during entry, this prevents the user from entering a channel number that starts with a digit lower than the lowest valid channel number unless the field is "selected" (all digits highlighted). The "Channel" control would allow the channel selection to be outside of the range for the selected Region File. The program now tests for the Region File channel range for any change in the channel setting. CHANGES in version 1.15 Added a "Mute" control button. This will only work with some TV card drivers. CHANGES in version 1.14 The AFC control was changed to detect the absence of AFC capability on the TV tuner and change the legend on the button to "NO AFC" if the button is used to turn on AFC. If the program fails to turn on the 'line in' connector on the TV card, no error message is output. CHANGES in version 1.13 Change made to correct an error message when the "line in" connector for audio is enabled and the command fails. The program would report a failure to enable the "video in" connector. CHANGES in version 1.12 The program would always show a "Digitalvideo03" device as a device with a TV tuner. When the YADTV/2 application was closed using the system menu and the TV or Tuner were not turned on the program would display "invalid device" messages. CHANGES in version 1.11 The "Size" buttons now include an X4 size. With an NTSC signal the X4 button will provide a 640X480 display image. This is the maximum image size that can be displayed. This button will only display a good image if it is used with the WCAST.SYS version 1.030M or later. This version of the driver also corrects some problems with MCI image handling that occur with drivers later than version 1.021J. When the "Presets" button is pressed the TV will be turned on if it is in the off state. Version 1.10 was not released. Minor bug fixes that I can't remember any more. CHANGES in version 1.09 The code that scans for digital video devices with tuner support has been changed. The code had a bug that would work with a developer's kit version of mdm.dll but had problems with the Warp4 release of mdm.dll. The program would display 'connector type not supported messages' CHANGES in Version 1.08 The program now has a "Tuner" mode. This mode adjusts the tuning for the card but does not display the monitor window. This mode is intended to be used with an application that displays the video from the capture card but does not have a method of setting the tuner channel or connector. An example of this type of application is the VideoIn recorder (SWVR.EXE) shipped with the Warp 4 BonusPak. This mode will NOT work with the MainActor/2 version 2.06 beta. This application acquires the video capture device in exclusive mode, and no other application can access the device through the MCI interface. The program now uses a different technique for calculating the display size for the X1, X2, and X3 display size buttons. It should maintain the proper aspect ratio. CHANGES in Version 1.07 The Presets window now has a menu "View" that allows you change the container view to "Column" (the default) or "Details". The Details view shows all the parameters saved for each Preset Channel. The "Presets" button will now turn the TV on if it is not already turned on. The MultiMedia Setup section is updates with information on using the VXPVAR command to set the TUNERTYPE. If you are not able to change channels with the application please read this section and try changing the TUNERTYPE value. CHANGES in Version 1.06 The display of the video image and the output of sound from the video capture card is now suppressed when the YADTV/2 TV is turned off. This has been tested with version 1.020X of the WCAST driver. If you have an earlier version please download the newer version from http://www.wdi.co.uk/os2tv/download.htm NOTE - the version number on the download page is not always changed when a new driver is available. NOTE - The default settings from the Multimedia setup notebook may be set to bring the TV card up in a state where it is tuned into a channel with the sound turned on. If you have this problem - change the settings in the multimedia setup to default to the test pattern. The program dialog now exits when the TV Off button is pressed. This change was required to ensure that the suppression of the video image display would work. There is an now an AFC control button. This button turns the tuner AFC function on and off. The button text changes to indicate the state of the AFC control. There is now a "Save" button. This button saves the current settings in a data file. When the button is pressed a dialog is displayed that allows you to view the channel settings that have been saved. There is now a "Presets" button. This button displays a dialog that allows you to view the channel settings that have been saved. Selecting one of the Settings in the dialog will set the TV controls to the values for that Setting. The program now supports saving and selecting of channel settings. The program records these settings in the file \mmos2\yadtv2.ini The file contains a record for each combination of channel, connector, and region file name. The fields stored are: Channel Connector Region Finetune Brightness Contrast Hue Saturation Size AFC Volume There is no way to remove a record from the file in the program. You can edit the file with any text editor and remove the lines you don't want. The file is an ascii text file. The first record in the file is used as the default setting when the TV is turned on. The yadtv2.ini file is saved when the TV is turned off. There is a "Scan" button. This button opens a dialog box that will do a channel scan. Right now the program does not save the results of the scan. CHANGES in Version 1.05 The program now displays the current channel as the Title on the monitor window. The MULTIMEDIA SETUP NOTEBOOK section in this readme file describes the method for aligning the displayed video image with the monitor window. CHANGES in version 1.04 Volume control slider now sets the master sound volume. This bypasses the limitation of the WCAST driver's inability to control the sound level. The original volume setting will be restored when the YADTV/2 application exits. DESCRIPTION This application uses the Abbotsbury Wincast/TV driver GRADD direct draw to display the TV picture. You must have a GRADD video driver installed to use the application. You can obtain the device driver from http://www.wdi.co.uk/os2tv/download.htm Plase refer to the GRADD.DOC file in the driver kit to set up your installation to use the GRADD direct draw. CONFIG.SYS example for GRADD setup (using MGAGRADD) the VCAFILT entry in the C1 variable is the Wincast/TV GRADD driver. DEVICE=C:\MMOS2\WCAST.SYS /T=WCAST /F='C:\MMOS2\WCAST 1.INI' /N=1 SET GRADD_CHAINS=C1 DEVICE=C:\OS2\GRADD.SYS DEVICE=C:\OS2\MDOS\VMANWIN.SYS SET C1=MGAGRADD,VCAFILT There is no installation routine for the application. Copy YADTV2.EXE to the directory of your choice and set up a program object if you want. The application was created using the DrDialog software written by David C Morrill of the IBM T.J. Watson Research Center. The application uses the MCI (Media Control Interface) routines to access the driver and display the picture. OPERATION The application scans the Digitalvideo devices installed in the system looking for the first device that has TV tuner support. The tuner region files are loaded from the C:\MMOS2\REGION directory. The first one in the list is the default. You will have to select the region each time you run the application. If you want a particular region file to be the first in the list copy it to a.rgn (ie: copy \mmos2\region\usa.rgn \mmos2\region\a.rgn) The default channel setting is obtained from the driver default settings. MULTIMEDIA SETUP NOTEBOOK The VXPVAR command is used to adjust the variables used by the WCAST driver. These parameters are stored in the "WCAST 1.INI" file. --------------------------------------------------------- NOTE - the following problem was corrected in the WCAST driver version 1.021R. The driver initialization routine may not set the variable TUNERTYPE correctly. The value is set to C6 instead of the value C2. You can use the VXPVAR command to set the value by typing the command: VXPVAR WCAST 1 TUNERTYPE C2 The program will show the current value and ask if you want to change it. Answer Yes. When the TUNERTYPE is set incorrectly the application programs using the driver (this includes the multimedia setup notebook) will not be able to change channels on the tuner. NOTE after this command is used the Multimedia setup program must be executed (it's in the system setup folder) for the new value to be saved in the "WCAST 1.INI" file. ------------------------------------------------------------ The settings in the multimedia setup notebook will affect the alignment of the picture in the monitor window. The Align page (3 of 6 with 1.020X) has two sliders for the Display window position. These should be set to 44 horizontal and 16 vertical. Some video drivers may require other settings. Experiment with the values until the display image aligns with the window. When the Multimedia setup notebook and the YADTV application are running at the same time you will have to press the size buttons or move the monitor window to force the video display to the monitor window. Any tuning changes made in the Multimedia setup notebook are not reflected in the YADTV application and vice versa. KNOWN RESTRICTIONS The Volume control slider adjusts the master audio level for all sounds. The current WCAST driver does not support changes to the sound level of the TV card through the MCI interface. There is no help for the application. CONTACT If you have any problems or any questions please feel free to contact me via e-mail at lsunley@canpay.com This is freeware. I make no promises about it's operation and am not responsible for any problems, frustrations, or damages, direct or indirect that result from it's use. PACKAGE CONTENTS read.me - (this file) YADTV2.EXE - Application executable YADTV2.RXX - Listing of the REXX code for the application