Classes
class	AbstractPlotWidget
	The PlotWidget is an abstract base class for 2D plotting components. More...

class	AdjustGridMouseHandler
	Special MouseHandler Implementation that allows several quadrangular grids to be defined. More...

struct	Border
	internally used component More...

struct	BorderBox
	A simple utility class (QWidget with titled border) More...

class	BorderHandle
	Handle class for "border" gui components (only for explicit "border" components) More...

class	BoxHandle
	A Handle for container GUI components (hbox, vbox, hscroll and vscroll) More...

struct	Button
	Button Component. More...

struct	ButtonGroup
	ButtonGroup component (aka vertical list of radio buttons) More...

class	ButtonGroupHandle
	Class for handling button goups. More...

class	ButtonHandle
	Special Utiltiy class for handling Button clicks in the ICL GUI API. More...

struct	CamCfg
	camera configuration component More...

class	CamCfgWidget
	Special QWidget implementation for configuring grabber properties. More...

struct	CheckBox
	CheckBox component. More...

class	CheckBoxHandle
	Special Utiltiy class for handling Button clicks in the ICL GUI API. More...

class	ChromaClassifierIO

class	ChromaGUI
	Dedicated GUI component which can be used to adjust segmentation parameters. More...

class	ColorHandle
	Class wrapping ColorLabel GUI compoenent handling. More...

class	ColorLabel
	Utility class to avoid Qt warning when accesing QLabels from differnt Threads. More...

struct	ColorSelect
	Color selection component. More...

struct	Combo
	ComboBox GUI component. More...

class	ComboHandle
	Handle class for combo components. More...

class	CompabilityLabel
	Utility class to avoid Qt warning when accesing QLabels from differnt Threads. More...

struct	ContainerGUIComponent
	Special GUI extension, that mimics the GUIComponent interface. More...

class	ContainerHandle
	Base class for Container like GUI handles as Box- or Tab widgets. More...

struct	Create
	Finalizes GUI creation (actually creates the Qt-GUI but initially hidden) More...

class	DataStore
	Extension of the associative container MultiTypeMap. More...

class	DefineQuadrangleMouseHandler
	Special MouseHandler Implementation that allows for defining a quadrangle. More...

class	DefineRectanglesMouseHandler
	Utility mouse handler implementation that allows to define rectangles via drag and drop. More...

struct	Disp
	Display component for a 2D Array of labels. More...

class	DispHandle
	Handle class for disp components. More...

class	DoubleSlider
	A utiltiy class which implements a labeld, double valued QSlider. More...

struct	Dragger
	Utility class that implements draggable rects on the ChromaWidget surface. More...

class	DragRectangleMouseHandler
	Special MouseHandler implementation that allows for dragging a Rectangle. More...

struct	Draw
	Image visualization component that allows for overlayed 2D image annotation. More...

struct	Draw3D
	Image visualization compoent that allows for 2D and 3D image annotation. More...

class	DrawHandle
	Handle class for image components. More...

class	DrawHandle3D
	Handle class for image components. More...

struct	Dummy
	Creates not component. More...

class	DynamicGUI
	Special GUI implementation that allows for defining the GUI layout in an XML-file. More...

struct	Float
	Text Input component, that allows float inputs in a given range. More...

class	FloatHandle
	Class for handling "float" textfield components. More...

struct	Fps
	Frames per second estimator component. More...

class	FPSHandle
	Class for Frames-per-second GUI-Label. More...

struct	FSlider
	Float-valued Slider component. More...

class	FSliderHandle
	Handle class for slider componets. More...

class	GLFragmentShader
	Simple wrapper class for OpenGL 2.0 Fragment Shader Programs. More...

class	GLImg
	OpenGL Texture Map Image class. More...

class	GLPaintEngine
	Paint engine to be used in QGLWigets for a high performance image visualization. More...

class	GUI
	Main Class of ICL's GUI creation framework. More...

class	GUIComponent
	The GUIComponent class servers as a generic interface for GUI definitions. More...

struct	GUIComponentWithOutput

class	GUIDefinition
	Utilty class to simplify creation of GUI components. More...

class	GUIHandle
	Abstract base class for Handle classes. More...

class	GUIHandleBase
	Base class for GUIHandles providing functions to register callbacks. More...

class	GUISyntaxErrorException
	Internally used and caught exception class for the GUI API. More...

class	GUIWidget
	Abstract class for GUI components. More...

struct	HBox
	Horizonal Box container component. More...

struct	HistogrammWidget
	Utility class used within the ICLWidget class. More...

struct	HScroll
	Horizontal scroll area. More...

struct	HSplit
	Horizontal split-component. More...

class	ICLApplication
	QApplication extension for ICL based applications. More...

class	ICLDrawWidget
	Extended Image visualization widget, with a drawing state machine interface. More...

class	ICLDrawWidget3D
	Extended ICLDrawWidget, able to draw 2D and 3D primitives using OpenGL. More...

class	ICLVideoSurface

class	ICLWidget
	Class for openGL-based image visualization components. More...

class	IconFactory
	Simple utility class providing static functions to create some icons. More...

struct	Image
	Image visualization component. More...

class	ImageHandle
	Handle class for image components. More...

struct	ImageStatistics

class	ImgParamWidget
	Internally used widget to define image params. More...

struct	ImgROI
	internal stuct, used for deep image copies More...

struct	Int
	Text Input component, that allows integer inputs in a given range. More...

class	IntHandle
	Class for handling "int" textfield components. More...

struct	Label
	Label component for displaying text. More...

class	LabelHandle
	Class for GUI-Label handling. More...

class	LowLevelPlotWidget
	Default AbstractPlotWidget implementation for plotting different kinds of data. More...

class	MouseEvent
	Provided by interface MouseGrabber. More...

class	MouseHandler
	MouseEvent Handler. More...

class	MultiDrawHandle
	Handle class for image components. More...

class	PaintEngine
	pure virtual Paint engine interface More...

struct	Plot
	a 2D function and data plotting component More...

class	PlotHandle
	Handle class for image components. More...

