+
+ bool is_zerocopy() const;
+
+ // Allocate a frame to render into. The returned two textures
+ // are yours to render into (build them into an FBO).
+ // Call end_frame() when you're done.
+ //
+ // The semantics of y_tex and cbcr_tex depend on is_zerocopy():
+ //
+ // - If false, the are input parameters, ie., the caller
+ // allocates textures. (The contents are not read before
+ // end_frame() is called.)
+ // - If true, they are output parameters, ie., VideoEncoder
+ // allocates textures and borrow them to you for rendering.
+ // In this case, after end_frame(), you are no longer allowed
+ // to use the textures; they are torn down and given to the
+ // H.264 encoder.
+ bool begin_frame(int64_t pts, int64_t duration, movit::YCbCrLumaCoefficients ycbcr_coefficients, const std::vector<RefCountedFrame> &input_frames, GLuint *y_tex, GLuint *cbcr_tex);
+
+ // Call after you are done rendering into the frame; at this point,
+ // y_tex and cbcr_tex will be assumed done, and handed over to the
+ // encoder. The returned fence is purely a convenience; you do not
+ // need to use it for anything, but it's useful if you wanted to set
+ // one anyway.
+ RefCountedGLsync end_frame();