You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
* Updated TMX changelog and docs with "color" and "file" property types
* Updated docs about multi-line strings, and noted this in the changelog
* Added note about embedded image data
Below are described the changes/additions that were made to the [TMX format](tmx-map-format.md) for recent versions of Tiled.
6
6
7
+
## Tiled 0.17 ##
8
+
9
+
* Added `color` and `file` as possible values for the [`property.type`](tmx-map-format.md#property) attribute.
10
+
* Added support for editing multi-line string properties, which are written out differently.
11
+
7
12
## Tiled 0.16 ##
8
13
9
14
* The [`property`](tmx-map-format.md#property) element gained a `type` attribute, storing the type of the value. Currently supported types are `string` (the default), `int`, `float` and `bool`.
Copy file name to clipboardExpand all lines: docs/reference/tmx-map-format.md
+7-3Lines changed: 7 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -65,6 +65,8 @@ This element is used to specify an offset in pixels, to be applied when drawing
65
65
* <b>width:</b> The image width in pixels (optional, used for tile index correction when the image changes)
66
66
* <b>height:</b> The image height in pixels (optional)
67
67
68
+
Note that it is not currently possible to use Tiled to create maps with embedded image data, even though the TMX format supports this. It is possible to create such maps using `libtiled` (Qt/C++) or [tmxlib](https://pypi.python.org/pypi/tmxlib) (Python).
69
+
68
70
Can contain: [data](#data) (since 0.9)
69
71
70
72
### <terraintypes> ###
@@ -272,14 +274,16 @@ Wraps any number of custom properties. Can be used as a child of the `map`, `til
272
274
### <property> ###
273
275
274
276
* <b>name:</b> The name of the property.
275
-
* <b>type:</b> The type of the property. Can be `string` (default), `int`, `float`or `bool`. (since 0.16)
277
+
* <b>type:</b> The type of the property. Can be `string` (default), `int`, `float`, `bool`, `color`or `file` (since 0.16, with `color` and `file` added in 0.17).
276
278
* <b>value:</b> The value of the property.
277
279
278
280
Boolean properties have a value of either "true" or "false".
279
281
280
-
When a string property spans contains newlines, the current versions of Tiled Java and Tiled Qt will write out the value as characters contained inside the `property` element rather than as the `value` attribute. However, it is at the moment not really possible to edit properties consisting of multiple lines with Tiled.
282
+
Color properties are stored in the format `#AARRGGBB`.
283
+
284
+
File properties are stored as paths relative from the location of the map file.
281
285
282
-
It is possible that a future version of the TMX format will switch to always saving property values inside the element rather than as an attribute.
286
+
When a string property contains newlines, the current version of Tiled will write out the value as characters contained inside the `property` element rather than as the `value` attribute. It is possible that a future version of the TMX format will switch to always saving property values inside the element rather than as an attribute.
0 commit comments