PictureMBS.ScaleFast(source as PictureMBS, width as Integer, height as Integer) as boolean

The final image is stored in the PictureMBS object you call this method on.
Returns true on success and false on failure.

This is a low quality algorithm, but it is fast.

This function is optimized for several image formats:
- Gray to Gray.
- RGB to Gray uses R*0.3+G*0.59+B*0.11.
- RGB to RGB.
- Gray to RGB fill red, green and blue with the same gray value.
If an alpha channel exists in both images, it is copied.

Some examples using this method:

• /Images/LargePicture/PictureMBS scale

PictureMBS.ScaleMT(threads as Integer, source as PictureMBS, temp as PictureMBS, mode as Integer, width as Integer, height as Integer) as boolean

Same as Scale, but with additional multithreading.

Threads parameter specifies how many threads you want to use:
A negative value disables threading, zero will use one thread for each CPU core and a positive number specifies the thread count.

If one of the pictures used has IsMapping = true, the plugin calls Scale() function.

The work is performed on a preemptive thread, so this function does not block the application and can yield time to other Xojo threads. Must be called in a Xojo thread to enjoy benefits. If called in main thread will block, but keep other background threads running.
If you run several threads calling MT methods, you can get all CPU cores busy while main thread shows GUI with progress window.

Some examples using this method:

• /Images/LargePicture/Multithreaded Scale

PictureMBS.SolarizeFilter(dest as PictureMBS) as PictureMBS

// get some picture
Var l as Picture = LogoMBS(500)
// create new image
Var p as new PictureMBS(l)
// add filter
p = p.SolarizeFilter(nil)
// show in window
window1.Backdrop = p.CopyPicture

if dest is nil, the picture factory is used to create a new picture.
On success dest or the new picture is returned.
If dest is not nil, it must match the size of the original picture.

Returns nil on any error.
Works with Gray, RGB and CMYK pictures and supports alpha channel.

Some examples using this method:

• /Images/LargePicture/PictureMBS filters

PictureMBS.StampFilter(dest as PictureMBS, radius as Double, threshold as Double, softness as Double, Black as Color, White as Color) as PictureMBS

if dest is nil, the picture factory is used to create a new picture.
On success dest or the new picture is returned.
If dest is not nil, it must match the size of the original picture.

Returns nil on any error.
Works with Gray and RGB pictures and supports alpha channel.

Some examples using this method:

• /Images/LargePicture/PictureMBS filters

PictureMBS.TransferFilter(dest as PictureMBS, gray() as Integer) as PictureMBS

Var l as Picture = LogoMBS(500)
Var p as new PictureMBS(l)

Var gray(256) as Integer

for i as Integer = 0 to 255
  gray(i)=255-i // invert
next

// inverts the picture
Var d as PictureMBS = p.TransferFilter(nil,gray)

Backdrop = d.CopyPicture

if dest is nil, the picture factory is used to create a new picture.
On success dest or the new picture is returned.
If dest is not nil, it must match the size of the original picture.

The array for gray must have 256 entries starting with index 0.
For RGB pictures the gray array is used for all three channels.

Returns nil on any error.

See also:

• TransferFilter(dest as PictureMBS, gray() as Integer, alpha() as Integer) as PictureMBS
• TransferFilter(dest as PictureMBS, red() as Integer, green() as Integer, blue() as Integer) as PictureMBS
• TransferFilter(dest as PictureMBS, red() as Integer, green() as Integer, blue() as Integer, alpha() as Integer) as PictureMBS

Some examples using this method:

• /Images/LargePicture/PictureMBS filters

PictureMBS.TransferFilter(dest as PictureMBS, gray() as Integer, alpha() as Integer) as PictureMBS

if dest is nil, the picture factory is used to create a new picture.
On success dest or the new picture is returned.
If dest is not nil, it must match the size of the original picture.

The arrays for gray and alpha must have 256 entries starting with index 0.
For RGB pictures the gray array is used for all three channels.
If the picture has no alpha channel, the alpha parameter is ignored.

Returns nil on any error.

