AliceVision
Photogrammetric Computer Vision Framework
ImageDescriber_SIFT_vlfeatFloat.hpp
1 // This file is part of the AliceVision project.
2 // Copyright (c) 2016 AliceVision contributors.
3 // Copyright (c) 2012 openMVG contributors.
4 // This Source Code Form is subject to the terms of the Mozilla Public License,
5 // v. 2.0. If a copy of the MPL was not distributed with this file,
6 // You can obtain one at https://mozilla.org/MPL/2.0/.
7 
8 #pragma once
9 
10 #include <aliceVision/feature/Descriptor.hpp>
11 #include <aliceVision/feature/ImageDescriber.hpp>
12 #include <aliceVision/feature/regionsFactory.hpp>
13 #include <aliceVision/feature/sift/SIFT.hpp>
14 
15 extern "C"
16 {
17 #include <nonFree/sift/vl/sift.h>
18 }
19 
20 #include <iostream>
21 #include <numeric>
22 
23 namespace aliceVision {
24 namespace feature {
25 
30 {
31  public:
32  explicit ImageDescriber_SIFT_vlfeatFloat(const SiftParams& params = SiftParams(), bool isOriented = true)
33  : ImageDescriber(),
34  _params(params),
35  _isOriented(isOriented)
36  {
37  // Configure VLFeat
38  VLFeatInstance::initialize();
39  }
40 
41  ~ImageDescriber_SIFT_vlfeatFloat() override { VLFeatInstance::destroy(); }
42 
47  bool useCuda() const override { return false; }
48 
53  bool useFloatImage() const override { return true; }
54 
59  EImageDescriberType getDescriberType() const override { return EImageDescriberType::SIFT_FLOAT; }
60 
68  std::size_t getMemoryConsumption(std::size_t width, std::size_t height) const override
69  {
70  return getMemoryConsumptionVLFeat(width, height, _params);
71  }
72 
77  void setUpRight(bool upRight) override { _isOriented = !upRight; }
78 
83  void setConfigurationPreset(ConfigurationPreset preset) override { return _params.setPreset(preset); }
84 
93  bool describe(const image::Image<float>& image, std::unique_ptr<Regions>& regions, const image::Image<unsigned char>* mask = nullptr) override
94  {
95  return extractSIFT<float>(image, regions, _params, _isOriented, mask);
96  }
97 
102  void allocate(std::unique_ptr<Regions>& regions) const override { regions.reset(new SIFT_Float_Regions); }
103 
104  private:
105  SiftParams _params;
106  bool _isOriented;
107 };
108 
109 } // namespace feature
110 } // namespace aliceVision
aliceVision::feature::ImageDescriber_SIFT_vlfeatFloat::useFloatImage
bool useFloatImage() const override
Check if the image describer use float image.
Definition: ImageDescriber_SIFT_vlfeatFloat.hpp:53
aliceVision::feature::ImageDescriber_SIFT_vlfeatFloat::getMemoryConsumption
std::size_t getMemoryConsumption(std::size_t width, std::size_t height) const override
Get the total amount of RAM needed for a feature extraction of an image of the given dimension.
Definition: ImageDescriber_SIFT_vlfeatFloat.hpp:68
aliceVision::feature::ImageDescriber_SIFT_vlfeatFloat::setConfigurationPreset
void setConfigurationPreset(ConfigurationPreset preset) override
Use a preset to control the number of detected regions.
Definition: ImageDescriber_SIFT_vlfeatFloat.hpp:83
aliceVision::feature::SiftParams
Definition: SIFT.hpp:35
aliceVision::feature::ImageDescriber_SIFT_vlfeatFloat::setUpRight
void setUpRight(bool upRight) override
Set image describer always upRight.
Definition: ImageDescriber_SIFT_vlfeatFloat.hpp:77
aliceVision::feature::ImageDescriber_SIFT_vlfeatFloat
Create an ImageDescriber interface for VLFeat SIFT Float feature extractor.
Definition: ImageDescriber_SIFT_vlfeatFloat.hpp:29
aliceVision
Definition: checkerDetector.cpp:32
aliceVision::feature::ImageDescriber
A pure virtual class for image description computation.
Definition: ImageDescriber.hpp:159
aliceVision::image::Image< float >
aliceVision::feature::ImageDescriber_SIFT_vlfeatFloat::useCuda
bool useCuda() const override
Check if the image describer use CUDA.
Definition: ImageDescriber_SIFT_vlfeatFloat.hpp:47
aliceVision::feature::FeatDescRegions
Definition: Regions.hpp:144
aliceVision::feature::ImageDescriber_SIFT_vlfeatFloat::getDescriberType
EImageDescriberType getDescriberType() const override
Get the corresponding EImageDescriberType.
Definition: ImageDescriber_SIFT_vlfeatFloat.hpp:59
aliceVision::feature::ConfigurationPreset
Definition: ImageDescriber.hpp:118
aliceVision::feature::ImageDescriber_SIFT_vlfeatFloat::allocate
void allocate(std::unique_ptr< Regions > &regions) const override
Allocate Regions type depending of the ImageDescriber.
Definition: ImageDescriber_SIFT_vlfeatFloat.hpp:102
aliceVision::feature::ImageDescriber_SIFT_vlfeatFloat::describe
bool describe(const image::Image< float > &image, std::unique_ptr< Regions > &regions, const image::Image< unsigned char > *mask=nullptr) override
Detect regions on the float image and compute their attributes (description)
Definition: ImageDescriber_SIFT_vlfeatFloat.hpp:93