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 bim_COMPLEX_IMAGE_EM_H 187f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project#define bim_COMPLEX_IMAGE_EM_H 197f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 207f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/* ---- includes ----------------------------------------------------------- */ 217f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 227f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project#include "b_BasicEm/Context.h" 237f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project#include "b_BasicEm/ComplexArr.h" 247f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project#include "b_TensorEm/Int16Rect.h" 257f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project#include "b_TensorEm/Flt16Alt2D.h" 267f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 277f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/* ---- related objects --------------------------------------------------- */ 287f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 297f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Projectstruct bim_APhImage; 307f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 317f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/* ---- typedefs ----------------------------------------------------------- */ 327f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 337f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/* ---- constants ---------------------------------------------------------- */ 347f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 357f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/* data format version number */ 367f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project#define bim_COMPLEX_IMAGE_VERSION 100 377f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 387f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/* ---- object definition -------------------------------------------------- */ 397f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 407f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/** image of complex values */ 417f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Projectstruct bim_ComplexImage 427f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project{ 437f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 447f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project /* ---- private data --------------------------------------------------- */ 457f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 467f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project /* ---- public data ---------------------------------------------------- */ 477f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 487f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project /** width of image */ 497f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project uint32 widthE; 507f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 517f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project /** height of image */ 527f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project uint32 heightE; 537f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 547f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project /** array of bytes */ 557f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project struct bbs_ComplexArr arrE; 567f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project}; 577f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 587f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/* ---- associated objects ------------------------------------------------- */ 597f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 607f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/* ---- external functions ------------------------------------------------- */ 617f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 627f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/* ---- \ghd{ constructor/destructor } ------------------------------------- */ 637f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 647f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/** initializes bim_ComplexImage */ 657f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Projectvoid bim_ComplexImage_init( struct bbs_Context* cpA, 667f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project struct bim_ComplexImage* ptrA ); 677f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 687f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/** frees bim_ComplexImage */ 697f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Projectvoid bim_ComplexImage_exit( struct bbs_Context* cpA, 707f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project struct bim_ComplexImage* ptrA ); 717f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 727f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/* ---- \ghd{ operators } -------------------------------------------------- */ 737f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 747f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/** copy operator */ 757f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Projectvoid bim_ComplexImage_copy( struct bbs_Context* cpA, 767f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project struct bim_ComplexImage* ptrA, 777f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project const struct bim_ComplexImage* srcPtrA ); 787f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 797f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/** equal operator */ 807f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Projectflag bim_ComplexImage_equal( struct bbs_Context* cpA, 817f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project const struct bim_ComplexImage* ptrA, 827f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project const struct bim_ComplexImage* srcPtrA ); 837f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 847f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/* ---- \ghd{ query functions } -------------------------------------------- */ 857f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 867f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/** checksum of image (for debugging purposes) */ 877f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Projectuint32 bim_ComplexImage_checkSum( struct bbs_Context* cpA, 887f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project const struct bim_ComplexImage* ptrA ); 897f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 907f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/** calculates the amount of heap memory needed (16bit words) if created with given parameters */ 917f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Projectuint32 bim_ComplexImage_heapSize( struct bbs_Context* cpA, 927f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project const struct bim_ComplexImage* ptrA, 937f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project uint32 widthA, uint32 heightA ); 947f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 957f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/* ---- \ghd{ modify functions } ------------------------------------------- */ 967f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 977f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/** allocates memory for bim_ComplexImage */ 987f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Projectvoid bim_ComplexImage_create( struct bbs_Context* cpA, 997f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project struct bim_ComplexImage* ptrA, 1007f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project uint32 widthA, 1017f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project uint32 heightA, 1027f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project struct bbs_MemSeg* mspA ); 1037f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 1047f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/** sets image size */ 1057f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Projectvoid bim_ComplexImage_size( struct bbs_Context* cpA, 1067f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project struct bim_ComplexImage* ptrA, 1077f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project uint32 widthA, 1087f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project uint32 heightA ); 1097f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 1107f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/* ---- \ghd{ memory I/O } ------------------------------------------------- */ 1117f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 1127f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/** word size (16-bit) object needs when written to memory */ 1137f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Projectuint32 bim_ComplexImage_memSize( struct bbs_Context* cpA, 1147f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project const struct bim_ComplexImage* ptrA ); 1157f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 1167f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/** writes object to memory; returns number of words (16-bit) written */ 1177f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Projectuint32 bim_ComplexImage_memWrite( struct bbs_Context* cpA, 1187f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project const struct bim_ComplexImage* ptrA, 1197f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project uint16* memPtrA ); 1207f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 1217f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/** reads object from memory; returns number of words (16-bit) read */ 1227f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Projectuint32 bim_ComplexImage_memRead( struct bbs_Context* cpA, 1237f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project struct bim_ComplexImage* ptrA, 1247f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project const uint16* memPtrA, 1257f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project struct bbs_MemSeg* mspA ); 1267f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 1277f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/* ---- \ghd{ exec functions } --------------------------------------------- */ 1287f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 1297f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/** sets all pixels to one value */ 1307f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Projectvoid bim_ComplexImage_setAllPixels( struct bbs_Context* cpA, 1317f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project struct bim_ComplexImage* ptrA, 1327f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project struct bbs_Complex valueA ); 1337f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 1347f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/** copies a section of given image */ 1357f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Projectvoid bim_ComplexImage_copySection( struct bbs_Context* cpA, 1367f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project struct bim_ComplexImage* ptrA, 1377f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project const struct bim_ComplexImage* srcPtrA, 1387f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project const struct bts_Int16Rect* sectionPtrA ); 1397f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 1407f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/** import abs-phase image */ 1417f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Projectvoid bim_ComplexImage_importAPh( struct bbs_Context* cpA, 1427f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project struct bim_ComplexImage* dstPtrA, 1437f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project const struct bim_APhImage* srcPtrA ); 1447f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 1457f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project#endif /* bim_COMPLEX_IMAGE_EM_H */ 1467f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 147