B4A Library RSImageProcessing Library

Hello everybody,

I'm back again with a new library.
With this library you can do a lot of image processing and it is easy to use:

• 
  Properties:
  • All As
  Methods:
  • applyConfig (config As Double()())
  • computeConvolution3x3 (src As Bitmap, matrix As ConvolutionMatrix) As Bitmap
    This works fluently on my app.
    Sharpens my image.
    Works slower!
    Uses getpixel
    src:
    matrix:
    Return type: @return:
• RSImageBlend
  Methods:
  • AddBlend (source As Bitmap, layer As Bitmap) As Bitmap
    Blends 2 bitmaps to one and adds addition blend.
  • AverageBlend (source As Bitmap, layer As Bitmap) As Bitmap
    Blends 2 bitmaps to one and adds average blend.
  • Blend (bottomImage As Bitmap, topImage As Bitmap, left As Float, top As Float) As Bitmap
    Blends 2 bitmaps together with help of a canvas. - Blending
    Draws them both to a canvas and saves them as a bitmap.
  • ColorBurnBlend (source As Bitmap, layer As Bitmap) As Bitmap
    Blends 2 bitmaps to one and adds substraction blend.
  • ColorDodgeBlend (source As Bitmap, layer As Bitmap) As Bitmap
    Blends 2 bitmaps to one and adds the color dodge blend mode to it.
  • DarkenBlend (source As Bitmap, layer As Bitmap) As Bitmap
    Blends 2 bitmaps to one and adds darken blend.
  • DifferenceBlend (source As Bitmap, layer As Bitmap) As Bitmap
    Blends 2 bitmaps to one and adds substraction blend.
  • ExclusionBlend (source As Bitmap, layer As Bitmap) As Bitmap
    Blends 2 bitmaps to one and adds substraction blend.
  • GlowBlend (source As Bitmap, layer As Bitmap) As Bitmap
    Blends 2 bitmaps to one and adds substraction blend.
  • HardMixBlend (source As Bitmap, layer As Bitmap) As Bitmap
    Blends 2 bitmaps to one and adds substraction blend.
  • HardlightBlend (source As Bitmap, layer As Bitmap) As Bitmap
    Blends 2 bitmaps to one and adds substraction blend.
  • LightenBlend (source As Bitmap, layer As Bitmap) As Bitmap
    Blends 2 bitmaps to one and adds lighten blend.
  • LinearBurnBlend (source As Bitmap, layer As Bitmap) As Bitmap
    Blends 2 bitmaps to one and adds substraction blend.
  • LinearDodgeBlend (source As Bitmap, layer As Bitmap) As Bitmap
    Blends 2 bitmaps to one and adds addition blend.
  • LinearLightBlend (source As Bitmap, layer As Bitmap) As Bitmap
    Blends 2 bitmaps to one and adds substraction blend.
  • MultiplyBlend (source As Bitmap, layer As Bitmap) As Bitmap
    Blends 2 bitmaps to one and adds darken blend.
  • NegationBlend (source As Bitmap, layer As Bitmap) As Bitmap
    Blends 2 bitmaps to one and adds substraction blend.
  • OverlayBlend (source As Bitmap, layer As Bitmap) As Bitmap
    Blends 2 bitmaps to one and adds substraction blend.
  • PhoenixBlend (source As Bitmap, layer As Bitmap) As Bitmap
    Blends 2 bitmaps to one and adds substraction blend.
  • PinLightBlend (source As Bitmap, layer As Bitmap) As Bitmap
    Blends 2 bitmaps to one and adds substraction blend.
  • ReflectBlend (source As Bitmap, layer As Bitmap) As Bitmap
    Blends 2 bitmaps to one and adds substraction blend.
  • ScreenBlend (source As Bitmap, layer As Bitmap) As Bitmap
    Blends 2 bitmaps to one and adds substraction blend.
  • SoftlightBlend (source As Bitmap, layer As Bitmap) As Bitmap
    Blends 2 bitmaps to one and adds substraction blend.
  • SubstractBlend (source As Bitmap, layer As Bitmap) As Bitmap
    Blends 2 bitmaps to one and adds substraction blend.
  • VividLightBlend (source As Bitmap, layer As Bitmap) As Bitmap
    Blends 2 bitmaps to one and adds substraction blend.
