CERES3CERES3CERES3CERES3CERES3CERES3CERES3CERES3CERES3CERES3CERES3

====================What's new in ceres3===================
Ceres3 is a simple cut-and-paste spectral sound editor. It contains 
further modifications and enhancements to the functionality of 
programs ceres and ceres2. It works on SGI, LINUX and LINUX_PPC.
Ceres3 is almost entirely based on the pioneering work of F.Richard 
Moore, Oyvind Hammer and Jonathan Lee and the free availability of 
their code for educational purpose. This program, even though just a 
a work in progress already deals with musical challenge.
/*
Ceres3 is a free program and therefore comes with absolutely
NO WARRANTY. PLEASE, USE IT AT YOUR OWN RISK!
*/
====================Release Notes=============================
This is an all-platform test release. It contains more files than you
will actually need. Please don't hesitate to trash those bin directories
which have nothing to do with your specific platform.However, your bin
directory also contains icons, schemes and app-default files.

You will find the binary in the ./bin_<your_platform> directory. It is
named ceres3. Start it by double clicking its icon or using command 
line arrguments (they are optional):
 
	ceres3 fft_size window_size window_step image_size
If it does not launch, recompile it from source by typing:
make -f <your_platform_makefile>

===================Installation=============================
Please read your platform-specific ReadMe file.

===================How to use the program===================
Please visit or download the ceres3-help page at:

http://www.music.columbia.edu/~stanko/About_Ceres3.html


===================Recent Additions & Fixes=================
===================0.27a8 New additions=====================
1.  22.05, 44.1k and 48k samling rate supported
2.  24 and 32 bit files supported
3.  stereo in-files supported
4.  experimental MacOSX/Darwin port with X11R6
5.  tichstuff support for MacOSX
6.  scrollbar complaints in stderr fixed
7.  audio-file and playback calls separated for portability
8.  a nasty phase error bug in overlap-add fixed
9.  current preview added (SGI)
10. Kjetil Mattheusen's fast oscbank (for non-SGI) implemented
11. fundamental extraction on time-segment of edit area
12. fft size can be chosen from menu for the first analysis
13. online display & window size & overlap selection
14. window size entry in terms of pitch and frequency
15. paint interactive with edit areas
16. blank program startup
===================0.26r4 New additions=====================
1. FFT import greatly improved
2. Tracking Filter from array fixed
3. Paint filter inaccuracies and bugs fixed
4. Default playback engine can be set through a compile flag
===================0.26b7 New additions=====================
1. File info in load file box
2. All Transform commands area dependant
3. Re-written NullPhase
4. Help things rewritten
5. Gain accepts negative values
6. Inventor export and pbm import improved
===================0.26a4 New additions=====================
1. Noisy spectra fundamental extraction in Edit>Extract
2. Warp command (new) in Transform menu
3. Console messages debugged
4. Arbitrary playback engine name in Settings>FFT/Play
===================0.26d4 New additions=====================
1. Export and import of IRCAM format FFT analysis text files
2. Fundamental extraction to control graph
3. Source-filter cross-synthesis
===================0.25.2 New additions=====================
1. Ask on quit dialog added.
2. A bug that had rendered the "Spread" menu command unusable 
   has been fixed
3. Complete desktop integration (IRIX version)
===================0.25f1 New additions=====================
1. Unified source code for IRIX, LINUX and LINUX_PPC
2. Resonant filter in TRANSFORM menu
3. IRCAM partials export improved
4. Choice of playback engines on all platforms	
5. Improved scale redraws
====================0.25b20 New additions===================	
1. Control Function import improved.
2. Synthesis treshold for osc-bank implemented.
3. Warning against accidental file overwriting.
4. Help file for Ceres3 completed
5. 16384 FFT size implemented
6. Screen redraws while processing
7. Vertical control function now interacts with almost
	all transform menu items.
====================0.25b18 New additions===================
1. Control function mapping across the diagonal: vertical
	control function will map into second horizontal and vice
	versa, depending on which one is selected in
	SETTINGS>EDIT/DISPLAY. Where: EDIT>CONTROL FUNCTION

2. New scratchpad-analysis can be started without opening a
	file. One can specify analysis length and spectral tem-
	plate (harmonic -on binfreq or white noise). 
	Where: FILE>NEW	
	
3. Minor bug in control function mirror-editing fixed.

====================0.25b16 New additions===================
1. Pitch grid functionality and GUI have been completely 
	re-written for functionallity, versatility, and musicality
	of use:
	-settings dialog box now covers almost all pitch grids one 
	can find in modern western tonalities. One can generate them
	from any of fifty preset modes (including Olivier Messiaen's
	Modes of Limited Transposition),or from user-definable 
	interval check box, or from simple file scripts which can be
	written both as list of frequency or pitch values.
	-FILE SCRIPT EXAMPLE: C3 E3 G3 Bb3 D4 F#4 Ab4 B4
	-for grids that don't repeat on the octave, there is a select-
	able file frequency multiplication option menu in the box.

