now, one more.
onto Digits. Not Digimon
But Digits
Ok, so now we know how to create panels... what comes next? Let's play with digits, a panel element that can display numerical values. Start Lite-C and open the file named script05 from inside workshop05:
////////////////////////////////////////////////////////////////////
PANEL* first_pan =
{
digits (410, 200, 2, *, 1, sys_seconds);
flags = VISIBLE;
}
/////////////////////////////////////////////////////////////////////
I like short examples, but I see something strange here: I thought that a panel definition must include a "bmap = some_bitmap;" line and numerical values for pos_x and pos_y! We will only display some figures here - we don't need a bitmap for that, so we don't have to add the bmap line of code. And if pos_x and / or pos_y are omitted, they are assumed to be 0.
The "digits" definition doesn't look that complicated. Let's discuss it right away:
digits (410, 200, 2, *, 1, sys_seconds);
- "digits" is the keyword that must be used whenever we want to display a figure on the screen;
- the first two numbers (x = 410 and y = 200) show the position of the digit on the panel. If the panel would have pos_x = 20 and pos_y = 30 and this digit definition has x = 410 and y = 200 we would see the figure on the screen at x = 430 and y = 230, get it?
- 2 is a format code. In this case it's just the number of digits that will be used to display our number. In my digits example I can display numbers up to 99 (2 digits), but if I would replace 2 with 5 I would set the limit to 99,999. There are more complicated format codes that give the number of decimals or allow to use texts as well (just like in our workshop02 example); you can learn everything about them in the reference manual.
- * tells the engine to use the default font, a small set of predefined characters that will be used to display figures or texts for testing purposes. We can define and use any other fancy fonts, but this one is built inside the engine so we don't have to write its definition;
- 1 is a factor that multiplies the value which needs to be displayed. Don't worry about it for now; we will use 1 here most (if not all) of the time;
- finally, sys_seconds is the name of the variable that will be displayed. You can replace it with any other variable.
Ok, now that we have talked about all these things, we can write down a more general digit definition:
digits (x, y, format, font, factor, variable);
I can see my digit on the screen and its value changes every second, just like a clock! I'm sure that "sys_seconds" is a predefined variable, just like video_mode, because I didn't have to write its definition at all. You can play with "90" and "200" to change the position of the digit on the screen. If you would change pos_x and pos_y too, you would see that the panel changes its position; however, the digit will keep its offset in relation with the panel.
These digits are cool! I could use them to display player's health, armor, number of bullets, lives... every time I need to display a value I will use a digit! But wait... how can we display several digits? Simply add several "digits" lines of code to your panel definition:
digits (370, 200, 2, *, 1, sys_hours);
digits (390, 200, 2, *, 1, sys_minutes);
digits (410, 200, 2, *, 1, sys_seconds);
and a little on Windows........
No, I'm not talking about the operating system here; I want to show you how to create a window, a panel element that uses a variable in order to display a certain part of a bitmap. If you aren't so sure if this "window" is useful, you'll have to trust me: it is. You will want to use windows whenever you want to create a compass or maybe a (horizontal or vertical) bar that changes its length or width, for example some health bars for your fighting game:
We have to define a window: add a variable and edit the panel code from inside script05.c until it looks like the one posted below (hint: copy and paste the lines into your script05.c file).
////////////////////////////////////////////////////////////////////
var altitude = 0; // height of the plane
PANEL* first_pan =
{
bmap = "frame.pcx";
window (40, 10, 178, 160, "height.pcx", 0, altitude);
flags = VISIBLE;
}
////////////////////////////////////////////////////////////////////
Let's see the changes: we have a new var named altitude and are using two bitmaps in the panel; one of them is used as a frame for the altimeter (we don't really "need" it, but it looks cool) and the other one is used inside the window definition. And of course, we have the window definition inside the panel named first_pan!
Time to run our script! Press Test run and you will see the following image:
window (x, y, size_x, size_y, bitmap, variable_x, variable_y);
- window is the keyword that must be used every time we define a window;
- x and y give the position of the window on the panel. If the panel has pos_x = 200 and pos_y = 100 and our window has x = 30 and y = 20, the bitmap used for the window will be placed at x = 230 and y = 120 on the screen.
- size_x and size_y give the size of the cutout "window" on x and y. Remember that the window bitmap itself is huge; these figures will set the size of the visible part of the bitmap on x and y;
- bitmap is the name of a previously defined BMAP* or the file name of the bitmap used for the window (height_pcx);
- variable_x gives the horizontal offset of the bitmap that will be used for the window. We don't want to move the red bitmap to the left or to the right so we use zero as variable_x in our example;
- variable_y gives the vertical offset of the bitmap used for the window. We wanted to be able to move the red bitmap up and down, so we have put a variable name here (var altitude).
Conclusion: When you create a window, you will only see a small part of the bitmap used for it. Change variable_x or variable_y (altitude in our script) and the long bitmap will be shifted along the x or y axis, displaying other parts of the bitmap on the screen. The size of the cutout window in pixels (the visible part of the bitmap) is given by size_x and size_y.
Next: Buttons and sliders
have a go and try out 3D Gamestudio. And with the Lite C too.
