image.h

Go to the documentation of this file.

/*******************************************************
 * Copyright (c) 2014, ArrayFire
 * All rights reserved.
 *
 * This file is distributed under 3-clause BSD license.
 * The complete license agreement can be obtained at:
 * http://arrayfire.com/licenses/BSD-3-Clause
 ********************************************************/
 
#pragma once
#include <af/defines.h>
#include <af/features.h>
 
#ifdef __cplusplus
namespace af
{
class array;
 
AFAPI void grad(array& dx, array& dy, const array& in);
 
AFAPI array loadImage(const char* filename, const bool is_color=false);
 
AFAPI void saveImage(const char* filename, const array& in);
 
#if AF_API_VERSION >= 31
AFAPI array loadImageMem(const void *ptr);
#endif
 
#if AF_API_VERSION >= 31
AFAPI void* saveImageMem(const array& in, const imageFormat format = AF_FIF_PNG);
#endif
 
#if AF_API_VERSION >= 31
AFAPI void deleteImageMem(void *ptr);
#endif
 
#if AF_API_VERSION >= 32
AFAPI array loadImageNative(const char* filename);
#endif
 
#if AF_API_VERSION >= 32
AFAPI void saveImageNative(const char* filename, const array& in);
#endif
 
#if AF_API_VERSION >= 33
AFAPI bool isImageIOAvailable();
#endif
 
AFAPI array resize(const array& in, const dim_t odim0, const dim_t odim1, const interpType method=AF_INTERP_NEAREST);
 
AFAPI array resize(const float scale0, const float scale1, const array& in, const interpType method=AF_INTERP_NEAREST);
 
AFAPI array resize(const float scale, const array& in, const interpType method=AF_INTERP_NEAREST);
 
AFAPI array rotate(const array& in, const float theta, const bool crop=true, const interpType method=AF_INTERP_NEAREST);
 
AFAPI array transform(const array& in, const array& transform, const dim_t odim0 = 0, const dim_t odim1 = 0,
                      const interpType method=AF_INTERP_NEAREST, const bool inverse=true);
 
#if AF_API_VERSION >= 33
AFAPI array transformCoordinates(const array& tf, const float d0, const float d1);
#endif
 
AFAPI array translate(const array& in, const float trans0, const float trans1, const dim_t odim0 = 0, const dim_t odim1 = 0, const interpType method=AF_INTERP_NEAREST);
 
AFAPI array scale(const array& in, const float scale0, const float scale1, const dim_t odim0 = 0, const dim_t odim1 = 0, const interpType method=AF_INTERP_NEAREST);
 
AFAPI array skew(const array& in, const float skew0, const float skew1, const dim_t odim0 = 0, const dim_t odim1 = 0, const bool inverse=true, const interpType method=AF_INTERP_NEAREST);
 
AFAPI array bilateral(const array &in, const float spatial_sigma, const float chromatic_sigma, const bool is_color=false);
 
AFAPI array histogram(const array &in, const unsigned nbins, const double minval, const double maxval);
 
AFAPI array histogram(const array &in, const unsigned nbins);
 
AFAPI array meanShift(const array& in, const float spatial_sigma, const float chromatic_sigma, const unsigned iter, const bool is_color=false);
 
AFAPI array minfilt(const array& in, const dim_t wind_length = 3, const dim_t wind_width = 3, const borderType edge_pad = AF_PAD_ZERO);
 
AFAPI array maxfilt(const array& in, const dim_t wind_length = 3, const dim_t wind_width = 3, const borderType edge_pad = AF_PAD_ZERO);
 
AFAPI array dilate(const array& in, const array& mask);
 
AFAPI array dilate3(const array& in, const array& mask);
 
AFAPI array erode(const array& in, const array& mask);
 
AFAPI array erode3(const array& in, const array& mask);
 
AFAPI array regions(const array& in, const af::connectivity connectivity=AF_CONNECTIVITY_4, const dtype type=f32);
 
AFAPI void sobel(array &dx, array &dy, const array &img, const unsigned ker_size=3);
 
AFAPI array sobel(const array &img, const unsigned ker_size=3, const bool isFast=false);
 
AFAPI array rgb2gray(const array& in, const float rPercent=0.2126f, const float gPercent=0.7152f, const float bPercent=0.0722f);
 
AFAPI array gray2rgb(const array& in, const float rFactor=1.0, const float gFactor=1.0, const float bFactor=1.0);
 
AFAPI array histEqual(const array& in, const array& hist);
 
AFAPI array gaussianKernel(const int rows, const int cols, const double sig_r = 0, const double sig_c = 0);
 
AFAPI array hsv2rgb(const array& in);
 
AFAPI array rgb2hsv(const array& in);
 
AFAPI array colorSpace(const array& image, const CSpace to, const CSpace from);
 
#if AF_API_VERSION >= 31
AFAPI array unwrap(const array& in, const dim_t wx, const dim_t wy,
                   const dim_t sx, const dim_t sy, const dim_t px=0, const dim_t py=0,
                   const bool is_column = true);
#endif
 
#if AF_API_VERSION >= 31
AFAPI array wrap(const array& in,
                 const dim_t ox, const dim_t oy,
                 const dim_t wx, const dim_t wy,
                 const dim_t sx, const dim_t sy,
                 const dim_t px = 0, const dim_t py = 0,
                 const bool is_column = true);
#endif
 
#if AF_API_VERSION >= 31
AFAPI array sat(const array& in);
#endif
 
#if AF_API_VERSION >= 31
AFAPI array ycbcr2rgb(const array& in, const YCCStd standard=AF_YCC_601);
#endif
 
#if AF_API_VERSION >= 31
AFAPI array rgb2ycbcr(const array& in, const YCCStd standard=AF_YCC_601);
#endif
 
#if AF_API_VERSION >= 34
AFAPI void moments(double* out, const array& in, const momentType moment=AF_MOMENT_FIRST_ORDER);
#endif
 
#if AF_API_VERSION >= 34
AFAPI array moments(const array& in, const momentType moment=AF_MOMENT_FIRST_ORDER);
#endif
 
#if AF_API_VERSION >= 35
AFAPI array canny(const array& in, const cannyThreshold thresholdType,
                  const float lowThresholdRatio, const float highThresholdRatio,
                  const unsigned sobelWindow = 3, const bool isFast = false);
#endif
 
#if AF_API_VERSION >= 36
AFAPI array anisotropicDiffusion(const af::array& in, const float timestep,
                                 const float conductance, const unsigned iterations,
                                 const fluxFunction fftype=AF_FLUX_EXPONENTIAL,
                                 const diffusionEq diffusionKind=AF_DIFFUSION_GRAD);
#endif
 
#if AF_API_VERSION >= 37
AFAPI array iterativeDeconv(const array& in, const array& ker,
                            const unsigned iterations, const float relaxFactor,
                            const iterativeDeconvAlgo algo);
 
AFAPI array inverseDeconv(const array& in, const array& psf,
                          const float gamma, const inverseDeconvAlgo algo);
 
AFAPI array confidenceCC(const array &in, const array &seeds,
                         const unsigned radius,
                         const unsigned multiplier, const int iter,
                         const double segmentedValue);
 
AFAPI array confidenceCC(const array &in, const array &seedx,
                         const array &seedy, const unsigned radius,
                         const unsigned multiplier, const int iter,
                         const double segmentedValue);
 
AFAPI array confidenceCC(const array &in, const size_t num_seeds,
                         const unsigned *seedx, const unsigned *seedy,
                         const unsigned radius, const unsigned multiplier,
                         const int iter, const double segmentedValue);
 
#endif
}
#endif
 