====================0.25b15 New additions===================
1. Optional fourth command line argument (with which the 
	program is being started from the console) is the 
	graphical image width.

2. Error proof reading of command line arguments:
	If you make a mistake, the program will choose
	the value closest to what's been typed.

3. All the functionallity of the program is organized
	in four menus: FILE, EDIT, TRANSFORM, SETTINGS.

4. All the menu items' which open additional dialog
	boxes have names followed by elypsis (...)

5. Sub-menus:FILE menu has IMPORT and EXPORT sub-menus,
	EDIT menu has PAINT sub-menu. Program can also export
	IRCAM partials.

6. New EDIT menu with undoable COPY, CUT and PASTE items.
	To make UNDO and REDO work, it has to be enabled in:
	SETTINGS>EDIT/DISPLAY/ALLOW UNDO.
	This has been made optional, because backing-up huge
	analysis files to disk takes a while, and you may not
	need it if you exactly know what you are after.

7. PAINT drawings and processing now belong to the EDIT 
	menu and have to be activated in:
	>SETTINGS>EDIT/DISPLAY/ALLOW PAINT.

8. EXTRACT item in EDIT menu:
	It maps the amplitude evnelope of the file or a portion
	of it into either of control functions 1 and 2.
	It also maps the spectral envelope of the file or a 
	portion of it into control function 3 (the vertical one).
	Precision of mapping can be specified in number of points.

9. CONTROL FUNCTION item in EDIT menu:
	Allows the control functions to be edited algorithmically.
	Editing will affect only the control function which has been
	made active in: SETTINGS>EDIT/DISPLAY>EDIT CONTROL FUNCTION #

	The following operations work on all three control functions:
	*** Slide, Scale, Shift, Mirror, Retro, Reset

	Additional operations which work only on control functions
	1 and 2 (the horizontal ones):
	** Add, Multiply, Replicate

10.	Improved functionallity of all TRANSFORM MENU items:
	They either work on the entire file or any area selected in:
	SETTINGS>EDIT/DISPLAY>ACTIVATE/EDIT AREA #.
	(Those areas are square surfaces drawn by dragging mouse
	button#3 across the image window).

11.	SIEVE in the TRANSFORM menu: allows fow "negative" i.e. in
	that mode the program will eliminate selected spectral 
	components instead of keeping them.


12.	SPECTRUM SHAPE in TRANSFORM menu: is a new powerful feature
	for dynamically modifying both spectral average and spectral 
	dynamics.

13. BAND filter in the TRANSFORM menu accepts time-varying
	multi-band filter parameter files.

New format of filter file:
stop  /*- or nothing*/
[ slices ]
( time[0] )
...
...
...
( time[1] )
...
...


14. BREAKPOINT FILTER is a new function which treats control
	functions as frequency plots

15. COMB FILTER is enhanced with lots of dynamic functionality.

16. TRACKING FILTER is a generalized form of interpolating comb-filter,
	with the ability of tracking spectral activity.

17. GAIN is now a dynamic time-varying control with the vartical con-
	trol function acting as equalizer.

18. ANALYSIS SETTINGS WINDOWS
	The program now lets you choose among eight different
	FFT analysis window types (SETTINGS>ANALYSIS)

19. RESYNTHESIS: VARIABLE TIME STRETCH
	In SETTINGS>RESYNTHESIS you can now choose that variable 
	time-stretch amount can be continuously controlled by control
	function 1 (this works with osc-bank).

20. PITCH GRID SETTINGS 
	In SETTINGS>PITCH GRID you can select fifty new preset grid scales:
	Traditional modes button lets you type major, minor or any of the
	old church modes into the neighbouring text-field.
	
	The program will also accept pitch as argument.
	Enharmonic substitutions, such as b#3 or c4, a#5 or bb5 will also work.
	
21. In most of the frequency dependant functions program will also 
	accept pitch as argument.
	
22. Rather complete help file Ceres3_help.html, based on previous and
	more successful attempts by Jonathan Lee and Oyvind Hammer
	
	
==========================KNOWN BUGS:=======================

1. Keyboard shortcuts for the menu functions won't work on SGI
	if NumLock is on.

============================================================

================PREPARING FOR NEXT REREASE:=================

1. Completely independent GUI and command line options.
2. More flexibility in Analysis and FFT settings.

============================================================

Finally, I would like to express my gratitude and respect to the
work of Dr. Oyvind Hammer, Jonathan Lee and F.Richard Moore, 
without who my work wouldn't be possible. They made the CERES, 
CERES2 and phase vocoder programs, and also made their source codes 
publically available. This has an immense pedagogical value, to me,
as well as to anyone else who tried to fiddle around with phase
vocoding. By making this program, I have decided to follow their
examples.
And last but not least, my gratitude to Dr. Brad Garton and Dr. 
Terry Pender of the Columbia University Computer Music Center,
as well as Dave Phillips, for helping me with the Linux port.


Stanko
.
