Math Libraries - Revision history

Costel Mincea: Text replacement - "" to ""

2025-01-26T19:06:04Z

Text replacement - "<syntaxhighlight>" to "<syntaxhighlight lang="C" line>"

← Older revision		Revision as of 19:06, 26 January 2025
Line 72:		Line 72:
	The FFP basic math library contains entries for the basic mathematics functions such as add, subtract and divide. It resides in ROM and is opened by calling OpenLibrary() with "mathffp.library" as the argument.		The FFP basic math library contains entries for the basic mathematics functions such as add, subtract and divide. It resides in ROM and is opened by calling OpenLibrary() with "mathffp.library" as the argument.

	<syntaxhighlight>		<syntaxhighlight lang="C" line>
	#include <exec/types.h>		#include <exec/types.h>
	#include <libraries/mathffp.h>		#include <libraries/mathffp.h>
Line 135:		Line 135:
	Be sure to include the proper data type definitions shown below.		Be sure to include the proper data type definitions shown below.

	<syntaxhighlight>		<syntaxhighlight lang="C" line>
	#include <exec/types.h>		#include <exec/types.h>
	#include <libraries/mathffp.h>		#include <libraries/mathffp.h>
Line 319:		Line 319:
	The FFP transcendental math library contains entries for the transcendental math functions sine, cosine, and square root. It resides on disk and is opened by calling OpenLibrary() with "mathtrans.library" as the argument.		The FFP transcendental math library contains entries for the transcendental math functions sine, cosine, and square root. It resides on disk and is opened by calling OpenLibrary() with "mathtrans.library" as the argument.

	<syntaxhighlight>		<syntaxhighlight lang="C" line>
	#include <exec/types.h>		#include <exec/types.h>
	#include <libraries/mathffp.h>		#include <libraries/mathffp.h>
Line 399:		Line 399:
	Be sure to include proper data type definitions, as shown in the example below.		Be sure to include proper data type definitions, as shown in the example below.

	<syntaxhighlight>		<syntaxhighlight lang="C" line>
	#include <exec/types.h>		#include <exec/types.h>
	#include <libraries/mathffp.h>		#include <libraries/mathffp.h>
Line 621:		Line 621:
	It is accessed by linking code into the executable file being created. The name of the file to include in the library description of the link command line is ''amiga.lib''. When this is included, direct calls are made to the conversion functions. Only a C interface exists for the conversion functions; there is no assembly language interface. The basic math library is required in order to access these functions.		It is accessed by linking code into the executable file being created. The name of the file to include in the library description of the link command line is ''amiga.lib''. When this is included, direct calls are made to the conversion functions. Only a C interface exists for the conversion functions; there is no assembly language interface. The basic math library is required in order to access these functions.

	<syntaxhighlight>		<syntaxhighlight lang="C" line>
	#include <exec/types.h>		#include <exec/types.h>
	#include <libraries/mathffp.h>		#include <libraries/mathffp.h>
Line 658:		Line 658:
	Be sure to include proper data type definitions, as shown in the example below. Print statements have been included to help clarify the format of the math conversion function calls.		Be sure to include proper data type definitions, as shown in the example below. Print statements have been included to help clarify the format of the math conversion function calls.

	<syntaxhighlight>		<syntaxhighlight lang="C" line>
	#include <exec/types.h>		#include <exec/types.h>
	#include <libraries/mathffp.h>		#include <libraries/mathffp.h>
Line 741:		Line 741:
	The library is opened by making calling OpenLibrary() with "mathieeesingbas.library" as the argument. Do not share the library base pointer between tasks - see note at beginning of chapter for details.		The library is opened by making calling OpenLibrary() with "mathieeesingbas.library" as the argument. Do not share the library base pointer between tasks - see note at beginning of chapter for details.

	<syntaxhighlight>		<syntaxhighlight lang="C" line>
	#include <exec/types.h>		#include <exec/types.h>
	#include <libraries/mathieeesp.h>		#include <libraries/mathieeesp.h>
