README.txt for popstar

"Pop Star"

by Bill Kendrick
bill@newbreedsoftware.com
http://www.newbreedsoftware.com/

June 27, 2006 - September 30, 2007

About
-----
"Pop Star" is a simple puzzle game where you must use floating stars to
form polygons.  The stars are continuously moving, which makes this tricky.
Various opportunities exist to gain bonus points.

FIXME: No scoring has been coded yet!

Playing
-------
  Controls
  --------
  Use the arrow keys ([Up], [Down], [Left] and [Right]) to move the flashing
  cursor from one star to the next.  The cursor will try to move to the next
  closest star in the direction you pressed.

  Press [Enter] or [Space] to 'select' the star that the cursor is following.

  Alternatively, you can use the mouse and click stars to select them.

  Forming Polygons
  ----------------
  As you select the stars, they are connected by lines.  When the lines
  form a polygon (that is, three or more stars connected), the stars
  disappear ('pop'), and you earn points.  The more stars involved in the
  formation, the more points you earn.  FIXME.

  Breaking Formations
  -------------------
  As the stars move around the screen, the shape of the polygon you're
  forming changes.  If two lines intersect (not counting the line between
  the last selected star, and the cursor, which flashes), they'll be
  destroyed, and the stars will break free.

  Capturing Stars
  ---------------
  Bonus points are scored for any stars that are 'caught' by the polygon.
  FIXME.

  Completing the Level
  --------------------
  If at least three stars remain on the screen, the cursor is automatically
  moved to the closest one.  If less than three remain, you advance to the next
  level.

  If all stars have been destroyed, either by being used to form polygons, or
  being captured by polygon formations, you receive bonus points at the end
  of the level, and "Level Complete" appears on the screen.  FIXME.

  If only one or two stars are left at the end of a level (not enough to
  form another polygon), you don't receive any bonus points, and
  "You Missed Some" appears on the screen.

Scoring
-------
FIXME: No scoring has been coded yet!

Credits
-------
See AUTHORS.txt.

PERMISSION  UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP     NAME
---------- ----------- ------- ------- ------ ---------- ------------ ----------
[generic]                 1374    2650  51.8% -lh5- 595d May  7  2007 popstar-0.0.2/docs/AUTHORS.txt
[generic]                  374     597  62.6% -lh5- 4d3a Oct  1  2007 popstar-0.0.2/docs/CHANGES.txt
[generic]                 7116   20596  34.6% -lh5- 13ef May  7  2007 popstar-0.0.2/docs/COPYING-CC-Attrib30.txt
[generic]                 7072   18228  38.8% -lh5- 9010 May  7  2007 popstar-0.0.2/docs/COPYING-GNU-GPL.txt
[generic]                13921   38800  35.9% -lh5- 447e May  7  2007 popstar-0.0.2/docs/COPYING.txt
[generic]                 1043    2218  47.0% -lh5- a686 Oct  1  2007 popstar-0.0.2/docs/README.txt
[generic]                  292     436  67.0% -lh5- aa75 Oct  1  2007 popstar-0.0.2/docs/TODO.txt
[generic]                26063   26308  99.1% -lh5- da2f Jun 28  2006 popstar-0.0.2/images/bkgd1.png
[generic]                91618   91618 100.0% -lh0- 93d2 May  7  2007 popstar-0.0.2/images/bkgd2.png
[generic]                13374   13374 100.0% -lh0- 1aa7 Jun 28  2006 popstar-0.0.2/images/bonus.png
[generic]                26747   26852  99.6% -lh5- 7008 Jun 28  2006 popstar-0.0.2/images/complete.png
[generic]                19533   19533 100.0% -lh0- 2577 Jun 28  2006 popstar-0.0.2/images/cursor.png
[generic]                44326   44326 100.0% -lh0- eb22 Jun 28  2006 popstar-0.0.2/images/gameover.png
[generic]                20102   20231  99.4% -lh5- dce6 Jun 28  2006 popstar-0.0.2/images/incomplete.png
[generic]                23377   24201  96.6% -lh5- 2ce3 Jun 28  2006 popstar-0.0.2/images/stars.png
[generic]               113853  113853 100.0% -lh0- ddb4 Jun 28  2006 popstar-0.0.2/images/title.png
[generic]                  406     892  45.5% -lh5- 3106 Jun 19  1980 popstar-0.0.2/Makefile
[generic]              3036139 3036139 100.0% -lh0- b411 May  6  2007 popstar-0.0.2/music/bull_fight.ogg
[generic]              2298671 2298671 100.0% -lh0- e881 May  6  2007 popstar-0.0.2/music/ethereal_jaunt.ogg
[generic]               129637  129637 100.0% -lh0- a1c3 May  7  2007 popstar-0.0.2/music/ph1lipina_sunris3.ogg
[generic]              1996133 1996133 100.0% -lh0- bd10 May  6  2007 popstar-0.0.2/music/popstar_song2.ogg
[generic]                39541   73284  54.0% -lh5- 647d Jun 19  1980 popstar-0.0.2/popstar
[generic]                 1155    2464  46.9% -lh5- 3ce5 Jun 19  1980 popstar-0.0.2/popstar-mos.readme
[generic]                 9071   30708  29.5% -lh5- cae7 Oct  1  2007 popstar-0.0.2/popstar.c
[generic]                 4375    7551  57.9% -lh5- 05c8 Oct  1  2007 popstar-0.0.2/sounds/bonus.wav
[generic]                 7706    8170  94.3% -lh5- 7997 Oct  1  2007 popstar-0.0.2/sounds/line_break.wav
[generic]                  658    6012  10.9% -lh5- 17ec Oct  1  2007 popstar-0.0.2/sounds/missed1.wav
[generic]                 1258    3120  40.3% -lh5- 9630 Oct  1  2007 popstar-0.0.2/sounds/move.wav
[generic]                 1877    4029  46.6% -lh5- 93af Oct  1  2007 popstar-0.0.2/sounds/pop.wav
[generic]                 1024    1356  75.5% -lh5- 0f0e Oct  1  2007 popstar-0.0.2/sounds/select.wav
---------- ----------- ------- ------- ------ ---------- ------------ ----------
 Total        30 files 7937836 8061987  98.5%            Jun 20 20:25