---
title: "CROP"
manual: "TypoScript Explained"
version: "13.4"
permalink: "https://docs.typo3.org/permalink/t3tsref:gifbuilder-crop@13.4"
source: "Gifbuilder/ObjectNames/Crop/Index.rst"
rendered: "2026-09-19T07:15:48+00:00"
---

# CROP {#gifbuilder-crop}

> [!NOTE]
> This object resets [workArea](https://docs.typo3.org/permalink/t3tsref:gifbuilder-properties-workarea@13.4) to the
> new dimensions of the image!

## Properties {#gifbuilder-crop-properties}

-   [align](https://docs.typo3.org/permalink/t3tsref:align@13.4)
-   [backColor](https://docs.typo3.org/permalink/t3tsref:backcolor@13.4)
-   [crop](https://docs.typo3.org/permalink/t3tsref:crop-1@13.4)

### align {#gifbuilder-crop-align}

-   **align**

    -   *Type:* VHalign / [stdWrap](https://docs.typo3.org/permalink/t3tsref:stdwrap@13.4)
    -   *Default:* l, t

    Pair of values, which defines the horizontal and vertical alignment of
    the crop frame.

    **Values:**

    Horizontal alignment:

    -   **l**

        left

    -   **c**

        center

    -   **r**

        right

    Vertical alignment:

    -   **t**

        top

    -   **c**

        center

    -   **b**

        bottom

    **Example:**

    Horizontally centered, vertically at the bottom:

    **EXT:site_package/Configuration/TypoScript/setup.typoscript**

    ```typoscript
    align = c, b
    ```

### backColor {#gifbuilder-crop-backcolor}

-   **backColor**

    -   *Type:* [Colors in TypoScript GIFBUILDER](https://docs.typo3.org/permalink/t3tsref:data-type-graphiccolor@13.4) / [stdWrap](https://docs.typo3.org/permalink/t3tsref:stdwrap@13.4)
    -   *Default:* The original background color

    Background color.

### crop {#gifbuilder-crop-crop}

-   **crop**

    -   *Type:* x,y,w,h [+calc](https://docs.typo3.org/permalink/t3tsref:gifbuilder-calc@13.4) /[stdWrap](https://docs.typo3.org/permalink/t3tsref:stdwrap@13.4)

    x,y is the offset of the crop frame from the position specified by
    [align](https://docs.typo3.org/permalink/t3tsref:gifbuilder-crop-align@13.4).

    w,h are the dimensions of the frame.