Difference between revisions of "WML Utilities"
From The Battle for Wesnoth Wiki
(Actually do that last remove correctly.) |
(Convert to new terrain codes) |
||
Line 10: | Line 10: | ||
# first_time_only=no | # first_time_only=no | ||
# | # | ||
− | # {IF_TERRAIN $x1 $y1 | + | # {IF_TERRAIN $x1 $y1 Gg,Gs^Fp,Mm ( |
# [then] | # [then] | ||
# {DEBUG_MSG "Stepped on grassland, forest or mountains!"} | # {DEBUG_MSG "Stepped on grassland, forest or mountains!"} | ||
Line 16: | Line 16: | ||
# )} | # )} | ||
# [/event]<br> | # [/event]<br> | ||
− | #define IF_TERRAIN X Y | + | #define IF_TERRAIN X Y TERRAIN CONTENTS |
[store_locations] | [store_locations] | ||
x={X} | x={X} | ||
y={Y} | y={Y} | ||
− | terrain={ | + | terrain={TERRAIN} |
variable=IF_TERRAIN_temp | variable=IF_TERRAIN_temp | ||
[/store_locations]<br> | [/store_locations]<br> |
Revision as of 00:28, 27 February 2008
Contents
Filter by Terrain
# Check whethers or not the terrain in the given coordinates is of the given # type or types. Filtering by terrain isn't possible directly. # # You can use it for example like this: # # [event] # name=moveto # first_time_only=no # # {IF_TERRAIN $x1 $y1 Gg,Gs^Fp,Mm ( # [then] # {DEBUG_MSG "Stepped on grassland, forest or mountains!"} # [/then] # )} # [/event]
#define IF_TERRAIN X Y TERRAIN CONTENTS [store_locations] x={X} y={Y} terrain={TERRAIN} variable=IF_TERRAIN_temp [/store_locations]
[if] [variable] name=IF_TERRAIN_temp.length not_equals=0 [/variable]
{CONTENTS} [/if]
{CLEAR_VARIABLE IF_TERRAIN_temp} #enddef
Iterate
# You can iterate through a range of numbers with this macro. The CONTENTS # are repeated with every iteration, and you can use the VAR variable to # insert the number of the current step into each iteration. Note that # when using this, you must iterate from a smaller number to the bigger # number, because the increment is always 1. # # Example that spawns a row of skeletons into the coordinates (4,5), # (5,5), (6,5), (7,5), (8,5) and (9,5): # # {ITERATE 4 9 i ( # [unit] # type=Skeleton # x=$i # y=5 # [/unit] # )}
#define ITERATE FROM TO VAR CONTENTS {VARIABLE {VAR} {FROM}}
[while] [variable] name={VAR} less_than_equal_to={TO} [/variable]
[do] {CONTENTS}
{VARIABLE_OP {VAR} add 1} [/do] [/while] #enddef
Adding unit overlays with a filter instead of (x,y)
# UNIT_OVERLAY adds an overlay to a unit, taking in a standard filter # # Example that gives all spearmen a book: # {UNIT_OVERLAY type=Spearman items/book1.png} #define UNIT_OVERLAY FILTER IMG [store_unit] [filter] {FILTER} [/filter] variable=UNIT_OVERLAY_store kill=no [/store_unit] {FOREACH UNIT_OVERLAY_store UNIT_OVERLAY_i} {VARIABLE_OP UNIT_OVERLAY_tempx format $UNIT_OVERLAY_store[$UNIT_OVERLAY_i].x} {VARIABLE_OP UNIT_OVERLAY_tempy format $UNIT_OVERLAY_store[$UNIT_OVERLAY_i].y} [unit_overlay] x=$UNIT_OVERLAY_tempx y=$UNIT_OVERLAY_tempy image={IMG} [/unit_overlay] {NEXT UNIT_OVERLAY_i} {CLEAR_VARIABLE UNIT_OVERLAY_store} #enddef
Determining opposite coordinates
# Using this, you can determine the coordinates on the "opposite side" of a # central hex, relative to another hex adjacent to it. What this really means # is illustrated below: # __ __ __ # __/ \__ __/2 \__ __/ \__ # / \__/1 \ / \__/ \ /2 \__/ \ C: central point # \__/C \__/ \__/C \__/ \__/C \__/ 1: the hex to "mirror" # /2 \__/ \ / \__/ \ / \__/1 \ 2: the result # \__/ \__/ \__/1 \__/ \__/ \__/ # \__/ \__/ \__/ # # The coordinates of the central point are given in {CENTER_X} and {CENTER_Y}, # and the coordinates of hex 1 in {X} and {Y}. The coordinates of hex 2 are # then stored in {VAR}, which will have member variables x and y. # # Note that this uses the IF macro given earlier on this page.
#define OPPOSITE_SIDE CENTER_X CENTER_Y X Y VAR {VARIABLE x_odd {X}}
{VARIABLE_OP x_odd multiply 0.5} {VARIABLE_OP x_odd multiply 2}
{VARIABLE c_x {CENTER_X}} {VARIABLE c_y {CENTER_Y}} {VARIABLE s_x {X}} {VARIABLE s_y {Y}}
{VARIABLE result_x {CENTER_X}} {VARIABLE result_y {CENTER_Y}}
{IF_VAR s_x greater_than $c_x ( [then] {VARIABLE_OP result_x add -1} [/then] )}
{IF_VAR s_x less_than $c_x ( [then] {VARIABLE_OP result_x add 1} [/then] )}
{IF_VAR s_x equals $c_x ( [then] {IF_VAR s_y less_than $c_y ( [then] {VARIABLE_OP result_y add 1} [/then] )}
{IF_VAR s_y greater_than $c_y ( [then] {VARIABLE_OP result_y add -1} [/then] )} [/then] )}
{IF_VAR x_odd not_equals $s_x ( [then] {IF_VAR s_y equals $c_y ( [then] {VARIABLE_OP result_y add 1} [/then] )} [/then]
[else] {IF_VAR s_y equals $c_y ( [then] {VARIABLE_OP result_y add -1} [/then] )} [/else] )} {VARIABLE {VAR}.x $result_x} {VARIABLE {VAR}.y $result_y}
{CLEAR_VARIABLE c_x} {CLEAR_VARIABLE c_y} {CLEAR_VARIABLE s_x} {CLEAR_VARIABLE s_y} {CLEAR_VARIABLE result_x} {CLEAR_VARIABLE result_y} {CLEAR_VARIABLE x_odd} #enddef