[freesci-develop] r1541 - in freesci/trunk: . src/engine

[freesci]

Author: jameson
Date: 2006-02-12 21:52:22 +0100 (Sun, 12 Feb 2006)
New Revision: 1541

Modified:
   freesci/trunk/AUTHORS
   freesci/trunk/README
   freesci/trunk/THANKS
   freesci/trunk/config.h
   freesci/trunk/config.log
   freesci/trunk/src/engine/kmenu.c
Log:
* Updated authors popup list to include Hugues
* Updated THANKS, README and AUTHORS a little.

(per-resource palettes are now mentioned)

-- Christooph



Modified: freesci/trunk/AUTHORS
===================================================================
--- freesci/trunk/AUTHORS       2006-02-12 20:50:08 UTC (rev 1540)
+++ freesci/trunk/AUTHORS       2006-02-12 20:52:22 UTC (rev 1541)
@@ -11,8 +11,7 @@
 
 
 
-Christoph Reichenbach: <address@hidden>
-[Maintenance]
+Christoph Reichenbach: <address@hidden>
 [Makefile.am, configure.in etc.]
 [Bug fixes]
 main.c
@@ -118,6 +117,7 @@
 
 
 Lars Skovlund: <address@hidden>
+[Maintenance]
 [Most research]
 [Major bugfixes]
 engine/

Modified: freesci/trunk/README
===================================================================
--- freesci/trunk/README        2006-02-12 20:50:08 UTC (rev 1540)
+++ freesci/trunk/README        2006-02-12 20:52:22 UTC (rev 1541)
@@ -422,7 +422,104 @@
 - device: ALSA device to play back through (default "hw:0,0").
 
 
-2.2 Config file example:
+2.2 Graphical per-resource customisation
+----------------------------------------
+FreeSCI supports a number of ways for customising the way in which graphics
+contained in SCI games are rendered on a per-resource level, i.e. by
+specifying certain options explicitly for the resource under consideration.
+ This is expressed by specifying two things to FreeSCI (per customisation
+step): A pattern and an alteration, terminated by a semicolon (';')
+character.
+
+2.2.1 Patterns
+--------------
+  The pattern specifies which resources the alteration applies to; for
+example, it may be applied to all cels of a certain view, to all pics with
+a certain palette, etc. Patterns may look like the following:
+
+  view  ( [nrs] )( [nrs] )( [nrs] )
+  pic   ( [nrs] )( [nrs] )
+  cursor( [nrs] )
+
+...where [nrs] may be a comma-separated collection of numbers, the
+asterisk wildcard ('*') for "all possible options", or a sequence
+'n..m', which indicates that all numbers x such that  n <= x <= m
+are matched. Ranges may be used (comma-separatedly) in combination with
+individual values. For example,
+
+  view (1,2)(1..3)(*)
+
+would match all cels of loops 1,2 and 3 in view.1 and view.2.
+Trailing '(*)' may be omitted, so the above may be re-written as
+
+  view (1,2)(1..3)
+
+with identical semantics.
+  For all resources, the first parenthesised set of values describes
+the resources it will match on (view number, pic number, etc.). For
+views, the second and third parenthesised sets describe the set of
+loops and cels matched on, respectively. For pics, the second
+parenthesised set describes the default SCI0 pic palette matched on,
+where applicable.
+
+
+2.2.2 Modifications
+-------------------
+FreeSCI distinguishes between two classes of modifications: Absolute and
+relative modifications. The current sets of absolute and relative
+modifications are depicted below. The difference between these is that
+at most one absolute modification may be applied to a given resource--
+currently, the last one specified is used-- whereas all relative
+modifications are sequentially applied to it (after applying the
+absolute modification).
+
+2.2.2.1 Absolute modifications
+------------------------------
+
+(a) Setting the resource palette
+
+  [pattern] = [palette]
+
+  ...where [palette] is one of the following:
+
+       default         - The default EGA palette
+       amiga           - A palette matching the AGI Amiga palette
+       gray            - A grayscale palette
+
+  
+
+2.2.2.2 Relative modifications
+------------------------------
+
+(a) Setting resource brightness
+
+  [pattern] *= [value]
+
+  This multiplies the described resources' brightness by [value].
+  For example, a [value] of 2.0 would double their brightness.
+
+
+(b) Linearly modifying resource colour channels
+
+  [pattern] *= ([rf], [gf], [bf])
+
+  This linearly modifies the three colour channels of the matched
+  resources independently. [rf], [gf] and [bf] may be floating point
+  numbers; they modify the red, green, and blue colour channel,
+  respectively.
+
+
+2.2.3 Examples for graphical per-resource customisation
+-------------------------------------------------------
+
+  pic(1..100) *= 0.4 ;
+  # darken the first 100 pics, starting at 1
+
+  view(*)(1,3,5) = gray ;
+  # Mark loops 1,3 and 5 in all views by turning their cels gray
+
+
+2.3 Config file example:
 ------------------------
 # FreeSCI config file
 

