mirror/JUCE
1
0
Fork 0
mirror of https://github.com/juce-framework/JUCE.git synced 2026-01-09 23:34:20 +00:00
Code Activity

Browse source
This commit is contained in:
jules 2007-06-13 08:28:44 +00:00
parent b85f154b4a
commit 94cfda5062
1033 changed files with 413256 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

683
docs/JUCE changelist.txt Normal file
View file

@ -0,0 +1,683 @@
==============================================================================
JUCE version 1.44
==============================================================================
Changelist for version 1.44
- changed the MouseEvent structure so that it now contains a pointer to the event component and also the original component.
- added a PopupMenu::dismissAllActiveMenus() method
- added the JUCE_LOG_ASSERTIONS flag, which can automatically log assertion failures, even in release builds
==============================================================================
Changelist for version 1.43
- I've done a bit of tidying up of the juce tree, moving things like the demo, the jucer, etc into a folder called "extras", and this also now includes the audio plugin code and BinaryBuilder, rather than having those available as separate downloads.
- native menu bar support for the Mac! See MenuBarModel::setMacMainMenu().
- a few changes to the MenuBarModel class and MenuBarComponent - the model object now has listeners, and when a menu changes, you should call MenuBarModel::menuItemsChanged() rather than calling the old equivalent method on the bar component. Also, the MenuBarModel virtual methods have changed slightly and no longer have a menu bar component as one of their parameters. One other related change is that DocumentWindow::setMenuBar() no longer takes a command manager - you should register the command manager directly using MenuBarModel::setApplicationCommandManagerToWatch
- horizontal mouse-wheel support - this involves a change to the Component::mouseWheelMove method, to add an extra parameter. If you've got existing code that uses the old form of this method, it should fail to compile with an error, and you just need to tweak it to add the new parameter
- sorted out some problems with the jucer's colour swatch menus
- fixes for AudioDeviceManager forgetting channel selection
- added a textCharacter member to the KeyPress class - this allows a unicode printing character to be stored separately from the keycode.
- added support for extra numeric keypad keys like add, subtract etc, and F13-F16
- added a radio group ID field to buttons in the jucer
- renamed TaskbarIconComponent as SystemTrayIconComponent to make it more obvious what it does, and added support for tray icons on linux (thanks to kraken for the code for that one)
- new class: ChannelRemappingAudioSource, which lets you take a source and remap its input and output channels.
- some tweaks to the Time functions on win32 to make them slightly more efficient
- new method: Slider::setIncDecButtonsDraggable(), which adds a hybrid click/drag mode to the inc/dec button slider
- added some linux-specific methods for creating new midi in/out devices (ta to kraken)
==============================================================================
Changelist for version 1.42
- jucer: fix for crash when trying to add items to a button
- optimisation for UndoManager when there's a lot of items
- added multiple file selection as an option for the FileChooser (using native dialogs, not yet juce file browsers)
- added some colour IDs for rotary slider colours
- new method: PopupMenu::addSectionHeader()
- tweaked the way that options are passed to the PropertiesFile constructor, and added an option to save the file as XML.
- new method: Slider::setSkewFactorFromMidPoint()
- jucer: added an option to specify a virtual parent class for components, so that you can edit a component of your own class using a built-in type (e.g. edit your own slider subclass using the slider class). Thanks to kraken for this idea.
- plugins: added support for current-program-only settings to be saved for VSTs
- changes to the way events are dispatched on the mac, to make use of mouse-tracking. This was necessary to avoid problems embedding HIViews in juce windows, and hopefully shouldn't cause any problems anywhere else in the code
- altered the way Files are stored internally to avoid ambiguity between "/" (on mac/linux) and File::nonexistent. Previously all files were stored without a trailing slash, but now in the case of the root dir, the slash is kept.
==============================================================================
Changelist for version 1.41
- handy new macro: numElementsInArray()
- improved menu highlighting of custom menu components
- win32 windowing changes to avoid problems with plugins messing up their host's keyboard accelerators
- new class: ApplicationProperties - this is a handy singleton for managing PropertyFile objects when you need both user-specific settings and settings that are common to all users of a machine
- extra options for PopupMenu to allow more control over the width and number of columns used. Note that there's a small change to the prototype of LookAndFeel::getIdealPopupMenuItemSize, in case you've overridden this in your code
- for consistency, changed the ComboBox to use a normal menu as its popup component, instead of the slightly-different component it had been using. This also involved ditching a load of LookAndFeel methods that were for drawing the old popup.
- the FLAC and Ogg-Vorbis libraries are now embedded and integrated into the juce build. Previously these could only be used if you linked to their library files, which needed building separately, but now it all just works without any external dependencies.
- tweaked the AudioDeviceSelectorComponent to give more flexible control over which channels are enabled in a multi-channel soundcard
- Linux + Mac: added a sockets-based HTTP stream class, so that linux now has this functionality. On the Mac, this replaces the old version which used deprecated OS functions (and which kept randomly crashing deep inside Apple's HTTP code)
- altered the AudioFormat::createWriterFor method to take an OutputStream rather than a FileOutputStream - if you've written a custom AudioFormat you'll have to tweak your method prototypes
- more efficient zip file parsing
- renamed MemoryBlock::to64BitEncoding and MemoryBlock::from64BitEncoding because they're a misnomer, and I must have been a bit muddled when I wrote those. They're now called toBase64Encoding and fromBase64Encoding.
- new methods: String::indexOfAnyOf and lastIndexOfAnyOf
- changes to the prototype of File::findChildFiles, DirectoryIterator, and a couple of other related methods, so that you can use an enum to specify whether to search for files, directories, or both.
- added some methods to ListBox and TableListBox to return the position of rows and cells
- added a method to allow easy drag-and-dropping of treeview items
- added support for the numeric keypad in KeyPress
- added methods to create custom buttons in TabbedComponents, and to save/restore the scroll position of a ListBox
- fixed whitespace display in a password textbox
- jucer: a very useful change allows each co-ordinate of a component to now be made relative to another component instead of the parent, allowing some complex layout behaviour.
- linux: added support for dealing with drag-and-dropped files (thanks to kraken for the code behind that one!)
==============================================================================
Changelist for version 1.40
- Audio Plugins: added an initial release of an RTAS wrapper!
- new classes: IIRFilter and IIRFilterAudioSource
- changed the Synthesiser to use reference counting for SynthesiserSound objects, so that sounds can be allowed to play on after being removed.
- added some colour options to the GroupComponent and Toolbar classes
- added a mouse-sensitivity setting to sliders
- Linux: added support for XShm, which uses shared memory to improve rendering speed
- Added a new method File::getSpecialLocation(), which lets you find out various system paths, e.g. home folders, documents folders, etc. This replaces a bunch of existing static method calls in SystemStats.
- Added a TableListBoxModel::getDragSourceDescription() method to allow easier dragging of table rows
- Added an option to PropertiesFile for creating files that are common to all users. Also tweaked a couple of methods in this class.
- Mac: added a PlatformUtilities method to convert unicode strings to their precomposed form, and used this in lots of file handling routines to avoid mix-ups between encodings of extended characters.
- Altered the directory search code to optimise fetching of file attributes - this should help when browsing directories on slower network drives
- couple of small fixes for TableHeaderComponent in stretch-to-fit mode
- added a new virtual method to OpenGLComponent to provide a callback for setting-up a new GL context
- some improvements to the AudioDeviceManager to make it do a better job of saving and restoring its state
- Jucer: some fixes for embedded jucer components
- changed the PNG loading code to correctly handle interlaced PNG formats
- added methods to convert a Path into a simple string of co-ordinates that can be reloaded. Also added a button to the font demo to turn glyphs into these strings
- added a multi-select option flag to treeviews
- mac + linux: implemented the InterProcessLock class
- fixed DirectSound handling of unicode driver names
==============================================================================
Changelist for version 1.39
- change to the way Components and LookAndFeel objects handle colour. Preset colours are now identified by a unique ID number, and can be retrieved or set either for the lookandfeel object or overridden for an individual component. See the new Component::findColour and LookAndFeel::findColour methods for more info on this.
- new classes: SamplerSound and SamplerVoice, which are used with the Symthesiser class to form a very simple sampler. I've added an example of this to the audio demo.
- some Win32 changes to enable window maximising via the native system menu
- added an option to the Slider class for showing min/max values
- added ALSA midi output support for Linux
- support for Linux displays with only 16-bit colour, and fixes for handling of exteneded keycode input
- added some more string constructors, for creating strings from unsigned integers as well as signed ones
- new class: ComponentMovementWatcher, for keeping track of movements of deeply nested components (probably quite esoteric, but needed for things like OpenGL and ActiveX windows)
- Jucer: made references to embedded jucer files use relative pathnames rather than absolute, so directories of jucer files can be moved easily without breaking links
- Jucer: added constructor parameters properties for the components inside tabbed components, viewports and jucer components.
- Jucer: SVG files can now be dropped in as image resources
- changed the ApplicationCommandManager::getFirstCommandTarget() method to add a command ID parameter
- MemoryBlock::to64BitEncoding now returns a string rather than taking a dest string parameter
- tweaked the ImageCache class to use 64-bit hash-codes
- Plugin toolkit: added a class StandAloneFilterWindow, which is a window object you can use to build a plugin as a standalone app
==============================================================================
Changelist for version 1.38
- Windows: mouse cursors and taskbar icons now use a full 8-bit alpha channel when running on WinXP
- Fixed some SVG bugs and made the parser more efficient
- got rid of the Component::setDragRepeatInterval() method and replaced it with a static method beginDragAutoRepeat(). This makes it easier for a parent component to enable auto-repeat when its children are clicked.
- bugfixes for some keyboard codes on Windows, RelativeTime rounding accuracy, Linux opengl repainting, mac window repainting, BWAV history chunk parsing, Table components, Mac fonts, Mac CoreAudio built-in device pairing, nested modal state return values, full-screen windows using native title bars, linux filenames with extended character sets.
- Windows: updated the network MAC address function, which wasn't correctly finding all network cards on some systems
- changes to allow a 64-bit build on Windows, including greater use of compiler intrinsics
- two new header files: juce_WithoutMacros.h and juce_DefineMacros.h (in the juce/src directory) - these make it easy to include juce.h without it defining macros that may conflict with other 3rd party header files. See the comments in these files for more info.
- tidied up the SystemStats operating system detection detection, to use an enum instead of strings, added Windows Vista detection, and renamed some of the methods. If you use these, you'll probably have to change the method you're calling, but it's not difficult.
- added an option to TreeView to set the indent size
- updated the build instructions for Windows compilers
==============================================================================
Changelist for version 1.37
- new classes: Toolbar and a bunch of related classes. For creating and dynamically customising toolbars.
- new class: ComponentAnimator, which will move and resize components to new positions, taking a specified length of time to get there. There's a button to demonstrate this in the jucedemo widgets section, on the buttons page
- new class: MultiTimer, which is like a Timer, but allows multiple independent timers with different frequencies to share a callback
- fixed a few bugs in the SVG parser and a gradient-rendering bug, and added an SVG object to the "paths + transforms" demo page
- added some assertions to warn people about adding components directly to a ResizableWindow rather than using setContentComponent()
- to improve performance of the ElementComparator class, I've changed the sort routines to use a templated class rather than a virtual method. If this breaks your code, all you need to do is to no longer derive your class from ElementComparator and everything else should continue to work as normal.
- finished off the ThreadPool class, and souped-up the threading page of the demo app to show how to use it.
- added some static methods to Drawable to automatically load Drawables from some kind of image or SVG file
- fixes for some Mac VST and AU windowing bugs
- new method Component::canModalEventBeSentToComponent(), which allows a modal component to selectively allow events to reach components that it is blocking
- fixed deprecated function warnings in MSVC8
- all projects and solutions are now compatible with MS Visual Studio 2005 - I've renamed some of the vcexpress directories to "vc7", and the projects in them will load with either VCexpress or VC8
- updated the "hello world" projects to use a document window
- altered the AudioFileFormat::createReaderFor() method to specify whether the input stream should be preserved if opening fails
==============================================================================
Changelist for version 1.36
- Windows: ActiveXComponents (and QuickTime components) now get told about any mouse events that happen inside the control
- Graphics::saveState() now saves the colour and brush as well as the clip region and origin
- SimpleListBox now prevents mouse clicks from getting sent to the list if the component is disabled
- new classes: TableListBox, TableHeaderComponent - these are for creating table components with column headings that can be re-ordered, resized, etc. I've added a table demo to the juce demo to show how to use it, and the Jucer's resources panel also now uses a stretch-to-fit table.
- removed class SimpleListBox: I've got rid of the separate SimpleListBox class, and merged its functionality with ListBox. If you're currently using a SimpleListBox, the only change you should need to make is to replace "SimpleListBox" in your code with "ListBox".
- Changes to ListBox: if you're using a ListBox with custom row components, you'll need to change your class to also derive from ListBoxModel, and make sure you call ListBox::setModel() to make it use your model class. Then you'll need to replace the old createRowComponent() and updateRowComponent() methods with the new refreshComponentForRow() method.
- new handy macro: forEachXmlChildElement, which is a neat way of iterating the child elements of an XmlElement
- new class: StretchableObjectResizer, which is for calculating how to fit a set of resizable items into a given space
- new class: TaskbarIconComponent, on Windows only, this lets you show an icon in the system tray.
- fixes for using a DLL build on Windows - I've moved all the allocators into the juce DLL, so this should now work ok
- added a bit of SSE optimisation in the graphics rendering code (just for blending large blocks of solid colour)
==============================================================================
Changelist for version 1.35
- added a simple SVG parser to the Drawable class - this can parse SVG into a graph of Drawable objects that you can then render. The parser's pretty basic, and doesn't support much of the (very large) SVG spec, but I'll keep adding features to it as they're needed
- fixed the updating of ToggleButtons that are connected to app commands so that they correctly reflect the command's 'ticked' state.
- fixed the XML parser's handling of non-text element entities
- added a few handy static methods to AffineTransform
- gradient fills can now have a transform matrix specified, to deform their shape
- new class: RectanglePlacement, which is a bit like Justification, but specifically for fitting rectangular graphics within a viewport with various positioning options. This will break a few places where you call methods like drawImageWithin(), but is easy to update and the result is more readable code.
- new method Colours::findColourForName() for looking up colour names from a string
- added a flag to ApplicationCommandInfo to stop menus and buttons getting flashed when particular commands are invoked
- new class: CharacterFunctions, which contains a set of static functions for manipulating ascii and unicode characters and null-terminated strings. This is intended to replace any use of functions like strlen, etc, with a set of safe, platform-independent ones.
- some fixes and optimisations to the file chooser components
- altered the Graphics and LowLevelGraphicsContext classes to use a stack for pushing and popping the clip regions, instead of setting these explicitly with a RectangleList. (This change is needed for future support of OS contexts that can't retrieve the clip path as a set of rectangles)
- removed the Graphics class's copy constructor (use the saveState/restoreState methods instead of a temporary copy)
- added method String::indexOfWholeWord()
- tidied up some of the header files, moving all inline functions (like jlimit, jmax, etc) into the juce namespace
- Mac: complete rewite of the windowing code. Components are now placed in HIViews, rather than directly in Windows. As well as being more futureproof, this is vital for support of AudioUnits and VSTs on Intel Macs.
- Mac: tidied up the build environment. It now compiles a universal binary which is compatible with any system from 10.2 onwards, including intel on 10.4
- Windows: new ActiveXControlComponent class, which lets you embed an ActiveX control in a Juce window. I wrote this to get the new Quicktime control working, but made it generic so you could use it for other things like embedding a web browser, etc.
- Windows: completely rewritten Quicktime support. This now requires QT7 (on windows, not Mac), but it now uses the new ActiveX QT control, which is much better than the archaic way it used to be done. Would like to update the Mac version too, but that'd only work on 10.4, so will wait until older OS versions are less common.
- Windows: fixes for non-western keyboard input sometimes not working in textboxes
- Linux: added a MIDI input device, using ALSA
- Linux: made launching of URLs in the default browser work properly
- Jucer: added an option to view a semi-transparent overlay of the components while editing the background graphics
- Jucer: better positioning of new objects when zoomed-in
- Jucer: added a "common background" graphics layer to buttons, which is drawn behind all the other button states
- Jucer: added key shortcuts for nudging component's position and size around
- JuceAudioPlugin: rewrote the mac VST and AU wrappers to embed a HIView rather than the old window hackery it was using.
==============================================================================
Changelist for version 1.34
- a bunch of changes to continue improving the expressiveness and consistency of listener classes, (and moving away from generic listeners like ChangeListener):
- new class: LabelListener class now replaces Label's use of ChangeListeners
- new class: ComboBoxListener for ComboBoxes, replacing the old use of ActionListener
- new class: ScrollBarListener for ScrollBars, replacing the old use of ChangeListener
- new class: KeyboardFocusTraverser, to take the logic of keyboard focus traversal out of the component class.
- removed the Component::setFocusOrder method - instead, a KeyboardFocusTraverser object now decides the focus order (and can be overridden to support custom behaviours)
- new class: ApplicationCommandManagerListener - this is used to listen for commands being invoked, and for changes to the status of commands. The Button class now uses this so that when a button is linked to a command, it enables itself only when the command is active, and flashes when it's invoked.
- new class: FocusChangeListener - this can be registered with the Desktop class to receive callbacks whenever the focused component changes
- new class: FilenameComponentListener - for getting events from FilenameComponents, replacing the use of ActionListener
- new class: BooleanPropertyComponent - a property component with a toggle button in it
- some fixes to DLL builds on windows
- couple of additions to the MidiKeyboardComponent class
- fix for large menus not scrolling correctly
- got rid of Component::getMouseX() and getMouseY() - this functionality is already available in Desktop::getMousePosition(), so not needed here as well
- replaced the Component::getMouseXRelative() and getMouseYRelative() method with a single method getMouseXYRelative() that returns both co-ordinates at once (this is a more efficient way of doing things)
- added new methods Component::relativePositionToGlobal, globalPositionToRelative and relativePositionToOtherComponent for converting co-ordinates to and from screen co-ords. These replace the old getXRelativeTo() method.
- new class: MagnifierComponent, which magnifies or shrinks any component that you put inside it
- added colour swatches to the ColourSelectorComponent
- Jucer: literal text strings can now contain special strings which are treated as c++ code - anything inside a pair of %% characters counts as c++, so %%getName()%% gets translated into the name of the component; %%getButtonText()%% into getButtonText(), and these are concatenated with the rest of the string.
- Jucer: Button documents now have a list of the various over/down/toggled states for which you want to design paint routines, and any combination of these can be enabled
- Jucer: you can now drag-and-drop a Jucer .cpp file into a component's layout window, and it will add it as a Jucer component
- Jucer: highlighted object borders can now go beyond the edges of the component, making it easier to edit comps that are slightly off-screen or aligned with the edges of the parent comp
- Jucer: new command to bring any items that are off the edges of the screen back into the middle
- Jucer: ComboBoxes and Labels now create callback methods
- Jucer: Zoom mode! As well as the zoom in/out commands on the menus and keyboard, you can use the mouse-wheel with ctrl or alt held down to zoom.
- Jucer: Holding down the space bar now lets you scroll around the component
- Jucer: ability to group paint elements together to treat them as a single entity
==============================================================================
Changelist for version 1.33
- fixed some graphics error with path strokes, and optimised the stroke creation code
- improved the ellipse and rounded rectangle path routines by using cubic approximations
- couple of extra methods for the AsyncUpdater class
- changed sliders so that they now use a SliderListener class to receive callbacks instead of using ChangeListeners
- Jucer: lots and lots of bugfixes
- Jucer: added options for converting text and other graphics elements into paths
- Jucer: Viewports can now have a content component specified, which may be a Jucer component
- Jucer: TabbedComponents can now be edited and have the contents of each tab specified
- Jucer: Added a list of extra callback methods that can be added to the code automatically
- Jucer: Added an option to images to change the stretch mode
- Jucer: Graphic objects can now use an ImageBrush for their fill or stroke
- Jucer: You can now drag-and-drop image files onto the graphics element editor page
- Jucer: Added a tooltip property to those components that implement the SettableTooltipClient interface
- Jucer: Gave it an icon
- Jucer: Sliders now create a SliderListener callback
==============================================================================
Changelist for version 1.32
- Jucer: added undo/redo support!
- Jucer: restructured most of the project, adding support for documents of different types, so now it can create either normal components, or buttons with normal/over/down graphics. More document types can be added in future
- Jucer: added a VC6 project, and fixed some things that didn't build because of VC6 compiler bugs
- Jucer: holding down shift when resizing things now fixes the aspect ratio
- Jucer: holding down ctrl when dragging disables/enables grid-snapping
- added a couple of options to MultiDocumentPanel
- fixed a graphics bug with thick path strokes not being created correctly
- mac: managed to stop it repainting windows unnecessarily while dragging them around
==============================================================================
Changelist for version 1.31
- First release of the Jucer! This is a component development tool that lets you design Juce components and produces c++ code. This initial release is functional but still a work-in-progress - it will be an ongoing project, adding more and more functionality and shortcuts for creating juce-based code. The Jucer source code lives inside the Juce tree, in the juce/jucer folder.
- new class: PositionedRectangle, which specifies a rectangle using either absolute or proportional co-ordinates, and giving flexible control over the anchor points used. Handy for positioning components.
- new set of classes: PropertyComponent, PropertyPanel and various basic subclasses of PropertyComponent. These allow you to quickly set up a properties panel for something, e.g. a selected object, which shows a list of named properties of various types, e.g. text, sliders, combo boxes, etc.
- added a method ApplicationCommandManager::setFirstCommandTarget() to make it easier to set up non-component command targets
- change to the FileBasedDocument load/save methods so that they can return an error message on failure
- new method: Graphics::fillCheckerBoard()
- added options to FileChooser and FileChooserDialogBox to prompt the user about overwriting files that already exist
- change to TabbedComponent, so that instead of using a virtual method to create the components for the tabs, you add components using the addTab method and the TabbedComponent looks after them for you.
- fixes to some focus issues, such as popup menus temporarily moving focus away from the main window
- new class: MultiDocumentPanel to hold multiple document windows as either floating DocumentWindows or in a TabbedComponent.
==============================================================================
Changelist for version 1.30
- major set of new classes to introduce "application commands". This is a powerful mechanism for despatching commands to command targets. It allows commands to be bound to keystrokes and easily triggered by menus, buttons, etc. New classes to support this include ApplicationCommandManager, ApplicationCommandTarget, ApplicationCommandInfo. I've rewritten the Juce demo to use commands to control its menu system, and added key-shortcuts to select the various demos.
- the new app command stuff replaces a lot of the functionality that was in KeyPressMappingSet, so this class has been slimmed down with some functionality moving into the new classes. I've renamed the createXml() and restoreFromXml() methods to draw attention to the slight difference in the way they're used, (and to make the names more consistent with other code)
- new class SettableTooltipClient, and made a lot of the existing widgets inherit from this, to make it easy to set tooltips for them
- new flag in the Justification class - horizontallyJustified, which spreads text out to align both its left and right margins
- tidied up the Uuid class and got rid of any platform-dependent libraries it was using
- the constructor for the Thread class now takes a name, and on windows this gets passed to the debugger to make it easy to see which thread is which. (Haven't got mac or linux implementations for this yet)
- some UI fixes for running under KDE on Linux
- added a File::areFileNamesCaseSensitive() method
- added a method to the MidiInputCallback class to handle incoming sections of a long sysex message. (This is only currently supported on the mac)
- the XML parser now loads extended UTF-8 characters correctly
==============================================================================
Changelist for version 1.29
- moved the Juce demo app into the main Juce tree, to make it all easier to download
- added classes for FLAC and Ogg-Vorbis audio formats
- added support for native window title bars and borders
- moved the window style flag enum out of Component and into ComponentPeer, adding lots of new flags.
- changed some of the methods in ComponentBoundsConstrainer so it'd work with the new windowing stuff
- couple of minor fixes to named pipes on windows
- some Quicktime component fixes and optimisations
- changed the AudioFormat class to allow multiple file extensions, and added a method AudioFormatManager::getWildcardForAllFormats() to make it easy to show browsers for audio files
- on OSX, added a juce.xcconfig file to the XCode build, to make it easier to select whether to build for gcc3 or 4
- made the TabBarButton class public to allow customised tab bar components
- changed the default font on OSX from Verdana to Lucida Grande, as Verdana isn't actually guaranteed to be installed on all systems
==============================================================================
Changelist for version 1.28
- Cleaned up the audio device driver architecture, adding an AudioIODeviceType class to represent the different types, (e.g. DSound, ASIO, CoreAudio, ALSA, etc). The AudioIODevice class is now an abstract base class, and instances can only be created by using an AudioIODeviceType object. This means that user code no longer needs to care whether support for ASIO is enabled or not.
- Fixes to the ReadWriteLock class
- Couple of bugfixes to stop older VC7 compilers complaining
- Finally found a way of making the windows come to the front correctly under Gnome on Linux
- Fixed a linux mouse focus bug that messed up menus
- New class: Socket, which is.. you guessed it.. a socket.
- New class: NamedPipe, which is, unsurprisingly, a named pipe, for interprocess comms.
- new class: InterprocessConnection, which manages a simple two-way socket or pipe-based message passing connection to another process or machine on the network.
- Added a new interprocess comms page to the demo, to demonstrate InterprocessConnections.
- Improvements to repaint speed on win32 when there are complex repaint regions
- Fix for a mac windowing bug that stopped modal windows coming to the front correctly
==============================================================================
Changelist for version 1.27
- lots of new file selector classes: DirectoryContentsList, FileListComponent, FileChooserDialogBox, FileBrowserComponent, FileFilter, etc. These can be used either as separate components or as a ready-made dialog box file chooser, which means that the Linux build finally has a file chooser!
- jazzed-up the colour selector to give more control over how it looks
- added a simple pattern match (for matching filenames, mainly) to the String class
- fixes to avoid problems with drifting clocks on the new dual-core intel cpus
- added UTF-8 conversion methods to the String class
- made PropertiesFile support unicode strings
- new class: BorderSize, which is used to represent the gaps around things - I've changed a few methods in classes like LookAndFeel, ResizableWindow, Component to use this instead of specifying the gaps manually, which was a bit messy.
- new class: AudioDataConverters, which contains methods for converting floating point audio to various integer formats
- new static_jassert macro for doing compile-time assertions
- fixes for mac MidiInput with certain drivers
- tidied up the MemoryBlock class and got rid of its virtual base class to make it quicker. Also dumped the AlignedMemoryBlock class: if anyone wants it back, let me know and I'll do a new version!
- optimised repainting for cases where there are a lot of deeply-nested components
- tweak to the broadcast message code on win32 to avoid deadlocks
- fixes for GCC4.0 optimised build under linux - the crashes here were due to strict aliasing in some numeric conversion functions. I've been through and made them more complient now.
==============================================================================
Changelist for version 1.26
- Linux audio support using ALSA! This is a first stab at an implementation, so I've only had chance to try it on one soundcard - linux audio experts, please let me know what I've done wrong!
- Restructured the way components are housed in windows, getting rid of NativeDesktopWindow and instead having a ComponentPeer base class, of which there may be more than one implementation. (This won't make any difference to most people, only power-users)
- Graphics contexts now work with a RectangleList as their clip region, instead of just a single rectangle
- added some methods to Desktop to access a list of top-level desktop components
- fixes and improvements to TextEditor, improving its handling of word-wrapping
- added a QuickTime page and an audio input monitor to the demo app.
==============================================================================
Changelist for version 1.25
- new class: TopLevelWindow to handle the concept of "active" windows
- new class: MidiMessageCollector helper for realtime midi input, and created a midi folder to tidy up the directory structure of the midi classes.
- added a JUCE_CATCH_UNHANDLED_EXCEPTIONS config to turn off the juce exception logging
- renamed JUCEApplication::getApplicationInstance() to JUCEApplication::getInstance(), for consistency with all the other singletons. Sorry for the hassle, but it's easy to find-and-replace it in your code.
- finished keyboard navigation for menu bars
- new class: Synthesiser, which is an abstract base class for multitimbral synths. Also added one of these to the audio page of the Juce demo
- TreeViews now have an extra item width parameter for each item, and horizontal scrollbars if items are too wide to fit on screen.
==============================================================================
Changelist for version 1.24
- more flexible gradient control, allowing sequences of colours
- new class: DocumentWindow, which is a resizable window with a titlebar, nice-looking maximise/minimise/close buttons, a menubar, and lots of cool options.
- improved the ability for ResizableWindows to be used as child components as well as on the desktop, without them losing their drop-shadows
- eye-candy changes to ShinyLookAndFeel, adding glassy-looking buttons
- added a JUCE_VERSION macro to allow conditional builds against different juce versions
- added an option to PopupMenu that allows any component to be easily added as a custom component, rather than only ones derived from PopupMenuCustomComponent.
- made the win32 crt memory debugging overrides conditional with JUCE_CHECK_MEMORY_LEAKS macro in juce_Config.h
- new class: LassoComponent for easy lassoing of groups of UI objects
- additions to SelectedItemSet to improve the logic used when multi-selecting items that might be dragged.
- handy new method: File::replaceWithText()
- new class: RecentlyOpenedFilesList
- updated some crt function names for compatibility with the latest msvc pro
- misc fixes to glyph layout, text editor listener callbacks + lots of other things.
- new class: ComponentBoundsConstrainer for more flexible control over resizing and dragging components around. This replaces the ResizableBase class.
- popup menus now accept keyboard navigation (not done this for jumping between them on menubars yet, though)
==============================================================================
Changelist for version 1.23
- new class AudioDeviceManager - this makes it super-easy for audio applications to manage the user's choice of audio and midi devices, and to save and load the user's audio settings.
- new class AudioDeviceSelectorComponent - goes with the AudioDeviceManager to make it easy to let the user change the audio settings. I've also updated the JuceDemo audio section to use these new features.
- fix to ProgressBar
- a few graphics rendering fixes, and some optimisations for pixel blending operations
- change to AudioIODeviceCallback class to add methods to tell the callback when the device starts and stops
- small tweak to AudioSourcePlayer now that it no longer needs to be told the sample rate and buffer size
- a few more tweaks for 64-bit compatibility on linux
- added a checkNewSize() method to ResizableBase and ResizableWindow to allow custom resize constraints.
- fix for a mac midi input bug that could freeze the system when malformed midi packets arrive
- optional drop-shadows on menus via the LookAndFeel class
==============================================================================
Changelist for version 1.22
- new class: AudioFormatManager
- removed any dependencies on DSound.h or DSound.lib so Juce can be built with the latest Platform SDK without needing the DX SDK as well.
- fixed a mac drag-and-drop bug
- made drop-shadows optional for alert boxes + splash screens
- added some fixes for compiling on gcc4.0.2 in mandriva linux
- big restructuring of the graphics code to make it ready for adding OS or hardware-accelerated UI rendering. In its current state it should be pretty much the same speed as before, but I've moved all the software rendering into one class. Small changes to the Image class mean that you can no longer get a pointer to its pixels, you need to lock and unlock a section of the image, so that this will also work in future for images that aren't kept in main memory.
==============================================================================
Changelist for version 1.21
- new class: MidiBuffer - an efficient array of midi messages for use in audio filters
- new class: MidiKeyboardComponent - a UI comp that shows a piano keyboard and has lots of groovy features
- additions to DragAndDropContainer to allow files to be dragged to external applications
- fix to Array::move()
- added a couple of accessor methods to TreeViewItem
- changed the colour selector component to make the alpha-channel optional
- fixed a layout bug with some tooltips
- fixes to the AIFF file format handler
- efficiency improvements to the Timer class
- add a Component::visibilityChanged() callback method
- added file and line info to the internal exception handling code
- linux window focus bugfix
==============================================================================
Changelist for version 1.20
- changes to support the latest XCode 2.2 on the Mac, and some changes ready for Intel-based macs
- changes to support the latest version of VSExpress
- optimisations to DirectoryIterator - should make it much faster when scanning slow disks
- optimised the way Timers are triggered
- mac fixes for repainting transparent windows on 10.4
- some tweaks necessary for AudioUnit support
==============================================================================
Changelist for version 1.19
- added some more translation macros for various strings that were missing
- translation files can now contain escaped characters, e.g. "\t" or "\n"
- added a method to the QuickTimeMovieComponent to manually unload QT, as the automatic method it was using could interfere with other uses of QT in your app
- on the mac, minimising windows now animates and properly minimises them rather than just hiding them
- on the mac, hide/show application now works correctly
- small fix to ComboBox/FilenameComponent
- updated to include the latest versions of all 3rd party libraries - i.e. libjpeg, libpng and zlib, so lots of speed and security improvements there
- added ImageFileFormat::writeImageToStream() method, currently supporting writing of JPEG and PNG files
- fixed a bug in PopupMenus with a large number of items on them
- fixed a mac audio cd reading bug that could mix up the track order
- option for ComponentDragger to keep the entire thing on-screen
==============================================================================
Changelist for version 1.18
- fixes to the audio resampler, and also to some looping bugs in the audio sources
- ComboBox::getSelectedId() was returning -1 if nothing was selected - changes this to be 0 instead, (it should always have been 0, as item IDs must be non-zero, but -1 is a valid ID)
- added a tryEnter() method to CriticalSection
- some tweaks to DirectSound support to allow the names of input devices to be used as well as those of output devices
- got rid of deprecated calls to strcpy
- a few fixes for gcc4.0 compatibility on linux
- new instructions for linking to the library in XCode
==============================================================================
Changelist for version 1.17
- fixes for the Mac in string parsing and windowing
- fix for initial folder in the directory chooser on windows
- better unicode font name handling for winXP
- added some code for handling uncaught exceptions on the message thread
- made the DialogWindow::closeButtonPressed a pure virtual to force subclasses to handle it properly
- fixes for some keypresses that didn't work on foreign keyboards on the mac
==============================================================================
Changelist for version 1.16
- added some methods to the ComboBox class to allow it to have disabled items in its drop-down list, and also to have separator lines and subheadings for different sections.
- new class: ToneGeneratorAudioSource
- more bugfixes for win98 support, XML, unicode, etc.
- on the mac, added DEBUG macros to the project, as these weren't being properly set up before and assertions were left in the release build
- on the mac, the project now creates two separate lib files for release and debug: libjuce.a and libjucedebug.a. Unfortunately there's no obvious way of making an app link to the correct one depending on whether you're doing a debug build, so you'll need to manually set the one you want in your project.
- on linux, fixed up a SUPPORT_AFFINITIES macro because some distros have obsolete APIs that won't compile the cpu affinity code
- methods to add XML elements to a PropertySet
==============================================================================
Changelist for version 1.15
- got rid of the separate unicode/ansi builds, deleted juce_unicode.h and introduced a JUCE_STRINGS_USE_UNICODE macro which is defined in juce_Config.h. This is now turned on by default, so if there's some reason why you don't want your app to use unicode, you'll need to opt-out by disabling the macro.
- a bunch of unicode fixes and tweaks
- changed the method KeyPressMappingSet::isSafeToInvokeCallbacks() into isSafeToInvokeCommand() so it can choose whether particular commands are safe to run
- added an option to the ResizableBorderComponent and ResizableCornerComponent so that they can enforce a fixed aspect ratio
- new helper method for logging: FileLogger::createDefaultAppLogger()
- new class ResizableBase, as a base class for various resizable components
- various win98 fixes
- made the name of the juce namespace optional
- added methods Rectangle::toString() and fromString() to save/load rectangles easily
- fixed a stupid bug in FilenameComponent
- fixed mac file handling to fully support unicode filenames
- added drag-and-drop functionality to SimpleListBox, with helper methods in ListBox and also a few tweaks to DragAndDropContainer to help it deal with drag sources that are different from the component currently under the mouse. Also updated the demo drag-and-drop to use a listbox.
- various mac UI fixes, including some focus gain/loss improvements
- fixed the Dev-Cpp build, and added a Dev-Cpp project for building the demo app
==============================================================================
Changelist for version 1.14
- tweaks to ComboBox to make it look and work better, and also to give control over the text justification
- buttons and menu items can now be linked to a command in a KeyPressMappingSet, to trigger commands automatically
- change to Buttons - rather than using an ActionListener, buttons now use a special ButtonListener to respond to callbacks. This allows for up/down messages as well as clicks, and provides a pointer to the button that triggered the event. You might have to alter a few of your classes to deal with this - sorry! but it's not too difficult to change and it does make your code neater and more readable.
- Rewrote BubbleComponent to now be a base class for drawing arbitrary graphics inside a speech bubble shape. Created BubbleMessageComponent as a subclass for showing a text message in a bubble (like the old BubbleComponent used to do).
- Sliders now have an optional pop-up bubble that shows you their current value while they're being dragged. This is handy for sliders which don't have a text box. See Slider::setPopupDisplayEnabled()
- Sliders can now have a suffix which they append to the text string that they display, to make it easy to show units without having to write a subclass
- cosmetic improvements to combo-boxes, menus, textboxes, sliders, and a few other bits + pieces
- mouse events now have a click counter to detect triple and quadruple clicks, and the TextEditor uses these to select the current paragraph or entire document
- added methods to the Desktop class to allow "global" MouseListeners to be registered, that will be told about all mouse events to all components
- new classes : MenuBarComponent and MenuBarModel for doing menu bars (obviously). This is a lightweight menu bar component, not yet an OS-specific menubar, which I'll eventually implement on the Mac, but the same model will apply to both.
- A few 64-bit compatibility tweaks, and the MessageCallbackFunction definition (used in MessageManager::callFunctionOnMessageThread()) now returns a void* instead of an int. This shouldn't affect many people.
- new class: FileBasedDocument - writing all the load/save/save-as logic for documents is pretty tedious, so this handy base-class takes care of all that stuff for you, doing all the file dialog boxes and asking whether to overwrite existing files, etc.
- on Windows, you can now build juce as a DLL, and your app can link to the DLL version by simply defining the JUCE_DLL macro before including the juce headers
==============================================================================
Changelist for version 1.13
- tidied up the components directory, recategorising the components that were there and putting them into more appropriate folders
- new class: PreferencesPanel for doing mac-style prefs panels.
- improved the KeyMappingEditorComponent to use a treeview instead of a list, and to just look a bit nicer.
- added parameters to DrawableButton to allow it to show another set of images when used as a toggle button.
- changed DrawableText to use a GlyphArrangement. (Not sure why I didn't do that in the first place)
- new class: ColourGradient for specifying a colour gradient (obviously..)
- DrawablePath now uses a ColourGradient to specify its fill type
- tweaked DrawableButton to make it a bit more flexible
- slider thumb size can now be specified in the lookandfeel class
- sliders now hide the mouse when in velocity-sensitive mode
- completely all-new TabbedComponent class, bearing no resemblence to the old one. This one's much easier to use, has look-and-feel support and looks nicer. I've also split out a TabbedButtonBar class so you can just use the bar on its own, rather than using the TabbedComponent, which manages the whole panel.
- fixed a leak when using modal components
- added a new slider style: LinearBar, which is a left-right bar with the text label over the top
- new class: ProgressBar, and a demo of the ThreadWithProgressWindow class (in jucedemo, widgets page, click the "show a popup menu" and it's under "alert windows")
- more refactoring of the LookAndFeel class, in particular moving colours into the base class so you can create looks with customised colours without needing to override any functions
- added an extra clicked() method to buttons so you can handle right clicks and modifier keys
- added a text colour option to the TextButton
- on Linux, sorted out setting the mouse position and invisible mouse cursors
==============================================================================
Changelist for version 1.12
- fixes to OpenGLComponent to make it work when parent components are moved
- added a flag to allow building of non-GUI apps under linux where UI libraries aren't present
- popup menus can now be positioned to align with a button or other component
- created some static initialiseJuce() functions in juce_Initialisation.h, to make it easy to embed juce in command-line apps or apps that use their own event-loop.
- new class: GroupComponent for drawing a line around a group of components
- new sliders! Completely revamped the Slider class so that it can now do vertical and rotary sliders, as well as allowing user-defined scaling and snapping.
- updated the Mac projects for XCode 2.1 and fixed the GCC4 problems. Apple have just changed the project format for this release, so if you're still on XCode 2.0, then sorry, you'll need to upgrade to build this release.
- a couple of changes to Path to clean up the elliptic-arc and pie-shape drawing methods
- added a Path::addStar() method for drawing star shapes and addBubble() for drawing speech bubble shapes
- new class: ComponentDragger to easily add logic for dragging components around
- new class: ResizableBorderComponent for adding windows-style resizable edges to components
- name change: ResizerComponent is now called ResizableCornerComponent to complement ResizableBorderComponent
- new class: ResizableWindow to make it easy to create top-level windows that are resizable/maximisable, and to make it easy to save/restore their position and state. DialogWindow has also now been changed to use this as its base class.
- renamed method: UndoManager::clear() becomes UndoManager::clearUndoHistory() (just to disambiguate when subclasses are used)
- Component::setInterceptsMouseClicks() can now optionally intercept clicks on child components
- fixed a bug in Array::move
- new set of classes: Drawables - these are used to build up a tree of graphic elements that can be drawn, forming a complex image. So far there are coloured shapes, images and text, but there may be more to add in future. They also have a persistence mechanism so can be saved/loaded and used as a vector graphics format. Although the classes are quite basic at the moment, I might expand these one day to form a way of rendering SVG.
- changes to Buttons - moved all the toggle-button logic into the base class so that all buttons can now have an on/off state and belong to button groups. TextButtons and DrawableButtons use this to draw themselves in an on/off state, and the old ToggleButton class is still there for a tickbox-style toggle button.
- new button type: DrawableButton which takes some Drawables as its image and has a few different styles. This button will ultimately take over from ImageButton and ShapeButton.
- moved isEnabled()/setEnabled() into the Component base class, so that it now applies hierarchically. (previously the different widgets all had their own separate enablement methods)
- fixes and tweaks to the windowing system on Linux to hopefully make it run more happily on Gnome
==============================================================================
Changelist for version 1.11
- fix for some file methods that were failing to identify volume type correctly in OSX10.4
- rearranged the OpenGL code to move it into the platform-specific folders.
- added openGL support for Linux
- replaced many of the win32 native calls with dual unicode/ansi implementations, so the same code will run on win98 but take advantage of unicode on win2000/XP
- reorganised the String::getHexValue() methods into 32 and 64 bit versions
- new class: SelectedObjectSet - for managing multiply-selected items
- fixed some maths bugs with rendering certain types of gradient brush
- buttons that auto-repeat can now be made to speed up the auto-repeat frequency the longer they're held down
- scrollbars can now have their buttons hidden
- implemented the MD5Checksum class
- new class: PropertySet, which now forms the base class for PropertiesFile
- each Component now has a set of named properties associated with it, which can be inherited from its parent component
- handy new method: DialogWindow::centreAroundComponent()
- finished implementing the Primes class
- finished the RSAKey class, to provide RSA public/private key cryptography
- beefed up the BitArray class, giving it a sign, so it can be used as a large number class, and added some new methods (mostly because they were needed for cryptography)
- implemented the BlowFish class, which is a symmetric-key encryption algorithm
- new layout classes: StretchableLayoutManager and StretchableLayoutResizerBar - these are for creating all kinds of sets of nested components that stretch to fill the available space, with vertical or horizontal divider bars to rescale them. I've added some code to the fonts page of the demo app to demonstrate how to use them
- better makefiles for Linux, generated using premake
- added xinerama support for Linux
==============================================================================
Changelist for version 1.10
- initial rough release of the Linux build! This is only the first release, so there are still a lot of things missing (audio support, file browsers, etc) and it's bound to be a bit buggy, but the demo app works!
- new class: FilenameComponent
- new class: ReadWriteLock for allowing multiple-reader access to a critical section.
- new class: SplashScreen
- new class: LocalisedStrings, which lets you use a translation file in your app for multi-language support
- improved the sample-rate conversion algorithm in ResamplingAudioSource
- some tweaks to the win32 demo projects (rtti wasn't enabled)
- made the image loading code support Exif digital camera files
- some enhancements to TextEditor and ComboBox, to allow a message to be displayed when nothing is yet entered or selected
- fixed a bug in SubregionStream
- changes to make the code GCC 3.4 complient
==============================================================================
Changelist for version 1.9
- OpenGL support with the OpenGLComponent class!
- fixed a bug with Array::addSorted that made list multi-selections go wrong
- added some methods to move array elements around
- added the TimeSliceThread class
- added the FileLogger class
==============================================================================
Changelist for version 1.8
- added some convenience methods to the URL class to download and parse a URL as a string, xml, etc.
- rewrote the TreeView class completely - sorry if you were using the old version, but this one's better, honest!
- TextEditors can now be used for entering passwords with an option to obscure their content
- renamed KeyPressMappingManager to KeyPressMappingSet, and tweaked it slightly
- and a load of bugfixes suggested by users
- updated the i/o streams to use 64-bit read/write positions, (and also the audio reader and writer classes)
- added an option to compile using unicode Win32 calls (turned on in win32_headers.h). This is off by default because although it's better for win2k/XP, it stops apps running on win98.
==============================================================================
Changelist for version 1.7
- new class: MouseHoverDetector
- new key-shortcut classes: KeyPressMappingManager and KeyMappingEditorComponent
- added QuickTime movie support via the QuickTimeMovieComponent class
- mouse-events are now time-stamped with the time the event occurred rather than using the time it was delivered (better for detecting double-clicks, etc)s
- getScreenX() now takes into account windows that are contained in non-juce parent windows (e.g. audio plugins)
==============================================================================
Changelist for version 1.6
- added a MessageManagerLock class for allowing multi-threaded access to UI components
- new audio source classes: PositionableAudioSource, BufferingAudioSource, AudioSourcePlayer, etc to make playback more generic
==============================================================================
Changelist for version 1.5
- added some workarounds to get it to build under the Borland C++ compiler
- added a VCExpress project, that should also (presumably) work in VC7
- changes to Component::focusGained() and focusLost() to indicate the cause of the focus change - be sure to check your code and update any places you've used these methods!
- changed NativeDesktopWindow::setFullScreen() to restore the last known size when full-screening is turned off
- tweaks to win32 window minimisation because some people had mysterious non-repainting windows when building with certain libraries
- added semi-transparent window support on the mac, and some fixes so that windows with the "appearsOnTaskbar" flag set will appear properly in expose
==============================================================================
Changelist for version 1.4
- made changes to the Mac event handling to allow Juce-based dynamic libraries to work correctly
- cleaned up a lot of warnings under newer MS compilers and got it to build under VC Express
- couple of minor midi bugfixes
==============================================================================
Changelist for version 1.3
- cleaned up various aspects of the code so it'll build under Mingw
- created a DevC++ project to build the library
- added some AudioFormatReader methods to scan for audio levels
- added some more timecode methods to MidiMessage
- the tab/shift-tab key now moves the focus between components
- changes to the DirectSound support to allow easier addressing of the individual devices and pair up matching input/output devices
- better build settings in XCode on the Mac, so it puts the build products in the right folder
==============================================================================
Changelist for version 1.2
- changed various bits of the message-handling code to allow it to work better when used to build DLLs on Windows
==============================================================================
Changelist for version 1.1
- added a StringPairArray class and used it to tidy up some other bits of code
- fixed StringArray::addTokens, which was missing out empty tokens
- added metadata to the audio format readers and writers
- added support for BWAV chunks to WavAudioFormat
- finished some ImageBrush and GradientBrush methods that hadn't been implemented
- added an operator= for the Image class
- tightened up some copy constructors and operator= methods for classes that shouldn't be copied
- added an AudioSubsectionReader class
- added AudioFormatWriter::writeFromAudioReader() and writeFromAudioSource() methods
- added a format type name to AudioFormatReaders and writers
- fixed a small bug with mouse cursors when using modal windows
- added some methods to AudioCDReader to scan for indexes (PC only)
- added FloatElementComparator and IntegerElementComparator classes
- fixed a couple of layout bugettes in AlertWindow
- added the ThreadWithProgressWindow class to make it easy to show a dialog box while a background task completes
- fixed a bug with certain accented characters not displaying correctly on the Mac
- fixed the cursor position sometimes being wrong in TextEditors when undoing/redoing
- added a sample rate parameter to AudioSource::prepareToPlay
==============================================================================
Changelist for version 1.0 - August 5th 2004
- initial release!
==============================================================================

273
docs/JUCE readme.html Normal file
View file

@ -0,0 +1,273 @@
<?xml version="1.0" encoding="windows-1250"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
<meta http-equiv="Content-Language" content="en-us" />
<meta name="description" content="Raw Material Software" />
<meta name="keywords" content="audio, music, juce, tracktion, c++, sequencer, library, programming, software, julian storer$otherkeywords" />
<meta name="robots" content="index,follow" />
<title>JUCE - installation and compiling</title>
<link href="rawmat.css" rel="stylesheet" type="text/css" media="all" />
</head>
<body>
<div class="pageholder">
<div class="banner">
<a href="http://www.rawmaterialsoftware.com">
<img src="images/rms_logo.gif" alt="raw material software" title="raw material software"/></a>
</div>
<p><a href="#intro">Introduction</a> - <a href="#license">License</a> -
<a href="#install">Installation</a> -
<a href="#buildvc2005">Building with VC2005</a> -
<a href="#buildvcx">Building with VC Express</a> -
<a href="#buildvc6">Building with VC6</a> -
<a href="#buildvc7">Building with VC7</a> -
<a href="#buildxcode">Building with XCode</a> -
<a href="#builddevcpp">Building with Dev-Cpp</a> -
<a href="#buildlinux">Building on Linux</a> -
</p>
<h1>JUCE</h1>
<h2><a name="intro"></a>Introduction</h2>
<p>JUCE is an all-encompassing C++ class
library for developing cross-platform applications.</p>
<p>A complete doxygen-created API guide is available <a href="http://www.rawmaterialsoftware.com/juce/api/index.html" target="juce api">here</a>
as HTML, or can be downloaded as a precompiled Windows help file from the
<a href="http://www.rawmaterialsoftware.com/juce/download.php">downloads</a> page.</p>
<p>For more help and information, please visit the <a href="http://www.rawmaterialsoftware.com/juce">JUCE website</a>.</p>
<h2><a name="license"></a>License</h2>
<p>JUCE is released under the <a href="http://www.gnu.org/copyleft/gpl.html">Gnu Public License</a>,
which means it can be freely copied and distributed, and costs nothing to use in open-source applications.</p>
<p>If you'd like to release a closed-source application that uses JUCE, commercial licenses are available
for a fee - click <a href="http://www.rawmaterialsoftware.com/juce/licensing.php">here</a> for more information on pricing and terms.</p>
<h2><a name="install"></a>Installation</h2>
<h3>Installing the source code</h3>
<p>The JUCE source code all lives in a folder called, unsurprisingly, <code>juce</code>, which you can unzip
and put somewhere on your system.</p>
<p>To compile the library, there is a subfolder <code>juce/build</code> that contains projects for different
operating systems and compilers.</p>
<h3>Building the demo application</h3>
<p>Inside the <code>juce</code> folder is a demo application that shows off a few of Juce's features.
The <code>juce/extras/juce demo/build</code> folder contains projects and workspaces for the various platforms and compilers.</p>
<h2>Building your application with JUCE</h2>
<h3><a name="buildvc2005"></a>Compiling with Microsoft Visual Studio 2005</h3>
<p>The quickest way to get started is to try building the demo application - there's a Visual Studio
soluion in <code>juce/extras/juce demo/build/win32_vc8/jucedemo.sln</code> which contains both the juce
library project and the demo application project.</p>
<p>This should build and run with no extra set-up needed in Visual Studio. (If you're using VCExpress Edition
see below for the few extra steps needed).</p>
<p>The only thing to check if you're unfamiliar with Visual Studio is that the <code>jucedemo</code>
project needs to be selected as your "startup" project (right-click on the
jucedemo project in the solution explorer for this option). Also, the active configuration should be
set to "Debug" or "Release", (the first time you load a project, VS selects one of the configurations and
usually picks "Debug DLL" as its default, for reasons best known to itself).</p>
<p>To create your own application that links to Juce:</p>
<ol>
<li>Either make a copy of the example project in <code>juce/projects</code> and rename/customise
it, or create a new application project as an 'empty' WIN32 application - avoid saying yes to
MFC or any of the other rubbish that Visual Studio might offer to pollute your application with.</li>
<li>Include the header file <code>juce.h</code> in all your source files (it's best to
put this in a precompiled header).</li>
<li>Ensure that the linker's search path for libraries includes the the <code>juce/bin</code> directory.
This path can be set globally, or can be added to your project's linker settings.</li>
<li>Choose to link to the "Multithreaded" or "Debug Multithreaded" run-time libraries, depending on
whether you're doing a debug or release build. On VC6, this is set in the Project Settings / C/C++ / Code
Generation options panel. In Visual Studio, it's in the project properties.</li>
<li>Make sure that your project has exception handling and run-time type information (RTTI) turned ON.</li>
<li>Have a look at the 'hello world' projects, demo projects, or the API documentation about the
<code>JUCEApplication</code> class to find out how to create the application launch code.</li>
</ol>
<h3><a name="buildvcx"></a>Compiling with Microsoft Visual C++ Express edition</h3>
<p>Although VCExpress is basically the same thing as Visual Studio 2005, it doesn't come
with all the Win32 library code pre-installed, so a couple of extra steps are required before JUCE
can be compiled with it:</p>
<ol>
<li>Install the latest Platform SDK from Microsoft.</li>
<li>A few extra items need to be added to your include and library search paths. The first few
entries on your include path should look like this (obviously you might have things installed in
different places, but the order is important!):
<pre>C:\Program Files\Microsoft Platform SDK\include
C:\Program Files\Microsoft Platform SDK\include\crt
C:\Program Files\Microsoft Platform SDK\include\mfc
C:\mycode\juce
...</pre>
And the library search path should begin like this:
<pre>$(VSInstallDir)VC\lib
C:\Program Files\Microsoft Platform SDK\lib
C:\mycode\juce\bin
...</pre>
</li>
</ol>
<p>Then, you can follow the same instructions as for Visual Studio 2005 above.</p>
<h3><a name="buildvc6"></a>Compiling with Microsoft Visual Studio 6</h3>
<p>To compile the JUCE .lib files from the source code:</p>
<ol>
<li>Install the latest Platform SDK from Microsoft.</li>
<li>Set up your include and library search paths. The first few items on your include path
should look like this (obviously you might have things installed in different places, but the
order is important!):
<pre>C:\Program Files\Microsoft Platform SDK\include
C:\Program Files\Microsoft Platform SDK\include\crt
C:\Program Files\Microsoft Platform SDK\include\mfc
C:\mycode\juce
...</pre>
And the library search path should begin like this:
<pre>C:\Program Files\Microsoft Visual Studio\VC98\LIB
C:\Program Files\Microsoft Platform SDK\lib
C:\mycode\juce\bin
...</pre>
</li>
<li>Open the juce.dsp project file in <code>juce/build/win32/vc6</code></li>
<li>There are several configurations: debug, release, debug-unicode, and release-unicode.
You can build all or some of these, and the resultant .lib files should end up in the
"juce/bin" folder.</li>
</ol>
<p>Note that there's a rather lame bug in VC6 that causes an internal compiler error if you include
filenames that are too long. This can get triggered if you put the juce folder in a deeply-nested
directory (such as your user home directory). Unfortunately I think the only workaround for this
is to move the source tree to a shallower directory.</p>
<p>For info on how to create an application that uses Juce, see the VC2005 notes above.</p>
<h3><a name="buildvc7"></a>Compiling with Microsoft Visual Studio 7</h3>
<p>For VC7, you can import the VC6 projects and this should work ok. It's also possible to
tweak the version number in the VC8 projects so that they can be opened in VC7, but that's a
less reliable method!</p>
<h3><a name="buildxcode"></a>Compiling with XCode on MacOSX</h3>
<p>To compile the JUCE binaries from the source code:</p>
<ol>
<li>Open the <code>Juce.xcodeproj</code> file in <code>juce/build/macosx</code></li>
<li>This project has "debug" and "release" configurations, and the library files it creates
are <code>libjuce.a</code> (release) and <code>libjucedebug.a</code> (debug), which will appear
in the <code>juce/bin</code> directory.</li>
</ol>
<p>Then, to create and build an application:</p>
<ol>
<li>Either make a copy of the example project in <code>juce/extras/example projects</code> and rename/customise it, or
create a new "Carbon Application" project.</li>
<li>Include the header file <code>juce.h</code> in all your source files.</li>
<li>Get rid of any main() functions that XCode might have generated for you, and instead use the
<code>JUCEApplication</code> class as your application launcher - see the API documentation for this
class for more details, or have a look at the example projects, or demos.</li>
<li>Drag-and-drop the <code>juce.xcodeproj</code> file into the project's "External Frameworks and Libraries"
list.</li>
<li>Expand this item in the treeview, and inside there'll be an item "libjuce.a" or "libjucedebug.a" - drag-and-drop
this into the "link binary with libraries" phase inside the xcode target. When you select either a debug
or release juce build these entries will (usually) update themselves to show the correct debug or release library
name. If you want your project to automatically rebuild Juce when you make changes to a juce file, you can
also add Juce to your target's "Direct Dependency" list (show information for the target, and this is on the
"general" tab).<br/>Alternative ways of linking to juce would be to add the libjuce.a or libjucedebug.a library to
your "External Frameworks and Libraries" list, or to add switch to the linker's command-line of either "-ljuce"
or "-ljucedebug".</li>
<li>You'll also need to add some of the following OSX frameworks to your "External Frameworks and Libraries" list,
depending on what features your application uses:
<pre>Carbon.framework
IOKit.framework
CoreAudio.framework
CoreMIDI.framework
QuickTime.framework
OpenGL.framework
AGL.framework</pre>
In future there may be other frameworks that you'll need to link with to support new JUCE features.
(It should be pretty obvious from the link-time error when one of these is missing).
</li>
</ol>
<h3><a name="builddevcpp"></a>Creating a JUCE application with Dev-C++</h3>
<ol>
<li>open <code>\juce\build\win32\devcpp\juce.dev</code></li>
<li>You may need to install the Platform SDK from Microsoft, and add <pre>C:\Program Files\Microsoft Platform SDK\Include</pre>
at the <strong>end</strong> of your include path to get some of the more recent header files.</li>
<li>Compile! It should produce a library file called <code>juce/bin/libjuce.a</code></li>
</ol>
<p>Then, to create and build an application:</p>
<ol>
<li>Create a new project, as a "win32 GUI".</li>
<li>Remove <code>main.cpp</code></li>
<li>Either copy the example main.cpp from the MSVC juce example project, or write your own based
around the <code>JUCEApplication</code> class</li>
<li>In your project settings (alt-P), you'll need to adjust the linker's options so that it links the following libraries:
<pre>libjuce.a (this will be in your juce/bin/ directory)
libwininet.a
libdsound.a
libole32.a
libwinmm.a
libgdi32.a
libuuid.a
libshell32.a
libvfw32.a
librpcrt4.a (these are all in the Dev-C++ libraries folder)</pre>
</li>
</ol>
<h3><a name="buildlinux"></a>Creating a JUCE application on Linux with GCC</h3>
<ol>
<li>Most linux distros should come with the tools you need, although you might want to get hold of
<a href="http://premake.sourceforge.net/">premake</a>, which is used to automatically generate the
juce makefile. (This isn't necessary if you're just going to use the makefile that's provided).</li>
<li>Get a command prompt and go into <code>/juce/build/linux</code></li>
<li>To build the debug version, use "<code>make CONFIG=Debug</code>", or use "<code>make CONFIG=Release</code>"
to build the release version. You can also use "<code>make clean</code>" to delete the intermediate
files.</li>
</ol>
<p>Then, to create and build an application:</p>
<ol>
<li>Building the library will have produced the library files <code>/juce/bin/libjuce.a</code> and
<code>/juce/bin/libjuce_debug.a</code>. You'll need to link to one of these in your app, and you'll
also need to link to these libraries:
<pre>freetype
pthread
X11</pre>
If you've set the <code>JUCE_USE_XINERAMA</code> flag in juce_Config.h, you'll also need to link to the
<code>xinerama</code> library.
And you'll need the <code>GL</code> and <code>GLU</code> libraries if you've enabled
<code>JUCE_OPENGL</code>
</li>
</ol>
<div class="ad">
<p class="ad">***</p>
</div>
<div class="bottomsection">
<p class="bottombar">- Copyright 2005 Raw Material Software Ltd -</p>
</div>
</div>
</body>
</html>

340
docs/gpl.txt Normal file
View file

@ -0,0 +1,340 @@
GNU GENERAL PUBLIC LICENSE
Version 2, June 1991
Copyright (C) 1989, 1991 Free Software Foundation, Inc.
59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
Everyone is permitted to copy and distribute verbatim copies
of this license document, but changing it is not allowed.
Preamble
The licenses for most software are designed to take away your
freedom to share and change it. By contrast, the GNU General Public
License is intended to guarantee your freedom to share and change free
software--to make sure the software is free for all its users. This
General Public License applies to most of the Free Software
Foundation's software and to any other program whose authors commit to
using it. (Some other Free Software Foundation software is covered by
the GNU Library General Public License instead.) You can apply it to
your programs, too.
When we speak of free software, we are referring to freedom, not
price. Our General Public Licenses are designed to make sure that you
have the freedom to distribute copies of free software (and charge for
this service if you wish), that you receive source code or can get it
if you want it, that you can change the software or use pieces of it
in new free programs; and that you know you can do these things.
To protect your rights, we need to make restrictions that forbid
anyone to deny you these rights or to ask you to surrender the rights.
These restrictions translate to certain responsibilities for you if you
distribute copies of the software, or if you modify it.
For example, if you distribute copies of such a program, whether
gratis or for a fee, you must give the recipients all the rights that
you have. You must make sure that they, too, receive or can get the
source code. And you must show them these terms so they know their
rights.
We protect your rights with two steps: (1) copyright the software, and
(2) offer you this license which gives you legal permission to copy,
distribute and/or modify the software.
Also, for each author's protection and ours, we want to make certain
that everyone understands that there is no warranty for this free
software. If the software is modified by someone else and passed on, we
want its recipients to know that what they have is not the original, so
that any problems introduced by others will not reflect on the original
authors' reputations.
Finally, any free program is threatened constantly by software
patents. We wish to avoid the danger that redistributors of a free
program will individually obtain patent licenses, in effect making the
program proprietary. To prevent this, we have made it clear that any
patent must be licensed for everyone's free use or not licensed at all.
The precise terms and conditions for copying, distribution and
modification follow.
GNU GENERAL PUBLIC LICENSE
TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
0. This License applies to any program or other work which contains
a notice placed by the copyright holder saying it may be distributed
under the terms of this General Public License. The "Program", below,
refers to any such program or work, and a "work based on the Program"
means either the Program or any derivative work under copyright law:
that is to say, a work containing the Program or a portion of it,
either verbatim or with modifications and/or translated into another
language. (Hereinafter, translation is included without limitation in
the term "modification".) Each licensee is addressed as "you".
Activities other than copying, distribution and modification are not
covered by this License; they are outside its scope. The act of
running the Program is not restricted, and the output from the Program
is covered only if its contents constitute a work based on the
Program (independent of having been made by running the Program).
Whether that is true depends on what the Program does.
1. You may copy and distribute verbatim copies of the Program's
source code as you receive it, in any medium, provided that you
conspicuously and appropriately publish on each copy an appropriate
copyright notice and disclaimer of warranty; keep intact all the
notices that refer to this License and to the absence of any warranty;
and give any other recipients of the Program a copy of this License
along with the Program.
You may charge a fee for the physical act of transferring a copy, and
you may at your option offer warranty protection in exchange for a fee.
2. You may modify your copy or copies of the Program or any portion
of it, thus forming a work based on the Program, and copy and
distribute such modifications or work under the terms of Section 1
above, provided that you also meet all of these conditions:
a) You must cause the modified files to carry prominent notices
stating that you changed the files and the date of any change.
b) You must cause any work that you distribute or publish, that in
whole or in part contains or is derived from the Program or any
part thereof, to be licensed as a whole at no charge to all third
parties under the terms of this License.
c) If the modified program normally reads commands interactively
when run, you must cause it, when started running for such
interactive use in the most ordinary way, to print or display an
announcement including an appropriate copyright notice and a
notice that there is no warranty (or else, saying that you provide
a warranty) and that users may redistribute the program under
these conditions, and telling the user how to view a copy of this
License. (Exception: if the Program itself is interactive but
does not normally print such an announcement, your work based on
the Program is not required to print an announcement.)
These requirements apply to the modified work as a whole. If
identifiable sections of that work are not derived from the Program,
and can be reasonably considered independent and separate works in
themselves, then this License, and its terms, do not apply to those
sections when you distribute them as separate works. But when you
distribute the same sections as part of a whole which is a work based
on the Program, the distribution of the whole must be on the terms of
this License, whose permissions for other licensees extend to the
entire whole, and thus to each and every part regardless of who wrote it.
Thus, it is not the intent of this section to claim rights or contest
your rights to work written entirely by you; rather, the intent is to
exercise the right to control the distribution of derivative or
collective works based on the Program.
In addition, mere aggregation of another work not based on the Program
with the Program (or with a work based on the Program) on a volume of
a storage or distribution medium does not bring the other work under
the scope of this License.
3. You may copy and distribute the Program (or a work based on it,
under Section 2) in object code or executable form under the terms of
Sections 1 and 2 above provided that you also do one of the following:
a) Accompany it with the complete corresponding machine-readable
source code, which must be distributed under the terms of Sections
1 and 2 above on a medium customarily used for software interchange; or,
b) Accompany it with a written offer, valid for at least three
years, to give any third party, for a charge no more than your
cost of physically performing source distribution, a complete
machine-readable copy of the corresponding source code, to be
distributed under the terms of Sections 1 and 2 above on a medium
customarily used for software interchange; or,
c) Accompany it with the information you received as to the offer
to distribute corresponding source code. (This alternative is
allowed only for noncommercial distribution and only if you
received the program in object code or executable form with such
an offer, in accord with Subsection b above.)
The source code for a work means the preferred form of the work for
making modifications to it. For an executable work, complete source
code means all the source code for all modules it contains, plus any
associated interface definition files, plus the scripts used to
control compilation and installation of the executable. However, as a
special exception, the source code distributed need not include
anything that is normally distributed (in either source or binary
form) with the major components (compiler, kernel, and so on) of the
operating system on which the executable runs, unless that component
itself accompanies the executable.
If distribution of executable or object code is made by offering
access to copy from a designated place, then offering equivalent
access to copy the source code from the same place counts as
distribution of the source code, even though third parties are not
compelled to copy the source along with the object code.
4. You may not copy, modify, sublicense, or distribute the Program
except as expressly provided under this License. Any attempt
otherwise to copy, modify, sublicense or distribute the Program is
void, and will automatically terminate your rights under this License.
However, parties who have received copies, or rights, from you under
this License will not have their licenses terminated so long as such
parties remain in full compliance.
5. You are not required to accept this License, since you have not
signed it. However, nothing else grants you permission to modify or
distribute the Program or its derivative works. These actions are
prohibited by law if you do not accept this License. Therefore, by
modifying or distributing the Program (or any work based on the
Program), you indicate your acceptance of this License to do so, and
all its terms and conditions for copying, distributing or modifying
the Program or works based on it.
6. Each time you redistribute the Program (or any work based on the
Program), the recipient automatically receives a license from the
original licensor to copy, distribute or modify the Program subject to
these terms and conditions. You may not impose any further
restrictions on the recipients' exercise of the rights granted herein.
You are not responsible for enforcing compliance by third parties to
this License.
7. If, as a consequence of a court judgment or allegation of patent
infringement or for any other reason (not limited to patent issues),
conditions are imposed on you (whether by court order, agreement or
otherwise) that contradict the conditions of this License, they do not
excuse you from the conditions of this License. If you cannot
distribute so as to satisfy simultaneously your obligations under this
License and any other pertinent obligations, then as a consequence you
may not distribute the Program at all. For example, if a patent
license would not permit royalty-free redistribution of the Program by
all those who receive copies directly or indirectly through you, then
the only way you could satisfy both it and this License would be to
refrain entirely from distribution of the Program.
If any portion of this section is held invalid or unenforceable under
any particular circumstance, the balance of the section is intended to
apply and the section as a whole is intended to apply in other
circumstances.
It is not the purpose of this section to induce you to infringe any
patents or other property right claims or to contest validity of any
such claims; this section has the sole purpose of protecting the
integrity of the free software distribution system, which is
implemented by public license practices. Many people have made
generous contributions to the wide range of software distributed
through that system in reliance on consistent application of that
system; it is up to the author/donor to decide if he or she is willing
to distribute software through any other system and a licensee cannot
impose that choice.
This section is intended to make thoroughly clear what is believed to
be a consequence of the rest of this License.
8. If the distribution and/or use of the Program is restricted in
certain countries either by patents or by copyrighted interfaces, the
original copyright holder who places the Program under this License
may add an explicit geographical distribution limitation excluding
those countries, so that distribution is permitted only in or among
countries not thus excluded. In such case, this License incorporates
the limitation as if written in the body of this License.
9. The Free Software Foundation may publish revised and/or new versions
of the General Public License from time to time. Such new versions will
be similar in spirit to the present version, but may differ in detail to
address new problems or concerns.
Each version is given a distinguishing version number. If the Program
specifies a version number of this License which applies to it and "any
later version", you have the option of following the terms and conditions
either of that version or of any later version published by the Free
Software Foundation. If the Program does not specify a version number of
this License, you may choose any version ever published by the Free Software
Foundation.
10. If you wish to incorporate parts of the Program into other free
programs whose distribution conditions are different, write to the author
to ask for permission. For software which is copyrighted by the Free
Software Foundation, write to the Free Software Foundation; we sometimes
make exceptions for this. Our decision will be guided by the two goals
of preserving the free status of all derivatives of our free software and
of promoting the sharing and reuse of software generally.
NO WARRANTY
11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN
OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS
TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE
PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
REPAIR OR CORRECTION.
12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
POSSIBILITY OF SUCH DAMAGES.
END OF TERMS AND CONDITIONS
How to Apply These Terms to Your New Programs
If you develop a new program, and you want it to be of the greatest
possible use to the public, the best way to achieve this is to make it
free software which everyone can redistribute and change under these terms.
To do so, attach the following notices to the program. It is safest
to attach them to the start of each source file to most effectively
convey the exclusion of warranty; and each file should have at least
the "copyright" line and a pointer to where the full notice is found.
<one line to give the program's name and a brief idea of what it does.>
Copyright (C) <year> <name of author>
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
Also add information on how to contact you by electronic and paper mail.
If the program is interactive, make it output a short notice like this
when it starts in an interactive mode:
Gnomovision version 69, Copyright (C) year name of author
Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
This is free software, and you are welcome to redistribute it
under certain conditions; type `show c' for details.
The hypothetical commands `show w' and `show c' should show the appropriate
parts of the General Public License. Of course, the commands you use may
be called something other than `show w' and `show c'; they could even be
mouse-clicks or menu items--whatever suits your program.
You should also get your employer (if you work as a programmer) or your
school, if any, to sign a "copyright disclaimer" for the program, if
necessary. Here is a sample; alter the names:
Yoyodyne, Inc., hereby disclaims all copyright interest in the program
`Gnomovision' (which makes passes at compilers) written by James Hacker.
<signature of Ty Coon>, 1 April 1989
Ty Coon, President of Vice
This General Public License does not permit incorporating your program into
proprietary programs. If your program is a subroutine library, you may
consider it more useful to permit linking proprietary applications with the
library. If this is what you want to do, use the GNU Library General
Public License instead of this License.

BIN
docs/images/rms_logo.gif Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 3.4 KiB

193
docs/rawmat.css Normal file
View file

@ -0,0 +1,193 @@
body {
color: #444444;
font-family: Tahoma, Geneva, Arial, Helvetica, sans-serif;
font-size: 0.8em;
line-height: 1.5em;
text-align: left;
background: #e0e0e0;
}
a { color: #005888; }
a:hover { color: #1c90b0; }
a:visited { color: #006699; }
a:visited:hover { color: #1c90b0; }
h1 {
font-family: "Arial Narrow", Tahoma, Geneva, Arial, Helvetica, sans-serif;
font-size: 1.6em;
color: #006b95;
margin: 15px 0 15px 0;
padding-left: 15px;
}
h2 {
font-family: "Arial Narrow", Tahoma, Geneva, Arial, Helvetica, sans-serif;
font-size: 1.3em;
color: #007aac;
margin: 15px;
}
h3 {
font-family: "Arial Narrow", Tahoma, Geneva, Arial, Helvetica, sans-serif;
font-size: 1.1em;
color: #56a7c1;
margin: 15px;
}
p {
margin: 10px 15px 5px 15px;
}
pre {
font-family: monospace;
font-size: 1.1em;
line-height: 1.1em;
}
code {
font-family: monospace;
font-size: 1.2em;
line-height: 1.1em;
}
.pageholder {
width: 800px;
min-width: 800px;
margin: 10px auto 0 auto;
background: #ffffff none;
padding: 0 !important; position: relative; }
.banner {
height: 90px;
background: #3366cc none; line-height: 20px; font-family: Arial, Tahoma, Geneva, Helvetica, sans-serif; }
.banner img {
float: left;
color: #ffffff;
margin: 15px 0 0 16px;
border: 0;
background: none; font-family: sans-serif; font-size: 25px;
}
.mainsections {
margin: 6px 0px 6px 0px;
padding: 0; position: absolute; left: 390px; top: 56px;
float: left;
font-size: 13px; }
.mainsections ul {
margin: 0;
padding: 0 0 0 10px; background-color: #3366cc; background-image: none; }
.mainsections li {
list-style-type: none;
float: left;
width: auto;
min-width: 50;
min-height: 22px; max-height: 22px;
text-align: center; margin: 6px 4px 0px 4px;
font-size: 12px; background: url(images/inactiverightcorner.gif) no-repeat top right; }
.mainsections a:link, .mainsections a:visited {
display: block;
color: #d0eef3; text-decoration: none;
padding: 2px 8px 0px 10px;
background: url(images/inactiveleftcorner.gif) no-repeat top left;
max-height: 20px; }
.mainsections a:hover, .mainsections a:visited:hover {
color: #ffffff;
text-decoration: none;
padding: 2px 8px 0px 10px;
}
.currentsection {
margin-top: 4px;
background-image: url(images/activerightcorner.gif) !important;
}
.currentsection a:link, .currentsection a:visited {
color: #006b95 !important;
background-image: url(images/activeleftcorner.gif) !important;
}
.currentsection a:hover, .currentsection a:visited:hover {
color: #2c93b0 !important;
}
.subsections {
clear: both;
}
.subsections ul {
margin: 0;
padding: 0 6px 0 6px;
}
.subsections li {
list-style-type: none;
float: left;
margin: 0px 4px 0 4px;
background-image: url(images/inactivesubsection.gif);
background-repeat: no-repeat;
background-position: center left;
padding-left: 10px; }
.subsections a:link, .subsections a:visited {
padding: 0 4px 0 4px;
text-decoration: none;
}
.currentsubsection a:link, .currentsubsection a:visited {
font-weight: bold;
color: #000099;
}
.currentsubsection {
background-image: url(images/activesubsection.gif) !important;
}
.content {
clear: both;
float: none;
padding: 2px 5px 0 5px;
min-height: 500px;
background-image: none;
font-family: Georgia, Helvetica, sans-serif;
}
.prop {
float: right;
width: 1px;
height: 400px;
}
.bottomsection {
clear: both;
text-align: center;
background-image: none;
margin: 0;
padding: 15px 0 12px 0;
}
.bottombar {
padding: 5px;
background: #3366cc none;
margin: 10px 0 10px 0 !important;
color: #ffffff; height: 26px;
font-size: 0.8em;
}
.bottombar a, .bottombar a:visited {
color: #d0eef0 !important;
}
.bottomtext a:hover, .bottomtext a:visited:hover {
color: #ffffff !important;
}
.ad {
clear: both;
padding: 30px 0 0 0;
text-align: center;
}