Back to FabImage Library website

You are here: Start » Function Reference » Histogram » Histogram Basics » GetHistogramBin

GetHistogramBin


Header: FIL.h
Namespace: fil
Module: FoundationBasic

Returns the value of a single histogram bin.

Syntax

C++
C#
 
void fil::GetHistogramBin
(
	const fil::Histogram& inHistogram,
	int inIndex,
	const bool inCyclic,
	const bool inInverse,
	double& outValue,
	ftl::Optional<float&> outBinStart = ftl::NIL,
	ftl::Optional<float&> outBinEnd = ftl::NIL
)

Parameters

Name Type Default Description
Input value inHistogram const Histogram& Input histogram
Input value inIndex int Input bin index
Input value inCyclic const bool False Whether to wrap the index around or not
Input value inInverse const bool Reversed order of bins
Output value outValue double& Output value of the bin
Output value outBinStart Optional<float&> NIL Lower limit of the bin
Output value outBinEnd Optional<float&> NIL Upper limit of the bin

Optional Outputs

The computation of following outputs can be switched off by passing value ftl::NIL to these parameters: outBinStart, outBinEnd.

Read more about Optional Outputs.

Errors

List of possible exceptions:

Error type Description
DomainError Incorrect index on input in GetHistogramBin.