• RSImageEffects
  Methods:
  • Blur (src As Bitmap, Factor As Int, Offset As Int) As Bitmap
    Does a Gaussian Blur to the image. - Filter
    It uses the concepts of Convolution Filtering to apply in image processing.
  • Brightness (src As Bitmap, value As Int) As Bitmap
    The concept of brightness is rather simple, increasing/decreasing value of each R, G, B channel together.
    + By increasing: image results brighter.
    + By decreasing: image results darker.
    
    Effects
  • ColorBoost (src As Bitmap, type As Int, percent As Float) As Bitmap
    Color boost technique is basically based on color filtering, which is to increase the
    intensity of a single color channel.
    
    Effect
  • Contrast (src As Bitmap, value As Double) As Bitmap
    Contrast is the difference in luminance and/or colour that makes an object (or its representation in an image or display) distinguishable.
    In visual perception of the real world, contrast is determined by the difference in the colour and
    brightness of the object and other objects within the same field of view.
    
    Effects
  • Emboss (src As Bitmap) As Bitmap
    Embosses your bitmap to make it look sketchy like.
    
    Filter
  • Engrave (src As Bitmap) As Bitmap
    Engraves your bitmap.
    
    Filter
  • Flip (src As Bitmap) As Bitmap
    Flips a bitmap vertically.
    
    Effect
  • GammaCorrection (src As Bitmap, red As Double, green As Double, blue As Double) As Bitmap
    Gamma correction or gamma encoding is one among the common image processing method
    Gamma correction, gamma nonlinearity, gamma encoding, or often simply gamma,
    is the name of a nonlinear operation used to code and decode luminance or tristimulus values in video or
    still image systems.
    
    Effect
  • GreyScale (src As Bitmap) As Bitmap
    Greyscales a bitmap
    The intensity is calculated by common formula: 30% of Red + 59% of Green + 11 % of Blue
    
    Effects
  • Highlight (src As Bitmap) As Bitmap
    Highlights a bitmap.
    
    Effects
  • Invert (src As Bitmap) As Bitmap
    Inverts a bitmap.
    Every image pixel holds information of four channels: Alpha, Red, Green, Blue.
    However, Alpha doesn�t reflect the image color as display. So the value is kept, and take inversion for other three
    channels by formula: 0xFF � CurrentValue.
  • Mirror (src As Bitmap) As Bitmap
    Flips a bitmap horizontally.
    
    Effect
  • Noise (source As Bitmap) As Bitmap
    Gives a noise or flea effect to the bitmap
    
    Effect
  • Paintify (src As Bitmap, bitOffset As Int, Factor As Int, Offset As Int) As Bitmap
    Makes a paint like effect on a picture.
    128 (or 64/32)
    8
    1
    
    Effect
  • Paintify2 (src As Bitmap, bitOffset As Int, Factor As Int, Offset As Int) As Bitmap
    Makes a paint like effect on a picture.
    128 (or 64/32)
    8
    1
    
    Effect
  • Posterize (src As Bitmap, bitOffset As Int) As Bitmap
    Decreasing color depth involves converting to standard values.
    For example: if I want to offset 32, then each image color channel will apply the range: 0, 31, 63 �
    
    Effects
  • Reflection (originalImage As Bitmap, ReflectionGap As Int) As Bitmap
    Makes a mirror/reflection like
    ReflectionGap: gap space between original and reflected
    
    Effect
  • ReplaceColor (src As Bitmap, fromColor As Int, targetColor As Int) As Bitmap
    Replaces pixels from one color to the other.
    
    Effect
  • Rotate (src As Bitmap, degree As Float) As Bitmap
    Rotates a bitmaps
    
    Effects
  • RoundCorner (src As Bitmap, round As Float) As Bitmap
    Create a bitmap with round corners.
    Effect
  • SepiaToning (src As Bitmap, depth As Int, red As Double, green As Double, blue As Double) As Bitmap
    Sepia-toning effect is used very commonly in photography.
    It is the process of changing the intensity on every pixel color of a gray-scale image, or so-called black-and-white.
    
    Effects
  • Sharpen (src As Bitmap, weight As Double) As Bitmap
    Sharpening effect make uses of Convolution Matrix
    The applied matrix is:
    [ 0 | -2 | 0 ]
    [ -2 | 11 | -2 ]
    [ 0 | -2 | 0 ]
    
    Filter
    Weight : 3
  • Sharpen2 (src As Bitmap, weight As Double) As Bitmap
    Sharpening effect make uses of Convolution Matrix
    The applied matrix is:
    [ 0 | -2 | 0 ]
    [ -2 | 11 | -2 ]
    [ 0 | -2 | 0 ]
    
    Filter
    Weight : 3
  • Sketchify (src As Bitmap, Factor As Int, Offset As Int) As Bitmap
    Sketchify a photo.
    src:
    Factor: 16
    Offset: 0
    Return type: @return:Effect
  • Smooth (src As Bitmap, value As Double) As Bitmap
    Smoothens a bitmap.
    The factor is 13 and offset 1.
    
    Filter
  • Snow (source As Bitmap) As Bitmap
    Adds a snow-like effect to the bitmap.
    Opposite of Black Filter
    Sets all pixels having R,G,B values to the max (0xFF) when they�re greater than threshold,
    then we have the Snow Effect.
    
    Effect
  • TintColor (src As Bitmap, degree As Int) As Bitmap
    Gives a nice tint color to a bitmap.
    degree: Use the constants for the degree.
    
    Effect
  • Watermark (src As Bitmap, watermark As String, x As Float, y As Float, color As Int, alpha As Int, size As Int, underline As Boolean) As Bitmap
    Gives your image a watermark, choose the location of the text, etc, etc
    Effect
