README
1
2xwave - an audio player, recorder, editor for the XWindow System
3
4 Copyright (C) 1996 Kai Kollmorgen
5 (kkollmor@informatik.uni-rostock.de)
6
7
8 This program is free software; you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation; either version 2 of the License, or
11 (at your option) any later version.
12
13 This program is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
17
18 You should have received a copy of the GNU General Public License
19 along with this program; if not, write to the Free Software
20 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
21
22
23
24This is an alpha release, so be patient.
25Many of the features i wanted to include are not there at this time.
26I have not heavy tested the installation and xwave on different systems,
27so it is possible that xwave will not compile or run on your system.
28
29I have used some libs from other authors, the copyrights and notes are in
30the different directories.
31
32The Userinterface of xwave is based on the Athena Widget Set and some
33Widgets from FWF. The application defaults are optimized for work with
34Xaw3d (replaces the Xaw for 3d look),
35so if you don't use Xaw3d you will probably modify the resources.
36
37Features:
38 - multiple files
39 - overview window
40 - zoom window
41 - mark, cut, copy, paste, merge
42 - echo, reverse, swap, resample, volume (absolute, dynamic
43 compressor)
44 - stop record on demand
45 - raw, wav, au, aiff, aifc (PCM,ALAW,ULAW,ADPCM <- not all
46 implementations)
47 - files of every length
48
49INSTALL:
50
51 - in the xwave directory do a "xmkmf -a" and "make"
52 - if you have problems:
53 - most problems occur while compiling FWF
54 - goto directory "FWF"
55 - edit Makefile
56 - search for 2nd "all::"
57 - before 1st "for" is a "@", this is OK
58 - if before 2nd "for" is also a "@" remove it
59 - if it fails again
60 - on sunsite (and mirrors) are precompiled versions
61 of FWF (i believe in Incomming), get one and install
62 - if its succesfull the executable "xwave" is in "./src"
63 - you have to load the application resource file with the following
64 commands: "cd ./src; xrdb -merge XWave"
65 (or copy "XWave" to "/usr/lib/X11/app-defaults")
66 - then you can start xwave
67
68To do:
69
70 - Documentation
71 - most "Effects" work only with samples in RAM
72 (look at XWave: XWave*maxmem)
73 - Progress report (while cut,copy,paste,echo etc.)
74 - undo
75 - different language support (half done, only have to write some
76 different resource files)
77 - SUN, SGI port (partial done)
78
79BUGS:
80 - marking (in Zoom-Window, and in Main-Window with repeater)
81 doesn't work correct in any cases
82
83Have fun,
84Kai.
85
README-XWAVE2
1
2XWave modified
3--------------
4
5I'm pleased to announce that I have improved XWave wave editor originally
6written by Kai Kollmorgen (kkollmor at informatik.uni-rostock.de) such
7that it actually is usable. The original XWave had a few severe design
8errors making it impossible to use XWave to what it is cabable.
9
10Both freely available MiXViews and DAP are not able to handle large files
11unless your virtual memory is big enough. XWave is cabable for handling
12large waves (45 minutes CD quality audio, for example) and thus it was
13a good idea to improve XWave.
14
15Below you will find a list of changes with usage information and improved
16XWave (XWave2) is available at "http://www.funet.fi/~kouhia/xwave2.tar.gz".
17
18I will continue to improve XWave and use it as a test-bed for routines
19developed for other free wave editors (Audiotechque, KWave, and my Waver).
20
21Yours,
22
23Juhana Kouhia
24kouhia at nic.funet.fi
25
26 -*-
27
28Changes:
29
301.
31
32A selection is now readjustable after it is initially set by "mb1 down,
33pointer move, mb1 up": click mb2 down (and up) and the nearest selection
34edge to the pointer is readjusted to the pointer's location.
35
36Problem: an edge can move only half of the length of the selection at
37a time, i.e., you cannot bring one edge near the other with one click:
38
39 initial selection: | |
40 you click here: *
41 then the first edge don't move, but the second:
42 | |
43
44 You have to do it this way with three clicks:
45 | * |
46 | * |
47 | * |
48 | |
49
50Because of the problem I have no intention to keep this as only selection
51readjustment method. Neither I will take it away because it is a good
52method and deserves its place in a good wave editor.
53
54
552.
56
57It is now possible to play the wave between the pointer and the nearest
58selection edge: press ctrl-mb2.
59
60This fix the problem that the play button plays the whole selection and
61so, it is impossible to both keep the selection and play only at near the
62selection edge when it is fine-tuned.
63
64Because it is also possible to play at outside the selection, you can hear
65if something important is left outside the selection.
66
67
683.
69
70Wave scrollbar movement is made better. Earlier the wave moved in very short
71steps even if clicked (with mb1 and mb3) at far right on the scrollbar. Now
72it moves full window size when clicked at far right, half size when clicked
73at middle, and so on.
74
75When scrollbar was moved with mb2, the waveform jumped to end when we
76were reaching the end of wave. Now the waveform moves without the jump.
77
78Zoom scrollbar is changed such that the zoom ratio is exponential with
79respect to the knob position. Earlier it was linear which caused that
80with large waves (such as 45 minutes of the CD quality) there were zoomings
81either with 1 sample/pixel, 1000 samples/pixel, 2000 samples/pixel and so
82on, but not betweens --- using mb2 it was impossible to get good zoomings.
83
84The reason for why the zooming is started from 1 sample/pixel is simply
85because the waveform drawing is so slow. After speeding up the drawing,
86zooming might be started from where the whole wave is visible, or such.
87
88
894.
90
91Recording level meter is changed to contain both the old maximum level
92meter and the new slowly varying maximum level meter. The old meter was
93updated every N samples (N may be 1024-4096, I don't know). The new meter
94is updated every SLOWMETERFREQ*N samples --- now it is 32*N, and can be
95redefined in recording_dialog.c (however, more slower meter is visually
96unpleasant).
97
98The old meter is in the upper part of the horizontal bar and the new
99meter is in the lower part.
100
101
README.v06
1
2For changes look in "Changelog".
3xwave 0.6 should be much more stable than version 0.5.
4There are still bugs in it, but it has now reached BETA state.
5No new features added. If you want some try coding ;).
6Xwave should now compile on SGI (tried on indy) SUN Solaris and
7FreeBSD. If you want to compile xwave on SGI you must edit the file
8"config.site". On SGI you can play and record files. Recording doesn't
9seem to work perfectly by now. Our Sun machines only have audio devices
10which are capable to play ULAW (or was it ALAW) with 8khz,mono. Therefore you
11can not playing or recording on SUNs with xwave yet. On suns there are still
12some known bugs.
13
14If you need help, for suggestions and bug-reports e-mail
15kkollmor@informatik.uni-rostock.de.
16Have fun,
17Bye Kai.
18
19