+ // Aspect: e.g. 16.0f, 9.0f for 16:9.
+ // resource_pool is a pointer to a ResourcePool with which to share shaders
+ // and other resources (see resource_pool.h). If NULL (the default),
+ // will create its own that is not shared with anything else. Does not take
+ // ownership of the passed-in ResourcePool, but will naturally take ownership
+ // of its own internal one if created.
+ EffectChain(float aspect_nom, float aspect_denom, ResourcePool *resource_pool = NULL);
+ ~EffectChain();
+
+ // User API:
+ // input, effects, output, finalize need to come in that specific order.
+
+ // EffectChain takes ownership of the given input.
+ // input is returned back for convenience.
+ Input *add_input(Input *input);
+
+ // EffectChain takes ownership of the given effect.
+ // effect is returned back for convenience.
+ Effect *add_effect(Effect *effect) {
+ return add_effect(effect, last_added_effect());
+ }
+ Effect *add_effect(Effect *effect, Effect *input) {
+ std::vector<Effect *> inputs;
+ inputs.push_back(input);
+ return add_effect(effect, inputs);
+ }
+ Effect *add_effect(Effect *effect, Effect *input1, Effect *input2) {
+ std::vector<Effect *> inputs;
+ inputs.push_back(input1);
+ inputs.push_back(input2);
+ return add_effect(effect, inputs);
+ }
+ Effect *add_effect(Effect *effect, const std::vector<Effect *> &inputs);
+
+ void add_output(const ImageFormat &format, OutputAlphaFormat alpha_format);
+
+ // Set number of output bits, to scale the dither.
+ // 8 is the right value for most outputs.
+ // The default, 0, is a special value that means no dither.
+ void set_dither_bits(unsigned num_bits)
+ {
+ this->num_dither_bits = num_bits;
+ }
+
+ void finalize();
+