• RSImageFilters
  Methods:
  • BlackFilter (source As Bitmap) As Bitmap
    Base on randomizing image pixels, another filter is created, named �Black Filter�, or enhance the noise of darkness.
    The algorithm is to generate a threshold number (0-255), if all R,G,B values of a pixel are less than the threshold,
    then set the pixel to black.
    
    Filter
  • ColorFilter (src As Bitmap, red As Double, green As Double, blue As Double) As Bitmap
    Filter the color on the bitmap, in which to display image by only one channel or
    combine the increase on every channel.
    
    Filter
  • EdgeEnhancement (src As Bitmap, Factor As Int, Offset As Int) As Bitmap
    Edge Enhancement
  • EdgeEnhancement2 (src As Bitmap, Factor As Int, Offset As Int) As Bitmap
    Edge Enhancement
  • EdgeEnhancement3 (src As Bitmap, Factor As Int, Offset As Int) As Bitmap
    Edge Enhancement
  • FindEdge (src As Bitmap, Factor As Int, Offset As Int) As Bitmap
    Find Edge
  • FindEdge2 (src As Bitmap, Factor As Int, Offset As Int) As Bitmap
    Find Edge
  • FindEdge3 (src As Bitmap, Factor As Int, Offset As Int) As Bitmap
    Find Edge
  • GaussianFilter (src As Bitmap, Factor As Int, Offset As Int) As Bitmap
    Gaussian filter.
  • GaussianFilter2 (src As Bitmap, Factor As Int, Offset As Int) As Bitmap
    Gaussian filter.
  • HueFilter (source As Bitmap, level As Int) As Bitmap
    Filters the Hue of a bitmap.
    By converting RGB to HSV, we can adjust pixel color in different way.
    
    Filter
  • MeanRemoval (src As Bitmap) As Bitmap
    Mean Removal Effect makes uses of Convolution Matrix.
    The applied matrix is:
    [ -1 | -1 | -1 ]
    [ -1 | 9 | -1 ]
    [ -1 | -1 | -1 ]
    
    Filter
  • SaturationFilter (source As Bitmap, level As Int) As Bitmap
    Filters the saturation of a bitmap.
    By converting RGB to HSV, we can adjust pixel color in different way.
    
    Filter
  • ShadingFilter (source As Bitmap, shadingColor As Int) As Bitmap
    Shading Filter is a technique that use AND operator for the current pixel color and a desired-shading color.
    
    Filter
  • Wedding (src As Bitmap, Factor As Int, Offset As Int) As Bitmap
    Wedding
    src:
    Factor: 16
    Offset: 0
    Return type: @return:Filter
