폰트 이름 가져오기 (font_get_fontname)
이 문서에서는 font_get_fontname 함수에 대해 설명하고, 다양한 활용 및 응용 예제를 포함하겠습니다.
함수 설명
font_get_fontname 함수는 주어진 폰트 자산의 실제 시스템 이름을 반환합니다. 이 함수는 문자열(a string)을 반환하며, 반환되는 이름은 사용하고 있는 폰트에 따라 달라집니다. 예를 들어, 자산 브라우저에 "fnt_Main"이라는 폰트 자산이 있고, 폰트 자체는 Windows 시스템 폰트인 Arial일 경우, 이 함수는 "Arial"을 반환합니다.
자산 브라우저에 표시되는 이름이 필요하다면 font_get_name() 함수를 사용해야 합니다. 위에서 설명한 동작은 IDE를 통해 추가된 폰트 자산에만 적용됩니다. 런타임에서 로드된 폰트(예: font_add()를 사용하여)에는 폰트 이름 대신 해당 폰트 파일의 전체 경로를 반환합니다.
문법
font_get_fontname(ind);
매개변수 설명
| 매개변수 | 타입 | 설명 |
|---|---|---|
| ind | Index | 확인할 폰트의 인덱스입니다. |
반환값
- 반환형: String
- 설명: 폰트 리소스의 시스템 이름을 반환합니다.
예제
다음은 font_get_fontname 함수를 사용하는 예제입니다.
fnt_Name = font_get_fontname(font0);
위 코드는 폰트 리소스의 시스템 이름을 가져와서 "fnt_Name" 변수에 문자열로 저장합니다.
활용 및 응용 예제
폰트 정보 출력
// 폰트 인덱스를 배열로 관리
for (var i = 0; i < array_length(fonts_array); i++) {
var font_name = font_get_fontname(fonts_array[i]);
show_message("폰트 이름: " + font_name);
}
이 예제는 폰트 배열에서 모든 폰트의 시스템 이름을 출력합니다.
런타임 폰트 추가
// 런타임에서 폰트를 추가하고 이름 가져오기
var fontID = font_add("폰트 파일 경로.ttf");
var font_path = font_get_fontname(fontID);
show_message("폰트 경로: " + font_path);
이 예제는 런타임에서 폰트를 추가한 후, 해당 폰트의 전체 경로를 출력합니다.
폰트 조건부 로딩
// 폰트 이름 확인 후 특정 행동 결정
var myFont = font_get_fontname(font0);
if (myFont == "Arial") {
show_message("Arial 폰트가 로드되었습니다!");
} else {
show_message("다른 폰트가 로드되었습니다: " + myFont);
}
이 예제는 로드된 폰트의 시스템 이름을 확인하고, 특정 폰트(예: Arial)에 대한 특정 메시지를 표시합니다.
이 문서에서는 font_get_fontname 함수에 대한 설명과 다양한 활용 예제를 제공했습니다. 필요에 따라 이 함수와 관련된 다른 기능들을 탐색하여 활용할 수 있습니다.