17f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/* 27f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * Copyright (C) 2008 The Android Open Source Project 37f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * 47f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 57f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * you may not use this file except in compliance with the License. 67f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * You may obtain a copy of the License at 77f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * 87f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 97f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * 107f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * Unless required by applicable law or agreed to in writing, software 117f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 127f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 137f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * See the License for the specific language governing permissions and 147f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * limitations under the License. 157f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project */ 167f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 177f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project#ifndef bbs_PHASE_EM_H 187f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project#define bbs_PHASE_EM_H 197f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 207f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/* ---- includes ----------------------------------------------------------- */ 217f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 227f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/** 237f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * Phase data type. 247f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * This data type represents a phase or angle value and takes advantage 257f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * of the circular value range when doing arithmetig with an integer 267f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * by ignoring overflow. 277f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * The phase value range lies within [ - PI, PI [; 287f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * The corresponding integer value range is [ MININT, MAXINT + 1 [. 297f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * The phase data type is to be used whereever an angle is needed. 307f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project */ 317f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 327f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project#include "b_BasicEm/Basic.h" 337f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 347f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/* ---- related objects --------------------------------------------------- */ 357f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 367f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/* ---- typedefs ----------------------------------------------------------- */ 377f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 387f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/** 8 bit phase value */ 397f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Projecttypedef int8 phase8; 407f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 417f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/** 16 bit phase value */ 427f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Projecttypedef int16 phase16; 437f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 447f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/** 32 bit phase value */ 457f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Projecttypedef int32 phase32; 467f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 477f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/* ---- constants ---------------------------------------------------------- */ 487f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 497f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/** value PI in a phase16 expression */ 507f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project#define bbs_M_PI_16 32768 517f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 527f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/** value PI/2 in a phase16 expression */ 537f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project#define bbs_M_PI_2_16 16384 547f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 557f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/** value PI/4 in a phase16 expression */ 567f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project#define bbs_M_PI_4_16 8192 577f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 587f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/** value PI in a phase8 expression */ 597f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project#define bbs_M_PI_8 128 607f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 617f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/** value PI/2 in a phase8 expression */ 627f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project#define bbs_M_PI_2_8 64 637f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 647f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/** value ( 32768 / PI ) in the format 14.1 */ 657f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project#define bbs_PHASE_MAX_BY_PI 20861 667f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 677f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/** sine interpolation method */ 687f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project#define bbs_SIN_INTERPOLATION_METHOD_2 697f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 707f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/* ---- object definition -------------------------------------------------- */ 717f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 727f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/* ---- associated objects ------------------------------------------------- */ 737f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 747f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/* ---- external functions ------------------------------------------------- */ 757f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 767f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/* ---- \ghd{ constructor/destructor } ------------------------------------- */ 777f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 787f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/* ---- \ghd{ operators } -------------------------------------------------- */ 797f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 807f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/* ---- \ghd{ query functions } -------------------------------------------- */ 817f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 827f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/** 837f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * Computes sine of a phase 847f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * The return value has the format 8.24 857f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * The function approximates ( int32 )( sin( ( M_PI * phaseA ) / ( 1<<15 ) ) * ( 1<<24 ) ) 867f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * Max error: 8.5E-5 (METHOD1); 7.0E-5 (METHOD2) 877f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * Std error: 4.4E-5 (METHOD1); 3.2E-5 (METHOD2) 887f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project */ 897f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Projectint32 bbs_sin32( phase16 phaseA ); 907f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 917f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/** 927f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * Computes cosine of a phase 937f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * The return value has the format 8.24 947f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * The function approximates ( int32 )( cos( ( M_PI * phaseA ) / ( 1<<15 ) ) * ( 1<<24 ) ) 957f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * Max error: 8.5E-5 (METHOD1); 7.0E-5 (METHOD2) 967f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * Std error: 4.4E-5 (METHOD1); 3.2E-5 (METHOD2) 977f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project */ 987f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Projectint32 bbs_cos32( phase16 phaseA ); 997f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 1007f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/** 1017f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * Computes sine of a phase 1027f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * The return value has the format 2.14 1037f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * see sin32 for details 1047f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project */ 1057f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Projectint16 bbs_sin16( phase16 phaseA ); 1067f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 1077f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/** 1087f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * Computes cosine of a phase 1097f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * The return value has the format 2.14 1107f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * see cos32 for details 1117f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project */ 1127f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Projectint16 bbs_cos16( phase16 phaseA ); 1137f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 1147f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/** 1157f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * Computes arcus tangens between [0,1[, where valA has the format 16.16 1167f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * The function approximates ( int16 )( atan( double( valA ) / ( ( 1 << 16 ) ) / M_PI ) * ( 1 << 15 ) ) 1177f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * Max error: 5.1E-5 PI 1187f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * Std error: 2.7E-5 PI 1197f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project */ 1207f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Projectphase16 bbs_atan16( uint32 valA ); 1217f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 1227f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/** 1237f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * Computes phase from a 2d vector as angle enclosed between vector and (0,0). 1247f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * It is vec = ( cos( angle ), sin( angle ) ); 1257f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * Max error: 5.4E-5 PI 1267f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * Std error: 2.9E-5 PI 1277f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project */ 1287f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Projectphase16 bbs_phase16( int32 xA, int32 yA ); 1297f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 1307f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/* ---- \ghd{ modify functions } ------------------------------------------- */ 1317f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 1327f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/* ---- \ghd{ memory I/O } ------------------------------------------------- */ 1337f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 1347f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/* ---- \ghd{ exec functions } --------------------------------------------- */ 1357f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 1367f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project#endif /* bbs_PHASE_EM_H */ 1377f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 138