- added some notes on using the file

[supertux.git] / data / images / tiles.strf

diff --git a/data/images/tiles.strf b/data/images/tiles.strf
index 8ddbdb7..6352209 100644 (file)
--- a/data/images/tiles.strf
+++ b/data/images/tiles.strf
@@ -1,3 +1,17 @@
+;; This file contains the mapping from tile-ids to image files as well
+;; as the tile properties (unisolid, solid, ice, water, etc.). Since
+;; it is important that the tile-ids don't change once created and
+;; used in a level some care has to be taken when editing this file,
+;; else the levels would be rendered unusable.
+;;
+;; Some notes on editing this file:
+;;  - tile-ids must be uniq
+;;  - the tile definition with the largest id should always be at the
+;;    bottom of the file
+;;  - when creating a new tile definition take the greatest current id
+;;    and increment it by one
+;;  - the meaning of the values in (attributes ...) can be seen in
+;;    src/tile.cpp, unisolid is 3 not 2
 (supertux-tiles
   (tilegroup
     (name "Snow")
@@ -9,7 +23,7 @@
       30   31   114  113
       21   22   19   203
       20   23   207  208
-      115  116  0    0
+      115  116  214  0
       117  118  0    0
       122  209  123  0
       124  210  125  0
@@ -465,13 +479,19 @@
 (tilegroup
  (name "Castle (snow)")
  (tiles
-  2021 2022 2023 0 
-  2026 2027 2028 0
-  2031 2032 2033 0
-  2036 2037 2038 0
-  2041 2042 2043 0
-  2046 2047 2048 0
-  2024 2025 0 0      
+ 2091 2092 2093 0
+ 2096 2097 2098 0
+ 2101 2102 2103 0
+ 2106 2107 2108 0
+ 2111 2112 2113 0
+ 2116 2117 2118 0
+
+ 2094 2095 0 0
+ 2099 2100 0 0
+ 2104 2105 0 0
+ 2109 2110 0 0
+ 2114 2115 0 0
+ 2119 2120 0 0
 ))
 
   (tilegroup
@@ -760,7 +780,7 @@
       207 208
       202 203
       204 206
-      205 205
+      214 205
     )
     (attributes
       1 1
@@ -6608,9 +6628,9 @@
     (height 4)
     (ids
       2032 2033 2034 2035
-      2036 2037 2032 2038
-      2039 2032 2032 2040
-      2032 2041 2042 2032
+      2036 2037    0 2038
+      2039    0    0 2040
+         0 2041 2042    0
     )
     (attributes
       0 0 0 0
@@ -6712,12 +6732,12 @@
   (tiles
     (width  5)
     (height 6)
-    (ids 2021 2022 2023 2024 2025
-         2026 2027 2028 2029 2030
-         2031 2032 2033 2034 2035
-         2036 2037 2038 2039 2040 
-         2041 2042 2043 2044 2052
-         2053 2047 2048 2050 2051
+    (ids 2091 2092 2093 2094 2095
+         2096 2097 2098 2099 2100
+         2101 2102 2103 2104 2105
+         2106 2107 2108 2109 2110
+         2111 2112 2113 2114 2115
+         2116 2117 2118 2119 2120
     )
     (attributes
       1 1 1 1 1