Modified: freesci/trunk/THANKS
===================================================================
--- freesci/trunk/THANKS        2006-02-12 20:50:08 UTC (rev 1540)
+++ freesci/trunk/THANKS        2006-02-12 20:52:22 UTC (rev 1541)
@@ -18,6 +18,7 @@
 Dmitry Jemerov <address@hidden>
 Emmanuel Jeandel
 Erian McKinley
+Fjolnir Asgeirsson
 Francois-R Boyer
 Gary Nutt
 George Reid <address@hidden>

Modified: freesci/trunk/config.h
===================================================================
--- freesci/trunk/config.h      2006-02-12 20:50:08 UTC (rev 1540)
+++ freesci/trunk/config.h      2006-02-12 20:52:22 UTC (rev 1541)
@@ -201,7 +201,7 @@
 /* #undef UNCHECKED_MALLOCS */
 
 /* Version number of package */
-#define VERSION "0.3.5pre1"
+#define VERSION "0.3.5pre2"
 
 /* Define to 1 if you want to build with on-screen console support. */
 /* #undef WANT_CONSOLE */

Modified: freesci/trunk/config.log
===================================================================
--- freesci/trunk/config.log    2006-02-12 20:50:08 UTC (rev 1540)
+++ freesci/trunk/config.log    2006-02-12 20:52:22 UTC (rev 1541)
@@ -3375,3 +3375,39 @@
 
 config.status:786: creating debian/Makefile
 config.status:1212: executing default-1 commands
+
+## ---------------------- ##
+## Running config.status. ##
+## ---------------------- ##
+
+This file was extended by config.status, which was
+generated by GNU Autoconf 2.59.  Invocation command line was
+
+  CONFIG_FILES    = 
+  CONFIG_HEADERS  = config.h
+  CONFIG_LINKS    = 
+  CONFIG_COMMANDS = 
+  $ ./config.status 
+
+on maya
+
+config.status:852: creating config.h
+config.status:1212: executing default-1 commands
+
+## ---------------------- ##
+## Running config.status. ##
+## ---------------------- ##
+
+This file was extended by config.status, which was
+generated by GNU Autoconf 2.59.  Invocation command line was
+
+  CONFIG_FILES    = src/Makefile
+  CONFIG_HEADERS  = 
+  CONFIG_LINKS    = 
+  CONFIG_COMMANDS = 
+  $ ./config.status 
+
+on maya
+
+config.status:786: creating src/Makefile
+config.status:1212: executing default-1 commands

Modified: freesci/trunk/src/engine/kmenu.c
===================================================================
--- freesci/trunk/src/engine/kmenu.c    2006-02-12 20:50:08 UTC (rev 1540)
+++ freesci/trunk/src/engine/kmenu.c    2006-02-12 20:52:22 UTC (rev 1541)
@@ -123,30 +123,31 @@
         "Emmanuel Jeandel\nBugfixes and bug reports\n\n"
         "Francois-R Boyer\nMT-32 information and mapping code\n\n"
         "George Reid\nFreeBSD package management\n\n"
-        "Ismail Khatib\nPort to the PocketPC platform",
+        "Hugues Valois\nGame selection menu",
         0, 15},
        {"Even more FreeSCI hackers & contributors",
+        "Ismail Khatib\nPort to the PocketPC platform\n\n"
         "Lars Skovlund\nMost of the relevant documentation, several 
bugfixes\n\n"
         "Magnus Reftel\nHeap implementation, Python class viewer, bugfixes\n\n"
         "Matt Hargett\nClean-ups, bugfixes, Hardcore QA, Win32\n\n"
         "Paul David Doherty\nGame version information\n\n"
         "Petr Vyhnak\nThe DCL-INFLATE algorithm, many Win32 improvements\n\n"
-        "Rainer Canavan\nIRIX MIDI driver and bug fixes\n\n"
-        "Rainer De Temple\nSCI research",
+        "Rainer Canavan\nIRIX MIDI driver and bug fixes",
         0, 15},
        {"Still more of them",
+        "Rainer De Temple\nSCI research\n\n"
         "Ravi I.\nSCI0 sound resource specification\n\n"
         "Ruediger Hanke\nPort to the MorphOS platform\n\n"
         "Rune Orsval\nConfiguration file editor\n\n"
         "Rickard Lind\nMT32->GM MIDI mapping magic, sound research\n\n"
         "Rink Springer\nPort to the DOS platform, several bug fixes\n\n"
-        "Robey Pointer\nBug tracking system hosting\n\n"
-        "Sergey Lapin\nPort of Carl's type 2 decompression code",
+        "Robey Pointer\nBug tracking system hosting",
         0, 15},
        {"And even more",
+        "Sergey Lapin\nPort of Carl's type 2 decompression code\n\n"
         "Solomon Peachy\nSDL ports and much of the sound subsystem\n\n"
         "Vyacheslav Dikonov\nConfig script improvements\n\n"
-        "Walter van Niftrik\nPort to the Dreamcast platform",
+        "Walter van Niftrik\nPorts to the Dreamcast and GP32 platforms",
         0, 15},
        {"The CSCI5573 Team at CU Boulder",
         "Xiaojun Chen\nSean Terrell\nChristoph Reichenbach\n\n"