Visual Servoing Platform
version 3.6.1 under development (2024-12-17)
|
#include <visp3/visual_features/vpFeatureLuminance.h>
Public Types | |
enum | vpBasicFeatureSelect { FEATURE_ALL = 0xffff } |
enum | vpBasicFeatureDeallocatorType { user , vpServo } |
Public Member Functions | |
vpFeatureLuminance () | |
vpFeatureLuminance (const vpFeatureLuminance &f) | |
virtual | ~vpFeatureLuminance () VP_OVERRIDE |
vpFeatureLuminance & | buildFrom (vpImage< unsigned char > &I) |
void | display (const vpCameraParameters &cam, const vpImage< unsigned char > &I, const vpColor &color=vpColor::green, unsigned int thickness=1) const VP_OVERRIDE |
void | display (const vpCameraParameters &cam, const vpImage< vpRGBa > &I, const vpColor &color=vpColor::green, unsigned int thickness=1) const VP_OVERRIDE |
vpFeatureLuminance * | duplicate () const VP_OVERRIDE |
vpColVector | error (const vpBasicFeature &s_star, unsigned int select=FEATURE_ALL) VP_OVERRIDE |
void | error (const vpBasicFeature &s_star, vpColVector &e) |
double | get_Z () const |
unsigned int | getBorder () const |
void | init (unsigned int _nbr, unsigned int _nbc, double _Z) |
void | init () VP_OVERRIDE |
vpMatrix | interaction (unsigned int select=FEATURE_ALL) VP_OVERRIDE |
void | interaction (vpMatrix &L) |
void | print (unsigned int select=FEATURE_ALL) const VP_OVERRIDE |
vpFeatureLuminance & | operator= (const vpFeatureLuminance &f) |
void | setCameraParameters (const vpCameraParameters &_cam) |
void | set_Z (double Z) |
Public Attributes | |
vpCameraParameters | cam |
Static Public Attributes | |
static const int | DEFAULT_BORDER = 10 |
static const unsigned int | FEATURE_LINE [32] |
Protected Attributes | |
double | Z |
unsigned int | nbr |
unsigned int | nbc |
unsigned int | bord |
vpLuminance * | pixInfo |
int | firstTimeIn |
vpColVector | s |
unsigned int | dim_s |
bool * | flags |
unsigned int | nbParameters |
Inherited functionalities from vpBasicFeature | |
vpBasicFeatureDeallocatorType | deallocate |
unsigned int | dimension_s () |
vpColVector | get_s (unsigned int select=FEATURE_ALL) const |
vpBasicFeatureDeallocatorType | getDeallocate () |
unsigned int | getDimension (unsigned int select=FEATURE_ALL) const |
virtual double | operator[] (unsigned int i) const |
void | setDeallocate (vpBasicFeatureDeallocatorType d) |
void | setFlags () |
static unsigned int | selectAll () |
void | resetFlags () |
Class that defines the image luminance visual feature.
For more details see [7].
Definition at line 74 of file vpFeatureLuminance.h.
|
inherited |
Indicates who should deallocate the feature.
Enumerator | |
---|---|
user | |
vpServo |
Definition at line 88 of file vpBasicFeature.h.
|
inherited |
Enumerator | |
---|---|
FEATURE_ALL |
Definition at line 83 of file vpBasicFeature.h.
vpFeatureLuminance::vpFeatureLuminance | ( | ) |
Default constructor that build a visual feature.
Definition at line 101 of file vpFeatureLuminance.cpp.
References vpBasicFeature::dim_s, vpBasicFeature::flags, init(), and vpBasicFeature::nbParameters.
Referenced by duplicate().
vpFeatureLuminance::vpFeatureLuminance | ( | const vpFeatureLuminance & | f | ) |
Copy constructor.
Definition at line 116 of file vpFeatureLuminance.cpp.
|
virtual |
Destructor.
Destructor that free allocated memory.
Definition at line 146 of file vpFeatureLuminance.cpp.
References pixInfo.
vpFeatureLuminance & vpFeatureLuminance::buildFrom | ( | vpImage< unsigned char > & | I | ) |
Build a luminance feature directly from the image
Definition at line 181 of file vpFeatureLuminance.cpp.
References bord, cam, vpPixelMeterConversion::convertPoint(), vpImageFilter::derivativeFilterX(), vpImageFilter::derivativeFilterY(), firstTimeIn, vpCameraParameters::get_px(), vpCameraParameters::get_py(), nbc, nbr, pixInfo, vpBasicFeature::s, and Z.
Referenced by vpFeatureLuminanceMapping::buildFrom().
|
inlineinherited |
Return the dimension of the feature vector .
Definition at line 110 of file vpBasicFeature.h.
|
virtual |
|
virtual |
|
virtual |
Create an object with the same type.
Implements vpBasicFeature.
Definition at line 361 of file vpFeatureLuminance.cpp.
References vpFeatureLuminance().
|
virtual |
Compute the error between the current and the desired
s_star | : Desired visual feature. |
select | : Not used. |
Reimplemented from vpBasicFeature.
Definition at line 288 of file vpFeatureLuminance.cpp.
void vpFeatureLuminance::error | ( | const vpBasicFeature & | s_star, |
vpColVector & | e | ||
) |
Compute the error between the current and the desired
s_star | : Desired visual feature. |
e | : Error between the current and the desired features. |
Definition at line 272 of file vpFeatureLuminance.cpp.
References vpBasicFeature::dim_s, vpColVector::resize(), and vpBasicFeature::s.
|
inherited |
Get the feature vector .
Definition at line 115 of file vpBasicFeature.cpp.
References vpBasicFeature::dim_s, vpBasicFeature::FEATURE_LINE, vpBasicFeature::s, and vpColVector::stack().
Referenced by vpServo::computeError(), vpBasicFeature::error(), vpFeatureDepth::error(), vpFeatureThetaU::error(), vpFeatureTranslation::error(), and vpGenericFeature::error().
double vpFeatureLuminance::get_Z | ( | ) | const |
Get the value of which represents the depth in the 3D camera frame.
Definition at line 171 of file vpFeatureLuminance.cpp.
References Z.
unsigned int vpFeatureLuminance::getBorder | ( | ) | const |
Definition at line 172 of file vpFeatureLuminance.cpp.
References bord.
Referenced by vpFeatureLuminanceMapping::init().
|
inlineinherited |
Definition at line 123 of file vpBasicFeature.h.
|
inherited |
Get the feature vector dimension.
Definition at line 102 of file vpBasicFeature.cpp.
References vpBasicFeature::dim_s, vpBasicFeature::FEATURE_LINE, vpArray2D< Type >::getRows(), and vpBasicFeature::s.
|
virtual |
Initialize the memory space requested for vpFeatureLuminance visual feature.
Implements vpBasicFeature.
Definition at line 59 of file vpFeatureLuminance.cpp.
References firstTimeIn, vpBasicFeature::flags, nbc, vpBasicFeature::nbParameters, nbr, and Z.
Referenced by init(), and vpFeatureLuminance().
void vpFeatureLuminance::init | ( | unsigned int | _nbr, |
unsigned int | _nbc, | ||
double | _Z | ||
) |
Definition at line 74 of file vpFeatureLuminance.cpp.
References bord, vpBasicFeature::dim_s, vpException::dimensionError, init(), nbc, nbr, pixInfo, vpColVector::resize(), vpBasicFeature::s, and Z.
Referenced by vpFeatureLuminanceMapping::init().
|
virtual |
Compute and return the interaction matrix . The computation is made thanks to the values of the luminance features
Implements vpBasicFeature.
Definition at line 257 of file vpFeatureLuminance.cpp.
Referenced by vpFeatureLuminanceMapping::buildFrom(), and vpFeatureLuminanceMapping::interaction().
void vpFeatureLuminance::interaction | ( | vpMatrix & | L | ) |
Compute and return the interaction matrix . The computation is made thanks to the values of the luminance features
Definition at line 230 of file vpFeatureLuminance.cpp.
References vpBasicFeature::dim_s, and pixInfo.
vpFeatureLuminance & vpFeatureLuminance::operator= | ( | const vpFeatureLuminance & | f | ) |
Copy operator.
Definition at line 125 of file vpFeatureLuminance.cpp.
References bord, cam, vpBasicFeature::dim_s, firstTimeIn, nbc, nbr, pixInfo, vpColVector::resize(), vpBasicFeature::s, and Z.
|
inlinevirtualinherited |
Return element i in the state vector (usage : x = s[i] )
Definition at line 130 of file vpBasicFeature.h.
|
virtual |
|
protectedinherited |
Definition at line 132 of file vpBasicFeature.cpp.
References vpBasicFeature::flags, and vpBasicFeature::nbParameters.
Referenced by vpFeatureVanishingPoint::interaction(), vpFeatureDepth::interaction(), vpFeatureEllipse::interaction(), vpFeatureLine::interaction(), vpFeaturePoint::interaction(), vpFeaturePoint3D::interaction(), vpFeaturePointPolar::interaction(), vpFeatureThetaU::interaction(), and vpFeatureTranslation::interaction().
|
inlinestaticinherited |
void vpFeatureLuminance::set_Z | ( | double | Z_ | ) |
Set the value of which represents the depth in the 3D camera frame.
Z_ | : value to set. |
Definition at line 159 of file vpFeatureLuminance.cpp.
References vpBasicFeature::flags, and Z.
void vpFeatureLuminance::setCameraParameters | ( | const vpCameraParameters & | _cam | ) |
Definition at line 174 of file vpFeatureLuminance.cpp.
References cam.
Referenced by vpFeatureLuminanceMapping::init().
|
inlineinherited |
Definition at line 137 of file vpBasicFeature.h.
Referenced by vpServo::addFeature().
|
inherited |
Set feature flags to true to prevent warning when re-computing the interaction matrix without having updated the feature.
Definition at line 142 of file vpBasicFeature.cpp.
References vpBasicFeature::flags, and vpBasicFeature::nbParameters.
|
protected |
Border size.
Definition at line 86 of file vpFeatureLuminance.h.
Referenced by buildFrom(), getBorder(), init(), and operator=().
vpCameraParameters vpFeatureLuminance::cam |
Definition at line 131 of file vpFeatureLuminance.h.
Referenced by buildFrom(), operator=(), and setCameraParameters().
|
protectedinherited |
Definition at line 148 of file vpBasicFeature.h.
Referenced by vpFeatureVanishingPoint::interaction(), vpFeatureDepth::interaction(), vpFeatureEllipse::interaction(), vpFeatureLine::interaction(), vpFeaturePoint::interaction(), vpFeaturePoint3D::interaction(), vpFeaturePointPolar::interaction(), vpFeatureSegment::interaction(), vpFeatureThetaU::interaction(), vpFeatureTranslation::interaction(), and vpBasicFeature::operator=().
|
static |
Definition at line 128 of file vpFeatureLuminance.h.
Referenced by vpLuminancePCA::init(), and vpLuminanceDCT::init().
|
protectedinherited |
Dimension of the visual feature.
Definition at line 94 of file vpBasicFeature.h.
Referenced by vpFeatureMoment::duplicate(), vpGenericFeature::duplicate(), vpBasicFeature::error(), vpFeatureLuminanceMapping::error(), vpGenericFeature::error(), error(), vpBasicFeature::get_s(), vpGenericFeature::get_s(), vpBasicFeature::getDimension(), vpFeatureMoment::getDimension(), vpFeatureDepth::init(), vpFeatureEllipse::init(), vpFeatureLine::init(), vpFeatureLuminanceMapping::init(), vpFeaturePoint::init(), vpFeaturePoint3D::init(), vpFeaturePointPolar::init(), vpFeatureSegment::init(), vpFeatureThetaU::init(), vpFeatureTranslation::init(), vpFeatureVanishingPoint::init(), init(), vpFeatureMoment::init(), vpFeatureLuminanceMapping::interaction(), vpFeatureMoment::interaction(), vpGenericFeature::interaction(), interaction(), vpBasicFeature::operator=(), operator=(), vpFeatureLuminanceMapping::operator=(), vpFeatureMoment::print(), vpGenericFeature::print(), vpGenericFeature::set_s(), vpGenericFeature::setError(), vpGenericFeature::setInteractionMatrix(), vpFeatureMoment::update(), vpFeatureLuminance(), and vpGenericFeature::vpGenericFeature().
|
staticinherited |
Definition at line 81 of file vpBasicFeature.h.
Referenced by vpBasicFeature::error(), vpGenericFeature::error(), vpBasicFeature::get_s(), vpBasicFeature::getDimension(), vpFeatureMoment::getDimension(), vpFeatureMoment::interaction(), vpGenericFeature::interaction(), vpFeatureMoment::print(), vpGenericFeature::print(), vpFeatureEllipse::select_n02(), vpFeatureEllipse::select_n11(), vpFeatureEllipse::select_n20(), vpFeatureSegment::selectAlpha(), vpFeatureVanishingPoint::selectAlpha(), vpFeatureVanishingPoint::selectAtanOneOverRho(), vpFeatureSegment::selectL(), vpFeatureVanishingPoint::selectOneOverRho(), vpFeatureLine::selectRho(), vpFeaturePointPolar::selectRho(), vpFeatureLine::selectTheta(), vpFeaturePointPolar::selectTheta(), vpFeatureThetaU::selectTUx(), vpFeatureThetaU::selectTUy(), vpFeatureThetaU::selectTUz(), vpFeatureTranslation::selectTx(), vpFeatureTranslation::selectTy(), vpFeatureTranslation::selectTz(), vpFeatureEllipse::selectX(), vpFeaturePoint::selectX(), vpFeaturePoint3D::selectX(), vpFeatureVanishingPoint::selectX(), vpFeatureSegment::selectXc(), vpFeatureEllipse::selectY(), vpFeaturePoint::selectY(), vpFeaturePoint3D::selectY(), vpFeatureVanishingPoint::selectY(), vpFeatureSegment::selectYc(), and vpFeaturePoint3D::selectZ().
|
protected |
Definition at line 90 of file vpFeatureLuminance.h.
Referenced by buildFrom(), init(), and operator=().
|
protectedinherited |
Ensure that all the parameters needed to compute the interaction matrix are set.
Definition at line 98 of file vpBasicFeature.h.
Referenced by vpFeatureLine::buildFrom(), vpFeaturePointPolar::buildFrom(), vpFeatureEllipse::buildFrom(), vpFeaturePoint::buildFrom(), vpFeatureDepth::buildFrom(), vpFeatureTranslation::buildFrom(), vpFeaturePoint3D::buildFrom(), vpFeatureThetaU::buildFrom(), vpFeatureMoment::duplicate(), vpFeatureDepth::init(), vpFeatureEllipse::init(), vpFeatureLine::init(), init(), vpFeaturePoint::init(), vpFeaturePoint3D::init(), vpFeaturePointPolar::init(), vpFeatureSegment::init(), vpFeatureThetaU::init(), vpFeatureTranslation::init(), vpFeatureVanishingPoint::init(), vpFeatureMoment::init(), vpFeatureVanishingPoint::interaction(), vpFeatureDepth::interaction(), vpFeatureEllipse::interaction(), vpFeatureLine::interaction(), vpFeaturePoint::interaction(), vpFeaturePoint3D::interaction(), vpFeaturePointPolar::interaction(), vpFeatureSegment::interaction(), vpFeatureThetaU::interaction(), vpFeatureTranslation::interaction(), vpBasicFeature::operator=(), vpBasicFeature::resetFlags(), vpFeaturePointPolar::set_rho(), vpFeaturePointPolar::set_rhoThetaZ(), vpFeaturePointPolar::set_theta(), vpFeatureThetaU::set_TUx(), vpFeatureThetaU::set_TUy(), vpFeatureThetaU::set_TUz(), vpFeatureDepth::set_x(), vpFeatureEllipse::set_x(), vpFeaturePoint::set_x(), vpFeaturePoint3D::set_X(), vpFeatureVanishingPoint::set_x(), vpFeatureEllipse::set_xy(), vpFeaturePoint::set_xyZ(), vpFeaturePoint3D::set_XYZ(), vpFeatureDepth::set_xyZLogZoverZstar(), vpFeatureDepth::set_y(), vpFeatureEllipse::set_y(), vpFeaturePoint::set_y(), vpFeaturePoint3D::set_Y(), vpFeatureVanishingPoint::set_y(), vpFeatureDepth::set_Z(), set_Z(), vpFeaturePoint::set_Z(), vpFeaturePoint3D::set_Z(), vpFeaturePointPolar::set_Z(), vpFeatureEllipse::setABC(), vpFeatureLine::setABCD(), vpFeatureVanishingPoint::setAlpha(), vpFeatureVanishingPoint::setAtanOneOverRho(), vpBasicFeature::setFlags(), vpFeatureEllipse::setMoments(), vpFeatureVanishingPoint::setOneOverRho(), vpFeatureLine::setRhoTheta(), vpFeatureMoment::update(), vpFeatureLuminance(), and vpBasicFeature::~vpBasicFeature().
|
protected |
Number of column.
Definition at line 84 of file vpFeatureLuminance.h.
Referenced by buildFrom(), init(), and operator=().
|
protectedinherited |
Number of parameters needed to compute the interaction matrix.
Definition at line 100 of file vpBasicFeature.h.
Referenced by vpFeatureLine::buildFrom(), vpFeaturePointPolar::buildFrom(), vpFeatureEllipse::buildFrom(), vpFeaturePoint::buildFrom(), vpFeatureDepth::buildFrom(), vpFeaturePoint3D::buildFrom(), vpFeatureThetaU::buildFrom(), vpFeatureMoment::duplicate(), vpFeatureDepth::init(), vpFeatureEllipse::init(), vpFeatureLine::init(), init(), vpFeaturePoint::init(), vpFeaturePoint3D::init(), vpFeaturePointPolar::init(), vpFeatureSegment::init(), vpFeatureThetaU::init(), vpFeatureTranslation::init(), vpFeatureVanishingPoint::init(), vpFeatureMoment::init(), vpFeatureVanishingPoint::interaction(), vpFeatureDepth::interaction(), vpFeatureEllipse::interaction(), vpFeatureLine::interaction(), vpFeaturePoint::interaction(), vpFeaturePoint3D::interaction(), vpFeaturePointPolar::interaction(), vpFeatureSegment::interaction(), vpFeatureThetaU::interaction(), vpFeatureTranslation::interaction(), vpBasicFeature::operator=(), vpBasicFeature::resetFlags(), vpFeaturePointPolar::set_rhoThetaZ(), vpFeaturePoint::set_xyZ(), vpFeaturePoint3D::set_XYZ(), vpFeatureDepth::set_xyZLogZoverZstar(), vpFeatureEllipse::setABC(), vpFeatureLine::setABCD(), vpBasicFeature::setFlags(), vpFeatureMoment::update(), and vpFeatureLuminance().
|
protected |
Number of rows.
Definition at line 82 of file vpFeatureLuminance.h.
Referenced by buildFrom(), init(), and operator=().
|
protected |
Store the image (as a vector with intensity and gradient I, Ix, Iy)
Definition at line 89 of file vpFeatureLuminance.h.
Referenced by buildFrom(), init(), interaction(), operator=(), and ~vpFeatureLuminance().
|
protectedinherited |
State of the visual feature.
Definition at line 92 of file vpBasicFeature.h.
Referenced by vpFeatureLine::buildFrom(), vpFeaturePointPolar::buildFrom(), vpFeatureEllipse::buildFrom(), vpFeaturePoint::buildFrom(), vpFeatureDepth::buildFrom(), vpFeatureTranslation::buildFrom(), vpFeaturePoint3D::buildFrom(), vpFeatureThetaU::buildFrom(), buildFrom(), vpFeatureLuminanceMapping::buildFrom(), vpFeatureEllipse::display(), vpFeatureMoment::duplicate(), vpFeatureVanishingPoint::error(), vpBasicFeature::error(), vpFeatureDepth::error(), vpFeatureEllipse::error(), vpFeatureLine::error(), vpFeatureMomentAlpha::error(), vpFeaturePoint::error(), vpFeaturePoint3D::error(), vpFeaturePointPolar::error(), vpFeatureThetaU::error(), vpFeatureTranslation::error(), vpGenericFeature::error(), error(), vpFeatureLuminanceMapping::error(), vpFeatureDepth::get_LogZoverZstar(), vpFeaturePointPolar::get_rho(), vpBasicFeature::get_s(), vpGenericFeature::get_s(), vpFeaturePointPolar::get_theta(), vpFeatureThetaU::get_TUx(), vpFeatureThetaU::get_TUy(), vpFeatureThetaU::get_TUz(), vpFeatureTranslation::get_Tx(), vpFeatureTranslation::get_Ty(), vpFeatureTranslation::get_Tz(), vpFeaturePoint::get_x(), vpFeaturePoint3D::get_X(), vpFeatureVanishingPoint::get_x(), vpFeaturePoint::get_y(), vpFeaturePoint3D::get_Y(), vpFeatureVanishingPoint::get_y(), vpFeaturePoint3D::get_Z(), vpFeatureVanishingPoint::getAlpha(), vpFeatureVanishingPoint::getAtanOneOverRho(), vpBasicFeature::getDimension(), vpFeatureVanishingPoint::getOneOverRho(), vpFeatureDepth::init(), vpFeatureEllipse::init(), vpFeatureLine::init(), vpFeaturePoint::init(), vpFeaturePoint3D::init(), vpFeaturePointPolar::init(), vpFeatureSegment::init(), vpFeatureThetaU::init(), vpFeatureTranslation::init(), vpFeatureVanishingPoint::init(), vpGenericFeature::init(), vpFeatureLuminanceMapping::init(), init(), vpFeatureMoment::init(), vpFeatureEllipse::interaction(), vpFeatureLine::interaction(), vpFeatureThetaU::interaction(), vpFeatureTranslation::interaction(), vpFeatureLuminanceMapping::interaction(), vpBasicFeature::operator=(), operator=(), vpFeatureLuminanceMapping::operator=(), vpFeatureEllipse::print(), vpFeatureLine::print(), vpFeatureLuminanceMapping::print(), vpFeatureMoment::print(), vpFeatureSegment::print(), vpFeatureThetaU::print(), vpFeatureTranslation::print(), vpGenericFeature::print(), vpFeatureDepth::set_LogZoverZstar(), vpFeaturePointPolar::set_rho(), vpGenericFeature::set_s(), vpFeaturePointPolar::set_theta(), vpFeatureThetaU::set_TUx(), vpFeatureThetaU::set_TUy(), vpFeatureThetaU::set_TUz(), vpFeatureTranslation::set_Tx(), vpFeatureTranslation::set_Ty(), vpFeatureTranslation::set_Tz(), vpFeatureEllipse::set_x(), vpFeaturePoint::set_x(), vpFeaturePoint3D::set_X(), vpFeatureVanishingPoint::set_x(), vpFeatureEllipse::set_xy(), vpFeatureEllipse::set_y(), vpFeaturePoint::set_y(), vpFeaturePoint3D::set_Y(), vpFeatureVanishingPoint::set_y(), vpFeaturePoint3D::set_Z(), vpFeatureVanishingPoint::setAlpha(), vpFeatureVanishingPoint::setAtanOneOverRho(), vpFeatureEllipse::setMoments(), vpFeatureVanishingPoint::setOneOverRho(), vpFeatureLine::setRhoTheta(), vpFeatureMoment::update(), and vpGenericFeature::vpGenericFeature().
|
protected |
FeaturePoint depth (required to compute the interaction matrix) default Z = 1m
Definition at line 79 of file vpFeatureLuminance.h.
Referenced by buildFrom(), get_Z(), init(), operator=(), and set_Z().