******************************************************* * Wilma! v2.1 * * * * A Sound Processor for 32-bit Windows * * * * Copyright (c) 2001 by SawTooth * * * * http://members.nbci.com/toothsaw * * * * toothsaw@email.com toothsaw@usa.net * * * ******************************************************* I wrote Wilma to learn about real time sound processing in Windows and how to control the sound mixer. When it became a working program, I decided to make it available to others. Perhaps you will learn a few things about this subject, if you are interested in it too. Wilma has a small tool for recording Buffer timing and traffic which I found very useful. If you are not that terribly interested in 'buffer traffic', you can use Wilma to create Pseudo-Stereo sound from Mono sound using the Wide function, to filter high-frequency noise on a bad signal, or to observe and analyze the frequency spectrum of ANY sound source, including Midi, Wave, MP3 or CD audio. By using the built-in Encoding/Decoding function, you can encode or decode any sound. Features: --------- - Ease of use - Fast and reliable AutoDetection of Nagra-encoded sound - Fast Decoding of mono Nagra-encoded sound - Outputs decoded sound in Stereo, with adjustable 'Wide' setting (30 steps) - FFT Frequency spectrum display of input or output - Option to process un-encoded sound or not (you get the pure original sound) - Twin Chebyshev low pass IIR filters for pre- and post-decoding noise reduction. - 16-bit 44100Hz sampling - Sound processing times and buffer traffic display - Auto Mute - Auto DeSaturate of input signal - Auto Gain for decoded sound - 3 buffer size presets, or user-definable down to 180-bytes buffers (90 samples) - Adjustable thread Priorities - Mixer interface and input sound VU-meter - Toolbar mode - Exclusive 'Transparent Toolbar Mode' when placed on top of an overlay surface. - Multiple language support - Launch applications or send keys to other applications on startup, or via a button - Transmit Decode state to up to 3 applications - Close up to 3 applications on exit Requirements: ------------ - Windows 95/98/ME/NT/2000 - Full duplex Sound card capable of simultaneous recording and playback of 16-bit samples at 44100Hz (Wilma cannot work if the sound card is not capable of this) - Sound output from a TV or TV card, if you want to test it with real encoded sound Command Line syntax: ------------------- Wilma [-QUIT] or Wilma [/q] The Quit (or Q) switch will cause Wilma to close a currently running instance of Wilma. I.e. if you have Wilma already running, and you run 'Wilma -q', you will close Wilma. This is useful if you wish to close Wilma from a batch file. The '-' and '/' separators are optional. Installation: ------------ Just place the following files in a directory of your choice: Wilma.exe WilmaLang.ini language file Wilma.txt help file WilmaWhatsNew.txt new features WilmaFAQ.txt FAQ When you close Wilma, a Wilma.ini file will be created in that directory, containing the program's configuration. You can move those files to any other directory at any time. If you install a new version over an older version I recommend that you delete the old ini file and re-adjust your settings. You can also rename the old exe file and its ini file and have more than one version of Wilma in the same folder. However, you cannot run more than one instance of Wilma at the same time. To place a shortcut to Wilma.exe on your desktop, simply drag its icon from the Explorer window to the desktop with the _Right_ mouse button, then select 'Create Shortcut' from the context menu that opens. To start the application minimized, right click on the shortcut you just created, select 'Properties', then select 'Minimized' in the 'Run' list box. Uninstallation: -------------- Just delete the files in Wilma's directory. Wilma does not write anything in the windows registry. Running Wilma for the first time: -------------------------------- - Press the Settings button, and select the Sound Card mixer and Input to which your TV card's sound output is connected (most probably 'Line-In'). Wilma will let you control the Recording volume and Playback Mute of the selected input, as well as the Playback volume of the Wave output. - Skip to the next section to try the program. If you don't hear sound, check the following : Make sure the Wave Mapper is set to your sound card : Open the 'Multimedia' icon in the windows Control Panel, click the 'Audio' tab, and select your sound card in the 'Preferred device' drop-down list boxes for both Playback and Recording. See the WilmaFAQ.txt file for further questions. Instructions: ------------ - Connect your TV sound output to the Sound card's Line-In input (or run your TV application if you have a TV card). - Make sure Wilma is active (the "Run" button is Green). - Make sure the AutoDetect button is down. - Make sure all volumes are at a reasonably high level, and your speakers are ON. Wilma will automatically detect Nagra encoded sound and decode it. Note: If another sound application (one that records or monitors sound, or plays wave sounds) is running before you run Wilma, Wilma may not be able to open the WaveIn or WaveOut devices. Close the other application, and restart Wilma (simply press the 'Run' button). Note: If you have followed all the above steps and still don't get any sound (or just get noise), it is quite possible that your TV-viewing application is unable to program your TV card properly to produce sound. If your TV card is a WinTV PCI NICAM card you can try the following: a) Put your TV-viewing application in 'mono' mode (if possible) b) Run the following command: rundll32 btviddlg.dll,initialize c) Change channels in you TV-viewing application. You should then have sound. If not, repeat steps b) and c). Program Settings: ---------------- - 'Run' Button: This turns Wilma On or Off. Wilma is completely disabled when you turn it off. When ON, it will continuously capture sound from the WaveIn device, and drive the input's VU-meter. Make sure the input volume is not too high. - 'AutoDetect' Button: When AutoDetect is ON, Wilma will analyze the incoming sound. When an encoded channel is detected, it will automatically decode the incoming sound and play it. It will also mute the original encoded sound (the mixer input line you selected). When you switch to a normal TV-channel, it will stop decoding the sound and un-mute the original sound. You will then hear the TV's unmodified (stereo) sound. Note: AutoDetection is very reliable. If you encounter problems, make sure the incoming sound (VU-meter) is neither too high (<80%), nor too low (>20%). If desperate, you can turn off AutoDetection. - 'Decode' Button: This button will force decoding of the incoming sound. Use this button if you wish to manually turn decoding ON/OFF. To use this button, AutoDetect must be OFF. In this case, you should also manually Mute/Unmute the original sound. - 'Mute' Button: This button will Mute the mixer input line you selected. To use this button, AutoDetect must be OFF. This button is only enabled if you have checked the 'Use Mixer' checkbox, and Wilma has found the Mute control in your mixer. If this button is not enabled, you should use your sound card's mixer application or the Windows standard Mixer to mute the TV input line (e.g. LineIn). * Buffer Preset Buttons: Four Buffer Preset Buttons are available: - 'Small Buffers' Button: Buffer Size: 882 bytes, Default number of Input and Output Buffers: 24 - 'Medium Buffers' Button: Buffer Size: 1764 bytes, Default number of Buffers: 12 - 'Large Buffers' Button: Buffer Size: 3528 bytes, Default number of Buffers: 6 For the above 3 presets, the number of buffers can be modified by pressing the Settings button. - 'User-defined Buffers' Button: This setting allows you to set both the buffer size and the number of input buffers by pressing the Settings button. The Number and Size of Output buffers is identical to that of input buffers. There are a maximum of 100 input and 100 output buffers. Input buffers are mono. Output buffers are stereo. - 'Settings' Button: Pressing this reveals other program settings. - 'Toolbar Mode' Button: Wilma's size can be reduced to a short Toolbar to use up less screen space. You can drag the toolbar to any position using its left or right edges, or even minimize it by clicking...
sumsara