• RSImageProcessing
  Methods:
  • Initialize
    Initializes the RSSImageProcessing Library.
    EventName - Events subs prefix.
  • compress (bitmap As Bitmap, format As String, quality As Int, stream As OutputStream)
    Write a compressed version of the bitmap to the specified outputstream.
    
    format The format of the compressed image
    quality Hint to the compressor, 0-100. 0 meaning compress for small size, 100 meaning compress for max quality. Some formats, like PNG which is lossless, will ignore the quality setting
    stream The outputstream to write the compressed data.
  • createScaledBitmap (src As Bitmap, dstWidth As Int, dstHeight As Int, filter As Boolean) As Bitmap
    Creates a new bitmap, scaled from an existing bitmap.
    src The source bitmap.
    dstWidth The new bitmap's desired width.
    dstHeight The new bitmap's desired height.
    filter true if the source should be filtered.
    Return type: @return:the bitmap
  • eraseColor (bitmap As Bitmap, c As Int)
    Fills the bitmap's pixels with the specified Color.
    bitmap: the source bitmap. (must be mutable!)
    c: colours
  • extractAlpha (bitmap As Bitmap) As Bitmap
    Returns a new bitmap that captures the alpha values of the original.
    bitmap:
  • extractBitmap (source As Bitmap, x As Int, y As Int, width As Int, height As Int) As Bitmap
    Returns an immutable bitmap from the specified subset of the source bitmap.
    The new bitmap may be the same object as source, or a copy may have been made.
    It is initialized with the same density as the original bitmap.
    source:
    x:
    y:
    width:
    height:
    Return type: @return:
  • extractBitmap2 (source As Bitmap, x As Int, y As Int, width As Int, height As Int) As Bitmap
    Returns an immutable bitmap from the specified subset of the source bitmap.
    The new bitmap may be the same object as source, or a copy may have been made.
    It is initialized with the same density as the original bitmap.
    source:
    x:
    y:
    width:
    height:
    Return type: @return:
  • getDestination (src As Bitmap, destination As Double) As Int
    Gets the new destination width or height keeping the aspect ratio of the image.
    src: - bitmap
    destination: -Source width or height
    Return type: @return:
  • getPixel (bitmap As Bitmap, x As Int, y As Int) As Int
    Returns the Color at the specified location.
    Throws an exception if x or y are out of bounds (negative or >= to the width or height respectively).
    bitmap:
    x: The x coordinate (0...width-1) of the pixel to return
    y: The y coordinate (0...height-1) of the pixel to return
    Return type: @return:The argb Color at the specified coordinate
  • hasAlpha (bitmap As Bitmap) As Boolean
    Returns true if the bitmap's config supports per-pixel alpha, and if the pixels may contain non-opaque alpha values.
    For some configs, this is always false (e.g. RGB_565), since they do not support per-pixel alpha.
    However, for configs that do, the bitmap may be flagged to be known that all of its pixels are opaque.
    In this case hasAlpha() will also return false. If a config such as ARGB_8888 is not so flagged, it will return true by default.
    bitmap:
    Return type: @return:
  • isMutable (bitmap As Bitmap) As Boolean
    Returns true if the bitmap is marked as mutable (i.e. can be drawn into)
    bitmap:
    Return type: @return:
  • isRecycled (bitmap As Bitmap) As Boolean
    Returns true if this bitmap has been recycled. If so, then it is an error to try to access its pixels, and the bitmap will not draw.
    bitmap:
    Return type: @return:true if the bitmap has been recycled
  • recycle (bitmap As Bitmap)
    Free the native object associated with this bitmap, and clear the reference to the pixel data.
    This will not free the pixel data synchronously; it simply allows it to be garbage collected if
    there are no other references. The bitmap is marked as "dead", meaning it will throw an exception if
    getPixels() or setPixels() is called, and will draw nothing. This operation cannot be reversed,
    so it should only be called if you are sure there are no further uses for the bitmap.
    This is an advanced call, and normally need not be called, since the normal GC process will free
    up this memory when there are no more references to this bitmap.
    bitmap:
  • rotate (src As Bitmap, degree As Float) As Bitmap
  • rotateBitmap (bitmap As Bitmap, degrees As Float) As Bitmap
    Rotates the bitmap.
    bitmap:
    degrees:
    Return type: @return:
  • scaleBitmap (bitmap As Bitmap, sx As Float, sy As Float) As Bitmap
    Scales the bitmap.
    bitmap:
    degrees:
    Return type: @return:
  • setHorizontalScrollBarEnabled (hsv As HorizontalScrollView, enabled As Boolean)
  • skewBitmap (bitmap As Bitmap, kx As Float, ky As Float) As Bitmap
    Skews the bitmap.
    bitmap:
    kx:
    ky:
    Return type: @return:
  • translateBitmap (bitmap As Bitmap, dx As Float, dy As Float) As Bitmap
    Translate the bitmap.
    bitmap:
    degrees:
    Return type: @return:
  • writeBitmapToFile (src As Bitmap, dir As String, fileName As String, quality As Int)
    Writes a bitmap to a file

And tons of other features!

Have fun,
Tomas

 

[vb1992]

Or this...

bitmap2= ii.Brightness(bitmap2,21)
bitmap2= ii.Contrast(bitmap2,21)
   bitmap2 =ii.Sketchify(bitmap2,16,0)

 

[Informatix]

Hi,

on my Galaxy S2 , ICS 4.0.3 I got following error with the new library while compiling:

