/* * Copyright 2013 The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef SCREENRECORD_OVERLAY_H #define SCREENRECORD_OVERLAY_H #include "Program.h" #include "TextRenderer.h" #include "EglWindow.h" #include <gui/BufferQueue.h> #include <gui/GLConsumer.h> #include <utils/Thread.h> #include <EGL/egl.h> namespace android { /* * Overlay "filter". This sits between the virtual display and the video * encoder. * * Most functions run on a thread created by start(). */ class Overlay : public GLConsumer::FrameAvailableListener, Thread { public: Overlay(bool monotonicTimestamps) : Thread(false), mThreadResult(UNKNOWN_ERROR), mState(UNINITIALIZED), mFrameAvailable(false), mExtTextureName(0), mStartMonotonicNsecs(0), mStartRealtimeNsecs(0), mLastFrameNumber(-1), mTotalDroppedFrames(0), mUseMonotonicTimestamps(monotonicTimestamps) {} // Creates a thread that performs the overlay. Pass in the surface that // output will be sent to. // // This creates a dedicated thread for processing frames. // // Returns a reference to the producer side of a new BufferQueue that will // be used by the virtual display. status_t start(const sp<IGraphicBufferProducer>& outputSurface, sp<IGraphicBufferProducer>* pBufferProducer); // Stops the thread and releases resources. It's okay to call this even // if start() was never called. status_t stop(); // This creates an EGL context and window surface, draws some informative // text on it, swaps the buffer, and then tears the whole thing down. static status_t drawInfoPage(const sp<IGraphicBufferProducer>& outputSurface); private: Overlay(const Overlay&); Overlay& operator=(const Overlay&); // Destruction via RefBase. virtual ~Overlay() { assert(mState == UNINITIALIZED || mState == STOPPED); } // Draw the initial info screen. static void doDrawInfoPage(const EglWindow& window, const Program& texRender, TextRenderer& textRenderer); // (overrides GLConsumer::FrameAvailableListener method) virtual void onFrameAvailable(const BufferItem& item); // (overrides Thread method) virtual bool threadLoop(); // One-time setup (essentially object construction on the overlay thread). status_t setup_l(); // Release all resources held. void release_l(); // Release EGL display, context, surface. void eglRelease_l(); // Process a frame received from the virtual display. void processFrame_l(); // Convert a monotonic time stamp into a string with the current time. void getTimeString_l(nsecs_t monotonicNsec, char* buf, size_t bufLen); // Guards all fields below. Mutex mMutex; // Initialization gate. Condition mStartCond; // Thread status, mostly useful during startup. status_t mThreadResult; // Overlay thread state. States advance from left to right; object may // not be restarted. enum { UNINITIALIZED, INIT, RUNNING, STOPPING, STOPPED } mState; // Event notification. Overlay thread sleeps on this until a frame // arrives or it's time to shut down. Condition mEventCond; // Set by the FrameAvailableListener callback. bool mFrameAvailable; // The surface we send our output to, i.e. the video encoder's input // surface. sp<IGraphicBufferProducer> mOutputSurface; // Producer side of queue, passed into the virtual display. // The consumer end feeds into our GLConsumer. sp<IGraphicBufferProducer> mProducer; // This receives frames from the virtual display and makes them available // as an external texture. sp<GLConsumer> mGlConsumer; // EGL display / context / surface. EglWindow mEglWindow; // GL rendering support. Program mExtTexProgram; Program mTexProgram; // Text rendering. TextRenderer mTextRenderer; // External texture, updated by GLConsumer. GLuint mExtTextureName; // Start time, used to map monotonic to wall-clock time. nsecs_t mStartMonotonicNsecs; nsecs_t mStartRealtimeNsecs; // Used for tracking dropped frames. nsecs_t mLastFrameNumber; size_t mTotalDroppedFrames; bool mUseMonotonicTimestamps; static const char* kPropertyNames[]; }; }; // namespace android #endif /*SCREENRECORD_OVERLAY_H*/