Line 808:		Line 808:
	Be sure to include proper data type definitions, as shown in the example below.		Be sure to include proper data type definitions, as shown in the example below.

	<syntaxhighlight>		<syntaxhighlight lang="C" line>
	#include <exec/types.h>		#include <exec/types.h>
	#include <libraries/mathieeesp.h>		#include <libraries/mathieeesp.h>
Line 991:		Line 991:
	This library resides on disk and is opened by calling OpenLibrary() with "mathieeesingtrans.library" as the argument. Do not share the library base pointer between tasks - see note at beginning of chapter.		This library resides on disk and is opened by calling OpenLibrary() with "mathieeesingtrans.library" as the argument. Do not share the library base pointer between tasks - see note at beginning of chapter.

	<syntaxhighlight>		<syntaxhighlight lang="C" line>
	#include <exec/types.h>		#include <exec/types.h>
	#include <libraries/mathieeesp.h>		#include <libraries/mathieeesp.h>
Line 1,072:		Line 1,072:
	Be sure to include the proper data type definitions as shown below.		Be sure to include the proper data type definitions as shown below.

	<syntaxhighlight>		<syntaxhighlight lang="C" line>
	#include <exec/types.h>		#include <exec/types.h>
	#include <libraries/mathieeesp.h>		#include <libraries/mathieeesp.h>
Line 1,285:		Line 1,285:
	The IEEE double-precision basic math library contains entries for the basic IEEE mathematics functions, such as add, subtract, and divide. This library resides on disk and is opened by calling OpenLibrary() with "mathieeedoubbas.library" as the argument. Do not share the library base pointer between tasks - see note at beginning of chapter for details.		The IEEE double-precision basic math library contains entries for the basic IEEE mathematics functions, such as add, subtract, and divide. This library resides on disk and is opened by calling OpenLibrary() with "mathieeedoubbas.library" as the argument. Do not share the library base pointer between tasks - see note at beginning of chapter for details.

	<syntaxhighlight>		<syntaxhighlight lang="C" line>
	#include <exec/types.h>		#include <exec/types.h>
	#include <libraries/mathieeedp.h>		#include <libraries/mathieeedp.h>
Line 1,350:		Line 1,350:
	Be sure to include proper data type definitions, as shown in the example below.		Be sure to include proper data type definitions, as shown in the example below.

	<syntaxhighlight>		<syntaxhighlight lang="C" line>
	#include <exec/types.h>		#include <exec/types.h>
	#include <libraries/mathieeedp.h>		#include <libraries/mathieeedp.h>
Line 1,531:		Line 1,531:
	The IEEE double-precision transcendental math library contains entries for the transcendental math functions such as sine, cosine, and square root. The library resides on disk and is opened by calling OpenLibrary() with "mathieeedoubtrans.library" as the argument. Do not share the library base pointer between tasks - see note at beginning of chapter for details.		The IEEE double-precision transcendental math library contains entries for the transcendental math functions such as sine, cosine, and square root. The library resides on disk and is opened by calling OpenLibrary() with "mathieeedoubtrans.library" as the argument. Do not share the library base pointer between tasks - see note at beginning of chapter for details.

	<syntaxhighlight>		<syntaxhighlight lang="C" line>
	#include <exec/types.h>		#include <exec/types.h>
	#include <libraries/mathieeedp.h>		#include <libraries/mathieeedp.h>
Line 1,612:		Line 1,612:
	Be sure to include proper data type definitions as shown below.		Be sure to include proper data type definitions as shown below.

	<syntaxhighlight>		<syntaxhighlight lang="C" line>
	#include <exec/types.h>		#include <exec/types.h>
	#include <libraries/mathieeedp.h>		#include <libraries/mathieeedp.h>

Rob Cranley: /* FFP Floating Point Data Format */ Added "(bit 7)" to identify the sign bit as it was not otherwise obvious

2023-08-03T09:53:32Z

FFP Floating Point Data Format: Added "(bit 7)" to identify the sign bit as it was not otherwise obvious