class	PlotWidget
	Easy to use widget component for 2D data visualization. More...

struct	Prop
	Propery adjustment component for configuable instances. More...

class	ProxyLayout
	just a helper class for GUI Layouting More...

struct	Ps
	Process status component. More...

class	QImageConverter
	class for conversion between QImage and core::ImgBase/Img<T> More...

class	QtCameraGrabber

class	QtVideoGrabber

class	RSBRemoteGUI
	Creates an RSB-interface to externally get and set parameters of the wrapped GUI. More...

struct	Show
	Finalizes GUI creation (actually creates the Qt-GUI and makes it visible) More...

struct	Slider
	Slider component for int-ranges. More...

class	SliderHandle
	Handle class for slider componets. More...

struct	SliderUpdateEvent
	Utility class for threaded updatable sliders. More...

struct	Spinner
	SpinBox component. More...

class	SpinnerHandle
	Handle class for spinner components. More...

class	SplitterHandle
	A Handle for SplitterWidget container GUI components. More...

struct	State
	For a state log panel. More...

class	StateHandle
	Class for GUI-Label handling a so called state component. More...

struct	String
	Text Input component, that allows float inputs with a given maximun length. More...

class	StringHandle
	Class for handling "string" textfield components. More...

class	StringSignalButton
	internally used button that emits a signal with its text More...

struct	Tab
	Tab-compnent. More...

class	TabHandle
	A Handle for TabWidget container GUI components. More...

class	ThreadedUpdatableSlider
	Compability class. More...

class	ThreadedUpdatableTextView

class	ThreadedUpdatableWidget
	Compability class. More...

class	ToggleButton

struct	VBox
	Vertical Box container component. More...

struct	VScroll
	Vertical scroll area. More...

struct	VSplit
	Vertical split-component. More...

Typedefs
typedef ICLApplication	ICLApp
	this is just a shortcut typedef More...

typedef std::vector< QRadioButton * >	RadioButtonVec
	type definition for the ButtonGroup handle More...

typedef utils::Array2D< LabelHandle >	LabelMatrix
	Type definition for handling GUI-"disp" components. More...

typedef core::Img< ICL_QUICK_TYPE >	ImgQ
	typedef for the quick images type (this time core::Img<icl32f>) More...

Enumerations
enum	MouseEventType { MouseMoveEvent = 0, MouseDragEvent = 1, MousePressEvent = 2, MouseReleaseEvent = 3, MouseEnterEvent = 4, MouseLeaveEvent = 5, MouseWheelEvent = 6, MAX_MOUSE_EVENT = MouseWheelEvent }
	list of supported mouse event types More...

enum	MouseButton { LeftMouseButton = 0, MiddleMouseButton = 1, RightMouseButton = 2, MAX_MOUSE_BUTTON = RightMouseButton }
	list of supported mouse buttons More...

enum	KeyboardModifier { NoModifier = Qt::NoModifier, ShiftModifier = Qt::ShiftModifier, ControlModifier = Qt::ControlModifier, AltModifier = Qt::AltModifier, MetaModifier = Qt::MetaModifier, KeypadModifier = Qt::KeypadModifier, GroupSwitchModifier = Qt::GroupSwitchModifier }

enum	ICLWidgetCaptureMode { capturingStarted, capturingStopped, capturingPaused }

Functions
ICLQt_API std::string	openFileDialog (const std::string &filter="", const std::string &caption="open file", const std::string &initialDirectory="_____last", void *parentWidget=0)
	uses Qt to spawn an open-file dialog with given filter More...

ICLQt_API std::string	saveFileDialog (const std::string &filter="", const std::string &caption="save file", const std::string &initialDirectory="_____last", void *parentWidget=0)
	uses Qt to spawn a save-file dialog with given filter More...

std::string	textInputDialog (const std::string &caption="text ...", const std::string &message="please write your text here", const std::string &initialText="", void parentWidget=0, core::ImgBase visImage=0, std::vector< std::string > completionOptions=std::vector< std::string >())
	uses Qt to spawn a text input dialog More...

ICLQt_API std::string	execute_process (const std::string &command)
	executes the given command as a child process and returns it output More...

creator functions
template<class T >
ICLQt_API core::Img< T >	zeros (int width, int height, int channels=1)
	create an empty (black) ImgQ (affinity for floats) More...

template<class T >
ICLQt_API core::Img< T >	ones (int width, int height, int channels=1)
	create an ImgQ that is pre-initialized with ones (affinity for floats) More...

template<class T >
ICLQt_API core::Img< T >	load (const std::string &filename)
	load an image file read file (affinity for floats) More...

template<class T >
ICLQt_API core::Img< T >	load (const std::string &filename, core::format fmt)
	loads an image file and returns image in given core::format (affinity for floats) More...

template<class T >
ICLQt_API core::Img< T >	create (const std::string &name, core::format fmt=icl::core::formatRGB)
	create a test image (converted to destination core::format) (affinity for floats) More...

template<class T >
ICLQt_API core::Img< T >	grab (const std::string &dev, const std::string &devSpec, const utils::Size &size=utils::Size::null, core::format fmt=core::formatRGB, bool releaseGrabber=false)
	grabs a new image from given device (affinity for floats) More...

converting function

ICLQt_API core::Img8u	cvt8u (const ImgQ &image)
	Converts the image into depth8u. More...

ICLQt_API core::Img16s	cvt16s (const ImgQ &image)
	Converts the image into depth16. More...

ICLQt_API core::Img32s	cvt32s (const ImgQ &image)
	Converts the image into depth32s. More...

ICLQt_API core::Img32f	cvt32f (const ImgQ &image)
	Converts the image into depth32f. More...

ICLQt_API core::Img64f	cvt64f (const ImgQ &image)
	Converts the image into depth64f. More...

ICLQt_API ImgQ	cvt (const core::Img8u &image)
	Converts a given core::Img8u into an ImgQ. More...

ICLQt_API ImgQ	cvt (const core::ImgBase *image)
	Converts a given core::ImgBase into an ImgQ. More...

