An image processing library implemented in pure-C

Ocular is a library for common and advanced image processing algorithms, without the use of any external dependencies. Suggestions for new features are welcome.

Note: RGBA byte-order is expected for all pixel data.

The documentation of the exported functions along with examples can be found at Library Documentation.

• Average Luminance Threshold
• Brightness/Contrast
• Exposure
• Equalize
• Gamma
• Histogram Stretch (contrast stretching)
• Levels
• Luminance Threshold (like Photoshop Threshold)

• Color Balance
• Color Invert
• Color Temperature
• Color Matrix
• Channel Mixer
• Curves
• False Color (mix between two colors using luminance)
• Grayscale (desaturate)
• Highlight/Shadow/Tint
• Hue
• HSL
• Levels
• Monochrome
• RGB
• Saturation
• Sepia
• Skin Tone
• Split Toning
• Vibrance
• White Balance

• Haze (add/remove)
• Haze Removal (Dark Channel Prior)
• Retinex (Multi-Scale with Color Restoration)
• Backlight Repair (corrects extremely low or non-uniform lighting)
• Highlight/Shadow

• Lookup (Remap Colors/LUT)
• Chroma Key (Color Key / Remove Specific Color)
• Posterize
• Palettize
  • from file (remaps colors to closest color in palette file with optional dithering)
  • from image (reduces unique colors using color quantization with optional dithering)

• Opacity
• Image Blending (supports 27 Photoshop modes)

• Auto Contrast
• Auto Gamma Correction
• Auto Level
• Auto White Balance
• Auto Threshold

• Average (Mean) Blur
• BEEPS (Bi-exponential Edge-preserving Smoothing)
• Bilateral (selectively blurs preserving edges and other details)
• Box Blur
• Exponential Blur
• Gaussian Blur
• Guided Filter
• Median Blur
• Motion Blur
• Radial Blur
• Surface Blur
• Skin Smoothing
• Zoom Blur

• Erode/Dilate
• High Pass
• Min/Max
• Skeletonize (thinning)

• Sharpen
• Unsharp Mask

• Canny Edge
• Gradient Edge
• Laplacian Edge (Laplacian of Gaussian)
• Prewitt Edge
• Roberts Edge
• Sobel Edge

• Colored Pencil
• Cutout
• Dry Brush
• Extrude
• Fresco
• Frosted Glass
• Film Grain
• Glass Tiles
• Kuwahara
• Marble
• Oil Paint
• Paint Daubs
• Palette Knife
• Plastic Wrap
• Portrait Glow
• Poster Edges
• Relief (Emboss)
• Rough Pastels
• Sponge
• Underpainting
• Watercolor
• Wind

• Color Halftone
• Crystallize
• Fragment
• Mosaic
• Pointillize

• Kaleidoscope
• Pinch
• Polar Coordinates
• Ripple
• Spherize
• Twirl
• Wave

• Clouds

• Despeckle (Salt & Pepper Noise Removal)
• Deskewing
• Skeletonize (thinning)

• 2D Convolution
• Resampling (resize) [Nearest-neighbor, bilinear, bicubic and lanzcos]
• Image Blending (supports 27 Photoshop modes)
• FFT (Fast Fourier Transform) [Low-pass, high-pass, band-pass, band-stop, custom]
• FFT Visualization (outputs frequency domain)

• Retrieve average image luminosity
• Retrieve average color
• Retrieve image size
• Crop
• Flip (Vertical/Horizontal)
• Rotate image (bilinear and bicubic)
• Hough transform line detection

• Median Cut, Octree

• Ordered Bayer (4x4 and 8x8), Atkinson, Burkes, Sierra, Sierra Two-Row, Sierra Lite, Stucki, Jarvis-Judice-Ninke, Single Neighbor, Floyd-Steinberg

Note: These are primarly used for included filters and added on as needed basis.

• RGB <--> YIQ
• RGB <--> HSL
• RGB <--> HSV
• RGB <--> YCbCr
• RGB <--> CMYK
• RGB <--> CIELab

NOTE: *RGB only.

Procreate swatches are stored as a ZIP archive and requires the included miniz library.

Affinity .afpalette format notes: afpalette-format.md.

To compile the library, simply do the following:

cmake .
make

This will out the following 4 files:

• static library lib\libocular.xxx
• dynamic link library bin\ocular.dll
• cli image demo bin\demo.exe
• cli palette demo bin\palette.exe

Ocular is under the MIT license.

See the LICENSE file for details.