imagefontheight()는 PHP에 내장된 함수로, 지정된 글꼴에서 문자의 픽셀 높이(pixel height)를 가져오는 데 사용됩니다. GD 라이브러리를 활용해 이미지에 텍스트를 그릴 때 텍스트의 세로 크기를 계산해야 하는 경우 유용하게 활용할 수 있습니다.
문법(Syntax)
int imagefontheight(int $font)
매개변수(Parameters)
imagefontheight() 함수는 하나의 매개변수 $font를 받습니다. 이 매개변수는 글꼴 값을 나타내며, 다음 두 가지 방식으로 지정할 수 있습니다.
- 내장 글꼴(Built-in fonts): 1부터 5까지의 숫자 값(1, 2, 3, 4, 5)을 사용합니다.
- 사용자 정의 글꼴(Custom fonts): imageloadfont() 함수로 불러온 커스텀 글꼴을 사용할 수 있습니다.
반환값(Return Values)
imagefontheight() 함수는 지정한 글꼴의 픽셀 단위 높이를 정수(int) 형태로 반환합니다.
예제 1
다음 예제는 글꼴 값 3에 해당하는 글꼴의 높이를 출력합니다.
<?php
// 글꼴 높이 값은 1부터 5까지 변경 가능합니다.
echo 'Font height: ' . imagefontheight(3);
?>
출력 결과
Font height: 13
예제 2
다음 예제는 1부터 5까지 모든 내장 글꼴의 높이를 한 번에 확인하는 방법을 보여줍니다.
<?php
// 1부터 5까지 각 글꼴 값의 높이를 가져옵니다.
echo 'Font height for the font value 1 is '
.imagefontheight(1) . '<br>'; // <br>은 줄바꿈을 위한 태그입니다.
echo 'Font height for the font value 2 is '
.imagefontheight(2) . '<br>';
echo 'Font height for the font value 3 is '
.imagefontheight(3) . '<br>';
echo 'Font height for the font value 4 is '
.imagefontheight(4) . '<br>';
echo 'Font height for the font value 5 is '
.imagefontheight(5) . '<br>';
?>
출력 결과
Font height for the font value 1 is 8
Font height for the font value 2 is 13
Font height for the font value 3 is 13
Font height for the font value 4 is 16
Font height for the font value 5 is 15
정리
imagefontheight() 함수는 PHP의 GD 라이브러리에서 제공하는 간단하면서도 실용적인 함수입니다. 이미지에 텍스트를 배치하거나 텍스트 영역의 크기를 계산할 때, imagefontwidth() 함수와 함께 사용하면 가로·세로 크기를 모두 손쉽게 구할 수 있습니다.