Slow but Easy Text Drawing

Screenshot of drawing text

This example shows an easy but very slow way to draw text.

Its main benefit is ease of use. More complicated approaches with arcade.Text objects can run thousands of times faster.

drawing_text.py
  1"""
  2Example showing how to draw text to the screen.
  3
  4If Python and Arcade are installed, this example can be run from the command line with:
  5python -m arcade.examples.drawing_text
  6"""
  7import arcade
  8
  9SCREEN_WIDTH = 1200
 10SCREEN_HEIGHT = 800
 11SCREEN_TITLE = "Drawing Text Example"
 12DEFAULT_LINE_HEIGHT = 45
 13DEFAULT_FONT_SIZE = 20
 14
 15
 16class MyGame(arcade.Window):
 17    """
 18    Main application class.
 19    """
 20
 21    def __init__(self, width, height, title):
 22        super().__init__(width, height, title)
 23
 24        self.background_color = arcade.color.BEIGE
 25        self.text_angle = 0
 26        self.time_elapsed = 0.0
 27
 28    def on_update(self, delta_time):
 29        self.text_angle += 1
 30        self.time_elapsed += delta_time
 31
 32    def on_draw(self):
 33        """
 34        Render the screen.
 35        """
 36
 37        # This command should happen before we start drawing. It will clear
 38        # the screen to the background color, and erase what we drew last frame.
 39        self.clear()
 40
 41        # Add the screen title
 42        start_x = 0
 43        start_y = SCREEN_HEIGHT - DEFAULT_LINE_HEIGHT * 1.5
 44        arcade.draw_text("Text Drawing Examples",
 45                         start_x,
 46                         start_y,
 47                         arcade.color.BLACK,
 48                         DEFAULT_FONT_SIZE * 2,
 49                         width=SCREEN_WIDTH,
 50                         align="center")
 51
 52        # start_x and start_y make the start point for the text. We draw a dot to make it
 53        # easy to see the text in relation to its start x and y.
 54        start_x = 10
 55        start_y = SCREEN_HEIGHT - DEFAULT_LINE_HEIGHT * 3
 56        arcade.draw_text("Fonts:",
 57                         start_x,
 58                         start_y,
 59                         arcade.color.FRENCH_WINE,
 60                         DEFAULT_FONT_SIZE, bold=True)
 61
 62        # Move the y value down to create another line of text
 63        start_y -= DEFAULT_LINE_HEIGHT
 64        arcade.draw_text("Default Font (Arial)",
 65                         start_x,
 66                         start_y,
 67                         arcade.color.BLACK,
 68                         DEFAULT_FONT_SIZE)
 69
 70        # Show some built-in fonts
 71        start_y -= DEFAULT_LINE_HEIGHT
 72        arcade.draw_text("Kenney Blocks Font",
 73                         start_x,
 74                         start_y,
 75                         arcade.color.BLACK,
 76                         DEFAULT_FONT_SIZE,
 77                         font_name="Kenney Blocks")
 78
 79        start_y -= DEFAULT_LINE_HEIGHT
 80        arcade.draw_text("Kenney Future Font",
 81                         start_x,
 82                         start_y,
 83                         arcade.color.BLACK,
 84                         DEFAULT_FONT_SIZE,
 85                         font_name="Kenney Future")
 86
 87        start_y -= DEFAULT_LINE_HEIGHT
 88        arcade.draw_text("Kenney High Font",
 89                         start_x,
 90                         start_y,
 91                         arcade.color.BLACK,
 92                         DEFAULT_FONT_SIZE,
 93                         font_name="Kenney High")
 94
 95        start_y -= DEFAULT_LINE_HEIGHT
 96        arcade.draw_text("Kenney High Square Font",
 97                         start_x,
 98                         start_y,
 99                         arcade.color.BLACK,
100                         DEFAULT_FONT_SIZE,
101                         font_name="Kenney High Square")
102
103        start_y -= DEFAULT_LINE_HEIGHT
104        arcade.draw_text("Kenney Mini Square Font",
105                         start_x, start_y,
106                         arcade.color.BLACK,
107                         DEFAULT_FONT_SIZE,
108                         font_name="Kenney Mini Square")
109
110        start_y -= DEFAULT_LINE_HEIGHT
111        arcade.draw_text("Kenney Pixel Font",
112                         start_x, start_y,
113                         arcade.color.BLACK,
114                         DEFAULT_FONT_SIZE,
115                         font_name="Kenney Pixel")
116
117        start_y -= DEFAULT_LINE_HEIGHT
118        arcade.draw_text("Kenney Pixel Square Font",
119                         start_x, start_y,
120                         arcade.color.BLACK,
121                         DEFAULT_FONT_SIZE,
122                         font_name="Kenney Pixel Square")
123
124        start_y -= DEFAULT_LINE_HEIGHT
125        arcade.draw_text("Kenney Rocket Font",
126                         start_x, start_y,
127                         arcade.color.BLACK,
128                         DEFAULT_FONT_SIZE,
129                         font_name="Kenney Rocket")
130
131        start_y -= DEFAULT_LINE_HEIGHT
132        arcade.draw_text("Kenney Rocket Square Font",
133                         start_x, start_y,
134                         arcade.color.BLACK,
135                         DEFAULT_FONT_SIZE,
136                         font_name="Kenney Rocket Square")
137
138        start_y -= DEFAULT_LINE_HEIGHT
139        # When trying to use system fonts, it can be risky to specify
140        # only a single font because someone else's computer might not
141        # have it installed. This is especially true if they run a
142        # different operating system. For example, if you are on Windows
143        # and a friend has a mac or Linux, they might not have the same
144        # fonts. Your game could look different or broken on their computer.
145        # One way around that is to provide multiple options for draw_text
146        # to try. It will use the first one it finds, and use Arial as a
147        # default if it can't find any of them.
148        # In the example below, draw_text is given a tuple of names for very
149        # similar fonts, each of which is common on a different major
150        # operating systems.
151        arcade.draw_text("Times New Roman (Or closest match on system)",
152                         start_x, start_y,
153                         arcade.color.BLACK,
154                         DEFAULT_FONT_SIZE,
155                         font_name=(
156                             "Times New Roman",  # Comes with Windows
157                             "Times",  # MacOS may sometimes have this variant
158                             "Liberation Serif"  # Common on Linux systems
159                         ))
160
161        start_y -= DEFAULT_LINE_HEIGHT
162        arcade.draw_text("Multi-Line\ntext using\n\\n characters.",
163                         start_x, start_y,
164                         arcade.color.BLACK,
165                         DEFAULT_FONT_SIZE / 2,
166                         multiline=True,
167                         width=300)
168
169        start_y -= DEFAULT_LINE_HEIGHT * 1.5
170        arcade.draw_text("Wrapping really long text automatically to a new line. "
171                         "The quick brown fox jumped over the lazy dogs.",
172                         start_x,
173                         start_y,
174                         arcade.color.BLACK,
175                         DEFAULT_FONT_SIZE / 2,
176                         multiline=True,
177                         width=300)
178
179        # --- Column 2 ---
180        start_x = 750
181        start_y = SCREEN_HEIGHT - DEFAULT_LINE_HEIGHT * 3
182        arcade.draw_text("Text Positioning:",
183                         start_x,
184                         start_y,
185                         arcade.color.FRENCH_WINE,
186                         DEFAULT_FONT_SIZE,
187                         bold=True)
188
189        # start_x and start_y make the start point for the text.
190        # We draw a dot to make it easy too see the text in relation to
191        # its start x and y.
192        start_y -= DEFAULT_LINE_HEIGHT
193        arcade.draw_point(start_x, start_y, arcade.color.BARN_RED, 5)
194        arcade.draw_text("Default of 'baseline' and 'Left'",
195                         start_x,
196                         start_y,
197                         arcade.color.BLACK,
198                         DEFAULT_FONT_SIZE)
199
200        start_y -= DEFAULT_LINE_HEIGHT
201        arcade.draw_point(start_x, start_y, arcade.color.BARN_RED, 5)
202        arcade.draw_text("'bottom' and 'left'",
203                         start_x,
204                         start_y,
205                         arcade.color.BLACK,
206                         DEFAULT_FONT_SIZE,
207                         anchor_x="left",
208                         anchor_y="bottom")
209
210        start_y -= DEFAULT_LINE_HEIGHT
211        arcade.draw_point(start_x, start_y, arcade.color.BARN_RED, 5)
212        arcade.draw_text("'top' and 'left'",
213                         start_x, start_y,
214                         arcade.color.BLACK,
215                         DEFAULT_FONT_SIZE,
216                         anchor_x="left",
217                         anchor_y="top")
218
219        start_y -= DEFAULT_LINE_HEIGHT * 2
220        arcade.draw_point(start_x, start_y, arcade.color.BARN_RED, 5)
221        arcade.draw_text("'baseline' and 'center'",
222                         start_x, start_y,
223                         arcade.color.BLACK,
224                         DEFAULT_FONT_SIZE,
225                         anchor_x="center",
226                         anchor_y="baseline")
227
228        start_y -= DEFAULT_LINE_HEIGHT
229        arcade.draw_point(start_x, start_y, arcade.color.BARN_RED, 5)
230        arcade.draw_text("'baseline' and 'right'",
231                         start_x,
232                         start_y,
233                         arcade.color.BLACK,
234                         DEFAULT_FONT_SIZE,
235                         anchor_x="right",
236                         anchor_y="baseline")
237
238        start_y -= DEFAULT_LINE_HEIGHT
239        arcade.draw_point(start_x, start_y, arcade.color.BARN_RED, 5)
240        arcade.draw_text("'center' and 'center'",
241                         start_x,
242                         start_y,
243                         arcade.color.BLACK,
244                         DEFAULT_FONT_SIZE,
245                         anchor_x="center",
246                         anchor_y="center")
247
248        start_y -= DEFAULT_LINE_HEIGHT * 4
249        # start_x = 0
250        # start_y = 0
251        arcade.draw_point(start_x, start_y, arcade.color.BARN_RED, 5)
252        arcade.draw_text("Rotating Text",
253                         start_x, start_y,
254                         arcade.color.BLACK,
255                         DEFAULT_FONT_SIZE,
256                         anchor_x="center",
257                         anchor_y="center",
258                         rotation=self.text_angle)
259
260
261def main():
262    MyGame(SCREEN_WIDTH, SCREEN_HEIGHT, SCREEN_TITLE)
263    arcade.run()
264
265
266if __name__ == "__main__":
267    main()