mirror of
				https://github.com/cookiengineer/audacity
				synced 2025-10-31 22:23:54 +01:00 
			
		
		
		
	
		
			
				
	
	
		
			258 lines
		
	
	
		
			9.9 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
			
		
		
	
	
			258 lines
		
	
	
		
			9.9 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
| README file for Nyquist Version 3.09
 | |
| 28 Dec 2014
 | |
| Roger B. Dannenberg
 | |
| 
 | |
| LICENSE: see license.txt
 | |
| WEB SITE: http://www.cs.cmu.edu/~music/nyquist
 | |
| 
 | |
| INSTALLING NYQUIST
 | |
| ====================
 | |
| You can download pre-compiled versions for Windows and OS X.
 | |
| 
 | |
| You can compile Nyquist from sources for Windows, OS X, linux, and
 | |
| other versions of Unix. For details, see one of these files:
 | |
|  - sys/win/README.txt
 | |
|  - sys/mac/README.txt
 | |
|  - sys/unix/README.txt
 | |
| 
 | |
| 
 | |
| IMPLEMENTATION STATUS
 | |
| =====================
 | |
| 
 | |
| Version 3.09 provides:
 | |
|     Various bug fixes
 | |
|     OS X version is significantly faster
 | |
|     Security features added to limit CPU, memory, file access (default
 | |
|         is still unrestricted; this feature is to protect servers)
 | |
| 
 | |
| Version 3.08 provides:
 | |
|     NyquistIDE opens documentation properly on default browser
 | |
|     NyquistIDE forcefully terminates nyquist process on exit if needed
 | |
|     bug fix for mixed sample rate signal handling, affects many primitives
 | |
|     timed-seq and score-play avoid stack overflow on finely spaced events
 | |
|     sampler() primitive does error checking to avoid infinite loop
 | |
|     
 | |
| Version 3.07 provides:
 | |
|     Bug fixes in NyquistIDE Envelope Editor
 | |
|     NyquistIDE installs symbolic links to lib and demos
 | |
|       directories from nyquist directory (where documentation
 | |
|       is kept) so these folders are not hidden in the app bundle.
 | |
|     Bug fix in quantize and snd-quantize functions. 
 | |
| 
 | |
| Version 3.06 provides:
 | |
|     64-bit architecture support
 | |
|     Access to OGG and FLAC file formats
 | |
|     Updates for MSVC++2010, VS2012, XCode 4.5
 | |
|     This is a deadline-driven release. Expect an update soon.
 | |
| 
 | |
| Version 3.05 provides:
 | |
|     New "UPIC Editor" window in NyquistIDE
 | |
|     Fix to escape backslashes in default windows directory
 | |
|     Fix to other problems with Preferences
 | |
|     Arpeggiator example in nyquist/demos
 | |
| 
 | |
| Version 3.04 provides:
 | |
|     Updates to libraries, including liblo and PortAudio
 | |
|     Documentation uses both syntax SAL and Lisp syntax
 | |
|     Some STK instruments have been added
 | |
|     Build files modified to make 32-bit code even on 64-bit 
 | |
|       architectures (Nyquist only runs in 32-bit mode)
 | |
| Version 3.03 provides:
 | |
|     Bug fix to Markov pattern generator (see make-markov).
 | |
|     Update to current (24-feb-09) liblo library.
 | |
|     Slight change to license.txt to comply wiht two LGPL
 | |
|       library licenses: libsndfile and liblo.
 | |
|     score-sort can sort very big scores now using iterative
 | |
|       merge sort
 | |
| Version 3.02 provides:
 | |
|     Uses libsndfile and recent version of portaudio.
 | |
|     Many bug fixes.
 | |
|     Support & compatibility for Algorithmic Composition (to appear)
 | |
| Version 3.01 provides:
 | |
|     Feedback FM: see fmfb, snd-fmfb and snd-fmfbv
 | |
|     fixed help functions and internal browser window
 | |
|     Documentation mostly using SAL syntax now
 | |
| Version 3.00 provides:
 | |
|     First release supporting SAL syntax
 | |
|     Major revision to documentation (but more to come)
 | |
|     Bug fixes for sustain transformation
 | |
|     Many new STK instruments ported by Pedro Morales
 | |
|     Pedro's sdl music input language
 | |
| Version 2.38 provides:
 | |
|     improved PWL editor
 | |
|     improved preferences dialog
 | |
|     bug fixes in Equalizer editor
 | |
|     additional documentation for demos/plight/drums.lsp
 | |
