crop

Typecommand
DictionaryLCS
LibraryLiveCode Script
Syntax
crop <image> to <left>, <top>, <right>, <bottom>
Summary

Trims an image.

Introduced2.0
OSmac, windows, linux
Platformsdesktop, server, mobile
Parameters
NameTypeDescription
image

Any image reference.

left

The left, top, right, and bottom describe the new rectangle of the image.

top
right
bottom
Example
crop image 1 to 100,100,200,200
crop image "photo" to the rect of graphic "Overlay"
RelatedKeyword: image, rectangle
Property: pixels, imageData, rectangle
Command: flip, rotate
Object: image
Glossary: property, referenced control, command, execution error
Description

Use the crop command to remove parts of an image, or to extend the image's edges.

The crop command changes the image's rectangle property to the new rectangle. Unlike changing the rectangle directly, the crop command removes image data outside the new rectangle, instead of scaling the image to fit.

If the crop rectangle is smaller than the image's original rectangle, the parts of the image outside the crop rectangle are removed. This is a permanent operation; the cropped portions do not reappear if you use the crop command to change the image's rectangle back to the original size.

If the crop rectangle is larger than the image's original rectangle, blank pixels are added to one or more edges of the image.

Important: The crop command cannot be used on a referenced image. Doing so will cause an execution error.

Tagsui