WGT v4.0 Troubleshooting
------------------------


Linker Errors:		Unrecognized symbol

		You must place all the WGT LIB files in the proper LIB
		directory for your compiler. The H files must go in the
		include directory as well.

		You MUST create a project file for any programs which require
		a LIB or OBJ to be linked. In the project file, place your
		C source filename, plus the filenames of the LIBs which
		are required for program execution.

Problem:        I compiled my program with the small memory model and
                realized it needed to be large.  I switched the model to
                large and it still doesn't work.  What's wrong?

                Unless you modified the source code, the IDE will not
                recompile the C code into an OBJ file.  You must delete
                your old OBJ files and recompile the program in the large
                memory model.


Compiler Warnings:	Suspicious pointer conversion
		
		Generally, you can disable the warnings for these messages
		in the compiler options. As long as there are simply warnings
		and no errors, the code is considered acceptable.



Program Output:		Garbled Display

		The program has run out of memory and cannot allocate dynamic
		RAM for image display. You may either exit the IDE and run
		the program from DOS, or you can increase the project's RAM
		limit by increasing the program heap size to 640k. This option
		can be found in the OPTIONS / DEBUGGER menu.

		It is also possible that an external data file could not be
		loaded because it was not found. Make sure that the directory
		you are executing the program from contains the necessary data
		files.



Misc. Problems:
---------------

Problem:  When I set the palette with wsetpalette, all the colors remain
	  black.
Solution: You should have set the palette beforehand, with wsetrgb,
	  or wloadpalette. If you have set the palette, make sure the 
          palette file was found if you are loading it in.




Problem:  When I use the fade_in, fade_out, or wsetpalette functions,
	  the screen flickers and "snow" appears. What is happening?

Solution: This screen disturbance occurs when you set the palette entries.
	  There is no way to get rid of the snow completely, however
	  there are a few things you can do. Try setting fewer palette
	  entries at once, and use a larger delay if you are fading the
	  colors in or out.




Problem:  My program compiles fine, but it gives me a stack overflow error
	  when I run it.

Solution: Make sure you compile your program using the large memory model.



Problem:  My program gives me an out of memory or out of heap space error.

Solution: Set the heap size under the Options/Debugger menu to a large
          number (try 640). This will change how much memory Turbo C gives it
	  when it runs. For the maximum amount, set it to 640. This will
	  make sure you can run very large programs.  If that doesn't
	  work, try running it from DOS, or cut down the memory
	  needed temporarily.



Problem:  Some of the example files do not seem to work right, and I
	  must use a control break to end.

Solution: Many of the example programs require a mouse to operate.
	  If you do not have a mouse, you will not be able to use
	  that particular program. Browse through the program to see
	  what exactly it is looking for to continue.  Sometimes
	  it is waiting for a keypress which you did not hit.



Problem:  When I display a sprite or a block on the screen, a mess
	  appears.

Solution: The block file or sprite file you loaded in was not found.
	  When you attempt to display the block or sprite, the data
	  in memory is undefined and it displays whatever was in
	  memory at that address before you ran your program.
	  Check to see the paths are correct in your load statements.
	  This error is common when you have first installed WGT
	  on your hard drive since it will depend on where you
	  copied the files.  You need to change the pathnames in
	  any operations which load a file.

          This will also occur when you run out of memory.



Problem:  When using the scrolling library, my objects do not show up
	  on top of the background.

Solution: Make sure you compile your program with word alignment OFF. To do
          this, set the option under Options/Compiler/Code Generation, or
	  use the appropriate switch from the command line compiler.
          Also make sure the correct sprite files have been loaded, and
          if using EMS, the wemsobjects flag is set.




Problem:  When using scrolling library, any drawing commands used on the
          visual screen to not appear.

Solution: The scrolling library alters the active video page and clipping
          boundaries.  Reset them with wnormscreen and wclip(0,0,319,199).



		
