Simple DirectMedia Layer 2.0
Fit
To fit the image properly, you need to tell the SDL_RenderCopy()
function the size of the texture, as well as the position of the upper left corner of the image in the window. SDL_RenderCopy()
expects this information as an SDL_Rect
.
This data structure simply encapsulates the dimensions of a rectangle. In other words, SDL_RECT pos;
first draws a rectangle. SDL counts the pixels from the left upper corner of the window, starting at 0
. In this example, I want the upper-left corner of the texture to be 150 pixels from the left edge of the window and 100 pixels from the top edge of the window. These two numbers are stored in the variables x
and y
:
pos.x = 150; pos.y = 100;
To define the width and height of the texture window, you use the pos.w
and pos.h
variables. To avoid texture distortion by the renderer, you thus assign the width and height of the texture to it. You can either painstakingly use a paint program to discover these two values, or you can use the SDL_QueryTexture()
function:
SDL_QueryTexture(texture, NULL, NULL, &pos.w, &pos.h);
This returns the pixel format (RGB, YUV, or similar), a pointer to the actual bitmap in memory, and the width and height of the texture. This information is no longer of interest, which is why SDL_QueryTexture()
keeps it to itself, thanks to the two NULL
s.
At this point, pos
contains the position and size that the renderer will use to paint the texture in the window. You only need to pass a pointer to pos
to SDL_RenderCopy()
:
SDL_RenderCopy(renderer, texture, NULL,&pos);
The results are shown in Figure 4. Using the same principle, you can then draw more textures in the window. The renderer draws the first textures copied first. In the following example,
SDL_RenderCopy(renderer, rear, NULL,NULL); SDL_RenderCopy(renderer, front, NULL, NULL);
the renderer would first paint the rear
texture in the window and then glue the front
texture on top. At the end of the code, you need to tell the renderer to display the updated window contents:
SDL_RenderPresent(renderer);
This last step only seems superfluous at first glance: If the renderer directly output every drawing action in the window, you would be able to see how the image was built up from individual textures. The result would be ugly, flickering animations.
Bus Stop
If you were to put together the code snippets as a program and launch it, you would briefly see a window appear and immediately disappear. To prevent that, you could stop the program just for two seconds:
SDL_Delay(2000);
However, a more elegant approach is to allow the user to quit by pressing a key, clicking on the window, or pressing the close button in the title bar. From this point on, SDL 1.2 users will be back on familiar ground: Keystrokes, mouse clicks, and other inputs are events in SDL.
Please Wait
Each event first ends up in a queue. The next event in the queue is retrieved by the SDL_WaitEvent()
function. If the queue is empty, SDL_WaitEvent()
waits until an event occurs. Then, you only need to query what event is occurring. The resulting switch
/case
monster is shown in Listing 1.
Listing 1
Event Handling in SDL
The helper variable quit
only indicates whether the end of the program has been reached. SDL_WaitEvent()
picks up the next event from the queue and puts it into a data structure of the SDL_Event
type. The structure stores the event type in a variable named type
. If the user presses a key, type
has a value of SDL_KEYDOWN
. The myevent.key.keysym.scancode
event variables reveal what key this was. The key number is translated by SDL_GetScancodeName()
into the corresponding letter or the label.
Because the keyboard on any given system will tend to differ, SDL assigns a symbolic name to each key, which is stored in the myevent.key.keysym.sym
variable. The SDL_GetKeyName()
function converts this to a readable result (Figure 5). An SDL_MOUSEBUTTONDOWN
type event is created if the user clicks on the window. The mouse pointer coordinates are stored in the variables myevent.motion.x
and myevent.motion.y
. A game would evaluate these coordinates and check which game object lies below them.
The user triggers the SDL_QUIT
event on quitting the program. In addition to the three cases presented, SDL supports many more events [4]. For example, if the user releases a key, this triggers an SDL_KEYUP
event.
« Previous 1 2 3 4 Next »
Buy this article as PDF
(incl. VAT)
Buy Linux Magazine
Subscribe to our Linux Newsletters
Find Linux and Open Source Jobs
Subscribe to our ADMIN Newsletters
Support Our Work
Linux Magazine content is made possible with support from readers like you. Please consider contributing when you’ve found an article to be beneficial.
News
-
Fedora 40 Beta Released Soon
With the official release of Fedora 40 coming in April, it's almost time to download the beta and see what's new.
-
New Pentesting Distribution to Compete with Kali Linux
SnoopGod is now available for your testing needs
-
Juno Computers Launches Another Linux Laptop
If you're looking for a powerhouse laptop that runs Ubuntu, the Juno Computers Neptune 17 v6 should be on your radar.
-
ZorinOS 17.1 Released, Includes Improved Windows App Support
If you need or desire to run Windows applications on Linux, there's one distribution intent on making that easier for you and its new release further improves that feature.
-
Linux Market Share Surpasses 4% for the First Time
Look out Windows and macOS, Linux is on the rise and has even topped ChromeOS to become the fourth most widely used OS around the globe.
-
KDE’s Plasma 6 Officially Available
KDE’s Plasma 6.0 "Megarelease" has happened, and it's brimming with new features, polish, and performance.
-
Latest Version of Tails Unleashed
Tails 6.0 is based on Debian 12 and includes GNOME 43.
-
KDE Announces New Slimbook V with Plenty of Power and KDE’s Plasma 6
If you're a fan of KDE Plasma, you'll be thrilled to hear they've announced a new Slimbook with an AMD CPU and the latest version of KDE Plasma desktop.
-
Monthly Sponsorship Includes Early Access to elementary OS 8
If you want to get a glimpse of what's in the pipeline for elementary OS 8, just set up a monthly sponsorship to help fund its continued existence.
-
DebConf24 to be Held in South Korea
Busan will be the location of the latest DebConf running July 28 through August 4