B4A Library RSImageProcessing Library

XverhelstX · Mar 23, 2012

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 · Jul 21, 2012

Or this...

B4X:

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

Informatix · Jul 21, 2012

awama said:
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 · Jul 21, 2012

replace

io.Initialize("io")

to

io.Initialize

awama · Jul 21, 2012

vb1992 said:
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 · Jul 21, 2012

vb1992 said:
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 · Jul 21, 2012

Have you checked the fixed updated version?

Tomas

Informatix · Jul 21, 2012

XverhelstX said:
Have you checked the fixed updated version?

Tomas

I did all tries with the fixed version.

vb1992 · Jul 21, 2012

I modified your project and it now
Works well

Especially with this order of effects:

Greyscale
Blur
Invert
Blend
Invert
SuperBlur
MultiBlend

Informatix · Jul 22, 2012

vb1992 said:
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 · Jul 22, 2012

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 · Jul 22, 2012

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 · Jul 22, 2012

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 · Sep 6, 2012

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.

B4X:

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 · Sep 6, 2012

Have you tried

LoadBitmapSample()

pixelpop · Sep 6, 2012

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 · Sep 7, 2012

then try CreateScaledBitmap

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

aloof · Nov 8, 2012

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 · Nov 13, 2012

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 · Nov 18, 2012

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

bluedude · Dec 9, 2012

Lomo effect

xverhelstx

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

Cheers,

B4A Library RSImageProcessing Library

Attachments

Well-Known Member

Expert

Well-Known Member

Active Member

Expert

Attachments

Well-Known Member

Expert

Well-Known Member

Attachments

Expert

Well-Known Member

Member

Well-Known Member

Active Member

Well-Known Member

Active Member

Well-Known Member

Member

Member

Active Member

Well-Known Member

Privacy & Transparency

Privacy & Transparency