From ca0e762b642674f631ef4275c29b1933d1cd30ef Mon Sep 17 00:00:00 2001
From: twanvl <twanvl@0fc631ac-6414-0410-93d0-97cfa31319b6>
Date: Tue, 3 Aug 2010 14:56:45 +0000
Subject: [PATCH] New image functions:  * invert  * flip_horizontal  *
 flip_vertical  * rotate

git-svn-id: svn://svn.code.sf.net/p/magicseteditor/code/trunk@1472 0fc631ac-6414-0410-93d0-97cfa31319b6
---
 doc/function/flip_horizontal.txt       |  18 +++++++
 doc/function/flip_vertical.txt         |  18 +++++++
 doc/function/image_logo.png            | Bin 0 -> 4944 bytes
 doc/function/image_logo_desaturate.png | Bin 0 -> 4789 bytes
 doc/function/image_logo_hflip.png      | Bin 0 -> 4894 bytes
 doc/function/image_logo_invert.png     | Bin 0 -> 4959 bytes
 doc/function/image_logo_rotate30.png   | Bin 0 -> 15198 bytes
 doc/function/image_logo_vflip.png      | Bin 0 -> 4851 bytes
 doc/function/index.txt                 |   4 ++
 doc/function/invert.txt                |  14 ++++++
 doc/function/rotate.txt                |  19 +++++++
 doc/function/saturate.txt              |   2 +
 src/data/field/color.cpp               |   9 +++-
 src/gfx/color.hpp                      |  22 +++++++++
 src/gfx/generated_image.cpp            |  42 ++++++++++++++++
 src/gfx/generated_image.hpp            |  46 +++++++++++++++++
 src/gfx/gfx.hpp                        |  11 ++++-
 src/gfx/image_effects.cpp              |  10 ++++
 src/gfx/rotate_image.cpp               |  66 +++++++++++++++++++------
 src/script/functions/image.cpp         |  25 ++++++++++
 20 files changed, 286 insertions(+), 20 deletions(-)
 create mode 100644 doc/function/flip_horizontal.txt
 create mode 100644 doc/function/flip_vertical.txt
 create mode 100644 doc/function/image_logo.png
 create mode 100644 doc/function/image_logo_desaturate.png
 create mode 100644 doc/function/image_logo_hflip.png
 create mode 100644 doc/function/image_logo_invert.png
 create mode 100644 doc/function/image_logo_rotate30.png
 create mode 100644 doc/function/image_logo_vflip.png
 create mode 100644 doc/function/invert.txt
 create mode 100644 doc/function/rotate.txt

diff --git a/doc/function/flip_horizontal.txt b/doc/function/flip_horizontal.txt
new file mode 100644
index 00000000..c3af2872
--- /dev/null
+++ b/doc/function/flip_horizontal.txt
@@ -0,0 +1,18 @@
+Function: flip_horizontal
+
+--Usage--
+> flip_horizontal(input: image)
+
+Flip an image horizontally.
+
+--Parameters--
+! Parameter	Type			Description
+| @input@	[[type:image]]		Image to flip.
+
+--Examples--
+> flip_horizontal("image_logo.png")  ==  [[Image]]
+>>> flip_horizontal(<img src="image_logo.png" alt='"image_logo.png"' style="border:1px solid black;vertical-align:middle;margin:1px;" />) == <img src="image_logo_hflip.png" alt='"image_logo_hflip.png"' style="border:1px solid black;vertical-align:middle;margin:1px;" />
+
+--See also--
+| [[fun:flip_vertical]]		Flip an image vertically
+| [[fun:rotate]]		Rotate an image
diff --git a/doc/function/flip_vertical.txt b/doc/function/flip_vertical.txt
new file mode 100644
index 00000000..19c7b3d1
--- /dev/null
+++ b/doc/function/flip_vertical.txt
@@ -0,0 +1,18 @@
+Function: flip_vertical
+
+--Usage--
+> flip_vertical(input: image)
+
+Flip an image vertically.
+
+--Parameters--
+! Parameter	Type			Description
+| @input@	[[type:image]]		Image to flip.
+
+--Examples--
+> flip_vertical("image_logo.png")  ==  [[Image]]
+>>> flip_vertical(<img src="image_logo.png" alt='"image_logo.png"' style="border:1px solid black;vertical-align:middle;margin:1px;" />) == <img src="image_logo_vflip.png" alt='"image_logo_vflip.png"' style="border:1px solid black;vertical-align:middle;margin:1px;" />
+
+--See also--
+| [[fun:flip_horizontal]]	Flip an image horizontally
+| [[fun:rotate]]		Rotate an image
diff --git a/doc/function/image_logo.png b/doc/function/image_logo.png
new file mode 100644
index 0000000000000000000000000000000000000000..c64c192b0b8b66c2ed771feedd236a666127ecd5
GIT binary patch
literal 4944
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
O0000<MNUMnLSTY2@<sRn

