AddPathText()

Синтаксис

AddPathText(Text$)

Описание

Добавляет Контуры символов текста к векторному контуру, начиная с текущей позиции курсора. После вызова этой функции курсор перемещается в конец добавленного контура текста. Текущую позицию курсора можно задать с помощью функции MovePathCursor().

Предпочтительней использовать функцию DrawVectorText(), если это возможно. Подробнее см. в комментариях.

Параметры

Text$

Задает текст (одну строку), который требуется добавить к векторному контуру.

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

Ничего.

Комментарии

Преобразование текста в контур является ресурсоёмкой операцией и может привести к потере качества текста и даже немного другой форме текста (в зависимости от шрифта), по сравнению с прямым выводом текста с помощью функции DrawVectorText(). Функция DrawVectorText() более эффективна и может использовать такие методы, как субпиксельный рендеринг, чтобы улучшить качество текста. Следовательно, функция AddPathText() должна использоваться только в том случае, если текст необходим именно в виде контура, а не в виде обычного текста.

Пример

If OpenWindow(0, 0, 0, 400, 200, "VectorDrawing", #PB_Window_SystemMenu | #PB_Window_ScreenCentered)
    CanvasGadget(0, 0, 0, 400, 200)
    LoadFont(0, "Times New Roman", 20, #PB_Font_Bold)

    If StartVectorDrawing(CanvasVectorOutput(0))
        VectorFont(FontID(0), 150)

        MovePathCursor(50, 25)
        AddPathText("Text")

        VectorSourceColor(RGBA(255, 0, 0, 255))
        DashPath(3, 6)

        StopVectorDrawing()
    EndIf

    Repeat
        Event = WaitWindowEvent()
    Until Event = #PB_Event_CloseWindow
EndIf

См. также

DrawVectorText(), DrawVectorParagraph(), VectorTextWidth(), VectorTextHeight()

Поддерживаемые OS

Все