|     option click or right click on completion list to get help
 | |
|     manual can be displayed in an internal window in jNyqIDE
 | |
| Version 2.37 provides:
 | |
|     fix for byte order on Mac PPC that prevented pianosyn.lsp from loading
 | |
| Version 2.36 provides:
 | |
|     cross-platform browser launching in jNyqIDE
 | |
|     fix search path set by jNyqIDE (OS X-related bug introduced in 2.35)
 | |
|     fix bug in slider update code on OS X
 | |
| Version 2.35 provides:
 | |
|     fix for Open Sound Control under Windows/jNyqIDE
 | |
|     other minor jNyqIDE fixes    
 | |
| Version 2.34 provides:
 | |
|     fix to ^U (send selection to Nyquist) in jNyqIDE
 | |
|     default sound file path for Mac OS X is /tmp
 | |
|     Nyquist exits when EOF detected -- try to make orphans abort
 | |
| Version 2.33 provides:
 | |
|     additional documentation for Open Sound Control
 | |
|         interface and utility programs
 | |
| Version 2.32 provides:
 | |
|     envelope editor in jNyqIDE
 | |
|     EQ editor in jNyqIDE
 | |
|     score editor in jNyqIDE
 | |
|     slider support in Nyquist
 | |
|     OSC (Open Sound Control) interface
 | |
|     OSC test program and serial-to-OSC program
 | |
|     drum machine (as separate download)
 | |
|     jNyqIDE has pop-up menus and per-file menu bars
 | |
| Version 2.31 provides:
 | |
|     new compositional algorithm support in xm.lsp
 | |
|     many bug fixes
 | |
|     MiniMoog emulator
 | |
|     spatialization libraries
 | |
|     sound reversal functions
 | |
|     Dolby Surround encode/decode
 | |
| Version 2.30 provides:
 | |
|     many many changes, bug fixes, enhancements
 | |
|     new Java-based IDE: jnyqide
 | |
|     LPC analysis/synthesis
 | |
|     uses PortAudio for audio I/O
 | |
|     changes for Debian Linux compatibility
 | |
|     new examples in demos
 | |
|     new documentation and html files
 | |
| Version 2.29 provides:
 | |
|     new functions: snd-alpassvc, sndalpassvv, snd-eqbandvvv
 | |
|     corresponding high-level functions in Nyquist
 | |
|     new licenses for both Nyquist and XLISP
 | |
|     new NyqIDE implementation
 | |
|     fixed BUZZ function
 | |
|     various bug and documentation fixes
 | |
| Version 2.28 provides:
 | |
|     include indx.html in doc folder (in files.txt)
 | |
|     fixed compute-default-sound-file in nyquist.lsp to
 | |
|     compute appropriate extension (.wav, .aif)
 | |
|     more code to automate win32 releases
 | |
| Version 2.27 provides:
 | |
|     makefile.lsp now generates sndfn.wcl & sndfn.cl
 | |
|     fix to include snd-pluck and some others omittted from 2.26
 | |
| Version 2.26 provides:
 | |
|     bug fix in sampler, negative frequency handling
 | |
|     guard against out-of-order events in TIMED-SEQ
 | |
|     added FMLFO, an lfo with frequency modulation
 | |
|     added SND-SQRT, S-SQRT, SND-ABS, S-ABS functions
 | |
|     new NyqIDE version with S-PLOT function (!)
 | |
|     NyqIDE has better parsing for paren balancing
 | |
|     NyqIDE upgrade to WindowsXP and Delphi 6
 | |
|     NyqIDE increases input string length maximum
 | |
|     NyqIDE prompts on save conflict
 | |
|     added voice-synthesis demo from Eduardo Miranda
 | |
|     corrected absolute path in demos/pmorales/e2.lsp
 | |
|     minor documentation and indexing improvements
 | |
|     pointer to demo docs goes on start menu now
 | |
| Version 2.25 provides:
 | |
|     new way to provide search path: set *SEARCH-PATH* to a string,
 | |
|     e.g. (SETF *SEARCH-PATH* 
 | |
|     "C:/program files/nyquist/runtime,c:/program files/nyquist/lib")
 | |
|     allowing Nyquist to be run without setting registry.
 | |
| Version 2.24 provides:
 | |
|     text editing for command lines in Linux version
 | |
| Version 2.23 provides:
 | |
|     bug fix in (current-path) for Mac
 | |
|     fixes to some Mac sources corrupted in 2.22
 | |
