1 #ifndef _MOVIT_YCBCR_INPUT_H
2 #define _MOVIT_YCBCR_INPUT_H 1
4 // YCbCrInput is for handling Y'CbCr (also sometimes, usually rather
5 // imprecisely, called “YUV”), which is typically what you get from a video
6 // decoder. It supports these formats:
8 // * 8-bit planar Y'CbCr, possibly subsampled (e.g. 4:2:0).
9 // * 8-bit semiplanar Y'CbCr (Y' in one plane, CbCr in another),
10 // possibly subsampled.
11 // * 8-bit interleaved (chunked) Y'CbCr, no subsampling (4:4:4 only).
12 // * All of the above in 10- and 12-bit versions, where each sample is
13 // stored in a 16-bit int (so the 6 or 4 top bits are wasted).
14 // * 10-bit interleaved (chunked) Y'CbCr packed into 32-bit words
15 // (10:10:10:2), no subsampling (4:4:4 only).
17 // For the planar and semiplanar cases, it upsamples planes as needed, using
18 // the default linear upsampling OpenGL gives you. Note that YCbCr422InterleavedInput
19 // supports the important special case of 8-bit 4:2:2 interleaved.
26 #include "effect_chain.h"
27 #include "image_format.h"
35 // Whether the data is planar (Y', Cb and Cr in one texture each) or not.
36 enum YCbCrInputSplitting {
37 // The standard, default case; Y', Cb and Cr in one texture each.
40 // Y' in one texture, and then Cb and Cr interleaved in one texture.
41 // In particular, this is a superset of the relatively popular NV12 mode.
42 // If you specify this mode, the “Cr” pointer texture will be unused
43 // (the ”Cb” texture contains both).
44 YCBCR_INPUT_SPLIT_Y_AND_CBCR,
46 // Y', Cb and Cr interleaved in the same texture (the “Y” texture;
47 // “Cb” and “Cr” are unused). This means you cannot have any subsampling;
49 YCBCR_INPUT_INTERLEAVED,
52 class YCbCrInput : public Input {
54 // Type can be GL_UNSIGNED_BYTE for 8-bit, GL_UNSIGNED_SHORT for 10- or 12-bit
55 // (or 8-bit, although that's a bit useless), or GL_UNSIGNED_INT_2_10_10_10_REV
56 // for 10-bit (YCBCR_INPUT_INTERLEAVED only).
57 YCbCrInput(const ImageFormat &image_format,
58 const YCbCrFormat &ycbcr_format,
59 unsigned width, unsigned height,
60 YCbCrInputSplitting ycbcr_input_splitting = YCBCR_INPUT_PLANAR,
61 GLenum type = GL_UNSIGNED_BYTE);
64 virtual std::string effect_type_id() const { return "YCbCrInput"; }
66 virtual bool can_output_linear_gamma() const { return false; }
67 virtual AlphaHandling alpha_handling() const { return OUTPUT_BLANK_ALPHA; }
69 std::string output_fragment_shader();
71 // Uploads the texture if it has changed since last time.
72 void set_gl_state(GLuint glsl_program_num, const std::string& prefix, unsigned *sampler_num);
74 unsigned get_width() const { return width; }
75 unsigned get_height() const { return height; }
76 Colorspace get_color_space() const { return image_format.color_space; }
77 GammaCurve get_gamma_curve() const { return image_format.gamma_curve; }
78 virtual bool can_supply_mipmaps() const { return false; }
80 // Tells the input where to fetch the actual pixel data. Note that if you change
81 // this data, you must either call set_pixel_data() again (using the same pointer
82 // is fine), or invalidate_pixel_data(). Otherwise, the texture won't be re-uploaded
83 // on subsequent frames.
85 // The data can either be a regular pointer (if pbo==0), or a byte offset
86 // into a PBO. The latter will allow you to start uploading the texture data
87 // asynchronously to the GPU, if you have any CPU-intensive work between the
88 // call to set_pixel_data() and the actual rendering. In either case,
89 // the pointer (and PBO, if set) has to be valid at the time of the render call.
90 void set_pixel_data(unsigned channel, const unsigned char *pixel_data, GLuint pbo = 0)
92 assert(type == GL_UNSIGNED_BYTE || type == GL_UNSIGNED_INT_2_10_10_10_REV);
93 assert(channel >= 0 && channel < num_channels);
94 this->pixel_data[channel] = pixel_data;
95 this->pbos[channel] = pbo;
96 invalidate_pixel_data();
99 void set_pixel_data(unsigned channel, const uint16_t *pixel_data, GLuint pbo = 0)
101 assert(type == GL_UNSIGNED_SHORT);
102 assert(channel >= 0 && channel < num_channels);
103 this->pixel_data[channel] = reinterpret_cast<const unsigned char *>(pixel_data);
104 this->pbos[channel] = pbo;
105 invalidate_pixel_data();
108 void set_pixel_data(unsigned channel, const uint32_t *pixel_data, GLuint pbo = 0)
110 assert(type == GL_UNSIGNED_INT_2_10_10_10_REV);
111 assert(channel == 0);
112 this->pixel_data[channel] = reinterpret_cast<const unsigned char *>(pixel_data);
113 this->pbos[channel] = pbo;
114 invalidate_pixel_data();
117 void invalidate_pixel_data();
119 // Note: Sets pitch to width, so even if your pitch is unchanged,
120 // you will need to re-set it after this call.
121 void set_width(unsigned width)
126 assert(width % ycbcr_format.chroma_subsampling_x == 0);
127 pitch[0] = widths[0] = width;
128 pitch[1] = widths[1] = width / ycbcr_format.chroma_subsampling_x;
129 pitch[2] = widths[2] = width / ycbcr_format.chroma_subsampling_x;
130 invalidate_pixel_data();
133 void set_height(unsigned height)
136 this->height = height;
138 assert(height % ycbcr_format.chroma_subsampling_y == 0);
140 heights[1] = height / ycbcr_format.chroma_subsampling_y;
141 heights[2] = height / ycbcr_format.chroma_subsampling_y;
142 invalidate_pixel_data();
145 void set_pitch(unsigned channel, unsigned pitch)
148 assert(channel >= 0 && channel < num_channels);
149 this->pitch[channel] = pitch;
150 invalidate_pixel_data();
153 // Tells the input to use the specific OpenGL texture as pixel data for the given
154 // channel. The comments on FlatInput::set_texture_num() also apply here, except
155 // that this input generally does not use mipmaps.
156 void set_texture_num(unsigned channel, GLuint texture_num)
158 possibly_release_texture(channel);
159 this->texture_num[channel] = texture_num;
160 this->owns_texture[channel] = false;
163 virtual void inform_added(EffectChain *chain)
165 resource_pool = chain->get_resource_pool();
168 bool set_int(const std::string& key, int value);
171 // Release the texture in the given channel if we have any, and it is owned by us.
172 void possibly_release_texture(unsigned channel);
174 ImageFormat image_format;
175 YCbCrFormat ycbcr_format;
177 YCbCrInputSplitting ycbcr_input_splitting;
179 GLuint pbos[3], texture_num[3];
180 GLint uniform_tex_y, uniform_tex_cb, uniform_tex_cr;
182 unsigned width, height, widths[3], heights[3];
183 const unsigned char *pixel_data[3];
185 bool owns_texture[3];
186 ResourcePool *resource_pool;
191 #endif // !defined(_MOVIT_YCBCR_INPUT_H)