ICLQt_API ImgQ	cvt (const core::ImgBase &image)
	Converts a given core::ImgBase into an ImgQ. More...

filtering function

template<class T >
ICLQt_API core::Img< T >	filter (const core::Img< T > &image, const std::string &filter)
	applies a filter operation on the source image (affinity for float) More...

template<class T >
ICLQt_API core::Img< T >	blur (const core::Img< T > &image, int maskRadius=1)
	applies gaussian blur to a given image (using a maskRadius*2+1-sized gaussian filter) More...

ICLQt_API ImgQ	cc (const ImgQ &image, core::format fmt)
	applies a color conversion More...

ICLQt_API ImgQ	rgb (const ImgQ &image)
	converts a given image to formatRGB More...

ICLQt_API ImgQ	hls (const ImgQ &image)
	converts a given image to formatHLS More...

ICLQt_API ImgQ	lab (const ImgQ &image)
	converts a given image to formatLAB More...

ICLQt_API ImgQ	gray (const ImgQ &image)
	converts a given image to formatGray More...

ICLQt_API ImgQ	scale (const ImgQ &image, float factor)
	scales an image by a given factor More...

ICLQt_API ImgQ	scale (const ImgQ &image, int width, int height)
	scales an image to the given size More...

ICLQt_API ImgQ	channel (const ImgQ &image, int channel)
	picks a specific image channel More...

ICLQt_API ImgQ	levels (const ImgQ &image, icl8u levels)
	reduces an images quantisation levels More...

ICLQt_API ImgQ	thresh (const ImgQ &image, float threshold)
	performs an image binarisation for each channel with given threshold More...

template<class T >
ICLQt_API core::Img< T >	copy (const core::Img< T > &image)
	deep copy for an image More...

template<class T >
ICLQt_API core::Img< T >	copyroi (const core::Img< T > &image)
	deep copy of an images roi More...

template<class T >
ICLQt_API core::Img< T >	norm (const core::Img< T > &image)
	normalize an images range to [0,255] More...

ICLQt_API ImgQ	flipx (const ImgQ &image)
	horizontal flip of an image More...

ICLQt_API ImgQ	flipy (const ImgQ &image)
	vertical flip of an image More...

output functions

ICLQt_API void	save (const core::ImgBase &image, const std::string &filename)
	write an image to HD More...

ICLQt_API void	show (const icl::core::ImgBase &image)
	shows an image using TestImages::show More...

ICLQt_API void	showSetup (const string &showCommand="xv %s", const string &rmCommand="rm -rf %s", int msecBeforeDelete=500)
	setup image visualisation programm More...

template<class T >
void	print (const core::Img< T > &image)
	print the images parameters to std::out More...

ImgQ arithmetical operators

ICLQt_API ImgQ	operator+ (const ImgQ &a, const ImgQ &b)
	adds two images pixel-wise More...

ICLQt_API ImgQ	operator- (const ImgQ &a, const ImgQ &b)
	subtracts two images pixel-wise More...

ICLQt_API ImgQ	operator * (const ImgQ &a, const ImgQ &b)
	multiplies two images pixel-wise More...

ICLQt_API ImgQ	operator/ (const ImgQ &a, const ImgQ &b)
	divides two images pixel-wise More...

ICLQt_API ImgQ	operator+ (const ImgQ &image, float val)
	adds a constant to each pixel value More...

ICLQt_API ImgQ	operator- (const ImgQ &image, float val)
	subtracts a constant to each pixel value More...

ICLQt_API ImgQ	operator * (const ImgQ &image, float val)
	multiplies each pixel value with a constant More...

ICLQt_API ImgQ	operator/ (const ImgQ &image, float val)
	divides each pixel value by a constant More...

ICLQt_API ImgQ	operator+ (float val, const ImgQ &image)
	adds a constant to each pixel value More...

ICLQt_API ImgQ	operator- (float val, const ImgQ &image)
	subtracts each pixel value from a constant More...

ICLQt_API ImgQ	operator * (float val, const ImgQ &image)
	multiplies each pixel value with a constant More...

ICLQt_API ImgQ	operator/ (float val, const ImgQ &image)
	divides a constant by each pixel value More...

ICLQt_API ImgQ	operator- (const ImgQ &image)
	returns image*(-1) More...

ImgQ arithmetical functions

ICLQt_API ImgQ	exp (const ImgQ &image)
	calls exp( each pixel ) More...

ICLQt_API ImgQ	ln (const ImgQ &image)
	calls ln( each pixel ) More...

ICLQt_API ImgQ	sqr (const ImgQ &image)
	calls ( each pixel )² More...

ICLQt_API ImgQ	sqrt (const ImgQ &image)
	calls sqrt( each pixel) More...

ICLQt_API ImgQ	abs (const ImgQ &image)
	calls abs ( each pixel) More...

ImgQ logical operators

ICLQt_API ImgQ	operator\|\| (const ImgQ &a, const ImgQ &b)
	pixel-wise logical or More...

ICLQt_API ImgQ	operator && (const ImgQ &a, const ImgQ &b)
	pixel-wise logical and More...

template<class T >
ICLQt_API ImgQ	binOR (const ImgQ &a, const ImgQ &b)
	pixels-wise binary or (each value is converted to T brefore binary or) More...

template<class T >
ICLQt_API ImgQ	binXOR (const ImgQ &a, const ImgQ &b)
	pixels-wise binary or (each value is converted to T brefore binary or) More...

template<class T >
ICLQt_API ImgQ	binAND (const ImgQ &a, const ImgQ &b)
	pixels-wise binary or (each value is converted to T brefore binary or) More...

ImgQ concatenation operators

ICLQt_API ImgQ	operator, (const ImgQ &a, const ImgQ &b)
	horizontal image concatenation More...

ICLQt_API ImgQ	operator% (const ImgQ &a, const ImgQ &b)
	vertical image combination (as ,-operator) More...

ICLQt_API ImgQ	operator\| (const ImgQ &a, const ImgQ &b)
	channel concatenation of images More...

ImgQ roi copy

ICLQt_API ImgROI	roi (ImgQ &r)
	creates a ROI-struct from an image More...