Compiling code. Error
Error compiling program.
Error description: Object reference not set to an instance of an object.
Occurred on line: 20
IO.Initialize("IO")
Word: (
r

+1 with a Huawei Honor A 2.3.6, B4A v2.02

 

[vb1992]

replace

io.Initialize("io")

to

io.Initialize

 

[awama]

replace

io.Initialize("io")

to

io.Initialize

Yes, that was it.

And with the fixed library other errors also are away.
You saved my weekend. Many thanks.
Walter

 

[Informatix]

replace

io.Initialize("io")

to

io.Initialize

In fact, almost everything is broken. I fixed all bugs. Here is a working demo (the blur effect doesn't do what I expect - blurring - so maybe there's something more to do).

EDIT: I did a few tests with other images and the blur effect did its job well. I'm old and my eyes need bigger images. ;-)

 

[XverhelstX]

Have you checked the fixed updated version?

Tomas

 

[Informatix]

Have you checked the fixed updated version?

Tomas

I did all tries with the fixed version.

 

[vb1992]

I modified your project and it now
Works well

Especially with this order of effects:

1. Greyscale
2. Blur
3. Invert
4. Blend
5. Invert
6. SuperBlur
7. MultiBlend

 

[Informatix]

I modified your project and it now
Works well

My example worked very well, but thanks anyway.

Is this lib considered as a fast one ? Does it exist faster libraries ?

 

[XverhelstX]

This imageprocessing library is considered slower than other techniques. The author of the java codes suggested to use opencv.

Tomas

Sent from my SE Xperia Play using Tapatalk.

 

[danoptic]

I m getting an error when compiling yhe project sample

Compiling code. Error
Error compiling program.
Error description: Unknown member: colordodgeblend
Occurred on line: 57
btmpBlend = IO.ColorDodgeBlend(btmpBlur, btmpGrayScale)
Word: colordodgeblend

M i missing a library?

 

[XverhelstX]

redownload the fixed library.
The images, effects, filters are all seperated in new classes

you should declare a new instance as RSImageFilters or something.

Tomas

 

[pixelpop]

I have an ImageView that is 320w X 200H. I need to load images into this ImageView while maintaining their aspect ratio. The images are always larger than the ImageView. This is my code, but I am getting an error on the emulator that bitmap size exceeds 32bits.

Dim scaleBitmap as Bitmap
Dim rs As RSImageProcessing

imgHeight = lgpic_array(0).Height
imgWidth = lgpic_array(0).Width
rs.Initialize

If imgHeight > imgWidth Then
   imgScaleWidth = rs.getDestination(lgpic_array(0),200)
   scaleBitmap = rs.scaleBitmap(lgpic_array(0), imgScaleWidth, 200)
Else
   imgScaleHeight = rs.getDestination(lgpic_array(0),320)
   scaleBitmap = rs.scaleBitmap(lgpic_array(0), 320, imgScaleHeight)
End If
   
   
imvImage.Initialize("imvImage")
imvImage.Gravity = Gravity.CENTER
imvImage.Bitmap = scaleBitmap

What am I doing wrong here? Also, there is a lot of overhead in this library to just scale a bitmap. Is there a more efficient method I should use instead? Thanks.

 

[vb1992]

Have you tried

LoadBitmapSample()

 

[pixelpop]

It appears that LoadBitmapSample requires a bitmap that is a file on the device. Note that in my case, the bitmap is strictly in memory. The bitmap is downloaded from a web site and assigned to a bitmap array location:

lgpic_array(0) = Job.GetBitmap

I'd rather not have to write this to storage and then read it back with LoadBitmapSample if I can avoid it.

 

[vb1992]

then try CreateScaledBitmap

http://www.b4x.com/forum/bugs-wishlist/11601-wish-implement-createscaledbitmap.html#post64776

 

[aloof]

how would i show a preview of a effect? in imageview

would i...
save the effect to file an then load it in imageview then delete it if not saved?

thanx

 

[holographl]

Some questions about your library

First thanks for the library it is very helpful.

I have a couple of things I need to figure out maybe you can help.

First how do I set the threshold for the BlackFilter? I would like the user to have a slide or something to adjust it.

Second: Is there a way to crop a polygon from a bitmap and save that as a new image? I know I can do it with a rectangle but cant seem to see how to do it with a polygon.

thanks for you help.

 

[TheJinJ]

Good implementation of the library!
Do you plan on adding all the filters included etc that haven't been done so far?

 

[bluedude]

Lomo effect

xverhelstx

Do you know if a combination of these effects could create a Lomo effect which is very popular currently.

Cheers,