Script: Quick Calc 3.0
Build: 404.4
mIRC Version: 5.51
Author: Daryth
Homepage: http://users.ncia.net/~paulc/
Email: paulc@ncia.net
               

1) *****(Humble Request)*****

	   Please do not rip any of the code in this script at all. If you would like
	to distribute this addon with your script please keep everything intact including
	this text file and everything in the script.
	

2) *****(Description)*****

   	   Quick Calc 3.0 is the long over due update to Quick Calc 2.01. It has been 
	totally rescripted from scratch to take advantage of mIRC 5.51's new features.
	It has all the features found in the previous versions plus a few extras like 
	Multiple graphing support, Graphing Zooming features with variable window dimensions, 
	Fixed/Floating decimal support, more robust table support and all at less than 
	half the size of 2.0x.


3) *****(Loading the Script)*****

	   To load the script make sure you have all the files unzipped into the same
	directory and in mIRC 5.51 or later (it will fail to load in previous versions)
	type "/load -rs qcalc3.mrc" without the quotes. If you unzipped the script into 
	a different directory other than the your mirc directory type 
	"/load -rs drive:\directory\qcalc3.mrc" where drive:\directory is the location 
	of where you unzipped the addon. 


4) *****(Starting the Script)*****

	   To run the script right click in a channel or the status window and go down
	to Quick Calc 3.0 and then go over and click on Quick Calc 3.0. You can also type
	"/qcalc3" without the quotes to run it.


5) *****(What's New in this Release?)*****

	   Many this have changed since the last public release of Quick Calc, This version
	has been totally rescripted to take advantage of mIRC 5.51's new offerings.
	Since this is just a major release of it I'll list off all the features found in
	this release and mark all the features and were not found in the last release 
	with a * for those you that used previous versions of this script.


		1) Standard Calculator features such as add, subtract, multiply, divide,
		   square roots, exponents, etc.

		2) Trig Functions just as sine, cosine, tangent, arcsine, arccosine &
		   arctangent.

		3) Variable support, assign values to any variable you wish and call them
		   back up at a latter time.

		4) Radian & Degree measures

	     *  5) Decimal Display settings, choose to display decimal answers in a fixed 
		   or floating manner.

	     *  6) Sum & Factorial calculating (Sum was added in 3.0)

	     *  7) Adjustable History/Answer display area which can display up to 100 of 
		   your last inputed problem answers. (History Size was not adjustable in
		   previous versions)

	     *  8) Full Multiple Graphing support, Graph up to 10 Equations at the same time
		   with configurable colors for each graph.

	     *  9) Adjustable Table support, displays the y values for all the y vars at 
		   designated x cordinate. 

	     * 10) Full Graphing window tweaking from Window width & height to x & y min &
		   max values and x-res (changes graphing resolution)

	       11) Changable Plot Types, allows you to select from Connected Points or Just
		   plain Points.

	     * 12) Settings to turn on and off Graph Axes and Grid (Grid display and the 
		   ability to turn off axes has been added in 3.0)

	     * 13) [Removed] Might return in another build


