Java Class File:		Prince.class
Version:			5.0 r2
Java Package:			com.princexml
Java Class:			com.princexml.Prince
Class Methods:

	1) Constructor methods: 

		There are two overloaded constructor methods:
		
		public Prince(String exePath)

		public Prince(String exePath, PrinceEvents events)

		exePath -- the full path of the prince.exe file. if you have Prince installed, it should be in
			   the prince\engine\bin directory.

		events -- a reference to an instance of a class that implements the PrinceEvents interface. See
			  the section below for details of the PrinceEvents interface.		

	2) public void addStyleSheet(String cssPath)

		cssPath -- the full path of the Cascading Style Sheet css file. 

	   	AddStyleSheet can be called many times to add different style sheets. Style sheets are 
		accumulated and are applied to the conversion. 

	   	This method should be called before calling a Convert method for the style sheet(s) to be 
                applied.

	3) Public void clearStyleSheets()

	   	This method clears all of the accumulated style sheet(s).

	4) public boolean convert(String xmlPath) throws IOException

		xmlPath -- the full path of the xml file.
		
		This method converts the xml file to pdf file. The output pdf file will be placed in the same 
		directory as the xml file. It returns TRUE if the conversion is successful, FALSE if the
		conversion fails.
	
	5) public boolean convert(String xmlPath, String pdfPath) throws IOException

		xmlPath -- the full path of the xml file.
		pdfPath -- the full path of the output pdf file.
		
		This method converts the xml file to pdf file. The output pdf file will be placed in the
		directory specified by pdfPath. It returns TRUE if the conversion is successful, FALSE if the
		conversion fails.

	6) public boolean convert(InputStream xmlInput, OutputStream pdfOutput) throws IOException

		xmlInput -- InputStream argument from which Prince will read the input xml file.
		pdfOutput -- OutputStream argument to which Prince will write the output pdf file.

		This method returns TRUE if the conversion is successful, FALSE if the conversion fails.


	7) public void setEncryptInfo(int keyBits,
                               	      String userPassword,
                               	      String ownerPassword,
                               	      boolean disallowPrint,
                               	      boolean disallowModify,
                               	      boolean disallowCopy,
                               	      boolean disallowAnnotate)

		This method can be called if encryption is required. It should be called before calling a
                Convert method for encryption information to be applied.

		1. Int keyBits can be either 40 or 128.
		2. String userPassword sets the password the user will have to type in to open the pdf file
		   as a user.
		3. String ownerPassword sets the password the user will have to type in to open the pdf file
		   as the owner.
		4. Boolean disallowPrint, if set true, printing will be disallowed for the user.
		5. Boolean disallowMOdify, if set true, modifying will be disallowed for the user.
		6. Boolean disallowCopy, if set true, copying text will be disallowed for the user.
		7. Boolean disallowAnnotate, if set true, Annotation will be disallowed for the user.

------------------------------------------------------------------------------------------------------------

Java Interface File:		PrinceEvents.class
Version:			5.0 r2
Java Package:			com.princexml
Java Interface:			com.princexml.PrinceEvents

	public interface PrinceEvents{
    		public void onMessage(String msgType, String msgLocation, String msg);
	}


	msgType:
			Value    Meaning				

			"inf" -- information
			"wrn" -- warning
			"err" -- error

	msgLocation:  	shows where the message came from or where the error occured (this can be empty).

	msg:    	is the content of the message

	Users wishing to process messages coming from Prince during conversion should create a Java class 
	of their own that implements the PrinceEvents interface and provide a customised definition of the
	onMessage method. An object of that class should then be instantiated and passed into the Prince
	constructor when instantiating a Prince object.

