MapLocalization - Revision history

Dugucloud: Added instruction of not to worry about disturbance between map texture and text stroke.

2018-05-20T02:14:41Z

Added instruction of not to worry about disturbance between map texture and text stroke.

Dugucloud: Put a reminder of GIMP version.

2018-05-18T02:20:22Z

Put a reminder of GIMP version.

Zookeeper: Added clear mention of font used, and a few other minor additions

2016-10-15T16:39:08Z

Added clear mention of font used, and a few other minor additions

Aquileia: New duplicate maps, now organized as a table

2015-01-25T06:41:07Z

New duplicate maps, now organized as a table

Aquileia: Second map which appears twice added

2015-01-19T12:48:58Z

Second map which appears twice added

Zookeeper: Removed note of both black and yellow labels being required

2014-06-21T11:13:24Z

Removed note of both black and yellow labels being required

Aquileia: /* Final notes */

2014-06-20T00:27:57Z

‎Final notes

Aquileia: Add comment about layer groups

2014-06-15T23:09:47Z

Add comment about layer groups

Aquileia: resources is now a separate repo

2014-06-13T13:08:04Z

resources is now a separate repo

Iceiceice: added to translations, like ImageLocalization page

2014-04-29T00:12:36Z

added to translations, like ImageLocalization page

@@ Line 11: / Line 11: @@
 ==== Preparations ====
