imagerectangle

    (PHP 4, PHP 5, PHP 7, PHP 8)

    imagerectangle — Draw a rectangle

    Опис

    imagerectangle(
        GdImage $image,
        int $x1,
        int $y1,
        int $x2,
        int $y2,
        int $color
    ): bool

    imagerectangle() creates a rectangle starting at the specified coordinates.

    Параметри

    image

    Об'єкт GdImage, що повертається однією з функцій створення зображення, такою як imagecreatetruecolor().

    x1

    Upper left x coordinate.

    y1

    Upper left y coordinate 0, 0 is the top left corner of the image.

    x2

    Bottom right x coordinate.

    y2

    Bottom right y coordinate.

    color

    Ідентифікатор кольору, створений за допомогою imagecolorallocate().

    Значення, що повертаються

    Повертає true у разі успіху або false в разі помилки.

    Журнал змін

    Версія Опис
    8.0.0 Тепер image має бути примірником GdImage. Раніше очікувався gd-resource.

    Приклади

    Приклад #1 Simple imagerectangle() example

    <?php
    // Create a 200 x 200 image
    $canvas = imagecreatetruecolor(200, 200);

    // Allocate colors
    $pink = imagecolorallocate($canvas, 255, 105, 180);
    $white = imagecolorallocate($canvas, 255, 255, 255);
    $green = imagecolorallocate($canvas, 132, 135, 28);

    // Draw three rectangles each with its own color
    imagerectangle($canvas, 50, 50, 150, 150, $pink);
    imagerectangle($canvas, 45, 60, 120, 100, $white);
    imagerectangle($canvas, 100, 120, 75, 160, $green);

    // Output and free from memory
    header('Content-Type: image/jpeg');

    imagejpeg($canvas);
    imagedestroy($canvas);
    ?>

    Поданий вище приклад виведе щось схоже на:

    Output of example : Simple imagerectangle() example

    Improve This Page

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes 3 notes

    up
    1
    stanislav dot eckert at vizson dot de
    9 years ago
    Please pay attention if you want to draw pixel perfect rectangles: Since this function uses absolute values for the second coordinate points (instead of width and height), you might face a logical problem. PHP counts from 0. But a pixel at position 0,0 occupies already a 1x1 space. In the example above you have the following line:

    imagerectangle($canvas, 50, 50, 150, 150, $pink);

    If you don't pay attention, you might thing that the difference between the two coordinates is exactly 100 and assume that the drawn rectangle would have the dimension of 100 x 100 pixels too. But it would be 101 x 101, because PHP counts from 0 and imagerectangle() uses absolute coordinates for the second point too. A smaller example: A rectangle with coordinates 0,0 and 5,5 means 0,1,2,3,4,5 which are 6 pixels, not 5.
    up
    0
    eustaquiorangel at yahoo dot com
    21 years ago
    If you want an empty rectangle, I mean, just the borders, fill it first with the ImageFilledRectangle function with the background color and then draw it with this function.
    up
    -2
    rogier
    17 years ago
    In addition to Corey's note, this is the kind of code he means. Note that I always draw an outer grid border, so drawing lines will always take
    1 + ceil((rows+cols)/2) actions. For a 20X20 grid, this means 21 actions, a 10X25 grid takes 19 Actions

    <?php

    function draw_grid(&$img, $x0, $y0, $width, $height, $cols, $rows, $color) {
    //draw outer border
    imagerectangle($img, $x0, $y0, $x0+$width*$cols, $y0+$height*$rows, $color);
    //first draw horizontal
    $x1 = $x0;
    $x2 = $x0 + $cols*$width;
    for (    $n=0; $n<ceil($rows/2); $n++) {
    $y1 = $y0 + 2*$n*$height;
    $y2 = $y0 + (2*$n+1)*$height;
    imagerectangle($img, $x1,$y1,$x2,$y2, $color);
    }
    //then draw vertical
    $y1 = $y0;
    $y2 = $y0 + $rows*$height;
    for (    $n=0; $n<ceil($cols/2); $n++) {
    $x1 = $x0 + 2*$n*$width;
    $x2 = $x0 + (2*$n+1)*$width;
    imagerectangle($img, $x1,$y1,$x2,$y2, $color);
    }
    }

    //example
    $img = imagecreatetruecolor(300, 200);
    $red = imagecolorallocate($img, 255, 0, 0);
    draw_grid($img, 0,0,15,20,20,10,$red);
    header("Content-type: image/png");
    imagepng($img);
    imagedestroy($img);
    ?>
    have fun ;)
    ＋add a note
    To Top