<commit_before><!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
    <HEAD>
	<!-- 	$Id$	 -->
	<META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=windows-1252"/>
	<TITLE>Audiveris Installation Manual</TITLE>
	<META NAME="AUTHOR" CONTENT="<NAME>"/>
	<META NAME="CREATED" CONTENT="20050429;15271809"/>
	<META NAME="CLASSIFICATION" CONTENT="Procedure for Audiveris installation"/>
	<META NAME="DESCRIPTION" CONTENT="How to retrieve the Audiveris software and how to install it on your environment"/>

	<!-- The following links are meant to be solved on my local PC -->
	<!-- The java.net site uses its own style sheets -->
 	<LINK REL="stylesheet" TYPE="text/css" HREF="../../branding/css/tigris.css"/>
 	<LINK REL="stylesheet" TYPE="text/css" HREF="../../branding/css/inst.css"/>

    </HEAD>

    <BODY MARGINWIDTH="0" MARGINHEIGHT="0" CLASS="COMPOSITE">
	
	<DIV CLASS="app" STYLE="text-align: justify;">
	    
	    <H1 ALIGN=CENTER>Audiveris Installation Manual</H1>
	    
	    <ADDRESS>Author : <A HREF="mailto:<EMAIL>">Herv&eacute;
		Bitteur</A></ADDRESS>
	    <ADDRESS>Updated : 11 May 2005</ADDRESS>

	    <A NAME="DOWNLOAD">
		<H2>Getting Audiveris software</H2>
	    </A>
	    
	    <P>The latest version is always available on the <A
            HREF="https://audiveris.dev.java.net/nonav/servlets/ProjectDocumentList?folderID=3257&expandFolder=3257&folderID=3257">
		Audiveris download area</A></P>

	    <A NAME="REQUIREMENTS">
		<H2>System Requirements</H2>
	    </A>
	    
	    <P> Audiveris is essentially a Java application, and as
		such should be usable on a wide variety of platforms. Is
		has been successfully used under Linux in the past and is
		currently being developed and used under Windows (2000 and
		XP).</P>
	    
	    <P><B>Beware</B> that Audiveris uses many features
		from <B>Java 5.0</B>, so you must have this version of Java
		environment available.</P>
	    
	    <P> In terms of resources, memory turns out to be more
		important that CPU power. Make sure you have 256MB of
		physical memory as a bare minimum, 512MB is much more
		comfortable. As an example, Audiveris is developed and
		run today on an old AMD Athlon (0.9 GHz, 768 MB)</P>

	    <A NAME="COMPANIONS">
		<H2>Companion tools</H2>
	    </A>
	    
	    <P>This section lists all components that are used by
		Audiveris for various functions, and thus need to be
		properly installed beforehand.</P>

	    <A NAME="MUSIC_FONT">
		<H3>Music Font (Musette)</H3>
	    </A>
	    
	    <P> This font is used only to provide icons in selection
		menus. For the time being we use the "Musette" font, a
		free True-Type font. However, it lacks many items, so
		we'll have to find out a more complete one some day.</P>
	    
	    <P> The font can be downloaded for the following <A
                HREF="http://www.canzona.com/music/musette/index.shtml">
                Musette web-site</A> dedicated to the "Musette music
                editor". The font itself is made available a few
                paragraphs down the page, or directly from <A
                HREF="http://canzona.com/cgi-bin/musette/countdown.cgi?musttf.exe">
		here</A>.</P>
	    
	    <P>The font must then be installed on Windows just like any
		other TTF font.</P>

	    <A NAME="JAI">
		<H3>Java Advanced Imaging (JAI)</H3>
	    </A>
	    
	    <P> JAI is a comprehensive framework for image processing,
		of which Audiveris makes a rather limited use :</P>
	    <UL>
		<LI><I>"fileload"</I> operator : Loading an image
		    file, taking advantage of the long list of
		    supported file formats supported by JAI</LI>
		<LI><I>"mosaic"</I> operator : Combining several
		images into one</LI>
		<LI><I>"rotate"</I> operator : Rotating an image</LI>
		<LI><I>"affine"</I> operator : Translating an image</LI>
	    </UL>		 
	    
	    <P> JAI has its high-level features coded in Java, and
		low-level primitives delegated to native libraries. It
		is implemented as a collection of jar files and DLLs
		(under Windows). It is better installed directly in
		your JDK (or JRE) by using the installation procedure
		found at the <A
		HREF="http://java.sun.com/products/java-media/jai/">JAI
		web-site</A>. Audiveris uses the latest JAI version
		(1.1.2).</P>

	    <A NAME="OTHER_COMPONENTS">
		<H3>Other components</H3>
	    </A>
	    
	    <P> All the following components need no special
		installation procedure, only their jar files have to be
		made available, for example via the classpath, to
		Audiveris at build or run time (see the provided file
		'build.xml' for build and run examples).</P>
		
	    <P><I>Nota : The versions for jar files are the ones used at
		the time of this writing, but higher versions should be
		usable as well (though not yet tested)</I></P>
	    
	    <TABLE WIDTH=100% BORDER=1>
		<TR>
		    <TH>Component</TH>
		    <TH>Purpose</TH>
		    <TH>Jar File(s)</TH>
		    <TH>Provider URL</TH>
		</TR>
		<TR CLASS="a">
		    <TD><B>Castor</B></TD>
		    <TD>XML databinding framework</TD>
		    <TD>castor-0.9.5.2-xml.jar</TD>
		    <TD><A HREF="http://www.castor.org/">
			http://www.castor.org/
			</A></TD>
		</TR>
		<TR CLASS="b">
		    <TD><B>Ant</B></TD>
		    <TD>Xerces implementation needed by Castor</TD>
		    <TD>xercesImpl.jar</TD>
		    <TD><A HREF="http://ant.apache.org/">
			http://ant.apache.org/
			</A></TD>
		</TR>
		<TR CLASS="a">
		    <TD><B>JGoodies/looks</B></TD>
		    <TD>Improvement of appearance of Swing</TD>
		    <TD>looks-1.3.jar</TD>
		    <TD><A HREF="https://looks.dev.java.net/">
			https://looks.dev.java.net/
			</A></TD>
		</TR>
		<TR CLASS="b">
		    <TD><B>JGoodies/forms</B></TD>
		    <TD>Forms layout system for Swing</TD>
		    <TD>forms-1.0.5.jar</TD>
		    <TD><A HREF="https://forms.dev.java.net/">
			    https://forms.dev.java.net/
			</A></TD>
		</TR>
		<TR CLASS="a">
		    <TD><B>JFreeChart</B></TD>
		    <TD>Chart generation, with common utilities</TD>
		    <TD>jfreechart-1.0.0-pre2.jar
			<BR/>
			jcommon-1.0.0-pre2.jar</TD>
		    <TD><A HREF="http://www.jfree.org/jfreechart/">
			    http://www.jfree.org/jfreechart/
			</A></TD>
		</TR>
		<TR CLASS="b">
		    <TD><B>Java L&amp;F Graphics Repository</B></TD>
		    <TD>Collection of toolbar button graphics</TD>
		    <TD>jlfgr-1_0.jar</TD>
		    <TD><A HREF="http://java.sun.com/developer/techDocs/hi/repository/">
			    http://java.sun.com/developer/techDocs/hi/repository/
			</A></TD>
		</TR>
		<TR CLASS="a">
		    <TD><B>Log4J</B></TD>
		    <TD>Application logging framework</TD>
		    <TD>log4j-1.2.8.jar</TD>
		    <TD><A HREF="http://logging.apache.org/log4j/docs/">
			    http://logging.apache.org/log4j/docs/<commit_msg>Updated with latest companion versions<commit_after><!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
    <HEAD>
	<!-- 	$Id$	 -->
	<META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=windows-1252"/>
	<TITLE>Audiveris Installation Manual</TITLE>
	<META NAME="AUTHOR" CONTENT="<NAME>"/>
	<META NAME="CREATED" CONTENT="20050429;15271809"/>
	<META NAME="CLASSIFICATION" CONTENT="Procedure for Audiveris installation"/>
	<META NAME="DESCRIPTION" CONTENT="How to retrieve the Audiveris software and how to install it on your environment"/>

	<!-- The following links are meant to be solved on my local PC -->
	<!-- The java.net site uses its own style sheets -->
 	<LINK REL="stylesheet" TYPE="text/css" HREF="../../branding/css/tigris.css"/>
 	<LINK REL="stylesheet" TYPE="text/css" HREF="../../branding/css/inst.css"/>

    </HEAD>

    <BODY MARGINWIDTH="0" MARGINHEIGHT="0" CLASS="COMPOSITE">
	
	<DIV CLASS="app" STYLE="text-align: justify;">
	    
	    <H1 ALIGN=CENTER>Audiveris Installation Manual</H1>
	    
	    <ADDRESS>Author : <A HREF="mailto:<EMAIL>">Herv&eacute;
		Bitteur</A></ADDRESS>
	    <ADDRESS>Updated : 11 May 2005</ADDRESS>

	    <A NAME="DOWNLOAD">
		<H2>Getting Audiveris software</H2>
	    </A>
	    
	    <P>The latest version is always available on the <A
            HREF="https://audiveris.dev.java.net/nonav/servlets/ProjectDocumentList?folderID=3257&expandFolder=3257&folderID=3257">
		Audiveris download area</A></P>

	    <A NAME="REQUIREMENTS">
		<H2>System Requirements</H2>
	    </A>
	    
	    <P> Audiveris is essentially a Java application, and as
		such should be usable on a wide variety of platforms. Is
		has been successfully used under Linux in the past and is
		currently being developed and used under Windows (2000 and
		XP).</P>
	    
	    <P><B>Beware</B> that Audiveris uses many features
		from <B>Java 5.0</B>, so you must have this version of Java
		environment available.</P>
	    
	    <P> In terms of resources, memory turns out to be more
		important that CPU power. Make sure you have 256MB of
		physical memory as a bare minimum, 512MB is much more
		comfortable. As an example, Audiveris is developed and
		run today on an old AMD Athlon (0.9 GHz, 768 MB)</P>

	    <A NAME="COMPANIONS">
		<H2>Companion tools</H2>
	    </A>
	    
	    <P>This section lists all components that are used by
		Audiveris for various functions, and thus need to be
		properly installed beforehand.</P>

	    <A NAME="MUSIC_FONT">
		<H3>Music Font (Musette)</H3>
	    </A>
	    
	    <P> This font is used only to provide icons in selection
		menus. For the time being we use the "Musette" font, a
		free True-Type font. However, it lacks many items, so
		we'll have to find out a more complete one some day.</P>
	    
	    <P> The font can be downloaded for the following <A
                HREF="http://www.canzona.com/music/musette/index.shtml">
                Musette web-site</A> dedicated to the "Musette music
                editor". The font itself is made available a few
                paragraphs down the page, or directly from <A
                HREF="http://canzona.com/cgi-bin/musette/countdown.cgi?musttf.exe">
		here</A>.</P>
	    
	    <P>The font must then be installed on Windows just like any
		other TTF font.</P>

	    <A NAME="JAI">
		<H3>Java Advanced Imaging (JAI)</H3>
	    </A>
	    
	    <P> JAI is a comprehensive framework for image processing,
		of which Audiveris makes a rather limited use :</P>
	    <UL>
		<LI><I>"fileload"</I> operator : Loading an image
		    file, taking advantage of the long list of
		    supported file formats supported by JAI</LI>
		<LI><I>"mosaic"</I> operator : Combining several
		images into one</LI>
		<LI><I>"rotate"</I> operator : Rotating an image</LI>
		<LI><I>"affine"</I> operator : Translating an image</LI>
	    </UL>		 
	    
	    <P> JAI has its high-level features coded in Java, and
		low-level primitives delegated to native libraries. It
		is implemented as a collection of jar files and DLLs
		(under Windows). It is better installed directly in
		your JDK (or JRE) by using the installation procedure
		found at the <A
		HREF="http://java.sun.com/products/java-media/jai/">JAI
		web-site</A>.</P>

	    <P> Audiveris uses the latest JAI version
		(1.1.3-alpha).</P>

	    <P> <B>Nota:</B> If not correctly installed, the native
		libraries cannot be used, and JAI issues the following
		warning :
		<DIV CLASS="warningmessage">
		    Could not load mediaLib accelerator wrapper
		    classes. Continuing in pure Java mode.
		</DIV></P>

	    <A NAME="OTHER_COMPONENTS">
		<H3>Other components</H3>
	    </A>
	    
	    <P> All the following components need no special
		installation procedure, only their jar files have to be
		made available, for example via the classpath, to
		Audiveris at build or run time (see the provided file
		'build.xml' for build and run examples).</P>
		
	    <P><I>Nota : The versions for jar files are the ones used at
		the time of this writing, but higher versions should be
		usable as well (though not yet tested)</I></P>
	    
	    <TABLE WIDTH=100% BORDER=1>
		<TR>
		    <TH>Component</TH>
		    <TH>Purpose</TH>
		    <TH>Jar File(s)</TH>
		    <TH>Provider URL</TH>
		</TR>
		<TR CLASS="a">
		    <TD><B>Castor</B></TD>
		    <TD>XML databinding framework</TD>
		    <TD>castor-0.9.7-xml.jar</TD>
		    <TD><A HREF="http://www.castor.org/">
			http://www.castor.org/
			</A></TD>
		</TR>
		<TR CLASS="b">
		    <TD><B>Ant</B></TD>
		    <TD>Xerces implementation needed by Castor</TD>
		    <TD>xercesImpl.jar</TD>
		    <TD><A HREF="http://ant.apache.org/">
			http://ant.apache.org/
			</A></TD>
		</TR>
		<TR CLASS="a">
		    <TD><B>JGoodies/looks</B></TD>
		    <TD>Improvement of appearance of Swing</TD>
		    <TD>looks-1.3.1.jar</TD>
		    <TD><A HREF="https://looks.dev.java.net/">
			https://looks.dev.java.net/
			</A></TD>
		</TR>
		<TR CLASS="b">
		    <TD><B>JGoodies/forms</B></TD>
		    <TD>Forms layout system for Swing</TD>
		    <TD>forms-1.0.5.jar</TD>
		    <TD><A HREF="https://forms.dev.java.net/">
			    https://forms.dev.java.net/
			</A></TD>
		</TR>
		<TR CLASS="a">
		    <TD><B>JFreeChart</B></TD>
		    <TD>Chart generation, with common utilities</TD>
		    <TD>jfreechart-1.0.0-rc1.jar
			<BR/>
			jcommon-1.0.0-rc1.jar</TD>
		    <TD><A HREF="http://www.jfree.org/jfreechart/">
			    http://www.jfree.org/jfreechart/
			</A></TD>
		</TR>
		<TR CLASS="b">
		    <TD><B>Java L&amp;F Graphics Repository</B></TD>
		    <TD>Collection of toolbar button graphics</TD>
		    <TD>jlfgr-1_0.jar</TD>
		    <TD><A HREF="http://java.sun.com/developer/techDocs/hi/repository/">
			    http://java.sun.com/developer/techDocs/hi/repository/
			</A></TD>
		</TR>
		<TR CLASS="a">
		    <TD><B>Log4J</B></TD>
		    <TD>Application logging framework</TD>
		    <TD>log4j-1.2.9.jar</TD>
		    <TD><A HREF="http://logging.apache.org/log4j/docs/">
			    http://logging.apache.org/log4j/docs/
			</A></TD>
		</TR>
		<TR CLASS="b">
		    <TD><B>Commons Logging</B></TD>
		    <TD>Jakarta logging environment, needed by recent
		    Castor releases</TD>
		    <TD>commons-logging-1.0.5/commons-logging.jar<BR/>
			commons-logging-1.0.5/commons-logging-optional.jar</TD>
		    <TD><A HREF="http://jakarta.apache.org/commons/logging/">
			    http://jakarta.apache.org/commons/logging/
{'fraction_non_alphanumeric': 0.15147205233963873, 'fraction_numerical': 0.015645000711136395, 'mean_word_length': 2.8090465872156014, 'pattern_counts': {'":': 0, '<': 456, '<?xml version=': 0, '>': 456, 'https://': 10, 'lorem ipsum': 0, 'www.': 10, 'xml': 4}, 'pii_count': 1, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 4, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '5981528', 'n_tokens_mistral': 5576, 'n_tokens_neox': 4785, 'n_words': 1367}