'+---------------+---------------------------------------------------+
'| ###### ###### |     .--. .         .-.                            |
'| ##  ## ##   # |     |   )|        (   ) o                         |
'| ##  ##  ##    |     |--' |--. .-.  `-.  .  .-...--.--. .-.        |
'| ######   ##   |     |  \ |  |(   )(   ) | (   ||  |  |(   )       |
'| ##      ##    |     '   `'  `-`-'  `-'-' `-`-`|'  '  `-`-'`-      |
'| ##     ##   # |                            ._.'                   |
'| ##     ###### | Sources & Documents placed under the MIT License. |
'+---------------+---------------------------------------------------+
'|                                                                   |
'| === ImageSupport.bm ===                                           |
'|                                                                   |
'| == This include file is part of the GuiTools Framework Project.   |
'| == It provides some useful SUBs/FUNCTIONS for image processing.   |
'| == Note that it supports true color (32-bit ARGB) images only.    |
'|                                                                   |
'+-------------------------------------------------------------------+
'| Done by RhoSigma, R.Heyder, provided AS IS, use at your own risk. |
'| Find me in the QB64 Forum or mail to support@rhosigma-cw.net for  |
'| any questions or suggestions. Thanx for your interest in my work. |
'+-------------------------------------------------------------------+

Image processing library

This small and easy to use library is providing various effects and filters. All functions support processing area selection by coordinates or by using a mask image.

Note that this library supports true color (32-bit ARGB) images only, so you've to _PUTIMAGE onto a 32-bit surface prior using these functions, if your images doesn't meet this requirement by default.

Table of Contents

GENERAL

• Common Info
  • informations about common inputs and results

IMAGE QUALITY

• ModifyBrightness
  • change the general brightness of the given image
• ModifyContrast
  • change the contrast of the given image
• ModifyGamma
  • change the graylevel brightness (gamma) of the given image

SIMPLE EFFECTS

• MakeGrayscale
  • make the given image into a B&W photograph (strip color information)
• MakeAntiqueTint
  • make the given image looking like an old yellowed photograph
• MakeNegative
  • make the given image into a photograph negative (inverts all colors)

CHANNEL ALTERATION

• ShiftARGB
  • swap (re-order) the component channels of the given image
• LimitARGB
  • crop each component's intensity of the given image into a defined range
• AddConstant
  • add a constant (component wise) to each pixel of the given image
• SubConstant
  • sub a constant (component wise) from each pixel of the given image
• ExtractChannels
  • extract the specified component channels from the given image

ADVANCED FILTERING

• ExtractBitfields
  • extract the specified bitplanes (component wise) from the given image
• ApplyFilter
  • apply the specified filter to the given image (convolution)