The Crop component provides the ability to crop a texture based Game Object to a defined rectangle, which can be updated in real-time.
- Source code: gameobjects/components/Crop.js (Line 13)
cropRect : Phaser.Rectangle
The Rectangle used to crop the texture this Game Object uses. Set this property via
crop. If you modify this property directly you must call
updateCropin order to have the change take effect.
- Default Value
- Source code: gameobjects/components/Crop.js (Line 24)
Crop allows you to crop the texture being used to display this Game Object. Setting a crop rectangle modifies the core texture frame. The Game Object width and height properties will be adjusted accordingly.
Cropping takes place from the top-left and can be modified in real-time either by providing an updated rectangle object to this method, or by modifying
cropRectproperty directly and then calling
The rectangle object given to this method can be either a
Phaser.Rectangleor any other object so long as it has public
A reference to the rectangle is stored in
true, in which case the values are duplicated to a local object.
Name Type Argument Default Description
The Rectangle used during cropping. Pass null or no parameters to clear a previously set crop rectangle.
cropRectwill be stored as a reference to the given rect. If true it will copy the rect values into a local Phaser Rectangle object stored in cropRect.
- Source code: gameobjects/components/Crop.js (Line 49)
If you have set a crop rectangle on this Game Object via
cropand since modified the
cropRectproperty, or the rectangle it references, then you need to update the crop frame by calling this method.
- Source code: gameobjects/components/Crop.js (Line 86)