Future work (user requests): X. Add tool to SWAP channels X. Add system resources page X. Warp function (like caliope) X. Allow editing of the info field X. On AVG funciton, allow combination based on percentages X. Add recording capability - Record for specific (MAX) amount of time - Select input - Specify volume X. Drag/Drop capability X. Define script syntax (REXX) X. Find a way to remove the notebook pages for the major tabs X. Reorder the buttons on the control panel X. Integrate MMPM into the editor dialog (maybe) X. Display multiple channels on the edit display. Revision history: Version 1.0: (22 Aug 94) 1. Modified Copy command to only copy a single channel when a single channel is selected. 2. Renamed class to "PMsndX 1.00" (This will have the effect of forcing beta testers to recreate the pmsndx.ini file) 3. Bug. Previously, the length of the start was always added to the end when the clipboard was merged. 4. Bug. Previously, no matter if a selection was specified for a channel or ALL was selected, REMOVE would remove from all channels. 5. Changed the profile operation so that the os2.ini file is only modified when the program is registered. 6. Added examples of the user interface to the help file. 7. Created two help files. The larger file is the default and contains examples of the user interface. smallhlp.hlp is the version of the help without the examples. To use the smaller version, copy it to pmsndx.hlp. Version 0.88: (16 Aug 94) 1. Bug. Oh hey, secondary windows receive a WM_QUIT message when they exit! That caused PMsndX to exit too! The solution? Remove the CLOSE item from the MMPM system menu. 2. Bug. When using the VIBRO function, if the speed was left at zero (0), PMsndX would hang. 3. AUTO DISMISS is now the default for the OPEN and SAVE dialogs. 4. The MMPM button has been renamed to PLAYBACK. 5. Added more updates to the CLOCK pointer so that it does not hang at positions when operations end prematurely. 6. If MMPM is installed it is automatically enabled in the settings box. 7. The default is to save the window positions and the last directory accessed. 8. Removed the REWind button from the MMPM player and reorganized the buttons. 9. Bug. The horizontal sides of the control panel would allow the panel to resize smaller without resizing the buttons. Now, resizing using the horizontal sides just moves the box. Version 0.87: (14 Aug 94) 1. Bug. The average function did not work for 4 channels. 2. Bug. The rate and speed dialogs did not properly manipulate the mouse pointer and it would go from 0 to 2 but no further. Note that there was nothing wrong with the operation other than the mouse pointer did not get updated properly. 3. Bug. When a range was selected for the REVERSE tool, the actual data reversed would be incorrect if the beginning was not at 0.0 offset. 4. Add tool to invert a waveform 5. When PASTING from the clipboard, if the SHIFT key is held down while pressing the PASTE button, the data on the clipboard will be merged instead of pasting. (merge = average 50/50). 6. Bug. When pasting, the old bug for Signed/Unsigned WAV data was found again. Version 0.86: (11 Aug 94) 1. Bug. The Lowpass dialog would not redraw itself after it is uncovered by another window. 2. Bug. If a .WAV file was loaded which contained a bad header, the READ task would hang. 3. If very small files were loaded (e.g. under 100 samples) the clock pointer would stick at the 11:00 position and the open dialog did not receive the signal to close. It appears that the system receives too many posts to the pointer queue and as we all know, OS/2 deletes posts that are duplicated. The solution...force a .1 second delay after the read before sending the update information. 4. Previous versions just BEEPed when an operation was attempted while the current sample was being manipulated. That has been changes so that if an operation is attempted while the data is "busy" an error is displayed. 5. Bug. If the MMPM dialog was dismissed while the MMPM buffers were being loaded, the "busy" flag would not be cleared and no further operations could be done. Version 0.85: (9 Aug 94) 1. Edited virtually all of the dialogs so that they would appear correctly when VGA fonts are used with SVGA displays. (Note, this may be an odd combination, but people use it and I had to make sure that PMsndX displays correctly). Version 0.84: (8 Aug 94) 1. Resized the MMPM dialog (moved the group box, added space between the checkboxes, and increased the width and height of the overall box) 2. Widened the OPEN and SAVE dialog boxes and moved things over to the right to add more space to avoid clipping 3. Bug. When the editor display is updated with a new file, the Vertical Scroll bar (Zoom) would be set to maximum but the actual zoom would be minimized. 4. Bug. When the redraw button on the editor was pressed, the horizontal scroll bar would revert to the leftmost position but the display would remain unchanged. Pressing an arrow would return it to the correct position. 5. The Tools box size has been increased to allow more space between the controls to avoid clipping. On a 1024x768 display the controls looked fine but at VGA resolution they were clipped. a. The Type page previously clipped the IRACAM and SMPVS b. The Average Channels page had the checkboxes touching c. The band-pass filter page clipped the "Add filter noise" d. The low-pass filter page clipped the slider at the top e. The Vibro-champ page had the sliders clipped f. The Fade page was clipped on the right side g. The Limit page clipped the sliders Version 0.83: (7 Aug 94) 1. Fixed up the bitmap displays. 2. PMsndX now checks the MMPM parameters to verify that the sound card can play 16 bit sound samples. If the sound card cannot play 16 bit sounds, then the MMPM player will not load its buffers and will just refuse to play. Version 0.82: (7 Aug 94) 1. In previous versions, if a file was being saved and the program exited, the program would wait indefinitely till the save completed. This could prevent killing PMsndX and would lock the message queue. 2. The MMPM player now displays "Loading Data" when it is filling the data buffers. 3. PMsndX now exits correctly when Ctrl-C is pressed from a command window or when PMsndX is terminated from a task manager. 4. PMsndX now properly terminates all tasks (save and MMPM) when the program exits. In previous versions, the MMPM task for loading buffers was not killed when the program exited or when the MMPM dialog was destroyed. 5. In previous versions I did not save the last position of the windows if the program exited while the windows were open. This was because I saved settings stuff before closing the windows and the windows did not save their positions till they closed. 6. The Toolbox now sets the tabs size based on the resolution of the monitor. This should avoid problems with clipping of text found in previous versions. (David Charlap showed me how to do this effectively) 7. Added hotkeys to the Tools notebook 8. Moved the registration information out of the pmsndx.ini file and into the system user ini file so that a user may use the pmsndx.ini file on any computer or on a network. Version 0.81: (17 Jul 94) 1. Bug. The MMPM reloaded its buffers when the channel to manipulate was changed regardless of the checkbox for global channels 2. Bug. The MMPM reloaded its buffers when the range to manipulate was changed regardless of the checkbox for global range 3. Bug. (Well, not really) The error boxes were not application modal. They are now. 4. A few fixups on the help text. 5. Dialog windows do not move with the main control panel. 6. The welcome dialog box has been changed so that the standard text is greyed and the new stuff is dark to make it easier to read. 7. If the current sample in memory has been modified and the EXIT button is pushed, the program will tell the user that modified buffers exist and verify that the user wants to continue. 8. The Registration box now has the capability to read a file and find the registration information if it has the proper keywords (i.e. if it was a password that I emailed you). 9. Fixed bug in .WAV reader in which an the header was not checked for invalid data and a "divide by 0" error could occur. Version 0.8: (17 Jul 94) 1. Added a menu item to the main control panel to reset the size of the main control panel to the default 2. Bug. When a sample is very short, the Display was not cleared beyond the end of the sample. 3. Bug. When "Play on load" was selected, the new MMPM thread would get triggered by window updates. 4. Bug. The Repeat button on the MMPM box could not be cleared once set without closing down the box and reopening it. 5. Resizable main control panel (what a bear!!!) 6. Fixed windows so that they cannot fall outside of the viewable area 7. Fix the file wildcard usage X. Added HOTKEYS for the main control panel Version 0.7: (13 Jul 94) 1. Added a REGISTRATION button the to Welcome box 2. Completed a little tool (which you will never see) to automatically generate the passwords and store them in a database. This illustrates the power of OS/2 because I completed a fully functional editor in about 1 day. 3. Edit confirmation to the EXIT button 4. .WAV files now skip unknown keywords rather than reporting errors 5. Added another thread to the MMPM player for loading the buffers. 6. Added new BITMAPs for the main control panel when MMPM is not installed. 7. Added a Repeat function to the MMPM playback 8. Finished the BALANCE tool 9. Fix all tasks so that sounds cannot be operated on while another a task is modifying the buffers (i.e. while the buffers are loading for the MMPM, the range selections cannot be made) 10. Added a redraw button the the editor 11. Bug fixed. When the display box was previously selected, the display would receive the mouse movements, but the window would not become the active window. 12. Add the ability to UNDO the last command. This will double the memory requirements and should be in the settings page to disable for users who don't want to lose the memory. 13. The letters "I" and "O" were removed from the passwords to prevent confusion over the number 1 and the letter I and the number 0 and the letter O. 14. Fixed window locations so that they can never fall off the screen. 15. Added MINIMIZE button to the dialogs 16. Bug fixed. VOC files with a type 0x0a marker were not read. Unknown markers are skipped now. 17. Bug/oversight. The Cut button was disabled for ranges even if the program was registered. Note 1: For Beta Testing purposes, use the following to enable all functions Name: "Beta Version Registration" Through Version: 0.99 Password: "cHLttnr0sqypjc2e" To enter the password, select REGISTER on the ABOUT or WELCOME boxes (accessed from the system menu). Version 0.6: (6 Jul 94) 1. Renamed the initialization file from pmsndx03.ini to pmsndx.ini 2. Removed QUALITY factor from the SAMPLING RATE tool 3. Set up a global object which is shared between all dialogs to allow the editor to be the central point of control for selecting the range and channels for operations. 4. Added checkbox to let the user select if he wants to automatically dismiss the save/open dialogs 5. Add "Global range selection" checkbox to MMPM Player 6. Use "Global channel selection" for MMPM player (add checkbox) 7. Add version indicator in the .ini file - (current version) 8. Setup timer to MAIN control panel which propagates to the dialogs 9. Check the size of the clipboard data and warn if it is dissimilar to memory (use smaller of the two after paste) 10. Check the rate of the clipboard data and warn if it is dissimilar to memory 11. When a version is run for the first time, a Welcome dialog is displayed in place of the About box with information about the current version. (The welcome can be redisplayed from the main menu.) 12. Change initial ABOUT box so that it doesn't block the message queue 13. Added info box to indicate whether each tool uses the global objects 14. Use "Global range selection" in place of local display for tools 15. Use "Global channel selection" for the tools 16. Add registration stuff (after 15 minutes of use, guilt!) - Disable all formats except .WAV and .AU if registration fails - Disable individual channel selection on the editor - Disable Range selection for Copy and Cut on the editor Note 1: For Beta Testing purposes, use the following to enable all functions Name: "Beta Version Registration" Through Version: 0.99 Password: "cHLttnr0sqypjc2e" Note 2: The format of the .ini file has not changed. Rename pmsndx03.ini to pmsndx.ini and you will not have to recreate the window locations and settings. Version 0.5: (8 June 94) 1. Finished the Editor 2. Added page in notebook for swapping channels 3. Fixed an error when writing WAVE files with multiple channels Note: The big addition of the editor was a lot of work and is probably not perfect for everyone's needs. Handling of multiple channels is awkward at best, but I think that I have made the most of it. Opinions for improvement are welcome. Read the help page to understand the PASTE operation before using it! The editor has been written such that it does not use the MMPM libraries for the sound manipulations in order to allow it to work on any system. Note 2: The global channel selection is not implemented across all the tools yet. That will be in the next release. Version 0.4a: (4 June 94) 1. Finished the Dupe dialog box in the tools box. 2. Fixed an error with processing the Rate effect when multiple channels are present. 3. Fixed Echo effect to work with multiple channels 4. Fixed Fade effect to work with multiple channels Version 0.4*: (22 May 94) 1. Added support for the MAC HCOM format. Unfortunately the only portions of the header that are implemented are the ones that SOX implements because I could not find examples of the HCOM format and had to create a sample file from a .WAV file using SOX. 2. Added support for the IRCAM format. Again, like the HCOM format, I could not find samples in this format and had to use SOX to create samples for testing. As a result, only the header fields supported by SOX are enabled. 3. Added support for SampleVision (.smp) format. WARNING: This is a wierd format in which the RATE is stored at the end of the file. You may find that when loading this type of file no error is produced but an absurd rate may be displayed in the Info tool page. (Some reasons...SOX10 for OS/2 replaces every CR return (char 13) with a CRLF. I think that the output file was not set to RAW so the file functions were fixing the data up for DOS. By the way, you can fix this up by changing the playback speed (not the rate!!!) to something logical.) 4. Reorganized the toolbox (again) and added place holders for fading and balancing in a sample. This will be added later. 5. Added the user interface for the editor. It is non-functional, but is intended to get feedback on the functions that it will be provided. If you don't like it, now is the time to change it! 6. *** BUG: Fixed bug in display routines for graphs when an absolute value was entered into the start and end fields for the reverse effect. 7. Added fading to the tool box under the major header of VOLUME. Samples can be faded in or out and at different rates. * Note: With this version, all of the functionality of SOX has been completed. From here on out, we are breaking new ground. ** Note: Space is reserved for the Dupe, Fade, and Balance effects, but they have not been implemented and the DOIT button is never enabled. *** The size of the executable is about 300k right now. The good news is that the only major additions will be the code for the clipboard stuff. The program currently has about 18000 lines of C code. I could change over to DLLs to make the actual executable smaller, but the way DLLs work with OS/2, there is no memory savings. If you hate 300k for a program like this, then go back to SOX. Version 0.3e: (27 March 94) NOTE: Since the size of the Open dialog box has changed, PMsndX will not use the window positions or settings from the .ini file. This is to prevent the Open dialog box from being positioned off the screen. 1. Multithreaded the command line playback functions. Previous versions shared the message queue through threads for playback when the control panel was used, but when a sound was played from the command line, all message processing would stop till the file had been played. 2. Fixed the .WAV read/write routines to handle the LIST fields correctly. Previous versions could not deal with the LIST field and returned a error indicating that the file was in a bad style. 3. Changed the .VOC to be able to store the ASCII text string in the info field. 4. Added support for .IFF formats (Amiga). This format has a couple of fields that need mention here. If you read a file in, the ANNO field is discarded and the NAME field is used for the Comment data retained in the files. If a file is written to disk, PMsndX arrogantly writes the "PMsndX ..." into the ANNO field (... is replaced by the version number). 5. The Version number has been changed to reflect the alpha version of the program. In the past changes to the version number changed the name of the profile and resulted in loss of the window positions and settings from previous versions. This has been changed such that the window positions and settings remain active unless a major change is made in the profile information. 6. Added user overrides for the file types when opening files. When a file is opened, if the user specifies a specific filetype (other than Auto), the program will try to open the file in that format. In the event that the filetype is not the type specified, the PMsndX will attempt to determine the file type as if the user had selected "Auto". 7. When the file type is changed through the Tools notebook, the output type is then specified and selected in the file type area of the SAVE dialog box. 8. The default format for saving a file is the same as the input format. 9. A field called "AUTO" has been added to the filetypes. When this button is selected, the file will be saved based on the filename alone. 10. If the filename field is changed, the "AUTO" button will automatically be selected. This is because the file type specified in the buttons will override the extension. As a result, if the user changes the filename and assumes that the file would be saved based on the filename extension, the file could be saved in a different format than the extension indicates. 11. The filename used to load a sample into memory is automatically used as the default filename when saving a file. The path for saving the file remains the last path used for saving the file. 12. Added the .sb (Signed Byte) format. This is a headerless format. If the user selects to load this format, the program must ask the user for the sampling rate before the file can be loaded. Each byte of the file is treated as an 8 bit signed sample. 13. Added the .sw (Signed Word) format. This is a headerless format and the program will request a sampling rate when the user loads this file format. Each word (2 bytes) is treated as a signed word in little endian order. 14. Added the .ub (Unsigned byte) format. This is a headerless format and the program will request a sampling rate when the user loads a file of this format. Each byte is treated as a unsigned byte. 15. Added the .uw (Unsigned word) format. This is a headerless format and the program will request a sampling rate when the user loads a file of this format. Each word (2 bytes) is treated as a unsigned word in little endian order. 16. Added the .ul (Ulaw) format. This is a headerless format and the program will request a sampling rate when the user loads a file of this format. Each byte is treated as a ULAW encoded sample. This format is the same format used for .AU files. 17. The file Open dialog box does not close when the operation is completed. 18. Multithreaded the file open operations. When a file is being read, the user may press the Abort button on the file open dialog box to stop the read process. If the program exits before a file read thread has completed, the read thread is terminated. 19. Multithreaded the file save operations. There is no means provided to abort a save operation. If the program exits when the file is saving, the program will wait till the save operation has completed before exiting. 20. Added support for the Amiga/SGI .aif format. Documentation for this format was hard to find. The only chunk formats I could find were for COMM, and SSND. Version 0.3d: 1. Added use of the second mouse button (usually the right mouse button) for the reverse effect and removed the dynamic sorting of the start and end so that the numbers don't jump back and forth when the user is entering the endpoints. 2. Added support for .VOC file formats. Note: I don't know what the hell SOX is doing, but it does not seem to produce a useable file. I always add an Extended data block to the file. I don't know if this will cause problems, but the extended part contains the number of channels. I don't know what to do with Repeat/End Repeat information so I am currently ignoring it. Any ideas? I currently dump (on the floor) any ASCII text. Anyone want me to keep the stuff in the info field? I currently only load 8 bit data. I cannot deal with packed data right now. It is 1:00am and I am tired. Some programs seem to expect the first block to be the DATA block so I write this first always. Version 0.3c: 1. Added Speed Effect 2. Reorganized the Tools notebook. There were too many tools to display the tabs on the notebook so major and minor pages were created to group the tools. 3. Modified the MMPM support to use a separate region of memory than the samples are stored in. Previously, the memory for storing the playlist was taken out of the pool for storing the samples for the effects. As a result, if you started the MMPM box an performed a effect that took up more memory, a hole would be left such that another block of memory could not be allocated. This method prevents creating the holes. 4. Added Reverse Effect. Version 0.3b: 1. Fixed a big bug in the Bandpass filter. If a sample had multiple channels, it would only bandpass on the first channel. 2. Fixed a big bug in the Lowpass filter. If a sample had multiple channels, it would only lowpass on the first channel. 3. Added the little clock pointer to indicate how much work has been completed. 4. Removed the requirement for the audio device to be a form of WaveAudio??. Any string will work as long as the device really exists. 5. Multi-threaded all of the effects so that the program is not a system hog. The file read/write functions are not multi-threaded. Should they be? Version 0.3a: 1. Fixed the Play button so that it is animated when the sample is played as it is loaded. (What is the longest record for staring at a code before you realize that it is so late that you have been staring at the bug all night and just did not recognize it?...What a dumb error on my part!!!) 2. Fixed the dynamic linking so that DosLoadModule is used rather than linking with the dynamic libraries. Version 0.3 would refuse to run on machines without MMPM installed because the libraries were loaded even if the MMPM support was not enabled. 3. Changed to using SW.DLL for the buttons of the MMPM dialog box. This guarantees that the program will use the latest formats for the buttons. 4. Added command line playing. I the PLAY_ON_LOAD option is selected, any filenames which appear on the command line will be played. If a file is not found, the program will signal an error and continue to the next command line file. If EXIT_AFTER_PLAY is not selected, the last file that was successfully loaded will be the current file in memory. 5. Enabled the EXIT_AFTER_PLAY feature and modified the behaviour such that the MMPM dialog is not displayed during the playback. Version 0.3: 1. Removed the RECORD button (now just a blank button until I can think of something) 2. Changed PLAY button to MMPM and added basic play capabilities (i.e. Play, Stop, Rewind, Pause). 3. Updated Settings dialog to reflect options for the MMPM stuff. Version 0.2: (20 March 94) 1. Fixed error with memory settings. In version 0.1 if you opened the Settings box and then applied it by pressing the DOIT button it sould clear the data samples even if the memory configuration had not changed. 2. Fixed bug in version 0 in which the data was cleared when the memory configuration was changed, but the sample header was not cleared. This led to th dialogs trying to access data that had been released causing a protection violation. 3. Added the Bandpass notebook page. This is probably one of the most complex user interfaces in the notebook. 4. Added the Echo effect. This is the most complex programming challenge for a useable user interface. (Note, the echo only works for single channel samples). 5. Fixed bug. In version 0.1, the lowpass function did not take into account the number of channels. This has a significant impact on the FFT operation. This is fixed in 0.2. 6. Fixed bug. In version 0.1, the Vibro effect did not take into account multiple channels in a sample. As a result, the vibro was not continuous on individual channels. Version 0.1: (13 March 94) 1. Added Channel Averaging (0.1a) 2. Added Vibro effect 3. The .ini file are automatically located in the same directory as the executable. 4. Individual tool pages no longer have separate HELP buttons 5. A HELP button has been added to the tool box for all pages. When pressed, the help page for the page shown in the tools dialog box will be displayed. 6. A DISMISS button has been added to the tools dialog box for a more consistent approach to dismissing. The user can still depress the tools button on the main control panel to dismiss any tool dialog. 7. Rearranged the buttons on the main control panel and added two new buttons for Playing and Recording samples (not implemented in this release...just placeholders) 8. Changed the memory storage requirements so that data takes half as much memory. Each sample is stored as a signed SHORT regardless of the sound type. 9. Corrected major memory bug which resulted in a memory leak. 10. The echo effect presents an interesting challenge to the user interface. How do you provide the user with an intuitive method to set the echo locations and the strength of the echo from a dialog box? My first attempt was to try to display the waveform in a window and then to let the user set the echo points, but the problem of setting the echo strength is still difficult. This operation may have to wait for another revision after I have had some time to "sleep" on it. The effect itself is very simple, but the interface is much more difficult. 0.1a - SOX can averages 4 channels to 1 by putting all four channels into 1. 4 channels to 2 is done by averaging the left channels and the right channels together. PMsndX allows the user to select any combination of the source channels. Version 0.0 (initial release): 1. 6 buttons and associated dialog boxes created 1. Ability to load and save .au files 2. Ability to load and save .wav files 3. Tool for changing the sampling rate (0.0a) 4. Display of information about the current sample 0.0a - SOX appears to use linear approximation to create the new sample. PMsndX provides for quality which allows the approximation to be adjusted.