DrawText()

Синтаксис

Result = DrawText(x , y , Text$ [, FrontColor [, BackColor]])

Описание

Отображает данную строку на текущей поверхности в заданной значениями x, y позиции. Текущая поверхность вывода устанавливается с помощью функции StartDrawing().

Параметры

x, y	Местоположение, в котором можно вывести текст.
Text$	Текст предназначенный для вывода.
FrontColor (дополн.)	Цвет, который будет использоваться для текста. Если этот параметр не указан, будет использоваться цвет по умолчанию, заданный с помощью FrontColor(). Этот цвет может быть в формате RGBA или RGB.
BackColor (дополн.)	Цвет, который будет использоваться для фона. Если этот параметр не указан, будет использоваться цвет по умолчанию, заданный с помощью BackColor(). Если в DrawingMode() активировать флаг #PB_2DDrawing_Transparent, то параметр цвета фона игнорируется, и фон будет прозрачным.

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

Возвращается новая позиция текстового курсора x (т.е. сразу за последним выведенным символом), чтобы упростить дописывание текста, если понадобится.

Комментарии

Если для DrawingMode() задан непрозрачный фон, а в текущем режиме рисования используется альфа-канал, то текст сначала смешивается с фоном, а затем выводится на текущую поверхность.

Пример

If OpenWindow(0, 0, 0, 200, 200, "2DDrawing Example", #PB_Window_SystemMenu | #PB_Window_ScreenCentered)
    If CreateImage(0, 200, 200) And StartDrawing(ImageOutput(0))
        DrawingMode(#PB_2DDrawing_Transparent)
        Box(0, 0, 200, 200, RGB(255, 255, 255))
        For i = 1 To 30
            DrawText(Random(200), Random(200), "Hello World!", RGB(Random(255), Random(255), Random(255)))
        Next i
        StopDrawing()
        ImageGadget(0, 0, 0, 200, 200, ImageID(0))
    EndIf

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

См. также

DrawRotatedText(), DrawingFont(), FrontColor(), BackColor()

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

Все