#ifdef __cplusplus
extern "C" {
#endif
 
    AFAPI af_err af_gradient(af_array *dx, af_array *dy, const af_array in);
 
    AFAPI af_err af_load_image(af_array *out, const char* filename, const bool isColor);
 
    AFAPI af_err af_save_image(const char* filename, const af_array in);
 
#if AF_API_VERSION >= 31
    AFAPI af_err af_load_image_memory(af_array *out, const void* ptr);
#endif
 
#if AF_API_VERSION >= 31
    AFAPI af_err af_save_image_memory(void** ptr, const af_array in, const af_image_format format);
#endif
 
#if AF_API_VERSION >= 31
    AFAPI af_err af_delete_image_memory(void* ptr);
#endif
 
#if AF_API_VERSION >= 32
    AFAPI af_err af_load_image_native(af_array *out, const char* filename);
#endif
 
#if AF_API_VERSION >= 32
    AFAPI af_err af_save_image_native(const char* filename, const af_array in);
#endif
 
#if AF_API_VERSION >= 33
    AFAPI af_err af_is_image_io_available(bool *out);
#endif
 
    AFAPI af_err af_resize(af_array *out, const af_array in, const dim_t odim0, const dim_t odim1, const af_interp_type method);
 
    AFAPI af_err af_transform(af_array *out, const af_array in, const af_array transform,
                              const dim_t odim0, const dim_t odim1,
                              const af_interp_type method, const bool inverse);
 
#if AF_API_VERSION >= 37
    AFAPI af_err af_transform_v2(af_array *out, const af_array in, const af_array transform,
                                 const dim_t odim0, const dim_t odim1,
                                 const af_interp_type method, const bool inverse);
#endif
 
#if AF_API_VERSION >= 33
    AFAPI af_err af_transform_coordinates(af_array *out, const af_array tf, const float d0, const float d1);
#endif
 
    AFAPI af_err af_rotate(af_array *out, const af_array in, const float theta,
                           const bool crop, const af_interp_type method);
    AFAPI af_err af_translate(af_array *out, const af_array in, const float trans0, const float trans1,
                              const dim_t odim0, const dim_t odim1, const af_interp_type method);
    AFAPI af_err af_scale(af_array *out, const af_array in, const float scale0, const float scale1,
                          const dim_t odim0, const dim_t odim1, const af_interp_type method);
    AFAPI af_err af_skew(af_array *out, const af_array in, const float skew0, const float skew1,
                         const dim_t odim0, const dim_t odim1, const af_interp_type method,
                         const bool inverse);
 
    AFAPI af_err af_histogram(af_array *out, const af_array in, const unsigned nbins, const double minval, const double maxval);
 
    AFAPI af_err af_dilate(af_array *out, const af_array in, const af_array mask);
 
    AFAPI af_err af_dilate3(af_array *out, const af_array in, const af_array mask);
 
    AFAPI af_err af_erode(af_array *out, const af_array in, const af_array mask);
 
    AFAPI af_err af_erode3(af_array *out, const af_array in, const af_array mask);
 
    AFAPI af_err af_bilateral(af_array *out, const af_array in, const float spatial_sigma, const float chromatic_sigma, const bool isColor);
 
    AFAPI af_err af_mean_shift(af_array *out, const af_array in, const float spatial_sigma, const float chromatic_sigma, const unsigned iter, const bool is_color);
 
    AFAPI af_err af_minfilt(af_array *out, const af_array in, const dim_t wind_length, const dim_t wind_width, const af_border_type edge_pad);
 
    AFAPI af_err af_maxfilt(af_array *out, const af_array in, const dim_t wind_length, const dim_t wind_width, const af_border_type edge_pad);
 
    AFAPI af_err af_regions(af_array *out, const af_array in, const af_connectivity connectivity, const af_dtype ty);
 
    AFAPI af_err af_sobel_operator(af_array *dx, af_array *dy, const af_array img, const unsigned ker_size);
 
    AFAPI af_err af_rgb2gray(af_array* out, const af_array in, const float rPercent, const float gPercent, const float bPercent);
 
    AFAPI af_err af_gray2rgb(af_array* out, const af_array in, const float rFactor, const float gFactor, const float bFactor);
 
    AFAPI af_err af_hist_equal(af_array *out, const af_array in, const af_array hist);
 
    AFAPI af_err af_gaussian_kernel(af_array *out,
                                    const int rows, const int cols,
                                    const double sigma_r, const double sigma_c);
 
    AFAPI af_err af_hsv2rgb(af_array* out, const af_array in);
 
    AFAPI af_err af_rgb2hsv(af_array* out, const af_array in);
 
    AFAPI af_err af_color_space(af_array *out, const af_array image, const af_cspace_t to, const af_cspace_t from);
 
#if AF_API_VERSION >= 31
    AFAPI af_err af_unwrap(af_array *out, const af_array in, const dim_t wx, const dim_t wy,
                           const dim_t sx, const dim_t sy, const dim_t px, const dim_t py,
                           const bool is_column);
#endif
 
#if AF_API_VERSION >= 31
    AFAPI af_err af_wrap(af_array *out,
                         const af_array in,
                         const dim_t ox, const dim_t oy,
                         const dim_t wx, const dim_t wy,
                         const dim_t sx, const dim_t sy,
                         const dim_t px, const dim_t py,
                         const bool is_column);
#endif
 
#if AF_API_VERSION >= 37
    AFAPI af_err af_wrap_v2(af_array *out,
                            const af_array in,
                            const dim_t ox, const dim_t oy,
                            const dim_t wx, const dim_t wy,
                            const dim_t sx, const dim_t sy,
                            const dim_t px, const dim_t py,
                            const bool is_column);
#endif
 
#if AF_API_VERSION >= 31
    AFAPI af_err af_sat(af_array *out, const af_array in);
#endif
 
#if AF_API_VERSION >= 31
    AFAPI af_err af_ycbcr2rgb(af_array* out, const af_array in, const af_ycc_std standard);
#endif
 
#if AF_API_VERSION >= 31
    AFAPI af_err af_rgb2ycbcr(af_array* out, const af_array in, const af_ycc_std standard);
#endif
 
#if AF_API_VERSION >= 34
    AFAPI af_err af_moments(af_array *out, const af_array in, const af_moment_type moment);
#endif
 
#if AF_API_VERSION >= 34
    AFAPI af_err af_moments_all(double* out, const af_array in, const af_moment_type moment);
#endif
 
#if AF_API_VERSION >= 35
    AFAPI af_err af_canny(af_array* out, const af_array in,
                          const af_canny_threshold threshold_type,
                          const float low_threshold_ratio,
                          const float high_threshold_ratio,
                          const unsigned sobel_window, const bool is_fast);
#endif
 
#if AF_API_VERSION >= 36
    AFAPI af_err af_anisotropic_diffusion(af_array* out, const af_array in,
                                          const float timestep,
                                          const float conductance,
                                          const unsigned iterations,
                                          const af_flux_function fftype,
                                          const af_diffusion_eq diffusion_kind);
#endif
 
#if AF_API_VERSION >= 37
    AFAPI af_err af_iterative_deconv(af_array* out,
                                     const af_array in, const af_array ker,
                                     const unsigned iterations,
                                     const float relax_factor,
                                     const af_iterative_deconv_algo algo);
 
    AFAPI af_err af_inverse_deconv(af_array* out, const af_array in,
                                   const af_array psf, const float gamma,
                                   const af_inverse_deconv_algo algo);
 
    AFAPI af_err af_confidence_cc(af_array *out, const af_array in,
                                  const af_array seedx, const af_array seedy,
                                  const unsigned radius,
                                  const unsigned multiplier, const int iter,
                                  const double segmented_value);
 
#endif
 
#ifdef __cplusplus
}
#endif