/* * Copyright (C) 2017 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 EVS_VTS_FRAMEHANDLER_H #define EVS_VTS_FRAMEHANDLER_H #include #include #include #include using namespace ::android::hardware::automotive::evs::V1_0; using ::android::hardware::Return; using ::android::hardware::Void; using ::android::hardware::hidl_vec; using ::android::hardware::hidl_handle; using ::android::sp; /* * FrameHandler: * This class can be used to receive camera imagery from an IEvsCamera implementation. Given an * IEvsDisplay instance at startup, it will forward the received imagery to the display, * providing a trivial implementation of a rear vew camera type application. * Note that the video frames are delivered on a background thread, while the control interface * is actuated from the applications foreground thread. */ class FrameHandler : public IEvsCameraStream { public: enum BufferControlFlag { eAutoReturn, eNoAutoReturn, }; FrameHandler(android::sp pCamera, CameraDesc cameraInfo, android::sp pDisplay = nullptr, BufferControlFlag mode = eAutoReturn); void shutdown(); bool startStream(); void asyncStopStream(); void blockingStopStream(); bool returnHeldBuffer(); bool isRunning(); void waitForFrameCount(unsigned frameCount); void getFramesCounters(unsigned* received, unsigned* displayed); void getFrameDimension(unsigned* width, unsigned* height); private: // Implementation for ::android::hardware::automotive::evs::V1_0::ICarCameraStream Return deliverFrame(const BufferDesc& buffer) override; // Local implementation details bool copyBufferContents(const BufferDesc& tgtBuffer, const BufferDesc& srcBuffer); // Values initialized as startup android::sp mCamera; CameraDesc mCameraInfo; android::sp mDisplay; BufferControlFlag mReturnMode; // Since we get frames delivered to us asnchronously via the ICarCameraStream interface, // we need to protect all member variables that may be modified while we're streaming // (ie: those below) std::mutex mLock; std::condition_variable mSignal; std::queue mHeldBuffers; bool mRunning = false; unsigned mFramesReceived = 0; // Simple counter -- rolls over eventually! unsigned mFramesDisplayed = 0; // Simple counter -- rolls over eventually! unsigned mFrameWidth = 0; unsigned mFrameHeight = 0; }; #endif //EVS_VTS_FRAMEHANDLER_H