389 lines
17 KiB
C
389 lines
17 KiB
C
/***************************************************************************
|
|
help.c - description
|
|
-------------------
|
|
begin : Sat Dec 15 2001
|
|
copyright : (C) 2001 by Michael Speck
|
|
email : kulkanie@gmx.net
|
|
***************************************************************************/
|
|
|
|
/***************************************************************************
|
|
* *
|
|
* This program is free software; you can redistribute it and/or modify *
|
|
* it under the terms of the GNU General Public License as published by *
|
|
* the Free Software Foundation; either version 2 of the License, or *
|
|
* (at your option) any later version. *
|
|
* *
|
|
***************************************************************************/
|
|
|
|
#include "lbreakout.h"
|
|
#include "config.h"
|
|
#include "event.h"
|
|
|
|
StkFont *help_caption_font = 0;
|
|
StkFont *help_font = 0;
|
|
SDL_Surface *help_bkgnd = 0;
|
|
int side_count = 4;
|
|
|
|
extern SDL_Surface *stk_display;
|
|
extern SDL_Surface *extra_pic;
|
|
extern SDL_Surface *brick_pic;
|
|
extern int stk_quit_request;
|
|
extern Config config;
|
|
|
|
/*
|
|
====================================================================
|
|
Locals
|
|
====================================================================
|
|
*/
|
|
|
|
/*
|
|
====================================================================
|
|
Draw title.
|
|
====================================================================
|
|
*/
|
|
void draw_title( )
|
|
{
|
|
help_caption_font->align = STK_FONT_ALIGN_CENTER_X | STK_FONT_ALIGN_TOP;
|
|
stk_font_write( help_caption_font,
|
|
stk_display, stk_display->w / 2, 20, STK_OPAQUE, _("Quick Help") );
|
|
}
|
|
/*
|
|
====================================================================
|
|
Add footnote.
|
|
====================================================================
|
|
*/
|
|
void draw_footnote( int side )
|
|
{
|
|
char buf[256];
|
|
help_font->align = STK_FONT_ALIGN_RIGHT | STK_FONT_ALIGN_BOTTOM;
|
|
sprintf( buf, "%i / %i", side, side_count );
|
|
stk_font_write( help_font, stk_display,
|
|
stk_display->w - 2, stk_display->h - 2, STK_OPAQUE, buf );
|
|
help_font->align = STK_FONT_ALIGN_LEFT | STK_FONT_ALIGN_BOTTOM;
|
|
sprintf( buf, _("<ESCAPE>: Quit <LEFT BUTTON>: Next Page <RIGHT BUTTON>: Previous Page") );
|
|
stk_font_write( help_font,
|
|
stk_display, 2, stk_display->h - 2, STK_OPAQUE, buf );
|
|
}
|
|
|
|
/*
|
|
====================================================================
|
|
Draw bonus info
|
|
====================================================================
|
|
*/
|
|
void draw_bonus_info( int x, int y, int id, char *text )
|
|
{
|
|
stk_surface_blit(
|
|
extra_pic, id * BRICK_WIDTH, 0, BRICK_WIDTH, BRICK_HEIGHT,
|
|
stk_display, x, y );
|
|
help_font->align = STK_FONT_ALIGN_LEFT | STK_FONT_ALIGN_CENTER_Y;
|
|
stk_font_write( help_font, stk_display,
|
|
x + BRICK_WIDTH + 10, y + BRICK_HEIGHT / 2, STK_OPAQUE, text );
|
|
}
|
|
|
|
/*
|
|
====================================================================
|
|
Draw brick info
|
|
====================================================================
|
|
*/
|
|
void draw_brick_info( int x, int y, int id, char *text )
|
|
{
|
|
stk_surface_blit(
|
|
brick_pic, id * BRICK_WIDTH, 0, BRICK_WIDTH, BRICK_HEIGHT,
|
|
stk_display, x, y );
|
|
help_font->align = STK_FONT_ALIGN_LEFT | STK_FONT_ALIGN_CENTER_Y;
|
|
stk_font_write( help_font, stk_display,
|
|
x + BRICK_WIDTH + 10, y + BRICK_HEIGHT / 2, STK_OPAQUE, text );
|
|
}
|
|
|
|
/*
|
|
====================================================================
|
|
Draw bonus info screen.
|
|
====================================================================
|
|
*/
|
|
void draw_bonus_screen()
|
|
{
|
|
int bonus_x = 20, bonus_y = 80, bonus_w = 200, bonus_h = 30;
|
|
int malus_x = 20, malus_y = 330, malus_w = 200, malus_h = 30;
|
|
|
|
stk_surface_blit( help_bkgnd, 0,0,-1,-1, stk_display, 0,0 );
|
|
draw_title();
|
|
|
|
/* bonuses */
|
|
help_caption_font->align = STK_FONT_ALIGN_LEFT | STK_FONT_ALIGN_TOP;
|
|
stk_font_write( help_caption_font,
|
|
stk_display, bonus_x, bonus_y - 30, STK_OPAQUE, _("Bonuses:") );
|
|
draw_bonus_info( bonus_x + bonus_w * 0, bonus_y + bonus_h * 0, 8, _("Expand paddle") );
|
|
draw_bonus_info( bonus_x + bonus_w * 1, bonus_y + bonus_h * 0, 9, _("Extra life") );
|
|
draw_bonus_info( bonus_x + bonus_w * 2, bonus_y + bonus_h * 0, 10, _("Sticky paddle") );
|
|
draw_bonus_info( bonus_x + bonus_w * 0, bonus_y + bonus_h * 1, 15, _("Plasma weapon") );
|
|
draw_bonus_info( bonus_x + bonus_w * 1, bonus_y + bonus_h * 1, 2, _("200 - 10,000 points extra score") );
|
|
draw_bonus_info( bonus_x + bonus_w * 0, bonus_y + bonus_h * 2, 12, _("Extra ball") );
|
|
draw_bonus_info( bonus_x + bonus_w * 1, bonus_y + bonus_h * 2, 11, _("Energy balls (penetrate bricks)") );
|
|
draw_bonus_info( bonus_x + bonus_w * 0, bonus_y + bonus_h * 3, 13, _("Bonus floor") );
|
|
draw_bonus_info( bonus_x + bonus_w * 1, bonus_y + bonus_h * 3, 18, _("Deccelerate balls to minimum speed") );
|
|
draw_bonus_info( bonus_x + bonus_w * 0, bonus_y + bonus_h * 4, 6, _("1,000 points extra score from bricks with no bonus") );
|
|
draw_bonus_info( bonus_x + bonus_w * 0, bonus_y + bonus_h * 5, 19, _("Instantly collect all bonuses and destroy all penalties") );
|
|
draw_bonus_info( bonus_x + bonus_w * 0, bonus_y + bonus_h * 6, 25, _("Explosive balls") );
|
|
draw_bonus_info( bonus_x + bonus_w * 1, bonus_y + bonus_h * 6, 26, _("Paddle attracts bonuses") );
|
|
|
|
/* penalties */
|
|
stk_font_write( help_caption_font, stk_display,
|
|
malus_x, malus_y - 30, STK_OPAQUE, _("Penalties:") );
|
|
draw_bonus_info( malus_x + malus_w * 0, malus_y + malus_h * 0, 7, _("Shrink paddle") );
|
|
draw_bonus_info( malus_x + malus_w * 0, malus_y + malus_h * 3, 17, _("Accelerate balls") );
|
|
draw_bonus_info( malus_x + malus_w * 0, malus_y + malus_h * 1, 14, _("Freeze paddle") );
|
|
draw_bonus_info( malus_x + malus_w * 1, malus_y + malus_h * 1, 21, _("Random ball reflection at bricks") );
|
|
draw_bonus_info( malus_x + malus_w * 0, malus_y + malus_h * 2, 20, _("Darkness") );
|
|
draw_bonus_info( malus_x + malus_w * 1, malus_y + malus_h * 2, 27, _("Paddle attracts penalties") );
|
|
draw_bonus_info( malus_x + malus_w * 1, malus_y + malus_h * 0, 22, _("Paddle disappears when not moving") );
|
|
draw_bonus_info( malus_x + malus_w * 1, malus_y + malus_h * 3, 28, /* xgettext:no-c-format */ _("40% chance that a ball doesn't damage brick") );
|
|
|
|
draw_footnote( 1 );
|
|
|
|
stk_display_update( STK_UPDATE_ALL );
|
|
}
|
|
/*
|
|
====================================================================
|
|
Draw hint
|
|
====================================================================
|
|
*/
|
|
void draw_hint( int x, int y, char *text )
|
|
{
|
|
stk_font_write( help_font, stk_display,
|
|
x, y, STK_OPAQUE, text );
|
|
}
|
|
/*
|
|
====================================================================
|
|
Draw hints
|
|
====================================================================
|
|
*/
|
|
void draw_hints_screen()
|
|
{
|
|
int hint_x = 20, hint_y = 80, hint_h = 20;
|
|
|
|
stk_surface_blit( help_bkgnd, 0,0,-1,-1, stk_display, 0,0 );
|
|
draw_title();
|
|
|
|
help_caption_font->align = STK_FONT_ALIGN_LEFT | STK_FONT_ALIGN_TOP;
|
|
stk_font_write( help_caption_font, stk_display,
|
|
hint_x, hint_y - 40, STK_OPAQUE, _("Hints:") );
|
|
|
|
draw_hint( hint_x, hint_y + hint_h * 0, _("<<'In Game'-Keys>>") );
|
|
draw_hint( hint_x, hint_y + hint_h * 1, _(" p Pause game. (and enter chatroom in network game)") );
|
|
draw_hint( hint_x, hint_y + hint_h * 2, _(" s Enable/Disable sound.") );
|
|
draw_hint( hint_x, hint_y + hint_h * 3, _(" a Change animation level (off/low/high).") );
|
|
draw_hint( hint_x, hint_y + hint_h * 4, _(" f Switch fullscreen/windowed mode.") );
|
|
draw_hint( hint_x, hint_y + hint_h * 5, _(" NOTE: Changing resolution takes a while so this is done best") );
|
|
draw_hint( hint_x, hint_y + hint_h * 6, _(" when game's paused.") );
|
|
draw_hint( hint_x, hint_y + hint_h * 7, _(" r Restart level.") );
|
|
draw_hint( hint_x, hint_y + hint_h * 8, _(" d Disintegrate single bricks. (AddOn's only)") );
|
|
draw_hint( hint_x, hint_y + hint_h * 9, _(" w Warp to next level after enough bricks where cleared. (AddOn's only)") );
|
|
draw_hint( hint_x, hint_y + hint_h * 10, _(" Shift Shows highest score of set instead of your score as long as you") );
|
|
draw_hint( hint_x, hint_y + hint_h * 11, _(" hold it down.") );
|
|
draw_hint( hint_x, hint_y + hint_h * 12, _(" Tab Take a screenshot.") );
|
|
draw_hint( hint_x, hint_y + hint_h * 13, _(" Esc Quit game.") );
|
|
|
|
draw_hint( hint_x, hint_y + hint_h * 15, _("Pressing the left or right mouse button will fire attached balls either") );
|
|
draw_hint( hint_x, hint_y + hint_h * 16, _("to the left or right direction if 'Ball Fire Angle' in 'Advanced Options'") );
|
|
draw_hint( hint_x, hint_y + hint_h * 17, _("is not set to 'Random'.") );
|
|
|
|
draw_footnote( 3 );
|
|
|
|
stk_display_update( STK_UPDATE_ALL );
|
|
}
|
|
/*
|
|
====================================================================
|
|
Draw ingame hints
|
|
====================================================================
|
|
*/
|
|
void draw_ingame_hints_screen()
|
|
{
|
|
int brick_x = 20, brick_y = 210, brick_h = 30;
|
|
int extra_x = 20, extra_y = 80, extra_h = 30;
|
|
|
|
stk_surface_blit( help_bkgnd, 0,0,-1,-1, stk_display, 0,0 );
|
|
draw_title();
|
|
|
|
help_caption_font->align = STK_FONT_ALIGN_LEFT | STK_FONT_ALIGN_TOP;
|
|
stk_font_write( help_caption_font, stk_display,
|
|
extra_x, extra_y - 30, STK_OPAQUE, _("Neutral Power-Ups:") );
|
|
|
|
draw_bonus_info( extra_x, extra_y + extra_h * 0, 16, _("Any of the listed bonuses/penalties.") );
|
|
draw_bonus_info( extra_x, extra_y + extra_h * 1, 23, _("Resets all active bonuses and penalties.") );
|
|
draw_bonus_info( extra_x, extra_y + extra_h * 2, 24, _("Adds 7 seconds to all active bonuses/penalties.") );
|
|
|
|
help_caption_font->align = STK_FONT_ALIGN_LEFT | STK_FONT_ALIGN_TOP;
|
|
stk_font_write( help_caption_font, stk_display,
|
|
brick_x, brick_y - 30, STK_OPAQUE, _("Special Bricks:") );
|
|
|
|
draw_brick_info( brick_x, brick_y + brick_h * 0, 0, _("Indestructible.") );
|
|
draw_brick_info( brick_x, brick_y + brick_h * 1, 1, _("May only be destroyed by energy ball else it's indestructible.") );
|
|
draw_brick_info( brick_x, brick_y + brick_h * 2, 2, _("As above and balls are reflected randomly at this brick.") );
|
|
draw_brick_info( brick_x, brick_y + brick_h * 3, 5, _("Needs three hits to be destroyed.") );
|
|
draw_brick_info( brick_x, brick_y + brick_h * 4, 9, _("As above and regenerates durability every 4 seconds.") );
|
|
draw_brick_info( brick_x, brick_y + brick_h * 5, 18, _("Explodes and destroys all nearby bricks.") );
|
|
draw_brick_info( brick_x, brick_y + brick_h * 6, 19, _("Creates up to 8 bricks on destruction.") );
|
|
|
|
draw_footnote( 2 );
|
|
|
|
stk_display_update( STK_UPDATE_ALL );
|
|
}
|
|
/*
|
|
====================================================================
|
|
Draw trouble shooting
|
|
====================================================================
|
|
*/
|
|
void draw_trouble( int x, int y, char *text )
|
|
{
|
|
draw_hint( x, y, text );
|
|
}
|
|
void draw_trouble_screen()
|
|
{
|
|
int trouble_x = 20, trouble_y = 90, trouble_h = 20;
|
|
int manual_x = 20, manual_y = 310, manual_h = 20;
|
|
stk_surface_blit( help_bkgnd, 0,0,-1,-1, stk_display, 0,0 );
|
|
draw_title();
|
|
|
|
help_caption_font->align = STK_FONT_ALIGN_LEFT | STK_FONT_ALIGN_TOP;
|
|
stk_font_write( help_caption_font, stk_display,
|
|
trouble_x, trouble_y - 40, STK_OPAQUE, _("Troubleshooting:") );
|
|
|
|
draw_trouble( trouble_x, trouble_y + trouble_h * 0, _("* In fullscreen mode the window keeps it size just adding a black frame?") );
|
|
draw_trouble( trouble_x, trouble_y + trouble_h * 1, _(" - Maybe you do not have 640x480 as resolution available? Check your") );
|
|
draw_trouble( trouble_x, trouble_y + trouble_h * 2, _(" X configuration.") );
|
|
draw_trouble( trouble_x, trouble_y + trouble_h * 3, _("* Sounds seem to be out of sync and are played with some delay?") );
|
|
draw_trouble( trouble_x, trouble_y + trouble_h * 4, _(" - Set SDL_AUDIODRIVER to dma (export SDL_AUDIODRIVER=dma). If this results") );
|
|
draw_trouble( trouble_x, trouble_y + trouble_h * 5, _(" in a lot of errors killing artsd (or esd) may help.") );
|
|
draw_trouble( trouble_x, trouble_y + trouble_h * 6, _("* LBreakout2 gets mute while playing when switching on/off sounds?") );
|
|
draw_trouble( trouble_x, trouble_y + trouble_h * 7, _(" - SDL_mixer seems to mute active channels. You shouldn't enable/disable") );
|
|
draw_trouble( trouble_x, trouble_y + trouble_h * 8, _(" sounds to often as you'll propably loose all channels then.") );
|
|
|
|
help_caption_font->align = STK_FONT_ALIGN_LEFT | STK_FONT_ALIGN_TOP;
|
|
stk_font_write( help_caption_font, stk_display,
|
|
manual_x, manual_y - 40, STK_OPAQUE , _("Manual:"));
|
|
draw_trouble( manual_x, manual_y + manual_h * 0, _("This is just a quick help with the most important facts about LBreakout2.") );
|
|
draw_trouble( manual_x, manual_y + manual_h * 1, _("If you want more and better information check out the manual installed to") );
|
|
draw_trouble( manual_x, manual_y + manual_h * 2, _("/usr/doc/lbreakout2 or the online version at http://lgames.sf.net.") );
|
|
draw_trouble( manual_x, manual_y + manual_h * 3, _("And if you have questions (not answered by the manual) or you found a bug") );
|
|
draw_trouble( manual_x, manual_y + manual_h * 4, _("or you just want to drop a general note about LBreakout2 just mail to:") );
|
|
draw_trouble( manual_x, manual_y + manual_h * 5, _(" kulkanie@gmx.net") );
|
|
draw_trouble( manual_x, manual_y + manual_h * 6, _(" Enjoy the game!") );
|
|
draw_trouble( manual_x, manual_y + manual_h * 6 + 10, _(" Michael Speck") );
|
|
|
|
draw_footnote( 4 );
|
|
|
|
stk_display_update( STK_UPDATE_ALL );
|
|
}
|
|
|
|
/*
|
|
====================================================================
|
|
Publics
|
|
====================================================================
|
|
*/
|
|
|
|
/*
|
|
====================================================================
|
|
Load/delete help resources.
|
|
====================================================================
|
|
*/
|
|
void help_create()
|
|
{
|
|
help_font = stk_font_load( SDL_SWSURFACE, "f_small_yellow.png" );
|
|
SDL_SetColorKey( help_font->surface, SDL_SRCCOLORKEY,
|
|
stk_surface_get_pixel( help_font->surface, 0,0 ) );
|
|
help_caption_font = stk_font_load( SDL_SWSURFACE, "f_yellow.png" );
|
|
SDL_SetColorKey( help_caption_font->surface, SDL_SRCCOLORKEY,
|
|
stk_surface_get_pixel( help_caption_font->surface, 0,0 ) );
|
|
/* background -- will be filled when running help */
|
|
help_bkgnd = stk_surface_create( SDL_SWSURFACE, stk_display->w, stk_display->h );
|
|
SDL_SetColorKey( help_bkgnd, 0, 0 );
|
|
}
|
|
void help_delete()
|
|
{
|
|
stk_font_free( &help_font );
|
|
stk_font_free( &help_caption_font );
|
|
stk_surface_free( &help_bkgnd );
|
|
}
|
|
|
|
/*
|
|
====================================================================
|
|
Run help.
|
|
====================================================================
|
|
*/
|
|
static void help_draw_side( int side_id )
|
|
{
|
|
switch ( side_id ) {
|
|
case 0: draw_bonus_screen(); break;
|
|
case 2: draw_hints_screen(); break;
|
|
case 1: draw_ingame_hints_screen(); break;
|
|
case 3: draw_trouble_screen(); break;
|
|
}
|
|
}
|
|
void help_run()
|
|
{
|
|
int leave = 0;
|
|
SDL_Event event;
|
|
int cur_side = 0;
|
|
SDL_Surface *buffer =
|
|
stk_surface_create(SDL_SWSURFACE,stk_display->w, stk_display->h);
|
|
|
|
/* buffer screen */
|
|
stk_surface_blit( stk_display, 0,0,-1,-1, buffer, 0,0 );
|
|
SDL_SetColorKey(buffer, 0, 0);
|
|
|
|
/* gray screen and use as background */
|
|
stk_surface_gray( stk_display, 0,0,-1,-1, 1 );
|
|
stk_surface_blit( stk_display, 0,0,-1,-1, help_bkgnd, 0,0 );
|
|
|
|
draw_bonus_screen();
|
|
while ( !leave && !stk_quit_request) {
|
|
SDL_WaitEvent( &event );
|
|
switch ( event.type ) {
|
|
case SDL_QUIT: stk_quit_request = 1; break;
|
|
case SDL_KEYDOWN:
|
|
switch ( event.key.keysym.sym ) {
|
|
case SDLK_ESCAPE: leave = 1; break;
|
|
case SDLK_LEFT:
|
|
case SDLK_RIGHT:
|
|
if ( event.key.keysym.sym == SDLK_RIGHT ) {
|
|
cur_side++;
|
|
if ( cur_side == side_count ) cur_side = 0;
|
|
}
|
|
else {
|
|
cur_side--;
|
|
if ( cur_side < 0 ) cur_side = side_count - 1;
|
|
}
|
|
help_draw_side(cur_side);
|
|
break;
|
|
case SDLK_f:
|
|
config.fullscreen = !config.fullscreen;
|
|
stk_display_apply_fullscreen( config.fullscreen );
|
|
help_draw_side(cur_side);
|
|
break;
|
|
default: break;
|
|
}
|
|
break;
|
|
case SDL_MOUSEBUTTONUP:
|
|
if ( event.button.button == STK_BUTTON_LEFT ) {
|
|
cur_side++;
|
|
if ( cur_side == side_count ) cur_side = 0;
|
|
}
|
|
else {
|
|
cur_side--;
|
|
if ( cur_side < 0 ) cur_side = side_count - 1;
|
|
}
|
|
help_draw_side(cur_side);
|
|
break;
|
|
default: break;
|
|
}
|
|
}
|
|
|
|
/* redraw screen */
|
|
stk_surface_blit( buffer, 0,0,-1,-1, stk_display, 0,0 );
|
|
stk_display_update( STK_UPDATE_ALL );
|
|
SDL_FreeSurface( buffer );
|
|
|
|
/* reset the relative position so paddle wont jump */
|
|
SDL_GetRelativeMouseState(0,0);
|
|
}
|