CGAL 5.4.4 - Classification
CGAL::Classification::Feature::Color_channel< GeomTraits, PointRange, ColorMap > Class Template Reference

#include <CGAL/Classification/Feature/Color_channel.h>

Inherits from

CGAL::Classification::Feature_base.

Definition

Feature based on HSV colorimetric information.

If the input point cloud has colorimetric information, it can be used for classification purposes.

The HSV channels are defined this way:

  • Hue ranges from 0 to 360 and measures the general "tint" of the color (green, blue, pink, etc.)
  • Saturation ranges from 0 to 100 and measures the "strength" of the color (0 is gray and 100 is the fully saturated color)
  • Value ranges from 0 to 100 and measures the "brightness" of the color (0 is black and 100 is the fully bright color)

Its default name is "color_hue", "color_saturation" or "color_value", depending on which channel is chosen in the constructor.

Note
The user only needs to provide a map to standard (and more common) RGB colors, the conversion to HSV is done internally.
Template Parameters
GeomTraitsmodel of CGAL Kernel.
PointRangemodel of ConstRange. Its iterator type is RandomAccessIterator and its value type is the key type of ColorMap.
ColorMapmodel of ReadablePropertyMap whose key type is the value type of the iterator of PointRange and value type is CGAL::IO::Color.

Public Types

enum  Channel { HUE = 0, SATURATION = 1, VALUE = 2 }
 Selected channel. More...
 

Public Member Functions

 Color_channel (const PointRange &input, ColorMap color_map, Channel channel)
 constructs a feature based on the given color channel. More...
 
- Public Member Functions inherited from CGAL::Classification::Feature_base
const std::string & name () const
 returns the name of the feature (initialized to abstract_feature for Feature_base).
 
void set_name (const std::string &name)
 changes the name of the feature.
 
virtual float value (std::size_t index)=0
 returns the value taken by the feature for at the item for the item at position index. More...
 

Member Enumeration Documentation

◆ Channel

template<typename GeomTraits , typename PointRange , typename ColorMap >
enum CGAL::Classification::Feature::Color_channel::Channel

Selected channel.

Enumerator
HUE 

0

SATURATION 

1

VALUE 

2

Constructor & Destructor Documentation

◆ Color_channel()

template<typename GeomTraits , typename PointRange , typename ColorMap >
CGAL::Classification::Feature::Color_channel< GeomTraits, PointRange, ColorMap >::Color_channel ( const PointRange &  input,
ColorMap  color_map,
Channel  channel 
)

constructs a feature based on the given color channel.

Parameters
inputpoint range.
color_mapproperty map to access the colors of the input points.
channelchosen HSV channel.