PHP imagefilledrectangle() 함수 완벽 가이드 – 채워진 사각형 그리기

PHP imagefilledrectangle() 함수란?

imagefilledrectangle() 함수는 GD 라이브러리에서 제공하는 이미지 처리 함수로, 지정한 두 좌표를 기준으로 내부가 채워진(fill) 사각형을 그리는 데 사용됩니다. 차트 생성, 워터마크 배경, 이미지 편집 도구 등 다양한 그래픽 작업에 활용됩니다.

사각형은 첫 번째 점(x1, y1)과 두 번째 점(x2, y2)을 마주 보는 모서리(대각선 양 끝점)로 삼아 그려집니다. 좌표의 순서가 반대여도 동일한 사각형이 그려집니다.

문법(Syntax)

imagefilledrectangle( $img, $x1, $y1, $x2, $y2, $color )

매개변수(Parameters)

• img
  그림을 그릴 대상 이미지 리소스입니다. 일반적으로 imagecreatetruecolor() 함수로 생성한 빈 이미지를 사용합니다.

• x1
  사각형의 첫 번째 모서리 점 1의 x좌표입니다.

• y1
  점 1의 y좌표입니다. (왼쪽 상단 기준)

• x2
  사각형의 반대편 모서리인 점 2의 x좌표입니다.

• y2
  점 2의 y좌표입니다.

• color
  사각형 내부를 채울 색상으로, imagecolorallocate() 함수로 생성한 색상 식별자를 전달합니다.

반환값(Return)

사각형이 성공적으로 그려지면 TRUE, 실패하면 FALSE를 반환합니다.

예제 코드

다음 예제는 500×300 크기의 이미지 위에 틸(teal) 계열의 RGB(0, 128, 128) 색상으로 채워진 사각형을 그린 후 PNG 형식으로 출력합니다.

<?php
    // 빈 이미지 생성 (가로 500px, 세로 300px)
    $img = imagecreatetruecolor(500, 300);

    // 채우기 색상 지정 (R:0, G:128, B:128 - 청록색)
    $color = imagecolorallocate($img, 0, 128, 128);

    // (30,30) ~ (470,270) 영역에 채워진 사각형 그리기
    imagefilledrectangle($img, 30, 30, 470, 270, $color);

    // PNG 이미지로 출력
    header("Content-type: image/png");
    imagepng($img);

    // 메모리 해제
    imagedestroy($img);
?>

실행 결과(Output)

위 코드를 실행하면 파란빛이 감도는 초록색(청록색) 사각형이 흰색 배경 가운데 그려진 PNG 이미지가 출력됩니다.

참고 사항

• 테두리만 있는 사각형을 그리고 싶다면 imagerectangle() 함수를 사용하세요.

• imagepng() 호출 후에는 imagedestroy()로 이미지 리소스를 반드시 해제하여 메모리 누수를 방지하는 것이 좋습니다.

• GD 라이브러리가 서버에 설치되어 있어야 해당 함수를 사용할 수 있습니다.