literal 0
HcmV?d00001

diff --git a/doc/function/image_logo_desaturate.png b/doc/function/image_logo_desaturate.png
new file mode 100644
index 0000000000000000000000000000000000000000..35c21f48a619f5d81e2a59baf53773f2fcb33f6b
GIT binary patch
literal 4789
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
P00000NkvXXu0mjf|C`FZ

literal 0
HcmV?d00001

diff --git a/doc/function/image_logo_hflip.png b/doc/function/image_logo_hflip.png
new file mode 100644
index 0000000000000000000000000000000000000000..4e0ded3dc0575f0ba527ed7dd8077ad40a7214b8
GIT binary patch
literal 4894
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
Q#Q*>R07*qoM6N<$f>WOjS^xk5

literal 0
HcmV?d00001

diff --git a/doc/function/image_logo_invert.png b/doc/function/image_logo_invert.png
new file mode 100644
index 0000000000000000000000000000000000000000..39e19dddfd978d1bfdf1e7f4ccc37ddd28fc453b
GIT binary patch
literal 4959
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

literal 0
HcmV?d00001

diff --git a/doc/function/image_logo_rotate30.png b/doc/function/image_logo_rotate30.png
new file mode 100644
index 0000000000000000000000000000000000000000..6799fbd52b96227f1e412c30121693d7f05045bc
GIT binary patch
literal 15198
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
Y18$~ac5(|f&Hw-a07*qoM6N<$f=-sk>;M1&

literal 0
HcmV?d00001

diff --git a/doc/function/image_logo_vflip.png b/doc/function/image_logo_vflip.png
new file mode 100644
index 0000000000000000000000000000000000000000..6f459f641a5562e23ac7f2e32f1f86590615b034
GIT binary patch
literal 4851
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
Z{{zM`o6J$5dlCQu002ovPDHLkV1nbf_Im&T

literal 0
HcmV?d00001

diff --git a/doc/function/index.txt b/doc/function/index.txt
index 3a380b9e..7422aae4 100644
--- a/doc/function/index.txt
+++ b/doc/function/index.txt
@@ -83,8 +83,12 @@ These functions are built into the program, other [[type:function]]s can be defi
 | [[fun:set_alpha]]		Change the transparency of an image.
 | [[fun:set_combine]]		Change how the image should be combined with the background.
 | [[fun:saturate]]		Saturate/desaturate an image.
+| [[fun:invert]]		Invert the colors of an image.
 | [[fun:enlarge]]		Enlarge an image by putting a border around it.
 | [[fun:crop]]			Crop an image, giving only a small subset of it.
+| [[fun:flip_horizontal]]	Flip an image horizontally.
+| [[fun:flip_vertical]]		Flip an image vertically.
+| [[fun:rotate]]		Rotate an image.
 | [[fun:drop_shadow]]		Add a drop shadow to an image.
 | [[fun:symbol_variation]]	Render a variation of a [[type:symbol]].
 | [[fun:built_in_image]]	Return an image built into the program.
