Class: Crop

Phaser.Component. Crop

new Crop()

The Crop component provides the ability to crop a texture based Game Object to a defined rectangle, which can be updated in real-time.

src/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 updateCrop in order to have the change take effect.

src/gameobjects/components/Crop.js line 24


crop(rect [, copy])

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 cropRect property directly and then calling updateCrop.

The rectangle object given to this method can be either a Phaser.Rectangle or any other object so long as it has public x, y, width, height, right and bottom properties.

A reference to the rectangle is stored in cropRect unless the copy parameter is true, in which case the values are duplicated to a local object.

Name Type Argument Default Description
rect Phaser.Rectangle

The Rectangle used during cropping. Pass null or no parameters to clear a previously set crop rectangle.

copy boolean <optional>

If false cropRect will 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.

src/gameobjects/components/Crop.js line 49


If you have set a crop rectangle on this Game Object via crop and since modified the cropRect property, or the rectangle it references, then you need to update the crop frame by calling this method.

src/gameobjects/components/Crop.js line 86

phaser-ce@2.8.8 is on GitHub and NPM

Documentation generated by JSDoc 3.5.4 on 2017-09-25 using Tomorrow.