Processing:Справочник языка Processing/loadFont()

Содержание

Среда разработки Processing

Справочник языка Processing

Библиотеки

Примеры

Режимы программирования

Перевод: Максим Кузьмин

Проверка/Оформление/Редактирование: Мякишев Е.А.

loadFont()

Обозначение

loadFont()

Описание

Загружает отформатированный (имеющий формат *.vlw) шрифт в объект PFont. Чтобы создать шрифт формата *.vlw, кликните в среде разработки Processing на Tools > Create Font… Этот инструмент создает текстуры для каждого символа шрифта, а затем сохраняет их как файл *.vlw в папку «data» текущего скетча. Поскольку символы шрифта заданы в виде текстур (а не векторных данных), при их отрисовке необходимо учитывать размер шрифта. К примеру, если скетч рисует 32-пиксельный шрифт или меньше, вам нужно будет загрузить для него 32-пунктный шрифт. С другой стороны, если загрузить 12-пунктный шрифт и отрисовать его как 48-пунктный шрифт, с визуальной точки зрения этот шрифт будет выглядеть плохо, потому что программа просто растянет маленькие изображения до большого размера.

Как loadImage() и другие методы для загрузки данных, метод loadFont() необходимо использовать внутри draw(), тиначе он будет сильно замедлять работу скетча – шрифт будет загружаться с диска (или из сети) на каждом кадре. Поэтому файлы (в том числе и файлы шрифтов) рекомендуется загружать внутри блока setup().

Чтобы шрифт загрузился корректно, он должен находиться внутри папки «data» текущего скетча. Кроме того, файл шрифта может быть загружен из любого места на локальном компьютере, и для этого в параметре filename необходимо указать абсолютный путь к файлу (в системах Unix и Linux он начинается с символа «/», а в Windows – с буквы диска). Если нужный файл находится в сети, в параметре filename нужно указать URL к нему.

В случае ошибки или если файл шрифта не будет найден, метод вернет значение null, а в консоли будет напечатано сообщение об ошибке. Оно не остановит работу программы, но если loadFont() вернет null, а в вашем скетче нет проверки на возврат null, это может вызвать исключение NullPointerException.

Чтобы включить использование векторных данных в визуализаторе по умолчанию, вместо loadFont() воспользуйтесь методом createFont(). Это может помочь, когда вам необходимы разные размеры шрифта или при работе с визуализатором вроде библиотеки PDF, основанном на визуализаторе по умолчанию.

Синтаксис

loadFont(filename)

Параметры

filename – название файла шрифта, который нужно загрузить. Тип данных – String

Возвращаемое значение

Тип данных – объект PFont.

Пример

PFont font;
// чтобы файл шрифта загрузился корректно,
// он должен находиться в папке «data» текущего скетча: 
font = loadFont("LetterGothicStd-32.vlw");
textFont(font, 32);
text("word", 10, 50);