SOD C/C++ API Reference - Image Processing


Syntax

sod_img sod_equalize_histogram(sod_img input);

Description

Equalize the image histogram. This works only on grayscale images. If you want to convert the colorspace of your input picture to the gray color model, call sod_grayscale_image(), sod_grayscale_image_3c() before or simply load your image from disk using the macro sod_img_load_grayscale(). A typical input image after histogram equalization should look like the following:

Input Picture

Nature before processing

After Processing via sod_equalize_histogram()

Nature after processing

Parameters

sod_img    input

The input image to be processed which must be in the grayscale colorspace. The image can be loaded from disk using sod_img_load_from_file(), from memory (i.e. network socket) via sod_img_load_from_mem() or dynamically created via sod_make_image().

Return Value

Processed image is returned in an instance of the sod_img object. if something goes wrong during processing, then an empty image is returned via sod_make_empty_image(). Once done, you must release the memory allocated to this object via sod_free_image() to avoid memory leaks.

Example

Checkout the introduction course, the C/C++ samples on the download page or refer to the SOD Github Repository.

See also

sod_canny_edge_imagesod_hilditch_thinsod_image_find_blobssod_hough_lines_detectsod_crop_imagesod_composite_image.



Back