Picture.ScaleMBS(width as integer, height as integer, AntiAlias as boolean=false, YieldTicks as integer=0) as picture
method, Graphics & Pictures, MBS Picture Plugin (PictureScale), class Picture, Plugin version: 5.1, Mac OS X: Works, Windows: Works, Linux x86: Works, Feedback.

Function: Scales the picture to the new size.
Notes:
This is a self made algorithm which produces nice pictures on all platforms.
It is slower than QuickDraw on Mac OS, but nicer than drawpicture on Windows.
Returns nil on low memory or invalid width and height values.

AntiAlias is set to false if width<=self.width or height<=self.height.

If YieldTicks is 0, no time is given to other threads in your application. If it is a value > 0, this time is waited before a thread switch is done. Setting it to 1 will give away control to another thread after 1/60th of a second. We recommend a value of 3 to 5 for a good reponsibility of your application.

Some examples which use this method:

• /Leopard/CGWindow capture
• /MacOSX/CGWindow capture
• /MacOSX/FakeMenuBar/FakeMenuBar
• /DynaPDF/PDF with picture
• /DynaPDF/PDF with picture direct
• /Picture/Picture Scale/Picture.ScaleMBS
• /Picture/Picture Scale/Scale Compare
• /Picture/Picture Scale/Scale Test

Picture.ScalingMBS(mode as integer, width as integer, height as integer) as picture
method, Graphics & Pictures, MBS Picture Plugin (PictureScaling), class Picture, Plugin version: 8.0, Mac OS X: Works, Windows: Works, Linux x86: Works, Feedback.

Function: Scales the picture to the given size.
Notes:
On low memory this function can return nil or the image may look bad. (e.g. all black)

The memory used for the temporary storage is original height * new width * 12 bytes plus some extra.

For scaling with the same size as the picture already has, the scaling is still performed.

Returns nil ony error. (e.g. destwidth=0)

Modes:

1	triangle
2	box, nereast neighbor
3	lanczos 3
4	lanczos 8
5	mitchell
6	poly 3
7	cubic

dim p as Picture

p=bild2.BitmapMBS // any bitmap image

if p.ScrollHorizontalMBS(100,true,false) then
  Title="ok"
end if

Backdrop=p

dim p as Picture

p=bild2.BitmapMBS // any bitmap image

if p.ScrollVerticalMBS(100,true,false) then
  Title="ok"
end if

Backdrop=p

TintPictureMBS(source as picture, GreyBase as color, SepiaBase as color) as picture
global method, Graphics & Pictures, MBS Picture Plugin (Picture), Plugin version: 4.3, Mac OS X: Works, Windows: Works, Linux x86: Works, Feedback.

Function: Tints the image.
Example:

// The code does the same thing as this Realbasic code:

Sub TintPicture(theImg as Picture, pGreyBase as Color, pSepiaBase as Color)
  Dim theRGBSurface as RGBSurface
  Dim theWidth, theHeight as Integer
  Dim pColor as Color
  Dim x, y as Integer
  Dim theGrey as Integer
  
  dim SepiaBaseR as Double
  dim SepiaBaseG as Double
  dim SepiaBaseB as Double
  
  dim GreyBaseR as Double
  dim GreyBaseG as Double
  dim GreyBaseB as Double
  
  SepiaBaseR=pSepiaBase.Red / 255.0
  SepiaBaseG=pSepiaBase.Green / 255.0
  SepiaBaseB=pSepiaBase.Blue / 255.0
  
  GreyBaseR=pGreyBase.Red / 255.0
  GreyBaseG=pGreyBase.Green / 255.0
  GreyBaseB=pGreyBase.Blue / 255.0
  
  theRGBSurface = theImg.RGBSurface
  
  theWidth = theImg.Width-1
  theHeight = theImg.Height-1
  
  For x = 0 to theWidth
    For y = 0 to theHeight
      pColor = theImg.RGBSurface.Pixel( x, y )
      
      theGrey = ( GreyBaseR * pColor.Red ) + ( GreyBaseG * pColor.Green ) + ( GreyBaseB * pColor.Blue )
      theImg.RGBSurface.Pixel( x, y ) = RGB( theGrey * SepiaBaseR, theGrey * SepiaBaseG, theGrey * SepiaBaseB )
      
    Next
  Next
End Sub

Notes:
You can use the code to do something like a Sepia effect.
Returns a new picture on success.

Some examples using this method:

• /Picture/Image effects/ColourTinter

Picture.TransformColorsMBS(red as memoryblock, blue as memoryblock, green as memoryblock) as picture
method, Graphics & Pictures, MBS Picture Plugin (Picture), class Picture, Plugin version: 4.3, Mac OS X: Works, Windows: Works, Linux x86: Works, Feedback.

Function: Applies a transform table to the pixels.
Notes:
Red, blue and green are 256 byte big memoryblocks with one byte for each value.

In RB the function does this:
color=rgb(red.byte[color.red], green.byte[color.green], blue.byte[color.blue])

Picture.TrimMBS(left as integer, top as integer, width as integer, height as integer) as picture
method, Graphics & Pictures, MBS Picture Plugin (PictureTrim), class Picture, Plugin version: 8.0, Mac OS X: Works, Windows: Works, Linux x86: Works, Feedback.

Function: Trims the picture to the given rectangle.
Example:

dim p as picture

p=someimage.TrimMBS(100,200,300,400)

Notes:
This method does not handle the mask.
So p.Trim(0,0,p.width,p.height) will give you a copy of the image pixels without mask.
left and top are zero based.

Use TrimWithMaskMBS if you need the mask to be trimmed.
Returns nil on low memory or bad parameters.

Some examples which use this method:

• /MacOSX/FakeMenuBar/FakeMenuBar

Picture.TrimWithMaskMBS(left as integer, top as integer, width as integer, height as integer) as picture
method, Graphics & Pictures, MBS Picture Plugin (PictureTrim), class Picture, Plugin version: 8.0, Mac OS X: Works, Windows: Works, Linux x86: Works, Feedback.

Function: Trims the picture to the given rectangle.
Example:

dim p as picture

p=someimage.TrimWithMaskMBS(100,200,300,400)

Notes:
left and top are zero based.
Returns nil on low memory or bad parameters.

Picture.VMirrorMBS as picture
method, Graphics & Pictures, MBS Picture Plugin (PictureRotate), class Picture, Mac OS X: Works, Windows: Works, Linux x86: Works, Feedback.

Function: Mirrors the picture vertically.
Example:

canvas1.backdrop=pic.VMirrorMBS

Notes:
This method returns a copy of the picture mirrored.
Returns nil on low memory.

Some examples which use this method:

• /Picture/Picture Mirror
• /Picture/Rotate picture/Rotation

Picture.VMirrorPictureMBS as boolean
method, Graphics & Pictures, MBS Picture Plugin (PictureRotate), class Picture, Plugin version: 7.8, Mac OS X: Works, Windows: Works, Linux x86: Works, Feedback.

Function: Mirrors the picture vertically.
Example:

if pic.VMirrorPictureMBS then // mirror picture
  canvas1.backdrop=pic
else
  canvas1.backdrop=pic.VMirrorMBS // mirror a copy
end if

Notes: This methods mirrors the picture data itself. Returns true on success and false on failure. Only bitmap pictures can be mirrored this way.

Some examples which use this method:

• /Picture/Picture Mirror