← Older revision		Revision as of 09:53, 3 August 2023
Line 50:		Line 50:
	The mantissa is considered to be a binary fixed-point fraction; except for 0, it is always normalized (the mantissa is shifted over and the exponent adjusted, so that the mantissa has a 1 bit in its highest position). Thus, it represents a value of less than 1 but greater than or equal to 1/2.		The mantissa is considered to be a binary fixed-point fraction; except for 0, it is always normalized (the mantissa is shifted over and the exponent adjusted, so that the mantissa has a 1 bit in its highest position). Thus, it represents a value of less than 1 but greater than or equal to 1/2.

	The sign bit is reset (0) for a positive value and set (1) for a negative value.		The sign bit (bit 7) is reset (0) for a positive value and set (1) for a negative value.

	The exponent is the power of two needed to correctly position the mantissa to reflect the number's true arithmetic value. It is held in excess-64 notation, which means that the two's-complement values are adjusted upward by 64, thus changing $40 (-64) through $3F (+63) to $00 through $7F. This facilitates comparisons among floating-point values.		The exponent is the power of two needed to correctly position the mantissa to reflect the number's true arithmetic value. It is held in excess-64 notation, which means that the two's-complement values are adjusted upward by 64, thus changing $40 (-64) through $3F (+63) to $00 through $7F. This facilitates comparisons among floating-point values.

Steven Solie at 19:02, 21 June 2013

2013-06-21T19:02:37Z

← Older revision		Revision as of 19:02, 21 June 2013
Line 1:		Line 1:
			== Introduction ==
	{{WIP}}

			The math libraries described in this section are implemented in 68K assembly language and are designed to only be callable from 68K code. They are provided for backwards compatibility with pre-4.0 versions of AmigaOS.

			For AmigaOS 4.0 and higher the math libraries you choose will depend on the application. A vast majority of the time the built-in math routines provided by the [[Newlib_Library\|Newlib Library]] and built-in functions of GCC will suffice.

	== Math Libraries ==		== Math Libraries ==

Steven Solie at 18:55, 21 June 2013

2013-06-21T18:55:10Z

← Older revision		Revision as of 18:55, 21 June 2013
Line 4:		Line 4:
	This chapter describes the structure and calling sequences required to access the Motorola Fast Floating Point (FFP), the IEEE single-precision math libraries and the IEEE double-precision math libraries via the Amiga-supplied interfaces.		This chapter describes the structure and calling sequences required to access the Motorola Fast Floating Point (FFP), the IEEE single-precision math libraries and the IEEE double-precision math libraries via the Amiga-supplied interfaces.

	In its present state, the FFP library consists of three separate entities: the basic math library, the transcendental math library, and C and assembly-language interfaces to the basic math library plus FFP conversion functions. The IEEE single-precision~~, introduced in Release 2,~~ and the double-precision libraries each presently consists of two entities: the basic math library and the transcendental math library.		In its present state, the FFP library consists of three separate entities: the basic math library, the transcendental math library, and C and assembly-language interfaces to the basic math library plus FFP conversion functions. The IEEE single-precision and the double-precision libraries each presently consists of two entities: the basic math library and the transcendental math library.

	{{Note\|title=Open Each Library Separately\|text=Each Task using an IEEE math library must open the library itself. Library base pointers to these libraries may ''not'' be shared. Libraries can be context sensitive and may use the Task structure to keep track of the current context. Sharing of library bases by Tasks may seem to work in some systems. This is true for any of the IEEE math libraries.}}		{{Note\|title=Open Each Library Separately\|text=Each Task using an IEEE math library must open the library itself. Library base pointers to these libraries may ''not'' be shared. Libraries can be context sensitive and may use the Task structure to keep track of the current context. Sharing of library bases by Tasks may seem to work in some systems. This is true for any of the IEEE math libraries.}}

Steven Solie: /* DP IEEE Transcendental Functions */

2013-06-21T18:53:59Z

DP IEEE Transcendental Functions

Show changes

Steven Solie: /* Function Reference */

2013-06-21T18:44:19Z

Function Reference