-. If you don't have GIMP, install it. GIMP 2.10.x would not work with the localization script, so you may need GIMP 2.8.x.
+. If you don't have GIMP, install it. '''Be aware''' that GIMP 2.10.x or later would not work with the localization script, so you may need GIMP 2.8.x instead.
 . Download the [https://github.com/wesnoth/resources/tree/master/image-localization/maps/wesnoth-map-localization.scm wesnoth-map-localization.scm script] and place it into a script directory recognized by GIMP. You can view and configure the script directories in GIMP's preferences (Preferences -> Folders -> Scripts). If you already have GIMP running, you need to use '''Filters -> Script-Fu -> Refresh Scripts''' to make it recognize the newly added script. In the Filters menu, you should now see a filter category called "Wesnoth", and inside it "Map Localization". However, we don't need it yet.
@@ Line 22: / Line 22: @@
 # Open the localization.xcf you've downloaded. It contains a bunch of layers needed by the localization script, but at this point all you need is the layer called "label placement guide". It's a version of the map without any perspective or displacement effects added, and it is the one onto which you need to place the localized layers.
-# Create a new layer which includes the localized labels, positioning them using the aforementioned layer as a guide. The positions or orientation or curving of the labels does not need to match the english labels in any way. Place them in a way which you think looks good.<br>The requirements for the labels are simple: black text should be pure black, whereas yellow labels on forests should have the RGB value 185,155,85. The script gives you a little bit of leeway so you don't have to stress over very small color deviations, but don't do it intentionally. Background should be transparent.<br>''Note that you can use whatever graphics application you want in creating your labels, as long as you can import the result into GIMP so that it meets the above requirements.''<br>
+# Create a new layer which includes the localized labels, positioning them using the aforementioned layer as a guide. The positions or orientation or curving of the labels does not need to match the english labels in any way. Place them in a way which you think looks good.<br>The requirements for the labels are simple: black text should be pure black, whereas yellow labels on forests should have the RGB value 185,155,85. The script gives you a little bit of leeway so you don't have to stress over very small color deviations, but don't do it intentionally. Background should be transparent. If you feel the geographical texture on the map disturbs your text stroke, it is OK. The script will make a shadow under your text, so the texture underneath will look like being a little bit erased.<br>''Note that you can use whatever graphics application you want in creating your labels, as long as you can import the result into GIMP so that it meets the above requirements.''<br>
 # Add the layer containing your localized text into the same localization.xcf file and name it "labels". Don't mess with the other layers.
 # If ''labels'' and ''label placement guide'' are layer groups, merge them down to single layers. Notice as well that the expected layer names are case-sensitive, so for example ''Labels'' will not work.

@@ Line 11: / Line 11: @@
 ==== Preparations ====
-. If you don't have GIMP, install it.
+. If you don't have GIMP, install it. GIMP 2.10.x would not work with the localization script, so you may need GIMP 2.8.x.
 . Download the [https://github.com/wesnoth/resources/tree/master/image-localization/maps/wesnoth-map-localization.scm wesnoth-map-localization.scm script] and place it into a script directory recognized by GIMP. You can view and configure the script directories in GIMP's preferences (Preferences -> Folders -> Scripts). If you already have GIMP running, you need to use '''Filters -> Script-Fu -> Refresh Scripts''' to make it recognize the newly added script. In the Filters menu, you should now see a filter category called "Wesnoth", and inside it "Map Localization". However, we don't need it yet.

@@ Line 32: / Line 32: @@
 If there are labels which you don't need to localize, then first of all, don't bother including them among your localized labels. Then, once you've generated the final overlay, simply erase the parts which cover up the original english label.
-===== Text sizing =====
+The localized overlay may end up having some small artifacts along the parchment edges; you can simply erase them if you want.
-These are the text sizing rules that have been used on the english maps. Depending on your language, you may want to break some of them.
+===== Font and text sizing =====
 Major geographical features or other large areas which extend beyond the map edges (including forests): 28px small caps, tracking ~200.

← Older revision		Revision as of 06:41, 25 January 2015
Line 68:		Line 68:
	The title screen map is identical with the ''Heir to the Throne'' campaign map. Localize the map for ''Heir to the Throne'', create a copy of the overlay and rename it to 'titlescreen--overlay.png', then place it in ''\data\core\images\maps\l10n\<language iso code>'' and you're done.		The title screen map is identical with the ''Heir to the Throne'' campaign map. Localize the map for ''Heir to the Throne'', create a copy of the overlay and rename it to 'titlescreen--overlay.png', then place it in ''\data\core\images\maps\l10n\<language iso code>'' and you're done.

−	~~The same applies to the ''A Tale of Two Brothers'' map, which is identical to the ''Liberty'' map but for the name.~~

		+	The same applies to several other maps:
		+
		+	{\|
		+	! Copy !! Source
		+	\|-
		+	\| ''titlescreen'' \|\| ''Heir to the Throne''
		+	\|-
		+	\| ''A Tale of Two Brothers'' \|\| ''Liberty''
		+	\|-
		+	\| ''Northern Rebirth'' \|\| ''An Orcish Incursion''
		+	\|-
		+	\| ''The Hammer of Thursagan'' \|\| ''The Sceptre of Fire''
		+	\|}

	[[Category:Translations]]		[[Category:Translations]]

@@ Line 64: / Line 64: @@
 All of the above is optional. You do not need to match the english labels in shape and location. If for some reason you need to, you can even omit some labels or add completely new ones.
-===== Title screen map =====
+==== Duplicate maps ====
 The title screen map is identical with the ''Heir to the Throne'' campaign map. Localize the map for ''Heir to the Throne'', create a copy of the overlay and rename it to 'titlescreen--overlay.png', then place it in ''\data\core\images\maps\l10n\<language iso code>'' and you're done.
 [[Category:Translations]]

← Older revision		Revision as of 00:27, 20 June 2014
Line 34:		Line 34:
	The script works if and only if the labels layer contains both black and golden pixels.		The script works if and only if the labels layer contains both black and golden pixels.

		+	''As the Dead Water map has no forests, there's a yellow label inmidst the ocean. You'll have to remove that from the final product - it's only there to save you a headache on why the script doesn't work.''

	===== Text sizing =====		===== Text sizing =====

@@ Line 21: / Line 21: @@
 ==== Localization ====
-. Open the localization.xcf you've downloaded. It contains a bunch of layers needed by the localization script, but at this point all you need is the layer called "label placement guide". It's a version of the map without any perspective or displacement effects added, and it is the one onto which you need to place the localized layers.
+# Open the localization.xcf you've downloaded. It contains a bunch of layers needed by the localization script, but at this point all you need is the layer called "label placement guide". It's a version of the map without any perspective or displacement effects added, and it is the one onto which you need to place the localized layers.
+# Create a new layer which includes the localized labels, positioning them using the aforementioned layer as a guide. The positions or orientation or curving of the labels does not need to match the english labels in any way. Place them in a way which you think looks good.<br>The requirements for the labels are simple: black text should be pure black, whereas yellow labels on forests should have the RGB value 185,155,85. The script gives you a little bit of leeway so you don't have to stress over very small color deviations, but don't do it intentionally. Background should be transparent.<br>''Note that you can use whatever graphics application you want in creating your labels, as long as you can import the result into GIMP so that it meets the above requirements.''<br>
-. Create a new layer which includes the localized labels, positioning them using the aforementioned layer as a guide. The positions or orientation or curving of the labels does not need to match the english labels in any way. Place them in a way which you think looks good.
+# Add the layer containing your localized text into the same localization.xcf file and name it "labels". Don't mess with the other layers.
+# If ''labels'' and ''label placement guide'' are layer groups, merge them down to single layers. Notice as well that these have to begin with a lowercase l for the script to work.
-The requirements for the labels are simple: black text should be pure black, whereas yellow labels on forests should have the RGB value 185,155,85. The script gives you a little bit of leeway so you don't have to stress over very small color deviations, but don't do it intentionally. Background should be transparent.
+# Run the script by choosing Filters -> Wesnoth -> Map Localization. The script will create a new image, and produce the output there. This will take a moment, perhaps as much as a minute or more on a slow computer, and for a few seconds it might seem like nothing is happening.
+# You should now have a new image with a single layer called "localized overlay". Inspect that everything's ok by adding the original english map as a new layer underneath the overlay; the english labels should be covered up, the localized labels in place and there should be no glitches anywhere. Export the image to PNG (just remember to hide/delete the english map layer first!) and you're done. In the PNG export dialog, uncheck the option "Save color values from transparent pixels" to get the file of expected size (~100-300 KiB; if the option is not unchecked, it is over 2 MiB).
 ===== Final notes =====

@@ Line 13: / Line 13: @@
 . If you don't have GIMP, install it.
-. Download the [https://github.com/wesnoth/wesnoth-old/tree/master/resources/image-localization/maps/ wesnoth-map-localization.scm script] and place it into a script directory recognized by GIMP. You can view and configure the script directories in GIMP's preferences (Preferences -> Folders -> Scripts). If you already have GIMP running, you need to use '''Filters -> Script-Fu -> Refresh Scripts''' to make it recognize the newly added script. In the Filters menu, you should now see a filter category called "Wesnoth", and inside it "Map Localization". However, we don't need it yet.
+. Download the [https://github.com/wesnoth/resources/tree/master/image-localization/maps/wesnoth-map-localization.scm wesnoth-map-localization.scm script] and place it into a script directory recognized by GIMP. You can view and configure the script directories in GIMP's preferences (Preferences -> Folders -> Scripts). If you already have GIMP running, you need to use '''Filters -> Script-Fu -> Refresh Scripts''' to make it recognize the newly added script. In the Filters menu, you should now see a filter category called "Wesnoth", and inside it "Map Localization". However, we don't need it yet.
-. Download the [https://github.com/wesnoth/wesnoth-old/tree/master/resources/image-localization/maps/ localization.xcf for the map you're localizing].
+. Download the [https://github.com/wesnoth/resources/tree/master/image-localization/maps/ localization.xcf for the map you're localizing].
 Now you're all set to begin.

← Older revision		Revision as of 00:12, 29 April 2014
Line 77:		Line 77:

	The title screen map is identical with the ''Heir to the Throne'' campaign map. Localize the map for ''Heir to the Throne'', create a copy of the overlay and rename it to 'titlescreen--overlay.png', then place it in ''\data\core\images\maps\l10n\<language iso code>'' and you're done.		The title screen map is identical with the ''Heir to the Throne'' campaign map. Localize the map for ''Heir to the Throne'', create a copy of the overlay and rename it to 'titlescreen--overlay.png', then place it in ''\data\core\images\maps\l10n\<language iso code>'' and you're done.
		+
		+
		+	[[Category:Translations]]