Support conversion to and from the XYZ color space.
[movit] / ycbcr_input.h
1 #ifndef _YCBCR_INPUT_H
2 #define _YCBCR_INPUT_H 1
3
4 // YCbCrInput is for handling planar 8-bit Y'CbCr (also sometimes, usually rather
5 // imprecisely, called “YUV”), which is typically what you get from a video decoder.
6 // It upsamples planes as needed, using the default linear upsampling OpenGL gives you.
7
8 #include "input.h"
9
10 struct YCbCrFormat {
11         // Which formula for Y' to use.
12         YCbCrLumaCoefficients luma_coefficients;
13
14         // If true, assume Y'CbCr coefficients are full-range, ie. go from 0 to 255
15         // instead of the limited 220/225 steps in classic MPEG. For instance,
16         // JPEG uses the Rec. 601 luma coefficients, but full range.
17         bool full_range;
18
19         // Sampling factors for chroma components. For no subsampling (4:4:4),
20         // set both to 1.
21         unsigned chroma_subsampling_x, chroma_subsampling_y;
22
23         // Positioning of the chroma samples. MPEG-1 and JPEG is (0.5, 0.5);
24         // MPEG-2 and newer typically are (0.0, 0.5).
25         float chroma_x_position, chroma_y_position;
26 };
27
28 class YCbCrInput : public Input {
29 public:
30         YCbCrInput(const ImageFormat &image_format,
31                    const YCbCrFormat &ycbcr_format,
32                    unsigned width, unsigned height);
33         ~YCbCrInput();
34
35         virtual std::string effect_type_id() const { return "YCbCrInput"; }
36
37         // Create the texture itself. We cannot do this in the constructor,
38         // because we don't necessarily know all the settings (sRGB texture,
39         // mipmap generation) at that point.
40         void finalize();
41
42         virtual bool can_output_linear_gamma() const { return false; }
43
44         std::string output_fragment_shader();
45
46         // Uploads the texture if it has changed since last time.
47         void set_gl_state(GLuint glsl_program_num, const std::string& prefix, unsigned *sampler_num);
48
49         unsigned get_width() const { return width; }
50         unsigned get_height() const { return height; }
51         ColorSpace get_color_space() const { return image_format.color_space; }
52         GammaCurve get_gamma_curve() const { return image_format.gamma_curve; }
53
54         // Tells the input where to fetch the actual pixel data. Note that if you change
55         // this data, you must either call set_pixel_data() again (using the same pointer
56         // is fine), or invalidate_pixel_data(). Otherwise, the texture won't be re-uploaded
57         // on subsequent frames.
58         void set_pixel_data(unsigned channel, const unsigned char *pixel_data)
59         {
60                 assert(channel >= 0 && channel < 3);
61                 this->pixel_data[channel] = pixel_data;
62                 invalidate_pixel_data();
63         }
64
65         void invalidate_pixel_data()
66         {
67                 needs_update = true;
68         }
69
70         void set_pitch(unsigned channel, unsigned pitch) {
71                 assert(channel >= 0 && channel < 3);
72                 if (this->pitch[channel] != pitch) {
73                         this->pitch[channel] = pitch;
74                         needs_pbo_recreate = true;
75                 }
76         }
77
78 private:
79         ImageFormat image_format;
80         YCbCrFormat ycbcr_format;
81         GLuint pbos[3], texture_num[3];
82         bool needs_update, needs_pbo_recreate, finalized;
83
84         int needs_mipmaps;
85
86         unsigned width, height, widths[3], heights[3];
87         const unsigned char *pixel_data[3];
88         unsigned pitch[3];
89 };
90
91 #endif // !defined(_YCBCR_INPUT_H)