Create an ImageDescriber interface for AprilTag feature extractor. More...

#include <ImageDescriber_APRILTAG.hpp>

Inheritance diagram for aliceVision::feature::ImageDescriber_APRILTAG:

Classes
struct	AprilTagParameters

Public Member Functions
bool	useCuda () const override
	Check if the image describer use CUDA. More...

bool	useFloatImage () const override
	Check if the image describer use float image. More...

EImageDescriberType	getDescriberType () const override
	Get the corresponding EImageDescriberType. More...

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. More...

void	setConfigurationPreset (ConfigurationPreset preset) override
	Use a preset to control the number of detected regions. More...

bool	describe (const image::Image< unsigned char > &image, std::unique_ptr< Regions > &regions, const image::Image< unsigned char > *mask=nullptr) override
	Detect regions on the 8-bit image and compute their attributes (description) More...

void	allocate (std::unique_ptr< Regions > &regions) const override
	Allocate Regions type depending of the ImageDescriber. More...

Public Member Functions inherited from aliceVision::feature::ImageDescriber
virtual void	setUpRight ([[maybe_unused]] bool upRight)
	Set whether the image describer is always upright. More...

virtual void	setUseCuda ([[maybe_unused]] bool useCuda)
	Set whether the image describer needs to use CUDA implementation. More...

virtual void	setCudaPipe ([[maybe_unused]] int pipe)
	Set the CUDA pipe. More...

virtual bool	describe ([[maybe_unused]] const image::Image< unsigned char > &image, [[maybe_unused]] std::unique_ptr< Regions > &regions, [[maybe_unused]] const image::Image< unsigned char > *mask=nullptr)
	Detect regions on the 8-bit image and compute their attributes (description) More...

virtual bool	describe ([[maybe_unused]] const image::Image< float > &image, [[maybe_unused]] std::unique_ptr< Regions > &regions, [[maybe_unused]] const image::Image< unsigned char > *mask=nullptr)
	Detect regions on the float image and compute their attributes (description) More...

void	Load (Regions *regions, const std::string &sfileNameFeats, const std::string &sfileNameDescs) const

void	Save (const Regions *regions, const std::string &sfileNameFeats, const std::string &sfileNameDescs) const

void	LoadFeatures (Regions *regions, const std::string &sfileNameFeats) const

Detailed Description

Create an ImageDescriber interface for AprilTag feature extractor.

Member Function Documentation

◆ allocate()

void aliceVision::feature::ImageDescriber_APRILTAG::allocate ( std::unique_ptr< Regions > & regions ) const

overridevirtual

Allocate Regions type depending of the ImageDescriber.

Parameters

[in,out] regions

Implements aliceVision::feature::ImageDescriber.

◆ describe()

bool aliceVision::feature::ImageDescriber_APRILTAG::describe	(	const image::Image< unsigned char > &	image,
		std::unique_ptr< Regions > &	regions,
		const image::Image< unsigned char > *	mask = `nullptr`
	)

override

Detect regions on the 8-bit image and compute their attributes (description)

Parameters

[in]	image	Image.
[out]	regions	The detected regions and attributes (the caller must delete the allocated data)
[in]	mask	8-bit grayscale image for keypoint filtering (optional) Non-zero values depict the region of interest.

Returns: True if detection succeeded.

◆ getDescriberType()

EImageDescriberType aliceVision::feature::ImageDescriber_APRILTAG::getDescriberType ( ) const

overridevirtual

Get the corresponding EImageDescriberType.

Returns: EImageDescriberType

Implements aliceVision::feature::ImageDescriber.

◆ getMemoryConsumption()

std::size_t aliceVision::feature::ImageDescriber_APRILTAG::getMemoryConsumption	(	std::size_t	width,
		std::size_t	height
	)		const

inlineoverridevirtual

Get the total amount of RAM needed for a feature extraction of an image of the given dimension.

Parameters

[in]	width	The image width
[in]	height	The image height

Returns: total amount of memory needed

Implements aliceVision::feature::ImageDescriber.

◆ setConfigurationPreset()

void aliceVision::feature::ImageDescriber_APRILTAG::setConfigurationPreset ( ConfigurationPreset preset )

overridevirtual

Use a preset to control the number of detected regions.

Parameters

[in] preset The preset configuration

Returns: True if configuration succeed. (here always false)

Implements aliceVision::feature::ImageDescriber.

◆ useCuda()

bool aliceVision::feature::ImageDescriber_APRILTAG::useCuda ( ) const

inlineoverridevirtual

Check if the image describer use CUDA.

Returns: True if the image describer use CUDA

Implements aliceVision::feature::ImageDescriber.

◆ useFloatImage()

bool aliceVision::feature::ImageDescriber_APRILTAG::useFloatImage ( ) const

inlineoverridevirtual

Check if the image describer use float image.

Returns: True if the image describer use float image

Implements aliceVision::feature::ImageDescriber.

The documentation for this class was generated from the following files:

/home/docs/checkouts/readthedocs.org/user_builds/alicevision/checkouts/latest/src/aliceVision/feature/apriltag/ImageDescriber_APRILTAG.hpp
/home/docs/checkouts/readthedocs.org/user_builds/alicevision/checkouts/latest/src/aliceVision/feature/apriltag/ImageDescriber_APRILTAG.cpp

Classes

Public Member Functions

Detailed Description

Member Function Documentation

◆ allocate()

◆ describe()

◆ getDescriberType()

◆ getMemoryConsumption()

◆ setConfigurationPreset()

◆ useCuda()

◆ useFloatImage()