See also:

• TransferFilter(dest as PictureMBS, gray() as Integer) as PictureMBS
• TransferFilter(dest as PictureMBS, red() as Integer, green() as Integer, blue() as Integer) as PictureMBS
• TransferFilter(dest as PictureMBS, red() as Integer, green() as Integer, blue() as Integer, alpha() as Integer) as PictureMBS

PictureMBS.TransferFilter(dest as PictureMBS, red() as Integer, green() as Integer, blue() as Integer) as PictureMBS

Var l as Picture = LogoMBS(500)
Var p as new PictureMBS(l)

Var red(256) as Integer
Var green(256) as Integer
Var blue(256) as Integer

for i as Integer = 0 to 255
  red(i)=i
  green(i)=i
  blue(i)=255-i // invert blue
next

Var d as PictureMBS = p.TransferFilter(nil,red,green,blue)

Backdrop = d.CopyPicture

if dest is nil, the picture factory is used to create a new picture.
On success dest or the new picture is returned.
If dest is not nil, it must match the size of the original picture.

The arrays for red, green and blue must have 256 entries starting with index 0.
For grayscale pictures the green array is used for the gray channel.

Returns nil on any error.

See also:

• TransferFilter(dest as PictureMBS, gray() as Integer) as PictureMBS
• TransferFilter(dest as PictureMBS, gray() as Integer, alpha() as Integer) as PictureMBS
• TransferFilter(dest as PictureMBS, red() as Integer, green() as Integer, blue() as Integer, alpha() as Integer) as PictureMBS

PictureMBS.TransferFilter(dest as PictureMBS, red() as Integer, green() as Integer, blue() as Integer, alpha() as Integer) as PictureMBS

if dest is nil, the picture factory is used to create a new picture.
On success dest or the new picture is returned.
If dest is not nil, it must match the size of the original picture.

The arrays for red, green, blue and alpha must have 256 entries starting with index 0.
For grayscale pictures the green array is used for the gray channel.
If the picture has no alpha channel, the alpha parameter is ignored.

Returns nil on any error.

See also:

• TransferFilter(dest as PictureMBS, gray() as Integer) as PictureMBS
• TransferFilter(dest as PictureMBS, gray() as Integer, alpha() as Integer) as PictureMBS
• TransferFilter(dest as PictureMBS, red() as Integer, green() as Integer, blue() as Integer) as PictureMBS

PictureMBS.Unmultiply

Pictures with alpha channel must be multiplied, while pictures with mask have the alpha unmultiplied and inverse in the mask.

See also:

• Unmultiply(x as integer, y as integer, width as integer, height as integer)

Some examples using this method:

• /Images/LargePicture/Picture Multiply

PictureMBS.Unmultiply(x as integer, y as integer, width as integer, height as integer)

Pictures with alpha channel must be multiplied, while pictures with mask have the alpha unmultiplied and inverse in the mask.

See also:

• Unmultiply

PictureMBS.UnsharpFilter(origpixels as PictureMBS, Amount as Double, Threshold as Integer) as boolean

You may want to run the BoxBlur filter first before using the unsharp filter.

if dest is nil, the picture factory is used to create a new picture.
On success dest or the new picture is returned.
If dest is not nil, it must match the size of the original picture.

Returns nil on any error.

Works with Gray, RGB and CMYK pictures and supports alpha channel.

PictureMBS.VMirror

// get some picture
Var l as Picture = LogoMBS(500)
// create new image
Var p as new PictureMBS(l)
// mirror
p.VMirror
// show in window
window1.Backdrop = p.CopyPicture

Works with Gray, RGB and CMYK pictures and supports alpha channel.

Some examples using this method:

• /Images/LargePicture/PictureMBS mirror and rotate
• /Images/LargePicture/Tiff Load and Save

PictureMBS.YellowChannel as PictureMBS

Returns nil if this channel does not exist.
No copy is made of the actual pixel data. Modifying the channel picture will modify the original picture.
Use this function to access the pixels of the channel directly.
The resulting PictureMBS object is a grayscale picture.