vision.h Source File

- Main Page
- Tutorials
- Functions
- Release Notes
- Examples

vision.h
Go to the documentation of this file.
1 /*******************************************************
2 * Copyright (c) 2014, ArrayFire
3 * All rights reserved.
4 *
5 * This file is distributed under 3-clause BSD license.
6 * The complete license agreement can be obtained at:
7 * http://arrayfire.com/licenses/BSD-3-Clause
8 ********************************************************/
9
10 #pragma once
11 #include <af/defines.h>
12 #include <af/features.h>
13
14 #ifdef __cplusplus
15 namespace af
16 {
17 class array;
18
42 AFAPI features fast(const array& in, const float thr=20.0f, const unsigned arc_length=9,
43 const bool non_max=true, const float feature_ratio=0.05,
44 const unsigned edge=3);
45
46 #if AF_API_VERSION >= 31
47
73 AFAPI features harris(const array& in, const unsigned max_corners=500,
74 const float min_response=1e5f, const float sigma=1.f,
75 const unsigned block_size=0, const float k_thr=0.04f);
76 #endif
77
100 AFAPI void orb(features& feat, array& desc, const array& image,
101 const float fast_thr=20.f, const unsigned max_feat=400,
102 const float scl_fctr=1.5f, const unsigned levels=4,
103 const bool blur_img=false);
104
105 #if AF_API_VERSION >= 31
106
137 AFAPI void sift(features& feat, array& desc, const array& in, const unsigned n_layers=3,
138 const float contrast_thr=0.04f, const float edge_thr=10.f,
139 const float init_sigma=1.6f, const bool double_input=true,
140 const float intensity_scale=0.00390625f, const float feature_ratio=0.05f);
141 #endif
142
143 #if AF_API_VERSION >= 32
144
175 AFAPI void gloh(features& feat, array& desc, const array& in, const unsigned n_layers=3,
176 const float contrast_thr=0.04f, const float edge_thr=10.f,
177 const float init_sigma=1.6f, const bool double_input=true,
178 const float intensity_scale=0.00390625f, const float feature_ratio=0.05f);
179 #endif
180
205 AFAPI void hammingMatcher(array& idx, array& dist,
206 const array& query, const array& train,
207 const dim_t dist_dim=0, const unsigned n_dist=1);
208
209 #if AF_API_VERSION >= 31
210
234 AFAPI void nearestNeighbour(array& idx, array& dist,
235 const array& query, const array& train,
236 const dim_t dist_dim=0, const unsigned n_dist=1,
237 const af_match_type dist_type = AF_SSD);
238 #endif
239
255 AFAPI array matchTemplate(const array &searchImg, const array &templateImg, const matchType mType=AF_SAD);
256
257 #if AF_API_VERSION >= 31
258
274 AFAPI features susan(const array& in,
275 const unsigned radius=3,
276 const float diff_thr=32.0f,
277 const float geom_thr=10.0f,
278 const float feature_ratio=0.05f,
279 const unsigned edge=3);
280 #endif
281
282 #if AF_API_VERSION >= 31
283
293 AFAPI array dog(const array& in, const int radius1, const int radius2);
294 #endif
295
296 #if AF_API_VERSION >= 32
297
322 AFAPI void homography(array& H, int& inliers, const array& x_src, const array& y_src,
323 const array& x_dst, const array& y_dst, const af_homography_type htype=AF_HOMOGRAPHY_RANSAC,
324 const float inlier_thr=3.f, const unsigned iterations=1000, const dtype otype=f32);
325 #endif
326
327 }
328 #endif
329
330 #ifdef __cplusplus
331 extern "C" {
332 #endif
333
359 AFAPI af_err af_fast(af_features *out, const af_array in, const float thr, const unsigned arc_length,
360 const bool non_max, const float feature_ratio, const unsigned edge);
361
362 #if AF_API_VERSION >= 31
363
389 AFAPI af_err af_harris(af_features *out, const af_array in, const unsigned max_corners,
390 const float min_response, const float sigma,
391 const unsigned block_size, const float k_thr);
392 #endif
393
416 AFAPI af_err af_orb(af_features *feat, af_array *desc, const af_array in,
417 const float fast_thr, const unsigned max_feat, const float scl_fctr,
418 const unsigned levels, const bool blur_img);
419
420 #if AF_API_VERSION >= 31
421
452 AFAPI af_err af_sift(af_features *feat, af_array *desc, const af_array in,
453 const unsigned n_layers, const float contrast_thr, const float edge_thr,
454 const float init_sigma, const bool double_input,
455 const float intensity_scale, const float feature_ratio);
456 #endif
457
458 #if AF_API_VERSION >= 32
459
490 AFAPI af_err af_gloh(af_features *feat, af_array *desc, const af_array in,
491 const unsigned n_layers, const float contrast_thr,
492 const float edge_thr, const float init_sigma, const bool double_input,
493 const float intensity_scale, const float feature_ratio);
494 #endif
495
517 AFAPI af_err af_hamming_matcher(af_array* idx, af_array* dist,
518 const af_array query, const af_array train,
519 const dim_t dist_dim, const unsigned n_dist);
520
521 #if AF_API_VERSION >= 31
522
546 AFAPI af_err af_nearest_neighbour(af_array* idx, af_array* dist,
547 const af_array query, const af_array train,
548 const dim_t dist_dim, const unsigned n_dist,
549 const af_match_type dist_type);
550 #endif
551
569 AFAPI af_err af_match_template(af_array *out, const af_array search_img,
570 const af_array template_img, const af_match_type m_type);
571
572 #if AF_API_VERSION >= 31
573
591 AFAPI af_err af_susan(af_features* out, const af_array in, const unsigned radius,
592 const float diff_thr, const float geom_thr,
593 const float feature_ratio, const unsigned edge);
594 #endif
595
596 #if AF_API_VERSION >= 31
597
609 AFAPI af_err af_dog(af_array *out, const af_array in, const int radius1, const int radius2);
610 #endif
611
612 #if AF_API_VERSION >= 32
613
640 AFAPI af_err af_homography(af_array *H, int *inliers, const af_array x_src, const af_array y_src,
641 const af_array x_dst, const af_array y_dst,
642 const af_homography_type htype, const float inlier_thr,
643 const unsigned iterations, const af_dtype otype);
644 #endif
645
646 #ifdef __cplusplus
647 }
648 #endif
af_harris
AFAPI af_err af_harris(af_features *out, const af_array in, const unsigned max_corners, const float min_response, const float sigma, const unsigned block_size, const float k_thr)
C Interface for Harris corner detector.
AF_SSD
Match based on Sum of Squared Differences (SSD)
Definition: defines.h:276
af
Definition: algorithm.h:14
af::dog
AFAPI array dog(const array &in, const int radius1, const int radius2)
C++ Interface wrapper for Difference of Gaussians.
af_orb
AFAPI af_err af_orb(af_features *feat, af_array *desc, const af_array in, const float fast_thr, const unsigned max_feat, const float scl_fctr, const unsigned levels, const bool blur_img)
C Interface for ORB feature descriptor.
af::orb
AFAPI void orb(features &feat, array &desc, const array &image, const float fast_thr=20.f, const unsigned max_feat=400, const float scl_fctr=1.5f, const unsigned levels=4, const bool blur_img=false)
C++ Interface for ORB feature descriptor.
af::homography
AFAPI void homography(array &H, int &inliers, const array &x_src, const array &y_src, const array &x_dst, const array &y_dst, const af_homography_type htype=AF_HOMOGRAPHY_RANSAC, const float inlier_thr=3.f, const unsigned iterations=1000, const dtype otype=f32)
C++ Interface for Homography estimation.
af_features
void * af_features
Definition: features.h:13
af_homography_type
af_homography_type
Definition: defines.h:358
af::harris
AFAPI features harris(const array &in, const unsigned max_corners=500, const float min_response=1e5f, const float sigma=1.f, const unsigned block_size=0, const float k_thr=0.04f)
C++ Interface for Harris corner detector.
features.h
af::nearestNeighbour
AFAPI void nearestNeighbour(array &idx, array &dist, const array &query, const array &train, const dim_t dist_dim=0, const unsigned n_dist=1, const af_match_type dist_type=AF_SSD)
C++ Interface wrapper for Nearest Neighbour.
af_dog
AFAPI af_err af_dog(af_array *out, const af_array in, const int radius1, const int radius2)
C Interface wrapper for Difference of Gaussians.
AF_HOMOGRAPHY_RANSAC
Computes homography using RANSAC.
Definition: defines.h:359
af_err
af_err
Definition: defines.h:67
af::susan
AFAPI features susan(const array &in, const unsigned radius=3, const float diff_thr=32.0f, const float geom_thr=10.0f, const float feature_ratio=0.05f, const unsigned edge=3)
C++ Interface for SUSAN corner detector.
defines.h
af_hamming_matcher
AFAPI af_err af_hamming_matcher(af_array *idx, af_array *dist, const af_array query, const af_array train, const dim_t dist_dim, const unsigned n_dist)
C Interface wrapper for Hamming matcher.
dim_t
long long dim_t
Definition: defines.h:50
af::fast
AFAPI features fast(const array &in, const float thr=20.0f, const unsigned arc_length=9, const bool non_max=true, const float feature_ratio=0.05, const unsigned edge=3)
C++ Interface for FAST feature detector.
af_fast
AFAPI af_err af_fast(af_features *out, const af_array in, const float thr, const unsigned arc_length, const bool non_max, const float feature_ratio, const unsigned edge)
C Interface for FAST feature detector.
AFAPI
#define AFAPI
Definition: defines.h:31
af::gloh
AFAPI void gloh(features &feat, array &desc, const array &in, const unsigned n_layers=3, const float contrast_thr=0.04f, const float edge_thr=10.f, const float init_sigma=1.6f, const bool double_input=true, const float intensity_scale=0.00390625f, const float feature_ratio=0.05f)
C++ Interface for SIFT feature detector and GLOH descriptor.
AF_SAD
Match based on Sum of Absolute Differences (SAD)
Definition: defines.h:273
af_match_template
AFAPI af_err af_match_template(af_array *out, const af_array search_img, const af_array template_img, const af_match_type m_type)
C Interface for image template matching.
afcl::array
static af::array array(af::dim4 idims, cl_mem buf, af::dtype type, bool retain=false)
Create an af::array object from an OpenCL cl_mem buffer.
Definition: opencl.h:161
af_nearest_neighbour
AFAPI af_err af_nearest_neighbour(af_array *idx, af_array *dist, const af_array query, const af_array train, const dim_t dist_dim, const unsigned n_dist, const af_match_type dist_type)
C Interface wrapper for Nearest Neighbour.
af::hammingMatcher
AFAPI void hammingMatcher(array &idx, array &dist, const array &query, const array &train, const dim_t dist_dim=0, const unsigned n_dist=1)
C++ Interface wrapper for Hamming matcher.
af::sift
AFAPI void sift(features &feat, array &desc, const array &in, const unsigned n_layers=3, const float contrast_thr=0.04f, const float edge_thr=10.f, const float init_sigma=1.6f, const bool double_input=true, const float intensity_scale=0.00390625f, const float feature_ratio=0.05f)
C++ Interface for SIFT feature detector and descriptor.
af_array
void * af_array
Definition: defines.h:219
af::matchType
af_match_type matchType
Definition: defines.h:389
f32
32-bit floating point values
Definition: defines.h:193
af_susan
AFAPI af_err af_susan(af_features *out, const af_array in, const unsigned radius, const float diff_thr, const float geom_thr, const float feature_ratio, const unsigned edge)
C Interface for SUSAN corner detector.
af_sift
AFAPI af_err af_sift(af_features *feat, af_array *desc, const af_array in, const unsigned n_layers, const float contrast_thr, const float edge_thr, const float init_sigma, const bool double_input, const float intensity_scale, const float feature_ratio)
C++ Interface for SIFT feature detector and descriptor.
af::matchTemplate
AFAPI array matchTemplate(const array &searchImg, const array &templateImg, const matchType mType=AF_SAD)
C++ Interface for image template matching.
af_gloh
AFAPI af_err af_gloh(af_features *feat, af_array *desc, const af_array in, const unsigned n_layers, const float contrast_thr, const float edge_thr, const float init_sigma, const bool double_input, const float intensity_scale, const float feature_ratio)
C++ Interface for SIFT feature detector and GLOH descriptor.
af_homography
AFAPI af_err af_homography(af_array *H, int *inliers, const af_array x_src, const af_array y_src, const af_array x_dst, const af_array y_dst, const af_homography_type htype, const float inlier_thr, const unsigned iterations, const af_dtype otype)
C Interface wrapper for Homography estimation.
af_dtype
af_dtype
Definition: defines.h:192
af_match_type
af_match_type
Definition: defines.h:272
af::dtype
af_dtype dtype
Definition: defines.h:384