Home | History | Annotate | Download | only in device3 
      1 /*
      2  * Copyright (C) 2013 The Android Open Source Project
      3  *
      4  * Licensed under the Apache License, Version 2.0 (the "License");
      5  * you may not use this file except in compliance with the License.
      6  * You may obtain a copy of the License at
      7  *
      8  *      http://www.apache.org/licenses/LICENSE-2.0
      9  *
     10  * Unless required by applicable law or agreed to in writing, software
     11  * distributed under the License is distributed on an "AS IS" BASIS,
     12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
     13  * See the License for the specific language governing permissions and
     14  * limitations under the License.
     15  */
     16 
     17 #ifndef ANDROID_SERVERS_CAMERA3_ZSL_STREAM_H
     18 #define ANDROID_SERVERS_CAMERA3_ZSL_STREAM_H
     19 
     20 #include <utils/RefBase.h>
     21 #include <gui/Surface.h>
     22 #include <gui/RingBufferConsumer.h>
     23 
     24 #include "Camera3OutputStream.h"
     25 
     26 namespace android {
     27 
     28 namespace camera3 {
     29 
     30 /**
     31  * A class for managing a single opaque ZSL stream to/from the camera device.
     32  * This acts as a bidirectional stream at the HAL layer, caching and discarding
     33  * most output buffers, and when directed, pushes a buffer back to the HAL for
     34  * processing.
     35  */
     36 class Camera3ZslStream :
     37         public Camera3OutputStream {
     38   public:
     39     /**
     40      * Set up a ZSL stream of a given resolution. Depth is the number of buffers
     41      * cached within the stream that can be retrieved for input.
     42      */
     43     Camera3ZslStream(int id, uint32_t width, uint32_t height, int depth);
     44     ~Camera3ZslStream();
     45 
     46     virtual void     dump(int fd, const Vector<String16> &args) const;
     47 
     48     enum { NO_BUFFER_AVAILABLE = BufferQueue::NO_BUFFER_AVAILABLE };
     49 
     50     /**
     51      * Locate a buffer matching this timestamp in the RingBufferConsumer,
     52      * and mark it to be queued at the next getInputBufferLocked invocation.
     53      *
     54      * Errors: Returns NO_BUFFER_AVAILABLE if we could not find a match.
     55      *
     56      */
     57     status_t enqueueInputBufferByTimestamp(nsecs_t timestamp,
     58                                            nsecs_t* actualTimestamp);
     59 
     60     /**
     61      * Clears the buffers that can be used by enqueueInputBufferByTimestamp
     62      */
     63     status_t clearInputRingBuffer();
     64 
     65   protected:
     66 
     67     /**
     68      * Camera3OutputStreamInterface implementation
     69      */
     70     status_t setTransform(int transform);
     71 
     72   private:
     73 
     74     int mDepth;
     75     // Input buffers pending to be queued into HAL
     76     List<sp<RingBufferConsumer::PinnedBufferItem> > mInputBufferQueue;
     77     sp<RingBufferConsumer>                          mProducer;
     78 
     79     // Input buffers in flight to HAL
     80     Vector<sp<RingBufferConsumer::PinnedBufferItem> > mBuffersInFlight;
     81 
     82     /**
     83      * Camera3Stream interface
     84      */
     85 
     86     // getInputBuffer/returnInputBuffer operate the input stream side of the
     87     // ZslStream.
     88     virtual status_t getInputBufferLocked(camera3_stream_buffer *buffer);
     89     virtual status_t returnInputBufferLocked(
     90             const camera3_stream_buffer &buffer);
     91 
     92     // Actual body to return either input or output buffers
     93     virtual status_t returnBufferCheckedLocked(
     94             const camera3_stream_buffer &buffer,
     95             nsecs_t timestamp,
     96             bool output,
     97             /*out*/
     98             sp<Fence> *releaseFenceOut);
     99 }; // class Camera3ZslStream
    100 
    101 }; // namespace camera3
    102 
    103 }; // namespace android
    104 
    105 #endif
    106