copyImage

copyImage(left:   Integer;
          top:    Integer;
          width:  Integer;
          height: Integer): Binary;

The copyImage method of the Binary primitive type returns a new binary image created from the rectangular subset (specified in the left, top, width, and height parameters) of the binary image of the receiver.

The created image has the same:

• Type as the original image from which it is created (that is, a .bmp, .tiff, .gif, .png, or .jpeg image).

• Bit and color depth as the original image (for example, 23‑bit, 8‑bit, and so on). If the image is 32‑bit, the alpha channel (transparency) information is preserved for each pixel description that is copied.

The copyImage method raises an exception if the:

• Binary is not a valid BMP, TIFF< GIF, PNG, or JPEG image

• Method is called from a server method (which requires jade.exe to perform the image copy)

• Application is not a GUI application

• Rectangle specified is not a subset of the total image rectangle

2016.0.03 (Service Pack 2) and higher