Name
gray_histo_rangegray_histo_rangeGrayHistoRangegray_histo_rangeGrayHistoRangeGrayHistoRange — Calculate the gray value distribution of a single channel image within a
certain gray value range.
Herror gray_histo_range(const Hobject Regions, const Hobject Image, double Min, double Max, const Hlong NumBins, Hlong* Histo, double* BinSize)
Herror T_gray_histo_range(const Hobject Regions, const Hobject Image, const Htuple Min, const Htuple Max, const Htuple NumBins, Htuple* Histo, Htuple* BinSize)
Herror gray_histo_range(Hobject Regions, Hobject Image, const HTuple& Min, const HTuple& Max, const HTuple& NumBins, Hlong* Histo, double* BinSize)
Herror gray_histo_range(Hobject Regions, Hobject Image, const HTuple& Min, const HTuple& Max, const HTuple& NumBins, HTuple* Histo, HTuple* BinSize)
Hlong HRegion::GrayHistoRange(const HImage& Image, const HTuple& Min, const HTuple& Max, const HTuple& NumBins, double* BinSize) const
HTuple HRegionArray::GrayHistoRange(const HImage& Image, const HTuple& Min, const HTuple& Max, const HTuple& NumBins, HTuple* BinSize) const
void GrayHistoRange(const HObject& Regions, const HObject& Image, const HTuple& Min, const HTuple& Max, const HTuple& NumBins, HTuple* Histo, HTuple* BinSize)
HTuple HImage::GrayHistoRange(const HRegion& Regions, const HTuple& Min, const HTuple& Max, Hlong NumBins, double* BinSize) const
Hlong HImage::GrayHistoRange(const HRegion& Regions, double Min, double Max, Hlong NumBins, double* BinSize) const
HTuple HRegion::GrayHistoRange(const HImage& Image, const HTuple& Min, const HTuple& Max, Hlong NumBins, double* BinSize) const
Hlong HRegion::GrayHistoRange(const HImage& Image, double Min, double Max, Hlong NumBins, double* BinSize) const
void HOperatorSetX.GrayHistoRange(
[in] IHUntypedObjectX* Regions, [in] IHUntypedObjectX* Image, [in] VARIANT Min, [in] VARIANT Max, [in] VARIANT NumBins, [out] VARIANT* Histo, [out] VARIANT* BinSize)
VARIANT HImageX.GrayHistoRange(
[in] IHRegionX* Regions, [in] VARIANT Min, [in] VARIANT Max, [in] Hlong NumBins, [out] double* BinSize)
VARIANT HRegionX.GrayHistoRange(
[in] IHImageX* Image, [in] VARIANT Min, [in] VARIANT Max, [in] Hlong NumBins, [out] double* BinSize)
static void HOperatorSet.GrayHistoRange(HObject regions, HObject image, HTuple min, HTuple max, HTuple numBins, out HTuple histo, out HTuple binSize)
HTuple HImage.GrayHistoRange(HRegion regions, HTuple min, HTuple max, int numBins, out double binSize)
int HImage.GrayHistoRange(HRegion regions, double min, double max, int numBins, out double binSize)
HTuple HRegion.GrayHistoRange(HImage image, HTuple min, HTuple max, int numBins, out double binSize)
int HRegion.GrayHistoRange(HImage image, double min, double max, int numBins, out double binSize)
gray_histo_rangegray_histo_rangeGrayHistoRangegray_histo_rangeGrayHistoRangeGrayHistoRange calculates the gray value distribution
HistoHistoHistoHistoHistohisto of the single channel ImageImageImageImageImageimage within RegionsRegionsRegionsRegionsRegionsregions
and the gray value range [MinMinMinMinMinmin,MaxMaxMaxMaxMaxmax]. The values for
MinMinMinMinMinmin and MaxMaxMaxMaxMaxmax are rounded down to the next integer if the
ImageImageImageImageImageimage is not of type 'real'"real""real""real""real""real". The gray value range is divided
into NumBinsNumBinsNumBinsNumBinsNumBinsnumBins bins of the same size, which is returned in
BinSizeBinSizeBinSizeBinSizeBinSizebinSize. If a gray value lies between two bins the gray value is
assigned to the smaller bin. If the ImageImageImageImageImageimage is of type 'real'"real""real""real""real""real"
BinSizeBinSizeBinSizeBinSizeBinSizebinSize = (MaxMaxMaxMaxMaxmax - MinMinMinMinMinmin) / NumBinsNumBinsNumBinsNumBinsNumBinsnumBins.
If the ImageImageImageImageImageimage has discrete gray values the size of a bin is
computed with
BinSizeBinSizeBinSizeBinSizeBinSizebinSize = (MaxMaxMaxMaxMaxmax - MinMinMinMinMinmin + 1) /
NumBinsNumBinsNumBinsNumBinsNumBinsnumBins. Since the accuracy of the histogram HistoHistoHistoHistoHistohisto can
be adjusted with NumBinsNumBinsNumBinsNumBinsNumBinsnumBins, the calculation of the gray value
histogram with gray_histo_rangegray_histo_rangeGrayHistoRangegray_histo_rangeGrayHistoRangeGrayHistoRange is most useful for images of type
'real'"real""real""real""real""real" and images of type 'integer'"integer""integer""integer""integer""integer", which have
a high bit depth.
Note that the operator gray_histo_rangegray_histo_rangeGrayHistoRangegray_histo_rangeGrayHistoRangeGrayHistoRange only considers
the given RegionsRegionsRegionsRegionsRegionsregions and ignores any previously set domain
of the input image ImageImageImageImageImageimage.
If the ImageImageImageImageImageimage has discrete gray values the value of BinSizeBinSizeBinSizeBinSizeBinSizebinSize
may cause the following effects:
For BinSizeBinSizeBinSizeBinSizeBinSizebinSize > 1 multiple neighboring gray values are
assigned to the same bin. If BinSizeBinSizeBinSizeBinSizeBinSizebinSize is no integer the gray values
are distributed uneven among the bins, e.g., for
BinSizeBinSizeBinSizeBinSizeBinSizebinSize = 1.5 the first and second gray value are
assigned to the first bin, the third gray value is assigned to the second
bin, and the fourth and fifth gray value are assigned to the third bin.
This becomes noticeable in several peeks in the histogram HistoHistoHistoHistoHistohisto.
If BinSizeBinSizeBinSizeBinSizeBinSizebinSize < 1 some classes are not assigned by any
gray value, e.g., for BinSizeBinSizeBinSizeBinSizeBinSizebinSize = 0.5 the first
gray value is assigned to the first bin and the second gray value is assigned
to the third bin. The histogram HistoHistoHistoHistoHistohisto shows some gaps, which
resembles the structure of a comb.
If the ImageImageImageImageImageimage is of type 'real'"real""real""real""real""real" and
MinMinMinMinMinmin = MaxMaxMaxMaxMaxmax, all pixels of the corresponding gray value
are assigned only to the first bin.
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Automatically parallelized on internal data level.
Region in which the histogram is to be calculated.
MinMinMinMinMinmin (input_control) real → HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong) (double / Hlong)
Minimum gray value.
Default value: 0
Suggested values: 0
MaxMaxMaxMaxMaxmax (input_control) real → HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong) (double / Hlong)
Maximum gray value.
Default value: 255
Suggested values: 255
Restriction: Max >= Min
Number of bins.
Default value: 256
Suggested values: 16, 32, 64, 128, 256
Restriction: NumBins >= 1
Histogram to be calculated.
If the parameters are valid, the operator gray_histo_rangegray_histo_rangeGrayHistoRangegray_histo_rangeGrayHistoRangeGrayHistoRange
returns the value 2 (H_MSG_TRUE). If necessary an exception is raised.
min_max_graymin_max_grayMinMaxGraymin_max_grayMinMaxGrayMinMaxGray
create_funct_1d_arraycreate_funct_1d_arrayCreateFunct1dArraycreate_funct_1d_arrayCreateFunct1dArrayCreateFunct1dArray
gray_histogray_histoGrayHistogray_histoGrayHistoGrayHisto,
gray_histo_absgray_histo_absGrayHistoAbsgray_histo_absGrayHistoAbsGrayHistoAbs
histo_2dimhisto_2dimHisto2dimhisto_2dimHisto2dimHisto2dim,
scale_image_maxscale_image_maxScaleImageMaxscale_image_maxScaleImageMaxScaleImageMax
Foundation