/* =========================================================================== File: BASOP32.H v.2.3 - 30.Nov.2009 =========================================================================== ITU-T STL BASIC OPERATORS GLOBAL FUNCTION PROTOTYPES History: 26.Jan.00 v1.0 Incorporated to the STL from updated G.723.1/G.729 basic operator library (based on basic_op.h) and G.723.1's basop.h. 05.Jul.00 v1.1 Added 32-bit shiftless mult/mac/msub operators 03 Nov 04 v2.0 Incorporation of new 32-bit / 40-bit / control operators for the ITU-T Standard Tool Library as described in Geneva, 20-30 January 2004 WP 3/16 Q10/16 TD 11 document and subsequent discussions on the wp3audio@yahoogroups.com email reflector. norm_s() weight reduced from 15 to 1. norm_l() weight reduced from 30 to 1. L_abs() weight reduced from 2 to 1. L_add() weight reduced from 2 to 1. L_negate() weight reduced from 2 to 1. L_shl() weight reduced from 2 to 1. L_shr() weight reduced from 2 to 1. L_sub() weight reduced from 2 to 1. mac_r() weight reduced from 2 to 1. msu_r() weight reduced from 2 to 1. mult_r() weight reduced from 2 to 1. L_deposit_h() weight reduced from 2 to 1. L_deposit_l() weight reduced from 2 to 1. L_mls() weight of 5. div_l() weight of 32. i_mult() weight of 3. 30 Nov 09 v2.3 round() function is now round_fx(). saturate() is not referencable from outside application 13 Mar 12 Add Overflow2 flag for additional overflow checking. ============================================================================ */ #ifndef _BASIC_OP_H #define _BASIC_OP_H /* #define BASOP_OVERFLOW2 */ /*___________________________________________________________________________ | | | Constants and Globals | |___________________________________________________________________________| */ extern Flag Overflow, Overflow2; extern Flag Carry; #define BASOP_SATURATE_WARNING_ON #define BASOP_SATURATE_WARNING_OFF #define BASOP_SATURATE_ERROR_ON #define BASOP_SATURATE_ERROR_OFF #define BASOP_CHECK() #define MAX_32 (Word32)0x7fffffffL #define MIN_32 (Word32)0x80000000L #define MAX_16 (Word16)0x7fff #define MIN_16 (Word16)0x8000 /*___________________________________________________________________________ | | | Prototypes for basic arithmetic operators | |___________________________________________________________________________| */ Word16 add (Word16 var1, Word16 var2); /* Short add, 1 */ Word16 sub (Word16 var1, Word16 var2); /* Short sub, 1 */ Word16 abs_s (Word16 var1); /* Short abs, 1 */ Word16 shl (Word16 var1, Word16 var2); /* Short shift left, 1 */ Word16 shr (Word16 var1, Word16 var2); /* Short shift right, 1 */ Word16 mult (Word16 var1, Word16 var2); /* Short mult, 1 */ Word32 L_mult (Word16 var1, Word16 var2); /* Long mult, 1 */ Word16 negate (Word16 var1); /* Short negate, 1 */ Word16 extract_h (Word32 L_var1); /* Extract high, 1 */ Word16 extract_l (Word32 L_var1); /* Extract low, 1 */ Word16 round_fx (Word32 L_var1); /* Round, 1 */ Word32 L_mac (Word32 L_var3, Word16 var1, Word16 var2); /* Mac, 1 */ Word32 L_msu (Word32 L_var3, Word16 var1, Word16 var2); /* Msu, 1 */ Word32 L_macNs (Word32 L_var3, Word16 var1, Word16 var2); /* Mac without sat, 1 */ Word32 L_msuNs (Word32 L_var3, Word16 var1, Word16 var2); /* Msu without sat, 1 */ Word32 L_add (Word32 L_var1, Word32 L_var2); /* Long add, 1 */ Word32 L_sub (Word32 L_var1, Word32 L_var2); /* Long sub, 1 */ Word32 L_add_c (Word32 L_var1, Word32 L_var2); /* Long add with c, 2 */ Word32 L_sub_c (Word32 L_var1, Word32 L_var2); /* Long sub with c, 2 */ Word32 L_negate (Word32 L_var1); /* Long negate, 1 */ Word16 mult_r (Word16 var1, Word16 var2); /* Mult with round, 1 */ Word32 L_shl (Word32 L_var1, Word16 var2); /* Long shift left, 1 */ Word32 L_shr (Word32 L_var1, Word16 var2); /* Long shift right, 1 */ Word16 shr_r (Word16 var1, Word16 var2); /* Shift right with round, 2 */ Word16 mac_r (Word32 L_var3, Word16 var1, Word16 var2); /* Mac with rounding, 1 */ Word16 msu_r (Word32 L_var3, Word16 var1, Word16 var2); /* Msu with rounding, 1 */ Word32 L_deposit_h (Word16 var1); /* 16 bit var1 -> MSB, 1 */ Word32 L_deposit_l (Word16 var1); /* 16 bit var1 -> LSB, 1 */ Word32 L_shr_r (Word32 L_var1, Word16 var2); /* Long shift right with round, 3 */ Word32 L_abs (Word32 L_var1); /* Long abs, 1 */ Word32 L_sat (Word32 L_var1); /* Long saturation, 4 */ Word16 norm_s (Word16 var1); /* Short norm, 1 */ Word16 div_s (Word16 var1, Word16 var2); /* Short division, 18 */ Word16 norm_l (Word32 L_var1); /* Long norm, 1 */ /* * Additional G.723.1 operators */ Word32 L_mls( Word32, Word16 ) ; /* Weight FFS; currently assigned 5 */ Word16 div_l( Word32, Word16 ) ; /* Weight FFS; currently assigned 32 */ Word16 i_mult(Word16 a, Word16 b); /* Weight FFS; currently assigned 3 */ /* * New shiftless operators, not used in G.729/G.723.1 */ Word32 L_mult0(Word16 v1, Word16 v2); /* 32-bit Multiply w/o shift 1 */ Word32 L_mac0(Word32 L_v3, Word16 v1, Word16 v2); /* 32-bit Mac w/o shift 1 */ Word32 L_msu0(Word32 L_v3, Word16 v1, Word16 v2); /* 32-bit Msu w/o shift 1 */ #endif /* ifndef _BASIC_OP_H */ /* end of file */