← Older revision		Revision as of 18:44, 21 June 2013
Line 2,316:		Line 2,316:
	\|-		\|-
	\| IEEESPNeg()		\| IEEESPNeg()
	\| Take ~~two‚Äôs~~ complement of IEEE single-precision variable		\| Take two's complement of IEEE single-precision variable
	\|-		\|-
	\| IEEESPSub()		\| IEEESPSub()
Line 2,409:		Line 2,409:
	\|-		\|-
	\| IEEEDPNeg()		\| IEEEDPNeg()
	\| Take ~~two‚Äôs~~ complement of IEEE double-precision variable		\| Take two's complement of IEEE double-precision variable
	\|-		\|-
	\| IEEEDPSub()		\| IEEEDPSub()

Steven Solie: /* IEEE Double-Precision Transcendental Math Library */

2013-06-21T18:36:29Z

IEEE Double-Precision Transcendental Math Library

Show changes

Steven Solie: /* DP IEEE Basic Functions */

2013-06-21T18:31:00Z

DP IEEE Basic Functions

Show changes

Steven Solie: /* IEEE Double-Precision Basic Math Library */

2013-06-21T17:21:23Z

IEEE Double-Precision Basic Math Library

← Older revision		Revision as of 17:21, 21 June 2013
Line 1,278:		Line 1,278:
	== IEEE Double-Precision Basic Math Library ==		== IEEE Double-Precision Basic Math Library ==

	The IEEE double-precision basic math library contains entries for the basic IEEE mathematics functions, such as add, subtract, and divide. This library resides on disk and is opened by calling OpenLibrary() with "mathieeedoubbas.library" as the argument. Do not share the library base pointer between tasks ~~‚Äì~~ see note at beginning of chapter for details.		The IEEE double-precision basic math library contains entries for the basic IEEE mathematics functions, such as add, subtract, and divide. This library resides on disk and is opened by calling OpenLibrary() with "mathieeedoubbas.library" as the argument. Do not share the library base pointer between tasks - see note at beginning of chapter for details.

			<syntaxhighlight>
	<pre>#include <exec/types.h>
	#include ~~<libraries~~/~~mathieeedp~~.h~~>~~		#include <exec/types.h>
			#include <libraries/mathieeedp.h>

	#include ~~<~~clib/mathdoubbas_protos.h~~>~~		#include <clib/mathdoubbas_protos.h>

	struct Library *MathIeeeDoubBasBase;		struct Library *MathIeeeDoubBasBase;
Line 1,290:		Line 1,291:
	{		{
	/* do not share base pointer between tasks. */		/* do not share base pointer between tasks. */
	if (MathIeeeDoubBasBase = OpenLibrary(~~"~~mathieeedoubbas.library~~"~~, 34))		if (MathIeeeDoubBasBase = OpenLibrary("mathieeedoubbas.library", 34))
	{		{
	. . .		. . .
Line 1,296:		Line 1,297:
	CloseLibrary(MathIeeeDoubBasBase);		CloseLibrary(MathIeeeDoubBasBase);
	}		}
	else printf(~~"~~Can't open mathieeedoubbas.library\n~~"~~);		else printf("Can't open mathieeedoubbas.library\n");
			}
⚫	}</pre>
			</syntaxhighlight>

	The global variable MathIeeeDoubBasBase is used internally for all future library references.		The global variable MathIeeeDoubBasBase is used internally for all future library references.

