The datapad's gui offers three main features, a customizable information page, a camera and a map:



The camera allows you to take screenshots. The screenshots will be saved under:

The map shows the current scenario map and the players current position on it, nothing else.

The information page contains three sub pages. Text, images and audio. All of those can be filled with your own data, and it's almost easy, all you need to do is provide the content you'd like to display to the player and do some little numeric magic. But not to worry, I'll show you how.

The datapad, or rather, every datapad in a scenario looks for three config files that are located in following subfolder:

The three files are:

• text.cfg
  
• images.cfg
  
• audio.cfg

Those files all contain the data to display, texts, images and audio files respectively. Each piece of data (a text, single image, and audio file) is represented by a single line. Each line consists of two string entries, the title and the actual data.

One important thing to remember is that those specify all the available data and each and every datapad (described in the scenario file) defines which of those entries it will use.

I will demonstrate that for the texts. It works in the same manner for the other types of data.

The datapad can display up to 32 (text) items. Clicking on one and hitting "READ" displays the actual text. All the available text data is stored in the text.cfg file using the following format:

You can type the text directly like this:

Of course you can use a reference to the strings.xml file like this:

Now the important theoretical part. You can populate your config file with texts and everything. Then, you create a scenario with a datapad. You fire up the game and...well, nothing. The datapad shows none of your texts.

The reason is that you have to tell each and every datapad which of the text entries from the text.cfg file you want it to use. This is accomplished by means of the generic vector value of said datapad. But first, this is how the line in the scenario file looks like, that defines a single datapad:

Now this is the code the scenario editor inserts for a datapad already stored in the players inventory. Just for your interest, the last six entries in this long lines have following meaning:

What we are interested in is the generic vector, which, in 3D space, is defined by three numbers. Now usually a vector is used to define a place in the world, or the direction of a force, velocity, etc. In this case it has a different meaning.

It defines three numeric values. Each value defines which entries to display. The first number defines which text entries to display. The second defines the images to display and the third the audio files.

I'm really sorry, but we have to dipp our toes in computer science. Those three numbers contain so called flags. This is a design pattern (technique) to store versatile information in a single number. It basically allows you to store boolean values (true/false) and retrieve them. The trick is powers of 2. Here's an example:

Now, in order to store a "meal order" in a single numeric value all you have to do is add the flag values. If we want a steak with a coke and no extras we add 2 and 8, the result is 10. A 10 uniquely identifies the flag values for a coke and a steak, nothing else.
The flag values are powers of 2, so the first is 1, then 2, 4, 8, 16, 32, 64, 128 and so on. Simply multiplay each number with 2 to get the next.

Now back to our datapad. Imagine each entry representing a text in the text.cfg is numerated like a list, but with powers of 2. Here's an example:

If you want your datapad to display all of those you have to add all the flag values and put them in the first generic string. Here, all summed up would be 1+2+4+8=15.

The generic vector is therefor:

Or as a complete entry:

And that's it. The reason the devs chose this aproach is to allow one text.cfg file that can supply several datapds with different information.

P.S.: The reason why the max number of text (or any other) items is 32 is that 2 power 32 is the highest number that a (32-bit) computer can store. I tell you that only to assure you the devs didn't chose the limitation out of a bad mood or something.

I hope this helps you. Have fun experimenting.