MCS' Coding Tips
                 "Success!"



  
Enabling in-game help text and end text (ReadThis!)

   Written by MCS
   Tested by Quinnsey


   
Main Page

News

Wolfenstein 3D
Texture Library


MCS' Coding
Tips - "Success"!


Utilities

Spear
Resurrection


Wolfendoom

Wolf
Collection


Original Wolf 3D

Doom/Duke
maps


Other Stuff

Links

Questions?
Email us!
If you ever played the original version of Wolfenstein 3D, you will remember the in-game help text and end text with some graphics from the game.
In the distributed source code package, this option has been disabled by default. However, it's possible to reenable this feature, so you can create your own help and end text to include in your add-on.
There was already a way to accomplish this, but the whole enabling scheme seems unnecessarily complex. Here's a very simple way to do it:


Open the file VERSION.H and remove these two lines:

#define ARTSEXTERN
#define GOODTIMES


Codewise, that's all!
Now there's only one more thing you have to do. Download the sample files
HELPART.WL6 and ENDART1.WL6 here. Put them in your Wolf data directory and open them in a text editor.
Now you can add your own text, graphics and colors. To do so, you'll need the following:


TEXT FORMATTING COMMANDS

^C<hex digit>                     Change text color
^E[enter]                              End of layout (all pages)
^G<y>,<x>,<pic>[enter]     Draw a graphic and push margins
^P[enter]                              Start new page, must be the first chars in a layout
^L<x>,<y>[ENTER]             Locate to a specific spot, x in pixels, y in lines


The <pic> value follows the order in which the graphics appear in VGAGRAPH. Open FloEdit, connect to your project and choose Graphics-Images. Note that values 1 and 2 are reserved for internal use, so if you want the first image in VGAGRAPH to appear in your helptext, enter 3 as a <pic> value, etc.
Just experiment a little with this, until you'll get the hang of it. It's not that difficult.

N.B. You'll notice that if you'll enable the ReadThis feature this way, you will also restore the so-called NonShareware notice.
Start up your game and you'll see it right after the signon screen.
If you don't want this screen at all, here's how to get rid of it:


Open WL_MAIN.C and do a search for

if (!NoWait)
   NonShareware();


and remove both of these lines.

If you want to keep this screen, and have your own customized message instead of the shareware notice:


Open WL_INTER.C and do a search for

#ifndef SPANISH
US_Print("Atencion");
#else
US_Print("Attention");
#endif

SETFONTCOLOR(HIGHLIGHT,BKGDCOLOR);
WindowX=PrintX=40;
PrintY=60;
#ifndef SPANISH
US_Print("Este juego NO es gratis y\n");
US_Print("NO es Shareware; favor de\n");
US_Print("no distribuirlo.\n\n");
#else
US_Print("This game is NOT shareware.\n");
US_Print("Please do not distribute it.\n");
US_Print("Thanks.\n\n");

#endif
US_Print("        Id Software\n");

VW_UpdateScreen ();
VW_FadeIn();
IN_Ack();


and change the English text in there to your likings. Be careful, most lines end with "\n" these represent line feeds and carriage returns, and they have to stay intact.

Success!
MCS.