X-Git-Url: https://git.sesse.net/?p=movit;a=blobdiff_plain;f=padding_effect.h;h=d922944f81703f5847cc21e36778bdecfba59e42;hp=901f892b9dd14f999776f823bb897370f32d25d5;hb=34776d3ed2565ee834405e575bf3bfc7f7933e36;hpb=c5b9c3df43caa7a88f2f729a5c52359ca8ca537f

diff --git a/padding_effect.h b/padding_effect.h
index 901f892..d922944 100644
--- a/padding_effect.h
+++ b/padding_effect.h
@@ -5,12 +5,26 @@
 // (although the latter is implemented slightly less efficiently, and you cannot both
 // pad and crop in the same effect).
 //
-// The source image is cut off at the texel borders (so there is no interpolation
-// outside them), and then given a user-specific color; by default, full transparent.
+// The source image is cut off at the texture border, and then given a user-specific color;
+// by default, full transparent. You can give a fractional border size (non-integral
+// "top" or "left" offset) if you wish, which will give you linear interpolation of
+// both pixel data of and the border. Furthermore, you can offset where the border falls
+// by using the "border_offset_{top,bottom,left,right}" settings; this is particularly
+// useful if you use ResampleEffect earlier in the chain for high-quality fractional-pixel
+// translation and just want PaddingEffect to get the border right.
 //
 // The border color is taken to be in linear gamma, sRGB, with premultiplied alpha.
 // You may not change it after calling finalize(), since that could change the
 // graph (need_linear_light() etc. depend on the border color you choose).
+//
+// IntegralPaddingEffect is like PaddingEffect, except that "top" and "left" parameters
+// are int parameters instead of float. This allows it to guarantee one-to-one sampling,
+// which can speed up processing by allowing more effect passes to be collapsed.
+// border_offset_* are still allowed to be float, although you should beware that if
+// you set e.g. border_offset_top to a negative value, you will be sampling outside
+// the edge and will read data that is undefined in one-to-one-mode (could be
+// edge repeat, could be something else). With regular PaddingEffect, such samples
+// are guaranteed to be edge repeat.
 
 #include <epoxy/gl.h>
 #include <string>
@@ -31,6 +45,7 @@ public:
 	virtual AlphaHandling alpha_handling() const;
 	
 	virtual bool changes_output_size() const { return true; }
+	virtual bool sets_virtual_output_size() const { return false; }
 	virtual void get_output_size(unsigned *width, unsigned *height, unsigned *virtual_width, unsigned *virtual_height) const;
 	virtual void inform_input_size(unsigned input_num, unsigned width, unsigned height);
 
@@ -39,6 +54,20 @@ private:
 	int input_width, input_height;
 	int output_width, output_height;
 	float top, left;
+	float border_offset_top, border_offset_left;
+	float border_offset_bottom, border_offset_right;
+	float uniform_offset[2], uniform_scale[2];
+	float uniform_normalized_coords_to_texels[2];
+	float uniform_offset_bottomleft[2], uniform_offset_topright[2];
+};
+
+class IntegralPaddingEffect : public PaddingEffect {
+public:
+	IntegralPaddingEffect();
+	virtual std::string effect_type_id() const { return "IntegralPaddingEffect"; }
+	virtual bool one_to_one_sampling() const { return true; }
+	virtual bool set_int(const std::string&, int value);
+	virtual bool set_float(const std::string &key, float value);
 };
 
 }  // namespace movit