| Version 2.22 provides:
 | |
|     documentation (HTML) included in release now
 | |
|     bug fix for Mac console output exceeding 32K limit
 | |
|     protection from playing very high sample rates in Win32
 | |
|         (crashes in Windows MME library!)
 | |
|     change s-save to take :endian rather than :swap parameter
 | |
|     pianosyn.lsp runs on the Mac now
 | |
|     demos/examples.lsp generates audio with "normal" sample rates
 | |
| Version 2.21 provides:
 | |
|     s-plot uses gnu-plot in Linux
 | |
|     separation from CVS -- I just couldn't keep beating my head
 | |
|                against the wall
 | |
| Version 2.20 provides:
 | |
|     improved Macintosh support
 | |
| Version 2.19 provides:
 | |
|     integration of Macintosh code (from v2.12)
 | |
|     addition of PLUCK and BUZZ synthesis functions
 | |
| Version 2.18 provides:
 | |
|     bug fix in midifile read routine under Linux
 | |
| Version 2.17 provides:
 | |
|     bug fix for long line input under linux and windows
 | |
|     biquad filters
 | |
|     hzosc osc-tri osc-saw osc-pulse -- new oscillator variants
 | |
|     bug fix for reading in non-AIFF files with 'FORM' headings
 | |
|     extension to s-read to support explicit byte-swap parameter
 | |
| Version 2.16 provides:
 | |
|     bug fix in tables (lookup oscillators and other functions)
 | |
|     Windows GUI version of Nyquist
 | |
| Version 2.15 provides:
 | |
|     port to Linux
 | |
| Version 2.5 provides:
 | |
|     more signal processing functions
 | |
| Version 2.2 provides:
 | |
|         ports to more systems including Win32 (Win95 and NT)
 | |
|         bug fixes
 | |
|         more signal processing functions
 | |
|         improved sound I/O subsystem
 | |
| Version 2.1 provides:
 | |
|         bug fixes
 | |
|         documentation and code for user extensions
 | |
| Version 2.0 provides:
 | |
|         continuous time warps
 | |
|         many more functions
 | |
|         bug fixes
 | |
| 
 | |
| The distribution may contain sources for Nyquist. If not,
 | |
| you got the runtime distribution, and there is a source version
 | |
| available.
 | |
|  
 | |
| A number of "source" files are machine generated, including:
 | |
| -  many .c and .h files that implement signal processing functions.
 | |
|         These are generated by translation system that converts
 | |
|         .alg files to .c and .h files.  .alg files give high-level
 | |
|         descriptions of DSP algorithms.  
 | |
| - Makefile.* is generated by "makefile.lsp".
 | |
| 
 | |
| The status is:
 | |
| 
 | |
| System                  Status
 | |
| 
 | |
| RS6K = RS6000, AIX      untested, but used to work
 | |
| NEXT = NeXT 3.0 (Cube)  untested, but worked fine on a previous version
 | |
| SGI = ???               untested, but used to work
 | |
| PMAX = Mach 2.5 on Dec workstation
 | |
|             untested, but worked in previous version
 | |
| SPARC = Sun Sparc ???   untested - previous version of Nyquist DID work
 | |
| LINUX = Linux		tested
 | |
| Win32			tested
 | |
| Mac			tested
 | |
| 
 | |
| If you have problems running Nyquist on a Unix machine, I'd be happy to 
 | |
| help. I can give you advice or if you give me an account, I can log in
 | |
| remotely and install Nyquist for you. If you make corrections yourself,
 | |
| please let me have them so I can put them in the next release.
 | |
| 
 | |
| DIRECTORY STRUCTURE
 | |
| ===================
 | |
| cmt - CMU MIDI Toolkit files, used by Nyquist for MIDI File I/O
 | |
| demos - Nyquist demos go here
 | |
| fft - some fft functions
 | |
| lib - .lsp files offering extensions to Nyquist
 | |
| misc - various files and programs used to implement Nyquist
 | |
| nyqsrc - general Nyquist source code (mostly in C)
 | |
| runtime - the Nyquist and XLisp runtime code (mostly in XLisp)
 | |
| sys - system specific files
 | |
| snd - the sound file, sound input, and sound output package
 | |
| test - test code (this is not maintained and may not be in the release)
 | |
| todo - list of things to do (this may not be in the release)
 | |
| tran - descriptor (.alg) files for machine-translated Nyquist code
 | |
| xlisp - sources for Xlisp (these are linked into Nyquist)
 | |
| 
 |