In-place Filters

Detailed Description

The functions in this section allow for in-place operations where input and output data buffers can be the same.
Note: This list is currently incomplete.

Functions
OC_STATUS	ocularGammaFilter (unsigned char *Input, unsigned char *Output, int Width, int Height, int Stride, float gamma[])
	Adjusts the gamma of an image.
OC_STATUS	ocularContrastFilter (unsigned char *Input, unsigned char *Output, int Width, int Height, int Stride, float contrast)
	Adjusts the contrast of the image.
OC_STATUS	ocularBrightnessFilter (unsigned char *Input, unsigned char *Output, int Width, int Height, int Stride, int brightness)
	Adjusts the brightness of the image.

Function Documentation

ocularGammaFilter()

OC_STATUS ocularGammaFilter	(	unsigned char *	Input,
		unsigned char *	Output,
		int	Width,
		int	Height,
		int	Stride,
		float	gamma[] )

Adjusts the gamma of an image.

Parameters

Input	The image input data buffer.
Output	The image output data buffer.
Width	The width of the image in pixels.
Height	The height of the image in pixels.
Stride	The number of bytes in one row of pixels.
gamma	The gamma adjustment to apply to each channel. Range [> 0 to ~4 or 5]. Supports 1 or 3 channels.

Returns

OC_STATUS_OK if successful, otherwise an error code (see core.h)

ocularContrastFilter()

OC_STATUS ocularContrastFilter	(	unsigned char *	Input,
		unsigned char *	Output,
		int	Width,
		int	Height,
		int	Stride,
		float	contrast )

Adjusts the contrast of the image.

Parameters

Input	The image input data buffer.
Output	The image output data buffer.
Width	The width of the image in pixels.
Height	The height of the image in pixels.
Stride	The number of bytes in one row of pixels.
contrast	The adjusted contrast. Range [0.0 - 4.0]. Default 1.0.

Returns

OC_STATUS_OK if successful, otherwise an error code (see core.h)

ocularBrightnessFilter()

OC_STATUS ocularBrightnessFilter	(	unsigned char *	Input,
		unsigned char *	Output,
		int	Width,
		int	Height,
		int	Stride,
		int	brightness )

Adjusts the brightness of the image.

Parameters

Input	The image input data buffer.
Output	The image output data buffer.
Width	The width of the image in pixels.
Height	The height of the image in pixels.
Stride	The number of bytes in one row of pixels.
brightness	The adjusted brightness. Range [-1.0 - 1.0]. Default 0.0.

Returns

OC_STATUS_OK if successful, otherwise an error code (see core.h)