ICLQt_API ImgROI	data (ImgQ &r)
	creates full ROI ROI-struct More...

drawing functions

ICLQt_API void	color (float r, float g=-1, float b=-1, float alpha=255)
	sets the current color to given r,g,b,alpha value More...

ICLQt_API void	fill (float r, float g=-1, float b=-1, float alpha=255)
	sets the current fill color to given r,g,b,alpha value More...

ICLQt_API void	colorinfo (float color[4], float fill[4])
	returns the current color state More...

ICLQt_API void	cross (ImgQ &image, int x, int y)
	draws a 6x6-cross into an image More...

void	cross (ImgQ &image, const utils::Point &p)
	draws a 6x6-cross into an image More...

ICLQt_API void	rect (ImgQ &image, int x, int y, int w, int h, int rounding=0)
	draws a rect into an image More...

void	rect (ImgQ &image, const utils::Rect &r, int rounding=0)
	draws a rect into an image More...

ICLQt_API void	triangle (ImgQ &image, int x1, int y1, int x2, int y2, int x3, int y3)
	draws a triangle into an image More...

void	triangle (ImgQ &image, const utils::Point &a, const utils::Point &b, const utils::Point &c)
	draws a triangle into an image More...

ICLQt_API void	line (ImgQ &image, int x1, int y1, int x2, int y2)
	draws a line into an image More...

void	line (ImgQ &image, const utils::Point &p1, const utils::Point &p2)
	draws a line into an image More...

ICLQt_API void	linestrip (ImgQ &image, const std::vector< utils::Point > &pts, bool closeLoop=true)
	draws a strip of connected lines More...

