/* * Copyright (C) 2008 The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef bbf_LOCAL_SCAN_DETECTOR_EM_H #define bbf_LOCAL_SCAN_DETECTOR_EM_H /* ---- includes ----------------------------------------------------------- */ #include "b_BasicEm/Context.h" #include "b_BasicEm/Basic.h" #include "b_BasicEm/UInt32Arr.h" #include "b_BasicEm/Int16Arr.h" #include "b_BasicEm/MemTbl.h" #include "b_TensorEm/IdCluster2D.h" #include "b_BitFeatureEm/Sequence.h" #include "b_BitFeatureEm/BitParam.h" #include "b_BitFeatureEm/LocalScanner.h" #include "b_TensorEm/RBFMap2D.h" /* ---- related objects --------------------------------------------------- */ /* ---- typedefs ----------------------------------------------------------- */ /* ---- constants ---------------------------------------------------------- */ /* data format version number */ #define bbf_LOCAL_SCAN_DETECTOR_VERSION 100 /* maximum number of features in scan detector */ #define bbf_LOCAL_SCAN_DETECTOR_MAX_FEATURES 16 /* maximum size of any cluster in all processing stages of landmarker */ #define bpi_LOCAL_SCAN_DETECTOR_MAX_CLUSTER_SIZE 24 /* maximum dimension of PCA subspace */ #define bpi_LOCAL_SCAN_DETECTOR_MAX_PCA_DIM 12 /* ---- object definition -------------------------------------------------- */ /** discrete feature set */ struct bbf_LocalScanDetector { /* ---- private data --------------------------------------------------- */ /** feature pointer arrray */ struct bbf_Feature* ftrPtrArrE[ bbf_LOCAL_SCAN_DETECTOR_MAX_FEATURES ]; /** multiple purpose rbf map */ struct bts_RBFMap2D rbfMapE; /** temporary cluster */ struct bts_Cluster2D tmpCluster1E; /** temporary cluster */ struct bts_Cluster2D tmpCluster2E; /** temporary cluster */ struct bts_Cluster2D tmpCluster3E; /** temporary cluster */ struct bts_Cluster2D tmpCluster4E; /** local scanner */ struct bbf_LocalScanner scannerE; /** activity array */ struct bbs_Int32Arr actArrE; /** index array */ struct bbs_Int16Arr idxArrE; /** working image buffer */ struct bbs_UInt8Arr workImageBufE; /* ---- public data ---------------------------------------------------- */ /** patch width */ uint32 patchWidthE; /** patch height*/ uint32 patchHeightE; /** width of scan area */ uint32 scanWidthE; /** height of scan area */ uint32 scanHeightE; /** scanner scale exponent */ uint32 scaleExpE; /** interpolated image warping */ flag interpolatedWarpingE; /** image downscale threshold (part of image warping) (16.16) */ uint32 warpScaleThresholdE; /** reference cluster */ struct bts_IdCluster2D refClusterE; /** cluster with scan positions */ struct bts_Cluster2D scanClusterE; /** feature data array (contains feature elements) */ struct bbs_UInt16Arr ftrDataArrE; /** parameter for bit generation */ struct bbf_BitParam bitParamE; /** outlier distance in pixels (16.16); ( >0: activates outlier analysis ) */ uint32 outlierDistanceE; /** pca reference cluster */ struct bts_IdCluster2D pcaClusterE; /** pca average vector (10.6) */ struct bbs_Int16Arr pcaAvgE; /** pca projection matrix (8.8) */ struct bbs_Int16Arr pcaMatE; /** pcs subspace dimensions */ uint32 pcaDimSubSpaceE; /** max width of working image */ uint32 maxImageWidthE; /** max height of working image */ uint32 maxImageHeightE; }; /* ---- associated objects ------------------------------------------------- */ /* ---- external functions ------------------------------------------------- */ /* ---- \ghd{ constructor/destructor } ------------------------------------- */ /** initializes bbf_LocalScanDetector */ void bbf_LocalScanDetector_init( struct bbs_Context* cpA, struct bbf_LocalScanDetector* ptrA ); /** resets bbf_LocalScanDetector */ void bbf_LocalScanDetector_exit( struct bbs_Context* cpA, struct bbf_LocalScanDetector* ptrA ); /* ---- \ghd{ operators } -------------------------------------------------- */ /** copy operator */ void bbf_LocalScanDetector_copy( struct bbs_Context* cpA, struct bbf_LocalScanDetector* ptrA, const struct bbf_LocalScanDetector* srcPtrA ); /** equal operator */ flag bbf_LocalScanDetector_equal( struct bbs_Context* cpA, const struct bbf_LocalScanDetector* ptrA, const struct bbf_LocalScanDetector* srcPtrA ); /* ---- \ghd{ query functions } -------------------------------------------- */ /* ---- \ghd{ modify functions } ------------------------------------------- */ /* ---- \ghd{ memory I/O } ------------------------------------------------- */ /** word size (16-bit) object needs when written to memory */ uint32 bbf_LocalScanDetector_memSize( struct bbs_Context* cpA, const struct bbf_LocalScanDetector* ptrA ); /** writes object to memory; returns number of words (16-bit) written */ uint32 bbf_LocalScanDetector_memWrite( struct bbs_Context* cpA, const struct bbf_LocalScanDetector* ptrA, uint16* memPtrA ); /** reads object from memory; returns number of words (16-bit) read */ uint32 bbf_LocalScanDetector_memRead( struct bbs_Context* cpA, struct bbf_LocalScanDetector* ptrA, const uint16* memPtrA, struct bbs_MemTbl* mtpA ); /* ---- \ghd{ exec functions } --------------------------------------------- */ /** processes image with cluster; produces output cluster and returns confidence (8.24) * offsPtrA specifies pixel position (0,0) in input image */ int32 bbf_LocalScanDetector_process( struct bbs_Context* cpA, const struct bbf_LocalScanDetector* ptrA, uint8* imagePtrA, uint32 imageWidthA, uint32 imageHeightA, const struct bts_Int16Vec2D* offsPtrA, const struct bts_IdCluster2D* inClusterPtrA, struct bts_IdCluster2D* outClusterPtrA ); #endif /* bbf_LOCAL_SCAN_DETECTOR_EM_H */