Method Description

GraphicImage.toBinary()

Write an image out to an instance of a the Binary class.

Syntax

GraphicImage = GraphicImage.toBinary(targetObject, format, quality)

Parameters

The 'GraphicImage.toBinary' method takes 3 parameters:

Results

The 'GraphicImage.toBinary' method returns GraphicImage:

Remarks

This method performs exactly the same transformation as GraphicImage.write, and then writes the result to the binary object rather than to the client browser.

Use this method when you want to do subsequent processing of an image, or where the image is to be saved in the database or to the file system.

The mime-type should be one of the following external formats :

• image/jpeg
  A JPEG format image.
• image/gif
  A palette based 256 colour GIF image.
• image/png
  A PNG format image.

Example

  // Load an image then create a smaller thumbnail to send to the browser
  var src= new GraphicImage
  src.make('/images/myBigImage.jpg','image/jpeg');

  // Create a smaller thumbnail
  var thumb = (new GraphicImage).create(100,100);

  // Copy the whole of the rectangle into a target size of 100x100.
  thumb.copyRect(srcImage,null,{z:0, y:0, w:100, h:100});

  // Save the resulting thumbnail into a Binary object and then to 
  // the file system.
  var thumbBinary = new Binary;
  var thumbFile = new Binary;

  thumb.toBinary(thumbBinary,'image/jpeg');
  thumbFile.open('/mythumb.jpg','wb');
  thumbFile.write(thumbBinary);
  thumbFile.close();