diff --git a/doc/function/invert.txt b/doc/function/invert.txt
new file mode 100644
index 00000000..fdc0619f
--- /dev/null
+++ b/doc/function/invert.txt
@@ -0,0 +1,14 @@
+Function: invert
+
+--Usage--
+> invert(input: image)
+
+Invert the colors in an image.
+
+--Parameters--
+! Parameter	Type			Description
+| @input@	[[type:image]]		Image to invert.
+
+--Examples--
+> invert("image_logo.png")  ==  [[Image]]
+>>> invert(<img src="image_logo.png" alt='"image_logo.png"' style="border:1px solid black;vertical-align:middle;margin:1px;" />) == <img src="image_logo_invert.png" alt='"image_logo_invert.png"' style="border:1px solid black;vertical-align:middle;margin:1px;" />
diff --git a/doc/function/rotate.txt b/doc/function/rotate.txt
new file mode 100644
index 00000000..3519dce1
--- /dev/null
+++ b/doc/function/rotate.txt
@@ -0,0 +1,19 @@
+Function: flip_vertical
+
+--Usage--
+> rotate(input: image, angle: some_number)
+
+Rotate an image. The image can become larger to accomodate the rotated bounding box.
+
+--Parameters--
+! Parameter	Type			Description
+| @input@	[[type:image]]		Image to rotate.
+| @angle@	[[type:double]]		Angle to rotate by, in degrees counter clockwise.
+
+--Examples--
+> rotate("image_logo.png", angle:30)  ==  [[Image]]
+>>> rotate(<img src="image_logo.png" alt='"image_logo.png"' style="border:1px solid black;vertical-align:middle;margin:1px;" />, angle:30) == <img src="image_logo_rotate30.png" alt='"image_logo_rotate30.png"' style="border:1px solid black;vertical-align:middle;margin:1px;" />
+
+--See also--
+| [[fun:flip_horizontal]]	Flip an image horizontally
+| [[fun:flip_vertical]]		Flip an image vertically
diff --git a/doc/function/saturate.txt b/doc/function/saturate.txt
index f9f9f9cf..44b0d904 100644
--- a/doc/function/saturate.txt
+++ b/doc/function/saturate.txt
@@ -19,3 +19,5 @@ To desaturate use an amount between @0@ (no desaturation) and @-1@ (convert to g
 >>> saturate(<img src="image5.png" alt='"image5.png"' style="border:1px solid black;vertical-align:middle;margin:1px;" />, amount:  0.5) == <img src="image_saturate1.png" alt='"image_saturate1.png"' style="border:1px solid black;vertical-align:middle;margin:1px;" />
 > saturate("image5.png", amount: -0.5)  ==  [[Image]]
 >>> saturate(<img src="image5.png" alt='"image5.png"' style="border:1px solid black;vertical-align:middle;margin:1px;" />, amount: -0.5) == <img src="image_saturate2.png" alt='"image_saturate2.png"' style="border:1px solid black;vertical-align:middle;margin:1px;" />
+> saturate("image_logo.png", amount: -1)  ==  [[Image]]
+>>> saturate(<img src="image_logo.png" alt='"image_logo.png"' style="border:1px solid black;vertical-align:middle;margin:1px;" />, amount: -1) == <img src="image_logo_desaturate.png" alt='"image_logo_desaturate.png"' style="border:1px solid black;vertical-align:middle;margin:1px;" />
diff --git a/src/data/field/color.cpp b/src/data/field/color.cpp
index 1c7d0708..82f33804 100644
--- a/src/data/field/color.cpp
+++ b/src/data/field/color.cpp
@@ -41,8 +41,13 @@ IMPLEMENT_REFLECTION(ColorField) {
 // ----------------------------------------------------------------------------- : ColorField::Choice
 
 IMPLEMENT_REFLECTION(ColorField::Choice) {
-	REFLECT(name);
-	REFLECT(color);
+	if (tag.reading() && !tag.isComplex()) {
+		REFLECT_NAMELESS(name);
+		color = parse_color(name);
+	} else {
+		REFLECT(name);
+		REFLECT(color);
+	}
 }
 
 // ----------------------------------------------------------------------------- : ColorStyle
diff --git a/src/gfx/color.hpp b/src/gfx/color.hpp
index 9c6a383f..aff7a1f7 100644
--- a/src/gfx/color.hpp
+++ b/src/gfx/color.hpp
@@ -60,9 +60,31 @@ Color hsl2rgb(double h, double s, double l);
 /// A darker version of a color
 Color darken(const Color& c);
 
+/// A black or white color, that contrasts with c
+Color contrasting_color(const Color& c);
+
 /// A saturated version of a color
 Color saturate(const Color& c, double amount);
 
+/// Recolor:
+/**
+ * Maps
+ *   black -> black
+ *   red   -> cr
+ *   green -> cg
+ *   blue  -> cb
+ *   white -> cw
+ *
+ * Allows for interpolation between the colors, so for example
+ *   rgb(128,128,128) -> 0.5*cw
+ *   rgb(128,128,0)   -> 0.5*cr + 0.5*cg
+ *   rgb(128,0,0)     -> 0.5*cr
+ */
+Color recolor(Color const& c,  Color const& cr, Color const& cg, Color const& cb, Color const& cw);
+Image recolor(Image const& im, Color const& cr, Color const& cg, Color const& cb, Color const& cw);
+/// Like recolor: map green to similar black/white and blue to complementary white/black
+Image recolor(Image const& im, Color const& cr);
+
 /// Fills an image with the specified color
 void fill_image(Image& image, const Color& color);
 
diff --git a/src/gfx/generated_image.cpp b/src/gfx/generated_image.cpp
index 1efbac25..76de5902 100644
--- a/src/gfx/generated_image.cpp
+++ b/src/gfx/generated_image.cpp
@@ -196,6 +196,48 @@ bool SaturateImage::operator == (const GeneratedImage& that) const {
 	             && amount == that2->amount;
 }
 
+// ----------------------------------------------------------------------------- : InvertImage
+
+Image InvertImage::generate(const Options& opt) const {
+	Image img = image->generate(opt);
+	invert(img);
+	return img;
+}
+bool InvertImage::operator == (const GeneratedImage& that) const {
+	const InvertImage* that2 = dynamic_cast<const InvertImage*>(&that);
+	return that2 && *image == *that2->image;
+}
+
+// ----------------------------------------------------------------------------- : FlipImage
+
+Image FlipImageHorizontal::generate(const Options& opt) const {
+	Image img = image->generate(opt);
+	return flip_image_horizontal(img);
+}
+bool FlipImageHorizontal::operator == (const GeneratedImage& that) const {
+	const FlipImageHorizontal* that2 = dynamic_cast<const FlipImageHorizontal*>(&that);
+	return that2 && *image == *that2->image;
+}
+
+Image FlipImageVertical::generate(const Options& opt) const {
+	Image img = image->generate(opt);
+	return flip_image_vertical(img);
+}
+bool FlipImageVertical::operator == (const GeneratedImage& that) const {
+	const FlipImageVertical* that2 = dynamic_cast<const FlipImageVertical*>(&that);
+	return that2 && *image == *that2->image;
+}
+
+Image RotateImage::generate(const Options& opt) const {
+	Image img = image->generate(opt);
+	return rotate_image(img,angle);
+}
+bool RotateImage::operator == (const GeneratedImage& that) const {
+	const RotateImage* that2 = dynamic_cast<const RotateImage*>(&that);
+	return that2 && *image == *that2->image
+	             && angle == that2->angle;
+}
+
 // ----------------------------------------------------------------------------- : EnlargeImage
 
 Image EnlargeImage::generate(const Options& opt) const {
diff --git a/src/gfx/generated_image.hpp b/src/gfx/generated_image.hpp
index c2f9aa8b..a97645f0 100644
--- a/src/gfx/generated_image.hpp
+++ b/src/gfx/generated_image.hpp
@@ -202,6 +202,52 @@ class SaturateImage : public SimpleFilterImage {
 	double amount;
 };
 
+// ----------------------------------------------------------------------------- : InvertImage
+
+/// Invert an image
+class InvertImage : public SimpleFilterImage {
+  public:
+	inline InvertImage(const GeneratedImageP& image)
+		: SimpleFilterImage(image)
+	{}
+	virtual Image generate(const Options& opt) const;
+	virtual bool operator == (const GeneratedImage& that) const;
+};
+
+// ----------------------------------------------------------------------------- : FlipImage
+
+/// Flip an image horizontally
+class FlipImageHorizontal : public SimpleFilterImage {
+  public:
+	inline FlipImageHorizontal(const GeneratedImageP& image)
+		: SimpleFilterImage(image)
+	{}
+	virtual Image generate(const Options& opt) const;
+	virtual bool operator == (const GeneratedImage& that) const;
+};
+
+/// Flip an image vertically
+class FlipImageVertical : public SimpleFilterImage {
+  public:
+	inline FlipImageVertical(const GeneratedImageP& image)
+		: SimpleFilterImage(image)
+	{}
+	virtual Image generate(const Options& opt) const;
+	virtual bool operator == (const GeneratedImage& that) const;
+};
+
+/// Rotate an image
+class RotateImage : public SimpleFilterImage {
+  public:
+	inline RotateImage(const GeneratedImageP& image, double angle)
+		: SimpleFilterImage(image), angle(angle)
+	{}
+	virtual Image generate(const Options& opt) const;
+	virtual bool operator == (const GeneratedImage& that) const;
+  private:
+	double angle;
+};
+
 // ----------------------------------------------------------------------------- : EnlargeImage
 
 /// Enlarge an image by adding a border around it
diff --git a/src/gfx/gfx.hpp b/src/gfx/gfx.hpp
index 077f67e3..7ca61043 100644
--- a/src/gfx/gfx.hpp
+++ b/src/gfx/gfx.hpp
@@ -74,8 +74,12 @@ inline double rad_to_deg(double rad) { return  rad * (180.0 / M_PI); }
 inline double deg_to_rad(double deg) { return  deg * (M_PI / 180.0); }
 
 /// Rotates an image counter clockwise
-/// angle must be a multiple of 90, i.e. {0,90,180,270}
-Image rotate_image(const Image& image, int angle);
+Image rotate_image(const Image& image, double angle);
+
+/// Flip an image horizontally
+Image flip_image_horizontal(const Image& image);
+/// Flip an image vertically
+Image flip_image_vertical(const Image& image);
 
 // ----------------------------------------------------------------------------- : Blending
 
@@ -98,6 +102,9 @@ void mask_blend(Image& img1, const Image& img2, const Image& mask);
 /// Saturate an image
 void saturate(Image& image, double amount);
 
+/// Invert the colors in an image
+void invert(Image& img);
+
 // ----------------------------------------------------------------------------- : Combining
 
 /// Ways in which images can be combined, similair to what Photoshop supports
diff --git a/src/gfx/image_effects.cpp b/src/gfx/image_effects.cpp
index eebdf94d..0a6d4896 100644
--- a/src/gfx/image_effects.cpp
+++ b/src/gfx/image_effects.cpp
@@ -60,3 +60,13 @@ void saturate(Image& image, double amount) {
 		}
 	}
 }
+
+// ----------------------------------------------------------------------------- : Color inversion
+
+void invert(Image& img) {
+	Byte* data = img.GetData();
+	int n = 3 * img.GetWidth() * img.GetHeight();
+	for (int i = 0 ; i < n ; ++i) {
+		data[i] = 255 - data[i];
+	}
+}
diff --git a/src/gfx/rotate_image.cpp b/src/gfx/rotate_image.cpp
index e659bb37..76bfd590 100644
--- a/src/gfx/rotate_image.cpp
+++ b/src/gfx/rotate_image.cpp
@@ -83,24 +83,58 @@ struct Rotate270 {
 
 // ----------------------------------------------------------------------------- : Interface
 
-Image rotate_image(const Image& image, int angle) {
-	switch (angle % 360) {
-		case 0:   return image;
-		case 90:  return rotate_image_impl<Rotate90> (image);
-		case 180: return rotate_image_impl<Rotate180>(image);
-		case 270: return rotate_image_impl<Rotate270>(image);
-		default:
-			if (!image.HasAlpha()) const_cast<Image&>(image).InitAlpha();
-			return image.Rotate(angle * M_PI / 180, wxPoint(0,0));
+double almost_equal(double x, double y) {
+	return fabs(x-y) < 1e-6;
+}
+
+Image rotate_image(const Image& image, double angle) {
+	double a = fmod(angle, 360);
+	if (almost_equal(a,  0)) return image;
+	if (almost_equal(a, 90)) return rotate_image_impl<Rotate90> (image);
+	if (almost_equal(a,180)) return rotate_image_impl<Rotate180>(image);
+	if (almost_equal(a,270)) return rotate_image_impl<Rotate270>(image);
+	else {
+		if (!image.HasAlpha()) const_cast<Image&>(image).InitAlpha();
+		return image.Rotate(angle * M_PI / 180, wxPoint(0,0));
 	}
 }
 
-/*Bitmap rotate_bitmap(const Bitmap& bitmap, int angle) {
-	switch (angle % 360) {
-		case 90:  
-		case 180: 
-		case 270: 
-		default:  return bitmap;
+
+// ----------------------------------------------------------------------------- : Flipping images
+
+// reverse a list of n chunks of size 'step'
+void do_flip(Byte const* in, Byte* out, int step, int n) {
+	for (int i = 0, j = n-1 ; i < n ; ++i, --j) {
+		memcpy(&out[i*step], &in[j*step], step);
 	}
 }
-*/
+void do_flip(Byte const* in, Byte* out, int step1, int n1, int n2) {
+	int step2 = step1 * n1;
+	for (int i = 0 ; i < n2 ; ++i) {
+		do_flip(in,out,step1,n1);
+		in  += step2;
+		out += step2;
+	}
+}
+
+Image flip_image_horizontal(Image const& img) {
+	int w = img.GetWidth(), h= img.GetHeight();
+	Image out(w,h,false);
+	do_flip(img.GetData(), out.GetData(), 3, w, h);
+	if (img.HasAlpha()) {
+		out.InitAlpha();
+		do_flip(img.GetAlpha(), out.GetAlpha(), 1, w, h);
+	}
+	return out;
+}
+
+Image flip_image_vertical(Image const& img) {
+	int w = img.GetWidth(), h= img.GetHeight();
+	Image out(w,h,false);
+	do_flip(img.GetData(), out.GetData(), 3 * w, h);
+	if (img.HasAlpha()) {
+		out.InitAlpha();
+		do_flip(img.GetAlpha(), out.GetAlpha(), 1 * w, h);
+	}
+	return out;
+}
diff --git a/src/script/functions/image.cpp b/src/script/functions/image.cpp
index 09590ee0..bd93c26f 100644
--- a/src/script/functions/image.cpp
+++ b/src/script/functions/image.cpp
@@ -86,6 +86,11 @@ SCRIPT_FUNCTION(saturate) {
 	return intrusive(new SaturateImage(input, amount));
 }
 
+SCRIPT_FUNCTION(invert_image) {
+	SCRIPT_PARAM_C(GeneratedImageP, input);
+	return intrusive(new InvertImage(input));
+}
+
 SCRIPT_FUNCTION(enlarge) {
 	SCRIPT_PARAM_C(GeneratedImageP, input);
 	SCRIPT_PARAM_N(double, _("border size"), border_size);
@@ -101,6 +106,22 @@ SCRIPT_FUNCTION(crop) {
 	return intrusive(new CropImage(input, width, height, offset_x, offset_y));
 }
 
+SCRIPT_FUNCTION(flip_horizontal) {
+	SCRIPT_PARAM_C(GeneratedImageP, input);
+	return intrusive(new FlipImageHorizontal(input));
+}
+
+SCRIPT_FUNCTION(flip_vertical) {
+	SCRIPT_PARAM_C(GeneratedImageP, input);
+	return intrusive(new FlipImageVertical(input));
+}
+
+SCRIPT_FUNCTION(rotate) {
+	SCRIPT_PARAM_C(GeneratedImageP, input);
+	SCRIPT_PARAM_N(double, _("angle"), angle);
+	return intrusive(new RotateImage(input,angle));
+}
+
 SCRIPT_FUNCTION(drop_shadow) {
 	SCRIPT_PARAM_C(GeneratedImageP, input);
 	SCRIPT_OPTIONAL_PARAM_N_(double, _("offset x"),    offset_x);
@@ -190,8 +211,12 @@ void init_script_image_functions(Context& ctx) {
 	ctx.setVariable(_("set alpha"),        script_set_alpha);
 	ctx.setVariable(_("set combine"),      script_set_combine);
 	ctx.setVariable(_("saturate"),         script_saturate);
+	ctx.setVariable(_("invert image"),     script_invert_image);
 	ctx.setVariable(_("enlarge"),          script_enlarge);
 	ctx.setVariable(_("crop"),             script_crop);
+	ctx.setVariable(_("flip horizontal"),  script_flip_horizontal);
+	ctx.setVariable(_("flip vertical"),    script_flip_vertical);
+	ctx.setVariable(_("rotate"),           script_rotate);
 	ctx.setVariable(_("drop shadow"),      script_drop_shadow);
 	ctx.setVariable(_("symbol variation"), script_symbol_variation);
 	ctx.setVariable(_("built in image"),   script_built_in_image);