6) *****(Buttons Explanation)*****

  [Row 1]

	Home:   Takes you to the main calculation screen. This is where all the answers
	        will be displayed.

	Y=:     This brings you to the Y= screen which allows you to enter equations to be
		graphed.

	Window: This button will bring you to the window setup screen which allows you to 
		change the Graphing Window settings from Window width & height to the 
		graphing resolution.

		win-w : The Graphing Windows width in pixels
		win-h : The Graphing Windows height in pixels
		x-min : The Minimum X Value boundry of the Graph
		x-max : The Maximum X Value boundry of the Graph
		x-min : The Minimum Y Value boundry of the Graph
		x-max : The Maximum Y Value boundry of the Graph
		X-res : The Graphing Resolution (must be > 0) [Default 2]

	Graph:  This will graph whatever equations are stored in the Y=. This will open
		a new window to draw the graph because of the inability to draw
		stuff inside a dialog window and it also allows for more flexibility.

	TblSet: This brings you to the Table Setting window, This allows you to change
		the table min & max values and the scale to go by.

		t-min   : The lowest value to start calculating the y values from
		t-max   : The highest value to calculate y from
		t-start : What value to select after it's done calculating the table
		t-scale : What value to increase x by each time to get y

	Table:  This will display the Table window with the x & y values of all the 
		graphs stored in the Y=

  
  [Row 2]

     2nd:	Changes the function of a few buttons on the calculator to do different things.
		All of which have a (2) by it if they are second functions.

     X-Var:     The X variable to be used in the Y= screen only (disabled in any other screen)

 (2) Var-Link:  Brings up the variable link window to insert, delete or clear all variables.

     Catalog:	Brings up the catalog window which allows access to a all the functions 
		available in Quick Calc. 

     Mode:	Allows you to change the various Quick Calc settings.

		Plots Type :      Choose from Connected Points or just Points
		Angle :           Change the angle from Radians to Degrees (for Trig Functions)
		Decimal Numbers : Change the way decimal numbers are displayed, float/fixed
		History Pairs :   How many lines the history list can have at the most
		Axes : 		  Turn On or Off the Graphing Axes
		Grid : 		  Turn On or Off the Graphing Background Grid
		Cordinates:	  Turn On or Off Cordinates Display
		Colors : 	  Change the colors of the Y variables

     Back:	Deletes the last character that was entered

     Clear:	Clears the whole equation box

 (2) ClrHst:	Clears the whole history display list

  [Row 3]

     ( & ):	Parentheses which are used to open and close functions and change the 
		order of evaluation of things.

 (2) [ & ]:	Brackets are like Parentheses but are used if you want to do something like
		5[6] and you want it to be multipled. (Can't use ( & )'s because of the
		major difference in the way everything is calculated out)

     Sin: 	Will take the sine of the number following it.

 (2) ArcSin: 	The Arcsine of the number following it (-1 to 1 only)

     Cos: 	Will take the cosine of the number following it.

 (2) ArcCos: 	The Arccosine of the number following it  (-1 to 1 only)

     Tan: 	Will take the tangent of the number following it.
		 
 (2) ArcTan:	The Arctangent of the number following it (-1 to 1 only)

     Stor: 	Will store the answer of the current equation into the specified variable.

 (2) Recall:	Returns the value of the specified variable.

  [Row 4]

     7,8,9:	The numbers... nothing special about them.

     Log:	Returns the common log of the number after it.

     Ln:	Returns the natural log of the number after it.

     Abs:	Will return the absolute value of the specified number. (how far away from 0)

  [Row 5]

     4,5,6:	A few numbers you should have a firm grasp on.

     n!:	Takes the factorial of the number following it. ex !(4) = 24 because 4*3*2*1=24

     e^x:	Returns e raised to the x power. ex e^1 = 2.718 

     ^:		Raises the presceding number to the following power. ex 2^3 = 8

  [Row 6]

     1,2,3:	A few simply numbers you should have know for a while

     x:		Multiply, Returns the product of the first number and the second number.

     /: 	Division.. Returns the quotient of the first number and the second number.
            	ex 9/3 = 3

     Sqrt:	Takes the Square of the number inside of it (has to be >0 or 0)

  [Row 7]

   0: 		The number zero, anything that gets divided by zero will return 'Undefined'

   .: 		Decimal point... hopefully no explaination of this is needed.

   Pi: 		Returns Pi, that 3.14159 Number that never ends.

   +: 		Addition.. Returns the sum of the first and second number. ex 512+34=546
 
   -: 		Subtraction.. Subtracts the second number from the first. ex 100-87=13

   Enter: 	Multiple functions.

		Home    :  Solves the equation (same as =)
		Y=      :  Assigns the equation in the editbox to the selected y var
		Window  :  Changes the selected setting to it's new value
		TblSet	:  Changes the selected setting to it's new value


7) *****(Things you should know)*****

	a)	Quick Calc uses a value of Pi rounded to 5 decimal points 

	b)	Changing x-res to a higher value will speed up the graphing speed but 
		sacrifices accuracy for it which is really apparent when you are uses
		Points instead of Connected points.

	c)	Double Clicking on anything will usually insert it into the editbox for
		changing or to be used in a equation.

	d)	Right Clicking on the Graph will bring up a menu to allow you to Zoom and
		change the graphing window settings.

	e)	All Floating point answers get rounded at 5 decimal places because mIRC
		can't handle more than that.

	f)	It's important to close all your parantheses so your answer gets calculated
		right. (When it automatically closes them for you it just adds them at the
		end which might not be what you wanted)

	g)	If you don't specify a value for each function you put in (ie sin() instead of
		sin(N)) you'll get a error in your status window

	h)	Bug Reports & Feature requests are welcome... honest...


									-Daryth

EOF 

