OLD | NEW |
| (Empty) |
1 // Copyright (c) 2013 The Chromium Authors. All rights reserved. | |
2 // Use of this source code is governed by a BSD-style license that can be | |
3 // found in the LICENSE file. | |
4 | |
5 #ifndef CONTENT_BROWSER_RENDERER_HOST_COMPOSITING_IOSURFACE_TRANSFORMER_MAC_H_ | |
6 #define CONTENT_BROWSER_RENDERER_HOST_COMPOSITING_IOSURFACE_TRANSFORMER_MAC_H_ | |
7 | |
8 #include <OpenGL/gl.h> | |
9 | |
10 #include "base/basictypes.h" | |
11 #include "content/browser/renderer_host/compositing_iosurface_shader_programs_ma
c.h" | |
12 #include "ui/gfx/size.h" | |
13 | |
14 namespace gfx { | |
15 class Rect; | |
16 } // namespace gfx | |
17 | |
18 namespace content { | |
19 | |
20 // Provides useful image filtering operations that are implemented efficiently | |
21 // using OpenGL shader programs. | |
22 // | |
23 // Note: All methods assume to be called within an active OpenGL context. | |
24 class CompositingIOSurfaceTransformer { | |
25 public: | |
26 // Construct a transformer that always uses the given parameters for texture | |
27 // bindings. |texture_target| is one of the valid enums to use with | |
28 // glBindTexture(). | |
29 // |src_texture_needs_y_flip| is true when the |src_texture| argument to any | |
30 // of the methods below uses upside-down Y coordinates. | |
31 // |shader_program_cache| is not owned by this instance. | |
32 CompositingIOSurfaceTransformer( | |
33 GLenum texture_target, bool src_texture_needs_y_flip, | |
34 CompositingIOSurfaceShaderPrograms* shader_program_cache); | |
35 | |
36 ~CompositingIOSurfaceTransformer(); | |
37 | |
38 // Delete any references to currently-cached OpenGL objects. This must be | |
39 // called within the OpenGL context just before destruction. | |
40 void ReleaseCachedGLObjects(); | |
41 | |
42 // Resize using bilinear interpolation. Returns false on error. Otherwise, | |
43 // the |texture| argument will point to the result. Ownership of the returned | |
44 // |texture| remains with CompositingIOSurfaceTransformer (i.e., the caller | |
45 // must not delete this texture). The |texture| remains valid until the next | |
46 // call to ResizeBilinear() or ReleaseCachedGLObjects(). | |
47 // | |
48 // If the src and dst sizes are identical, this becomes a simple copy into a | |
49 // new texture. | |
50 // | |
51 // Note: This implementation is faulty in that minifications by more than 2X | |
52 // will undergo aliasing. | |
53 bool ResizeBilinear(GLuint src_texture, const gfx::Rect& src_subrect, | |
54 const gfx::Size& dst_size, GLuint* texture); | |
55 | |
56 // Color format conversion from RGB to planar YV12 (also known as YUV420). | |
57 // | |
58 // YV12 is effectively a twelve bit per pixel format consisting of a full- | |
59 // size y (luminance) plane and half-width, half-height u and v (blue and | |
60 // red chrominance) planes. This method will return three off-screen | |
61 // textures, one for each plane, via the output arguments |texture_y|, | |
62 // |texture_u|, and |texture_v|. While the textures are in GL_RGBA format, | |
63 // they should be interpreted as the appropriate single-byte, planar format | |
64 // after reading the pixel data. The output arguments |packed_y_size| and | |
65 // |packed_uv_size| follow from these special semantics: They represent the | |
66 // size of their corresponding texture, if it was to be treated like RGBA | |
67 // pixel data. That means their widths are in terms of "quads," where one | |
68 // quad contains 4 Y (or U or V) pixels. | |
69 // | |
70 // Ownership of the returned textures remains with | |
71 // CompositingIOSurfaceTransformer (i.e., the caller must not delete the | |
72 // textures). The textures remain valid until the next call to | |
73 // TransformRGBToYV12() or ReleaseCachedGLObjects(). | |
74 // | |
75 // If |src_subrect|'s size does not match |dst_size|, the source will be | |
76 // bilinearly interpolated during conversion. | |
77 // | |
78 // Returns true if successful, and the caller is responsible for deleting the | |
79 // output textures. | |
80 bool TransformRGBToYV12( | |
81 GLuint src_texture, const gfx::Rect& src_subrect, | |
82 const gfx::Size& dst_size, | |
83 GLuint* texture_y, GLuint* texture_u, GLuint* texture_v, | |
84 gfx::Size* packed_y_size, gfx::Size* packed_uv_size); | |
85 | |
86 private: | |
87 enum CachedTexture { | |
88 RGBA_OUTPUT = 0, | |
89 Y_PLANE_OUTPUT, | |
90 UUVV_INTERMEDIATE, | |
91 U_PLANE_OUTPUT, | |
92 V_PLANE_OUTPUT, | |
93 NUM_CACHED_TEXTURES | |
94 }; | |
95 | |
96 // If necessary, generate the texture and/or resize it to the given |size|. | |
97 void PrepareTexture(CachedTexture which, const gfx::Size& size); | |
98 | |
99 // If necessary, generate a framebuffer object to be used as an intermediate | |
100 // destination for drawing. | |
101 void PrepareFramebuffer(); | |
102 | |
103 // Target to bind all input and output textures to (which defines the type of | |
104 // textures being created and read). Generally, this is | |
105 // GL_TEXTURE_RECTANGLE_ARB. | |
106 const GLenum texture_target_; | |
107 const bool src_texture_needs_y_flip_; | |
108 CompositingIOSurfaceShaderPrograms* const shader_program_cache_; | |
109 | |
110 // Cached OpenGL objects. | |
111 GLuint textures_[NUM_CACHED_TEXTURES]; | |
112 gfx::Size texture_sizes_[NUM_CACHED_TEXTURES]; | |
113 GLuint frame_buffer_; | |
114 | |
115 // Auto-detected and set once in the constructor. | |
116 bool system_supports_multiple_draw_buffers_; | |
117 | |
118 DISALLOW_COPY_AND_ASSIGN(CompositingIOSurfaceTransformer); | |
119 }; | |
120 | |
121 } // namespace content | |
122 | |
123 #endif // CONTENT_BROWSER_RENDERER_HOST_COMPOSITING_IOSURFACE_TRANSFORMER_MAC_H
_ | |
OLD | NEW |