Grey Alien BlitzMax Game Framework for sale!

How To Play
-----------

Just move left and right and shoot the UFOs with Z, that's it for now...

Keys
----

Press <Esc> to exit the game.
Press <F> to toggle full screen/windowed mode.
Press <V> to toggle VSync on/off.
Press <D> to bring up the debug display
Whilst in debug mode, press <T> to toggle full speed.
Whilst in debug mode, press <L> to toggle slow motion.
Whilst in debug mode, press <I> to toggle Flip modes.
Whilst in debug mode, press <A> to toggle anti-lag fix.
Press <P> to pause the game.
Press <Q> to quit the game.
Press <S> to toggle sound on/off.
Press <M> to toggle music on/off.
Press <-> and <=> to adjust sound volume.
Press <F12> to take a screenshot.
Press <Ctrl+X> to exit the game instantly.

- Smooth Fixed Rate Logic timing.
- Dynamically change between Full-Screen and Windowed Mode.
- Windowed mode has working minimise and close buttons.
- Game and music pauses whenever focus is lost.
- Full icon support.
- Ini file to save user settings.
- Extensive debug suite.
- Take screenshots with F12.
- Integrated mouse pointer.
- Sound and music functions.
- Sprite type.
- Button type.
- Menu type.
- Splash screen.
- Loading screen.
- Title screen.
- Fully working options screen.
- Load, save and enter High Scores.
- Other example screens such as Game Over and Credits.
- Example types such as Player, Bullet, Alien etc.
- Fast fade.
- Manage multiple game screens easily.
- BlitzMax fixes and workarounds.
- And more!

*Timing*

- Extra smooth Fixed Rate Logic (an alternative to Delta Timing).
Your game will run the same speed on all systems regardless of
refresh rate/VSync and in windowed or full-screen mode.
- If anything occurs which causes a big delay, such as loading
music or changing screen mode or dragging the window etc., the
Fixed Rate Logic will reset its timing variables to avoid any
skipping caused by the time delay.

*Full-Screen/Windowed Mode*
- Switch between full-screen and windowed mode easily on-the-fly.
- Automatically chooses graphics mode. Will reduce from
full-screen 32-bit to 24-bit to 16-bit, then to windowed mode,
and will finally error nicely if nothing is supported.
- DirectX rendering lag has been fixed.
- Option to prevent vertical tearing in windowed mode (on some
systems).
- Windowed mode has minimise button.
- Windowed mode has a working close button.
- The window is automatically centred on the desktop.
- When game is minimised or focus is lost (even in full-screen
mode) the game and music are paused, yet the screen will still
redraw to avoid Windows overwriting it. The game and music
will resume when the window is restored or refocused.
- When the game is in windowed mode and the user clicks in
another window, the game and music will pause and the screen
will display "Paused" until the user clicks back in the window.
- Moving the mouse onto the title bar will show the default
Windows cursor so that you can click on minimise and close etc.
This is NOT default Blitz Max behaviour!
- Windowed mode uses Delay(1) so that Windows can have some CPU
power each frame. This stops other applications from running
slowly when the Game Framework is running.

*Icon*
- Icon will show on title bar, task bar, and when alt+tabbing.
- Exe can have icon built in (needs some external work)

*Ini File*

- Important variables are stored in an auto-generated,
auto-repairing ini file. This means that you can save options
such as Full Screen On/Off, Music and Sound volumes, Particle
Quality etc. and have them load in each time the game is run.
The ini file is automatically updated whenever a user changes
an ini variable, such as when they change screen mode or
volume etc.

*Debug*

- Display Debug variables anywhere on-screen, including:
- Logic Time
- Draw Time
- FPS
- Desktop Hz
- Game Hz
- Fixed Rate Logic Ticks
- Lag Fix (on/off)
- Flip mode (-1,0,1)
- Fast (on/off)
- Slow Motion (on/off)
- VSync (on/off)
- Memory Allocated
- Music Volume (0-100)
- Sound Volume (0-100)
- FPS Counter.
- Fast on/off toggle. Good for testing maximum frame rate.
- Slow Motion mode. Runs at 25% (or user-defined speed), good
for testing movement and animation.
- Toggle Direct X Lag Fix
- Toggle Flip modes
- VSync toggle.

*Functionality*

- Screenshot with F12.
- Quick Exit key for developers.
- Toggle VSync On/Off (user can do this)
- Boss Key automatically minimises and pauses game and music, even
in full-screen mode.
- Sound and music on/off hot keys.
- Adjust music volume and sound volume separately.
- Pause Key. Also pauses and resumes music (if any is playing).
Also shows a paused image on-screen (if an image is assigned).
- Protection against two copies of game running at once.
- Current Screen and Destination Screen are tracked to enable
a clever centralised screen change function to be used.
- Ability to play a sound when escape is pressed to exit from
a screen.

*Other Useful Types*
- TMousePointer handles loading a cursor, getting mouse values
once per logic loop (to ensure constant coords and button
readings), supports offsets for where point is not in top left,
and slides the game cursor smoothly off the edges of the window
instead of leaving it at the last known position.
- TSprite includes animation, brightness, scale and rotation
capabilities.
- TButton with mouse-over graphic, sound and management code.
- TGameSound incorporates name, pitch and volume.
- TSoundBank for easy storage and retrieval of sounds.
- TGameImage incorporates name, width and height.
- TImageBank for easy storage and retrieval of images.
- TGameFade fades the screen and music without any GrabImage
delay. The fade is tied into the game timing so it will pause
if the game is paused or suspended, plus you can optionally fade
a still or animated screen. The fade can be skipped with a key
press or mouse click. An ini flag can be disabled to skip
fades; this is useful for developers.
- TMenu allows you to easily group together and manage several
buttons, and to track which one the user clicked.
- TScreen includes background image, header, menu and default
behaviour so that you can extend it for other screens.
- THighScoreList loads and saves high scores.
- TTextInput allows user to input text such as their name.

*Splash screens*
- Splash screen with fade image and sound in/out functionality.
- Support for a publisher/portal splash screen.

*Loading screen*
- Loading screen with a loading bar supported.
- After Loading is complete, the loading bar is optionally
replaced with a "Click here to play" button.

*Title screen*
- Example title screen with music and a menu that launches other
screens as well as exiting the game.

*Options screen*
- Fully working options screen including separate music and sound
volumes, full-screen toggle, vsync toggle and particles level.
It also has a button which shows the credits screen.

*Example Types*
- TExplosion extends TSprite, and TExplosionList.
- TPlayer extends TSprite and has shield bar and lives, and when
you die you are taken to the game over screen.
- TBullet extends TSprite, and TBulletList.
- TAlien extends TSprite, and TAlienList.
- TInstructionScreen extends TScreen
- TCreditsScreen extends TScreen
- TGameOverScreen extends TScreen

' -----------------------------------------------------------------------------
' ccFixLag()
' -----------------------------------------------------------------------------
Function ccFixLag()
	'This fixes the annoying DirectX7 rendering lag in BlitzMax
	?Win32
		If TD3D7Max2DDriver(_max2dDriver)
			Local sdesc:DDSurfaceDesc2 = New DDSurfaceDesc2
			sdesc.dwSize = SizeOf(sdesc)
			Local res:Int = PrimaryDevice.backbuffer.Lock(Null,sdesc,DDLOCK_WAIT|DDLOCK_READONLY,Null)
			PrimaryDevice.backbuffer.unlock(Null)
			Return res
		EndIf
	?
End Function