ICLQt_API void	polygon (ImgQ &image, const std::vector< utils::Point > &corners)
	draws a polygon (constructed out of linestrips More...

ICLQt_API void	pix (ImgQ &image, int x, int y)
	draw a single pixel into an image More...

void	pix (ImgQ &image, const utils::Point &p)
	draw a single pixel into an image More...

ICLQt_API void	pix (ImgQ &image, const vector< utils::Point > &pts)
	draws a set of points into an image More...

ICLQt_API void	pix (ImgQ &image, const vector< vector< utils::Point > > &pts)
	draws a set of point sets into an image More...

ICLQt_API void	circle (ImgQ &image, int x, int y, int r)
	renders a filled circle into an image More...

ICLQt_API void	text (ImgQ &image, int x, int y, const string &text)
	renders a text into an image (only available with Qt-Support) More...

void	text (ImgQ &image, const utils::Point &p, const string &sText)
	renders a text into an image (only available with Qt-Support) More...

ICLQt_API ImgQ	label (const ImgQ &image, const string &text)
	labels an image in the upper left corner (only available with Qt-Support) More...

ICLQt_API void	font (int size, const string &family="Arial")
	sets up the current font (only available with Qt-Support) More...

ICLQt_API void	fontsize (int size)
	sets up current fontsize (only available with Qt-Support) More...

timer and benchmarking

ICLQt_API void	tic (const std::string &label="")
	starts a timer More...

ICLQt_API void	toc ()
	stops a timer started with tic() More...

Typedef Documentation

◆ ICLApp

typedef ICLApplication icl::qt::ICLApp

this is just a shortcut typedef

◆ ImgQ

typedef core::Img<ICL_QUICK_TYPE> icl::qt::ImgQ

typedef for the quick images type (this time core::Img<icl32f>)

Enumeration Type Documentation

◆ ICLWidgetCaptureMode

enum icl::qt::ICLWidgetCaptureMode

Enumerator
capturingStarted
capturingStopped
capturingPaused

◆ KeyboardModifier

enum icl::qt::KeyboardModifier

Enumerator
NoModifier	No modifier key is pressed.
ShiftModifier	A Shift key on the keyboard is pressed.
ControlModifier	A Ctrl key on the keyboard is pressed.
AltModifier	An Alt key on the keyboard is pressed.
MetaModifier	A Meta key on the keyboard is pressed.
KeypadModifier	A keypad button is pressed.
GroupSwitchModifier	X11 only. A Mode_switch key on the keyboard is pressed.

◆ MouseButton

enum icl::qt::MouseButton

list of supported mouse buttons

when ever you'll find a bool downmaks[3], buttons are arranged by this enum order

Enumerator
LeftMouseButton	left mouse button
MiddleMouseButton	middle mouse button
RightMouseButton	right moouse button
MAX_MOUSE_BUTTON	highest enum value (enum value count = MAX_MOUSE_BUTTON + 1)

◆ MouseEventType

enum icl::qt::MouseEventType

list of supported mouse event types

Enumerator
MouseMoveEvent	mouse moved
MouseDragEvent	mouse button pressed down and held
MousePressEvent	mouse button pressed
MouseReleaseEvent	mouse button released
MouseEnterEvent	mouse entered area
MouseLeaveEvent	mouse left area
MouseWheelEvent	mouse wheel
MAX_MOUSE_EVENT	highest enum value (enum value count = MAX_MOUSE_EVENT + 1)

Function Documentation

◆ abs()

ICLQt_API ImgQ icl::qt::abs ( const ImgQ & image )

calls abs ( each pixel)

Parameters

image source image

◆ binAND()

template<class T >

ICLQt_API ImgQ icl::qt::binAND	(	const ImgQ &	a,
		const ImgQ &	b
	)

pixels-wise binary or (each value is converted to T brefore binary or)

◆ binOR()

template<class T >

ICLQt_API ImgQ icl::qt::binOR	(	const ImgQ &	a,
		const ImgQ &	b
	)

pixels-wise binary or (each value is converted to T brefore binary or)

◆ binXOR()

template<class T >

ICLQt_API ImgQ icl::qt::binXOR	(	const ImgQ &	a,
		const ImgQ &	b
	)

pixels-wise binary or (each value is converted to T brefore binary or)

◆ blur()

template<class T >

ICLQt_API core::Img<T> icl::qt::blur	(	const core::Img< T > &	image,
		int	maskRadius = `1`
	)

applies gaussian blur to a given image (using a maskRadius*2+1-sized gaussian filter)

affinity for floats

◆ cc()

ICLQt_API ImgQ icl::qt::cc	(	const ImgQ &	image,
		core::format	fmt
	)

applies a color conversion

Parameters

image	source image*
fmt	destination image format

◆ channel()

ICLQt_API ImgQ icl::qt::channel	(	const ImgQ &	image,
		int	channel
	)

picks a specific image channel

Parameters

image	source image
channel	channel index to pick

◆ circle()

ICLQt_API void icl::qt::circle	(	ImgQ &	image,
		int	x,
		int	y,
		int	r
	)

renders a filled circle into an image

This function renders a filled circle into a 3 or 1 channel image (only with fill color!) using a QPainter internally.

Parameters

image	destination image
x	x-pos of the circle center
y	x-pos of the circle center
r	radius of the circle

◆ color()

ICLQt_API void icl::qt::color	(	float	r,
		float	g = `-1`,
		float	b = `-1`,
		float	alpha = `255`
	)

sets the current color to given r,g,b,alpha value

Parameters

r	red value
g	green value (if < 0, g is set to r)
b	blue value (if < 0, b is set to r)
alpha	alpha value 255 = no transparency, 0 = full transparency

◆ colorinfo()

ICLQt_API void icl::qt::colorinfo	(	float	color[4],
		float	fill[4]
	)

returns the current color state

Parameters

color	destintaion array for the current draw color
fill	destinaion array for the current fill color

◆ copy()

template<class T >

ICLQt_API core::Img<T> icl::qt::copy ( const core::Img< T > & image )

deep copy for an image

Parameters

image source image

◆ copyroi()

template<class T >

ICLQt_API core::Img<T> icl::qt::copyroi ( const core::Img< T > & image )

deep copy of an images roi

Parameters

image source image

◆ create()

template<class T >

ICLQt_API core::Img<T> icl::qt::create	(	const std::string &	name,
		core::format	fmt = `icl::core::formatRGB`
	)

create a test image (converted to destination core::format) (affinity for floats)

Parameters

name	identifier for the image: names are: parrot, lena, cameraman, mandril, windows, flowers, women, house and tree
fmt	image core::format to convert the result to

◆ cross() [1/2]

ICLQt_API void icl::qt::cross	(	ImgQ &	image,
		int	x,
		int	y
	)

draws a 6x6-cross into an image

Parameters

image	destination image
x	x-pos of the cross
y	y-pos of the cross

◆ cross() [2/2]

void icl::qt::cross	(	ImgQ &	image,
		const utils::Point &	p
	)

inline

draws a 6x6-cross into an image

Parameters

image	destination image
p	position

◆ cvt() [1/3]

ICLQt_API ImgQ icl::qt::cvt ( const core::Img8u & image )

Converts a given core::Img8u into an ImgQ.

Parameters

image source image

Returns: converted image

◆ cvt() [2/3]

ICLQt_API ImgQ icl::qt::cvt ( const core::ImgBase * image )

Converts a given core::ImgBase into an ImgQ.

Parameters

image source image

Returns: conveted image

◆ cvt() [3/3]

ICLQt_API ImgQ icl::qt::cvt ( const core::ImgBase & image )

Converts a given core::ImgBase into an ImgQ.

Parameters

image source image

Returns: conveted image

◆ cvt16s()

ICLQt_API core::Img16s icl::qt::cvt16s ( const ImgQ & image )

Converts the image into depth16.

Parameters

image source image

Returns: converted image

◆ cvt32f()

ICLQt_API core::Img32f icl::qt::cvt32f ( const ImgQ & image )

Converts the image into depth32f.

Parameters

image source image

Returns: converted image

◆ cvt32s()

ICLQt_API core::Img32s icl::qt::cvt32s ( const ImgQ & image )

Converts the image into depth32s.

Parameters

image source image

Returns: converted image

◆ cvt64f()

ICLQt_API core::Img64f icl::qt::cvt64f ( const ImgQ & image )

Converts the image into depth64f.

Parameters

image source image

Returns: converted image

◆ cvt8u()

ICLQt_API core::Img8u icl::qt::cvt8u ( const ImgQ & image )

Converts the image into depth8u.

Parameters

image source image

Returns: converted image

◆ data()

ICLQt_API ImgROI icl::qt::data ( ImgQ & r )

creates full ROI ROI-struct

this can also be used for deep copies

ImgQ a,b;

a = aaa    b = bBBBb ( B = ROI pixel )
    aaa        bBBBb ( b = no ROI pixel )
    aaa        bBBBb
               bbbbb

data(a) = roi(b)

a = BBB
    BBB
    BBB

equal to:
or a = copyroi(b) // this will release a and reallocate its data

Parameters

r	image to wrap

◆ execute_process()

ICLQt_API std::string icl::qt::execute_process ( const std::string & command )

executes the given command as a child process and returns it output

Internally, popen is used

◆ exp()

ICLQt_API ImgQ icl::qt::exp ( const ImgQ & image )

calls exp( each pixel )

Parameters

image source image

◆ fill()

ICLQt_API void icl::qt::fill	(	float	r,
		float	g = `-1`,
		float	b = `-1`,
		float	alpha = `255`
	)

sets the current fill color to given r,g,b,alpha value

Parameters

r	red value
g	green value (if < 0, g is set to r)
b	blue value (if < 0, b is set to r)
alpha	alpha value 255 = no transparency, 0 = full transparency

◆ filter()

template<class T >

ICLQt_API core::Img<T> icl::qt::filter	(	const core::Img< T > &	image,
		const std::string &	filter
	)

applies a filter operation on the source image (affinity for float)

Parameters

image	source image
filter	filter name, possible: sobelx, sobely, gauss, laplacs, median, dilation,erosion, opening and closing

◆ flipx()

ICLQt_API ImgQ icl::qt::flipx ( const ImgQ & image )

horizontal flip of an image

Parameters

image source image

◆ flipy()

ICLQt_API ImgQ icl::qt::flipy ( const ImgQ & image )

vertical flip of an image

Parameters

image source image

◆ font()

ICLQt_API void icl::qt::font	(	int	size,
		const string &	family = `"Arial"`
	)

sets up the current font (only available with Qt-Support)

Parameters

size	new font size 12 by default
family	font family string "Arial" by default

◆ fontsize()

ICLQt_API void icl::qt::fontsize ( int size )

sets up current fontsize (only available with Qt-Support)

Parameters

size	new font size (default is 12)

◆ grab()

template<class T >

ICLQt_API core::Img<T> icl::qt::grab	(	const std::string &	dev,
		const std::string &	devSpec,
		const utils::Size &	size = `utils::Size::null`,
		core::format	fmt = `core::formatRGB`,
		bool	releaseGrabber = `false`
	)

grabs a new image from given device (affinity for floats)

Parameters

dev	device driver type (see Generic Grabber for more details)
devSpec	device specifier
size	output image size (grabbers size if utils::Size::null)
fmt	output format
releaseGrabber	if set to true, the correspondig grabbers are deleted immediately

◆ gray()

ICLQt_API ImgQ icl::qt::gray ( const ImgQ & image )

converts a given image to formatGray

Parameters

image source image

◆ hls()

ICLQt_API ImgQ icl::qt::hls ( const ImgQ & image )

converts a given image to formatHLS

Parameters

image source image

◆ lab()

ICLQt_API ImgQ icl::qt::lab ( const ImgQ & image )

converts a given image to formatLAB

Parameters

image source image

◆ label()

ICLQt_API ImgQ icl::qt::label	(	const ImgQ &	image,
		const string &	text
	)

labels an image in the upper left corner (only available with Qt-Support)

Parameters

image	image to label
text	text label

Returns: labeled source image (= given image)

◆ levels()

ICLQt_API ImgQ icl::qt::levels	(	const ImgQ &	image,
		icl8u	levels
	)

reduces an images quantisation levels

Internally the image is coverted to core::Img8u and back to apply this operation.

Parameters

image	source image
levels	gray level count for each channel of the destination image

◆ line() [1/2]

ICLQt_API void icl::qt::line	(	ImgQ &	image,
		int	x1,
		int	y1,
		int	x2,
		int	y2
	)

draws a line into an image

Parameters

image	destination image
x1	fist point x coord
y1	fist point y coord
x2	second point x coord
y2	second point y coord

◆ line() [2/2]

void icl::qt::line	(	ImgQ &	image,
		const utils::Point &	p1,
		const utils::Point &	p2
	)

inline

draws a line into an image

Parameters

image	destination image
p1	fist point
p2	second point

◆ linestrip()

ICLQt_API void icl::qt::linestrip	(	ImgQ &	image,
		const std::vector< utils::Point > &	pts,
		bool	closeLoop = `true`
	)

draws a strip of connected lines

Parameters

image	destination image
pts	list of points
closeLoop	if true, then also the first and the last point is connected

◆ ln()

ICLQt_API ImgQ icl::qt::ln ( const ImgQ & image )

calls ln( each pixel )

Parameters

image source image

◆ load() [1/2]

template<class T >

ICLQt_API core::Img<T> icl::qt::load ( const std::string & filename )

load an image file read file (affinity for floats)

Parameters

filename filename/pattern to read

◆ load() [2/2]

template<class T >

ICLQt_API core::Img<T> icl::qt::load	(	const std::string &	filename,
		core::format	fmt
	)

loads an image file and returns image in given core::format (affinity for floats)

Parameters

filename	filename to read (.jpg, .ppm, *.pgm)
fmt	image core::format to convert the result to

◆ norm()

template<class T >

ICLQt_API core::Img<T> icl::qt::norm ( const core::Img< T > & image )

normalize an images range to [0,255]

Parameters

image source image

◆ ones()

template<class T >

ICLQt_API core::Img<T> icl::qt::ones	(	int	width,
		int	height,
		int	channels = `1`
	)

create an ImgQ that is pre-initialized with ones (affinity for floats)

Parameters

width	image width
height	image height
channels	image channel count

◆ openFileDialog()

ICLQt_API std::string icl::qt::openFileDialog	(	const std::string &	filter = `""`,
		const std::string &	caption = `"open file"`,
		const std::string &	initialDirectory = `"_____last"`,
		void *	parentWidget = `0`
	)

uses Qt to spawn an open-file dialog with given filter

throws an exception if cancel was pressed. The function is thread-safe and can savely be called from a working thread

◆ operator &&()

ICLQt_API ImgQ icl::qt::operator &&	(	const ImgQ &	a,
		const ImgQ &	b
	)

pixel-wise logical and

Parameters

a	first source image
b	second source image

◆ operator *() [1/3]

ICLQt_API ImgQ icl::qt::operator *	(	const ImgQ &	a,
		const ImgQ &	b
	)

multiplies two images pixel-wise

Parameters

a	first source image
b	second source image

◆ operator *() [2/3]

ICLQt_API ImgQ icl::qt::operator *	(	const ImgQ &	image,
		float	val
	)

multiplies each pixel value with a constant

Parameters

image	source image
val	const multiplication value

◆ operator *() [3/3]

ICLQt_API ImgQ icl::qt::operator *	(	float	val,
		const ImgQ &	image
	)

multiplies each pixel value with a constant

Parameters

image	source image
val	const multiplication value

◆ operator%()

ICLQt_API ImgQ icl::qt::operator%	(	const ImgQ &	a,
		const ImgQ &	b
	)

vertical image combination (as ,-operator)

Parameters

a	upper image
b	lower image

◆ operator+() [1/3]

ICLQt_API ImgQ icl::qt::operator+	(	const ImgQ &	a,
		const ImgQ &	b
	)

adds two images pixel-wise

Parameters

a	first source image
b	second source image

◆ operator+() [2/3]

ICLQt_API ImgQ icl::qt::operator+	(	const ImgQ &	image,
		float	val
	)

adds a constant to each pixel value

Parameters

image	source image
val	const addition value

◆ operator+() [3/3]

ICLQt_API ImgQ icl::qt::operator+	(	float	val,
		const ImgQ &	image
	)

adds a constant to each pixel value

Parameters

image	source image
val	const addition value

◆ operator,()

ICLQt_API ImgQ icl::qt::operator,	(	const ImgQ &	a,
		const ImgQ &	b
	)

horizontal image concatenation

example: ImgQ a,b,c;
a=aaa  b = bbbbb
  aaa      bbbbb
  aaa

c = a,b,a;

c = aaabbbbbaaa
    aaabbbbbaaa
    aaa00000aaa

empty spaces are set to 0;

Parameters

a	left image
b	right image

◆ operator-() [1/4]

ICLQt_API ImgQ icl::qt::operator-	(	const ImgQ &	a,
		const ImgQ &	b
	)

subtracts two images pixel-wise

Parameters

a	first source image
b	second source image

◆ operator-() [2/4]

ICLQt_API ImgQ icl::qt::operator-	(	const ImgQ &	image,
		float	val
	)

subtracts a constant to each pixel value

Parameters

image	source image
val	const subtraction value

◆ operator-() [3/4]

ICLQt_API ImgQ icl::qt::operator-	(	float	val,
		const ImgQ &	image
	)

subtracts each pixel value from a constant

Parameters

image	source image
val	const left value for subtraction

◆ operator-() [4/4]

ICLQt_API ImgQ icl::qt::operator- ( const ImgQ & image )

returns image*(-1)

Parameters

image source image

◆ operator/() [1/3]

ICLQt_API ImgQ icl::qt::operator/	(	const ImgQ &	a,
		const ImgQ &	b
	)

divides two images pixel-wise

Parameters

a	first source image
b	second source image

◆ operator/() [2/3]

ICLQt_API ImgQ icl::qt::operator/	(	const ImgQ &	image,
		float	val
	)

divides each pixel value by a constant

Parameters

image	source image
val	const division value

◆ operator/() [3/3]

ICLQt_API ImgQ icl::qt::operator/	(	float	val,
		const ImgQ &	image
	)

divides a constant by each pixel value

Parameters

image	source image
val	nominator for the division operation

◆ operator|()

ICLQt_API ImgQ icl::qt::operator\|	(	const ImgQ &	a,
		const ImgQ &	b
	)

channel concatenation of images

Parameters

a	first image (channels f1,f2,f3,...)
b	second image (channels s2, s2,s3,...)

Returns: image with channels (f1,f2,... s1, s2, ...)

◆ operator||()

ICLQt_API ImgQ icl::qt::operator\|\|	(	const ImgQ &	a,
		const ImgQ &	b
	)

pixel-wise logical or

Parameters

a	first source image
b	second source image

◆ pix() [1/4]

ICLQt_API void icl::qt::pix	(	ImgQ &	image,
		int	x,
		int	y
	)

draw a single pixel into an image

Parameters

image	destination image
x	xpos of the pixel
y	ypos of the pixel

◆ pix() [2/4]

void icl::qt::pix	(	ImgQ &	image,
		const utils::Point &	p
	)

inline

draw a single pixel into an image

Parameters

image	destination image
p	pos of the pixel

◆ pix() [3/4]

ICLQt_API void icl::qt::pix	(	ImgQ &	image,
		const vector< utils::Point > &	pts
	)

draws a set of points into an image

Parameters

image	destination image
pts	vector of points

◆ pix() [4/4]

ICLQt_API void icl::qt::pix	(	ImgQ &	image,
		const vector< vector< utils::Point > > &	pts
	)

draws a set of point sets into an image

Parameters

image	destination image
pts	vector of vector of points to draw

◆ polygon()

ICLQt_API void icl::qt::polygon	(	ImgQ &	image,
		const std::vector< utils::Point > &	corners
	)

draws a polygon (constructed out of linestrips

◆ print()

template<class T >

void icl::qt::print ( const core::Img< T > & image )

print the images parameters to std::out

Parameters

image image to print to std::out

◆ rect() [1/2]

ICLQt_API void icl::qt::rect	(	ImgQ &	image,
		int	x,
		int	y,
		int	w,
		int	h,
		int	rounding = `0`
	)

draws a rect into an image

Parameters

image	destination image
x	x-pos of the rect
y	x-pos of the rect
w	width of the rect
h	height of the rect
rounding	rounded corners (in pixels)

◆ rect() [2/2]

void icl::qt::rect	(	ImgQ &	image,
		const utils::Rect &	r,
		int	rounding = `0`
	)

inline

draws a rect into an image

Parameters

image	destination image
r	rect to draw
rounding	rounded corners (in pixels)

◆ rgb()

ICLQt_API ImgQ icl::qt::rgb ( const ImgQ & image )

converts a given image to formatRGB

Parameters

image source image

◆ roi()

ICLQt_API ImgROI icl::qt::roi ( ImgQ & r )

creates a ROI-struct from an image

This function helps to copy images ROIs:

ImgQ a,b;

a = aaaaa (A = ROI pixel)
    aaAAA (a = no ROI pixel)
    aaAAA

b = bbb
    bbb

roi(a) = b;

a = aaaaa
    aabbb
    aabbb

also possible: roi(a) = roi(b);

Parameters

r	image to wrap

◆ save()

ICLQt_API void icl::qt::save	(	const core::ImgBase &	image,
		const std::string &	filename
	)

write an image to HD

Parameters

image	source image
filename	filename to write the image to.

◆ saveFileDialog()

ICLQt_API std::string icl::qt::saveFileDialog	(	const std::string &	filter = `""`,
		const std::string &	caption = `"save file"`,
		const std::string &	initialDirectory = `"_____last"`,
		void *	parentWidget = `0`
	)

uses Qt to spawn a save-file dialog with given filter

throws an exception if cancel was pressed. The function is thread-safe and can savely be called from a working thread

◆ scale() [1/2]

ICLQt_API ImgQ icl::qt::scale	(	const ImgQ &	image,
		float	factor
	)

scales an image by a given factor

Parameters

image	source image
factor	scale factor

◆ scale() [2/2]

ICLQt_API ImgQ icl::qt::scale	(	const ImgQ &	image,
		int	width,
		int	height
	)

scales an image to the given size

Parameters

image	source image
width	destination image width
height	destination image height

◆ show()

ICLQt_API void icl::qt::show ( const icl::core::ImgBase & image )

shows an image using TestImages::show

The image is wrote to disk into a temporary file. Then it is shown using a specifi show command, which can be set, using the the showSetup function, which is also available in this package.

Parameters

image image to show

See also: showSetput(const string&, const stirng&, int)

◆ showSetup()

ICLQt_API void icl::qt::showSetup	(	const string &	showCommand = `"xv %s"`,
		const string &	rmCommand = `"rm -rf %s"`,
		int	msecBeforeDelete = `500`
	)

setup image visualisation programm

when images are shown using an extrenal viewer like gnu's xv, the image is temporarily written to the hard disk. Then the show command is called. Before the rmCommand is called usleep(1000*msecBeforeDelete); is called, to ensure, that the viewer has read the image completely. By default, the "iclxv" image viewer is used, which is available as example of the ICLQt package. In this case, the showCommand is "iclxv -input %s -delete". As iclxv automatically deletes the image, when it was read, the rmCommand is empty and the wait time is 0. To use this, you have to place at least a link to ICLQt/examples/iclxv into any directory contained in your path variable.

See also: show; ICLIO/TestImages

◆ sqr()

ICLQt_API ImgQ icl::qt::sqr ( const ImgQ & image )

calls ( each pixel )²

Parameters

image source image

◆ sqrt()

ICLQt_API ImgQ icl::qt::sqrt ( const ImgQ & image )

calls sqrt( each pixel)

Parameters

image source image

◆ text() [1/2]

ICLQt_API void icl::qt::text	(	ImgQ &	image,
		int	x,
		int	y,
		const string &	text
	)

renders a text into an image (only available with Qt-Support)

This functin renders a text into a 3 or 1 channel image using the a QPainter internally.

Parameters

image	destination image
x	xpos of the lower left corner of the text
y	ypos of the lower left corner of the text
text	text to render

◆ text() [2/2]

void icl::qt::text	(	ImgQ &	image,
		const utils::Point &	p,
		const string &	sText
	)

inline

renders a text into an image (only available with Qt-Support)

This functin renders a text into an 3 or 1 channel image using the a QPainter internally.

Parameters

image	destination image
p	pos of the lower left corner of the text
sText	text to render

◆ textInputDialog()

std::string icl::qt::textInputDialog	(	const std::string &	caption = `"text ..."`,
		const std::string &	message = `"please write your text here"`,
		const std::string &	initialText = `""`,
		void *	parentWidget = `0`,
		core::ImgBase *	visImage = `0`,
		std::vector< std::string >	completionOptions = `std::vector< std::string >()`
	)

uses Qt to spawn a text input dialog

throws an exception if cancel was pressed. The function is thread-safe and can savely be called from a working thread. If the visImage pointer is not null, it will be visualized in the dialog

◆ thresh()

ICLQt_API ImgQ icl::qt::thresh	(	const ImgQ &	image,
		float	threshold
	)

performs an image binarisation for each channel with given threshold

Parameters

image	source image
threshold	threshold to compare each pixel with

◆ tic()

ICLQt_API void icl::qt::tic ( const std::string & label = "" )

starts a timer

◆ toc()

ICLQt_API void icl::qt::toc ( )

stops a timer started with tic()

◆ triangle() [1/2]

ICLQt_API void icl::qt::triangle	(	ImgQ &	image,
		int	x1,
		int	y1,
		int	x2,
		int	y2,
		int	x3,
		int	y3
	)

draws a triangle into an image

given 3 points (x1,y1),(x2,y2),(x3,y3)

◆ triangle() [2/2]

void icl::qt::triangle	(	ImgQ &	image,
		const utils::Point &	a,
		const utils::Point &	b,
		const utils::Point &	c
	)

inline

draws a triangle into an image

◆ zeros()

template<class T >

ImgQ icl::qt::zeros	(	int	width,
		int	height,
		int	channels = `1`
	)

inline

create an empty (black) ImgQ (affinity for floats)

Parameters

width	image width
height	image height
channels	image channel count

Classes

Typedefs

Enumerations

Functions

creator functions

converting function

filtering function

output functions

ImgQ arithmetical operators

ImgQ arithmetical functions

ImgQ logical operators

ImgQ concatenation operators

ImgQ roi copy

drawing functions

timer and benchmarking

Typedef Documentation

◆ ICLApp

◆ ImgQ

Enumeration Type Documentation

◆ ICLWidgetCaptureMode

◆ KeyboardModifier

◆ MouseButton

◆ MouseEventType

Function Documentation

◆ abs()

◆ binAND()

◆ binOR()

◆ binXOR()

◆ blur()

◆ cc()

◆ channel()

◆ circle()

◆ color()

◆ colorinfo()

◆ copy()

◆ copyroi()

◆ create()

◆ cross() [1/2]

◆ cross() [2/2]

◆ cvt() [1/3]

◆ cvt() [2/3]

◆ cvt() [3/3]

◆ cvt16s()

◆ cvt32f()

◆ cvt32s()

◆ cvt64f()

◆ cvt8u()

◆ data()

◆ execute_process()

◆ exp()

◆ fill()

◆ filter()

◆ flipx()

◆ flipy()

◆ font()

◆ fontsize()

◆ grab()

◆ gray()

◆ hls()

◆ lab()

◆ label()

◆ levels()

◆ line() [1/2]

◆ line() [2/2]

◆ linestrip()

◆ ln()

◆ load() [1/2]

◆ load() [2/2]

◆ norm()

◆ ones()

◆ openFileDialog()

◆ operator &&()

◆ operator *() [1/3]

◆ operator *() [2/3]

◆ operator *() [3/3]

◆ operator%()

◆ operator+() [1/3]

◆ operator+() [2/3]

◆ operator+() [3/3]

◆ operator,()