Line 1,304:		Line 1,307:
	=== DP IEEE Basic Functions ===		=== DP IEEE Basic Functions ===

			; IEEEDPAbs() DOUBLE IEEEDPAbs( DOUBLE parm );
	Take absolute value of IEEE double-precision variable.		: Take absolute value of IEEE double-precision variable.

			; IEEEDPAdd() DOUBLE IEEEDPAdd( DOUBLE leftParm, DOUBLE rightParm );
	Add two IEEE double-precision variables.		: Add two IEEE double-precision variables.

			; IEEEDPCeil() DOUBLE IEEEDPCeil( DOUBLE parm );
	Compute least integer greater than or equal to variable.		: Compute least integer greater than or equal to variable.

			; IEEEDPCmp() LONG IEEEDPCmp( DOUBLE leftParm, DOUBLE rightParm );
	Compare two IEEE double-precision variables.		: Compare two IEEE double-precision variables.

			; IEEEDPDiv() DOUBLE IEEEDPDiv( DOUBLE dividend, DOUBLE divisor );
	Divide two IEEE double-precision variables.		: Divide two IEEE double-precision variables.

			; IEEEDPFix() LONG IEEEDPFix( DOUBLE parm );
	Convert IEEE double-precision variable to integer.		: Convert IEEE double-precision variable to integer.

			; IEEEDPFloor() DOUBLE IEEEDPFloor( DOUBLE parm );
	Compute largest integer less than or equal to variable.		: Compute largest integer less than or equal to variable.

			; IEEEDPFlt() DOUBLE IEEEDPFlt( long integer );
	Convert integer variable to IEEE double-precision.		: Convert integer variable to IEEE double-precision.

			; IEEEDPMul() DOUBLE IEEEDPMul( DOUBLE factor1, DOUBLE factor2 );
	Multiply two IEEE double-precision variables.		: Multiply two IEEE double-precision variables.

			; IEEEDPNeg() DOUBLE IEEEDPNeg( DOUBLE parm );
	Take ~~two‚Äôs~~ complement of IEEE double-precision variable.		: Take two's complement of IEEE double-precision variable.

			; IEEEDPSub() DOUBLE IEEEDPSub( DOUBLE leftParm, DOUBLE rightParm );
	Subtract two IEEE double-precision variables.		: Subtract two IEEE double-precision variables.

			; IEEEDPTst() LONG IEEEDPTst( DOUBLE parm );
	Test an IEEE double-precision variable against zero.		: Test an IEEE double-precision variable against zero.

	Be sure to include proper data type definitions, as shown in the example below.		Be sure to include proper data type definitions, as shown in the example below.

			<syntaxhighlight>
	<pre>#include <exec/types.h>
	#include ~~<libraries~~/~~mathieeedp~~.h~~>~~		#include <exec/types.h>
			#include <libraries/mathieeedp.h>

	#include ~~<~~clib/mathieeedoubbas_protos.h~~>~~		#include <clib/mathieeedoubbas_protos.h>

	struct Library *MathIeeeDoubBasBase;		struct Library *MathIeeeDoubBasBase;
Line 1,342:		Line 1,358:
	LONG i1;		LONG i1;

	if (MathIeeeDoubBasBase = OpenLibrary(~~"~~mathieeedoubbas.library~~"~~,34))		if (MathIeeeDoubBasBase = OpenLibrary("mathieeedoubbas.library",34))
	{		{

Line 1,360:		Line 1,376:
	CloseLibrary(MathIeeeDoubBasBase);		CloseLibrary(MathIeeeDoubBasBase);
	}		}
	else printf(~~"~~Can't open mathieeedoubbas.library\n~~"~~);		else printf("Can't open mathieeedoubbas.library\n");
			}
⚫	}</pre>
			</syntaxhighlight>

	The Amiga assembly language interface to the IEEE double-precision floating-point basic math routines is shown below, including some details about how the system flags are affected by each operation. The access mechanism from assembly language is:		The Amiga assembly language interface to the IEEE double-precision floating-point basic math routines is shown below, including some details about how the system flags are affected by each operation. The access mechanism from assembly language is:

		⚫	<pre>
	~~<pre>~~MOVEA.L _MathIeeeDoubBasBase,A6		MOVEA.L _MathIeeeDoubBasBase,A6
	JSR _LVOIEEEDPFix(A6)~~</pre>~~		JSR _LVOIEEEDPFix(A6)
		⚫	</pre>

	'''DP IEEE Basic Assembly Functions'''		'''DP IEEE Basic Assembly Functions'''

Steven Solie: /* SP IEEE Transcendental Functions (V36 or greater) */

2013-06-21T17:16:45Z

SP IEEE Transcendental Functions (V36 or greater)

Show changes