1ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin/* 2ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * Copyright (C) 2013 The Android Open Source Project 3ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * 4ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * Licensed under the Apache License, Version 2.0 (the "License"); 5ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * you may not use this file except in compliance with the License. 6ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * You may obtain a copy of the License at 7ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * 8ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * http://www.apache.org/licenses/LICENSE-2.0 9ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * 10ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * Unless required by applicable law or agreed to in writing, software 11ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * distributed under the License is distributed on an "AS IS" BASIS, 12ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * See the License for the specific language governing permissions and 14ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * limitations under the License. 15ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin */ 16ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin 17ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin#ifndef ANDROID_SERVERS_CAMERA3_STREAM_INTERFACE_H 18ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin#define ANDROID_SERVERS_CAMERA3_STREAM_INTERFACE_H 19ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin 20ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin#include <utils/RefBase.h> 21ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin#include "Camera3StreamBufferListener.h" 22ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin 23ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkinstruct camera3_stream_buffer; 24ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin 25ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkinnamespace android { 26ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin 27ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkinnamespace camera3 { 28ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin 29f1e98d857ec377f2c9b916073d40732e6ebb7cedEino-Ville Talvalaclass StatusTracker; 30f1e98d857ec377f2c9b916073d40732e6ebb7cedEino-Ville Talvala 31ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin/** 32ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * An interface for managing a single stream of input and/or output data from 33ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * the camera device. 34ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin */ 35ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkinclass Camera3StreamInterface : public virtual RefBase { 36ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin public: 37c78ac26e3a65328fc0118f16ee76a800d0687eb7Ruben Brunk 38c78ac26e3a65328fc0118f16ee76a800d0687eb7Ruben Brunk enum { 39c78ac26e3a65328fc0118f16ee76a800d0687eb7Ruben Brunk ALLOCATE_PIPELINE_MAX = 0, // Allocate max buffers used by a given surface 40c78ac26e3a65328fc0118f16ee76a800d0687eb7Ruben Brunk }; 41c78ac26e3a65328fc0118f16ee76a800d0687eb7Ruben Brunk 42ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin /** 43ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * Get the stream's ID 44ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin */ 45ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin virtual int getId() const = 0; 46ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin 47ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin /** 48ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * Get the stream's dimensions and format 49ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin */ 50ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin virtual uint32_t getWidth() const = 0; 51ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin virtual uint32_t getHeight() const = 0; 52ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin virtual int getFormat() const = 0; 53d46a6b9fd8b2a4f9098757384711e2cd03a91651Eino-Ville Talvala virtual android_dataspace getDataSpace() const = 0; 54ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin 55ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin /** 56ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * Start the stream configuration process. Returns a handle to the stream's 57ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * information to be passed into the HAL device's configure_streams call. 58ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * 59ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * Until finishConfiguration() is called, no other methods on the stream may 60ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * be called. The usage and max_buffers fields of camera3_stream may be 61ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * modified between start/finishConfiguration, but may not be changed after 62ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * that. The priv field of camera3_stream may be modified at any time after 63ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * startConfiguration. 64ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * 65ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * Returns NULL in case of error starting configuration. 66ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin */ 67ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin virtual camera3_stream* startConfiguration() = 0; 68ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin 69ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin /** 70ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * Check if the stream is mid-configuration (start has been called, but not 71ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * finish). Used for lazy completion of configuration. 72ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin */ 73ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin virtual bool isConfiguring() const = 0; 74ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin 75ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin /** 76ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * Completes the stream configuration process. During this call, the stream 77ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * may call the device's register_stream_buffers() method. The stream 78ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * information structure returned by startConfiguration() may no longer be 79ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * modified after this call, but can still be read until the destruction of 80ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * the stream. 81ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * 82ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * Returns: 83ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * OK on a successful configuration 84ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * NO_INIT in case of a serious error from the HAL device 85ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * NO_MEMORY in case of an error registering buffers 86ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * INVALID_OPERATION in case connecting to the consumer failed 87ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin */ 88ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin virtual status_t finishConfiguration(camera3_device *hal3Device) = 0; 89ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin 90ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin /** 911754351d9199721e7e7943461689e399ef015260Eino-Ville Talvala * Cancels the stream configuration process. This returns the stream to the 921754351d9199721e7e7943461689e399ef015260Eino-Ville Talvala * initial state, allowing it to be configured again later. 931754351d9199721e7e7943461689e399ef015260Eino-Ville Talvala * This is done if the HAL rejects the proposed combined stream configuration 941754351d9199721e7e7943461689e399ef015260Eino-Ville Talvala */ 951754351d9199721e7e7943461689e399ef015260Eino-Ville Talvala virtual status_t cancelConfiguration() = 0; 961754351d9199721e7e7943461689e399ef015260Eino-Ville Talvala 971754351d9199721e7e7943461689e399ef015260Eino-Ville Talvala /** 984d44cad22ea925a651463f2d51d6586c14d4b787Eino-Ville Talvala * Determine whether the stream has already become in-use (has received 994d44cad22ea925a651463f2d51d6586c14d4b787Eino-Ville Talvala * a valid filled buffer), which determines if a stream can still have 1004d44cad22ea925a651463f2d51d6586c14d4b787Eino-Ville Talvala * prepareNextBuffer called on it. 1014d44cad22ea925a651463f2d51d6586c14d4b787Eino-Ville Talvala */ 1024d44cad22ea925a651463f2d51d6586c14d4b787Eino-Ville Talvala virtual bool isUnpreparable() = 0; 1034d44cad22ea925a651463f2d51d6586c14d4b787Eino-Ville Talvala 1044d44cad22ea925a651463f2d51d6586c14d4b787Eino-Ville Talvala /** 1054d44cad22ea925a651463f2d51d6586c14d4b787Eino-Ville Talvala * Start stream preparation. May only be called in the CONFIGURED state, 106c78ac26e3a65328fc0118f16ee76a800d0687eb7Ruben Brunk * when no valid buffers have yet been returned to this stream. Prepares 107c78ac26e3a65328fc0118f16ee76a800d0687eb7Ruben Brunk * up to maxCount buffers, or the maximum number of buffers needed by the 108c78ac26e3a65328fc0118f16ee76a800d0687eb7Ruben Brunk * pipeline if maxCount is ALLOCATE_PIPELINE_MAX. 1094d44cad22ea925a651463f2d51d6586c14d4b787Eino-Ville Talvala * 1104d44cad22ea925a651463f2d51d6586c14d4b787Eino-Ville Talvala * If no prepartion is necessary, returns OK and does not transition to 1114d44cad22ea925a651463f2d51d6586c14d4b787Eino-Ville Talvala * PREPARING state. Otherwise, returns NOT_ENOUGH_DATA and transitions 1124d44cad22ea925a651463f2d51d6586c14d4b787Eino-Ville Talvala * to PREPARING. 1134d44cad22ea925a651463f2d51d6586c14d4b787Eino-Ville Talvala * 1144d44cad22ea925a651463f2d51d6586c14d4b787Eino-Ville Talvala * Returns: 1154d44cad22ea925a651463f2d51d6586c14d4b787Eino-Ville Talvala * OK if no more buffers need to be preallocated 1164d44cad22ea925a651463f2d51d6586c14d4b787Eino-Ville Talvala * NOT_ENOUGH_DATA if calls to prepareNextBuffer are needed to finish 1174d44cad22ea925a651463f2d51d6586c14d4b787Eino-Ville Talvala * buffer pre-allocation, and transitions to the PREPARING state. 1184d44cad22ea925a651463f2d51d6586c14d4b787Eino-Ville Talvala * NO_INIT in case of a serious error from the HAL device 1194d44cad22ea925a651463f2d51d6586c14d4b787Eino-Ville Talvala * INVALID_OPERATION if called when not in CONFIGURED state, or a 1204d44cad22ea925a651463f2d51d6586c14d4b787Eino-Ville Talvala * valid buffer has already been returned to this stream. 1214d44cad22ea925a651463f2d51d6586c14d4b787Eino-Ville Talvala */ 122c78ac26e3a65328fc0118f16ee76a800d0687eb7Ruben Brunk virtual status_t startPrepare(int maxCount) = 0; 1234d44cad22ea925a651463f2d51d6586c14d4b787Eino-Ville Talvala 1244d44cad22ea925a651463f2d51d6586c14d4b787Eino-Ville Talvala /** 1254d44cad22ea925a651463f2d51d6586c14d4b787Eino-Ville Talvala * Check if the stream is mid-preparing. 1264d44cad22ea925a651463f2d51d6586c14d4b787Eino-Ville Talvala */ 1274d44cad22ea925a651463f2d51d6586c14d4b787Eino-Ville Talvala virtual bool isPreparing() const = 0; 1284d44cad22ea925a651463f2d51d6586c14d4b787Eino-Ville Talvala 1294d44cad22ea925a651463f2d51d6586c14d4b787Eino-Ville Talvala /** 1304d44cad22ea925a651463f2d51d6586c14d4b787Eino-Ville Talvala * Continue stream buffer preparation by allocating the next 1314d44cad22ea925a651463f2d51d6586c14d4b787Eino-Ville Talvala * buffer for this stream. May only be called in the PREPARED state. 1324d44cad22ea925a651463f2d51d6586c14d4b787Eino-Ville Talvala * 1334d44cad22ea925a651463f2d51d6586c14d4b787Eino-Ville Talvala * Returns OK and transitions to the CONFIGURED state if all buffers 1344d44cad22ea925a651463f2d51d6586c14d4b787Eino-Ville Talvala * are allocated after the call concludes. Otherwise returns NOT_ENOUGH_DATA. 1354d44cad22ea925a651463f2d51d6586c14d4b787Eino-Ville Talvala * 1364d44cad22ea925a651463f2d51d6586c14d4b787Eino-Ville Talvala * Returns: 1374d44cad22ea925a651463f2d51d6586c14d4b787Eino-Ville Talvala * OK if no more buffers need to be preallocated, and transitions 1384d44cad22ea925a651463f2d51d6586c14d4b787Eino-Ville Talvala * to the CONFIGURED state. 1394d44cad22ea925a651463f2d51d6586c14d4b787Eino-Ville Talvala * NOT_ENOUGH_DATA if more calls to prepareNextBuffer are needed to finish 1404d44cad22ea925a651463f2d51d6586c14d4b787Eino-Ville Talvala * buffer pre-allocation. 1414d44cad22ea925a651463f2d51d6586c14d4b787Eino-Ville Talvala * NO_INIT in case of a serious error from the HAL device 1424d44cad22ea925a651463f2d51d6586c14d4b787Eino-Ville Talvala * INVALID_OPERATION if called when not in CONFIGURED state, or a 1434d44cad22ea925a651463f2d51d6586c14d4b787Eino-Ville Talvala * valid buffer has already been returned to this stream. 1444d44cad22ea925a651463f2d51d6586c14d4b787Eino-Ville Talvala */ 1454d44cad22ea925a651463f2d51d6586c14d4b787Eino-Ville Talvala virtual status_t prepareNextBuffer() = 0; 1464d44cad22ea925a651463f2d51d6586c14d4b787Eino-Ville Talvala 1474d44cad22ea925a651463f2d51d6586c14d4b787Eino-Ville Talvala /** 1484d44cad22ea925a651463f2d51d6586c14d4b787Eino-Ville Talvala * Cancel stream preparation early. In case allocation needs to be 1494d44cad22ea925a651463f2d51d6586c14d4b787Eino-Ville Talvala * stopped, this method transitions the stream back to the CONFIGURED state. 1504d44cad22ea925a651463f2d51d6586c14d4b787Eino-Ville Talvala * Buffers that have been allocated with prepareNextBuffer remain that way, 1514d44cad22ea925a651463f2d51d6586c14d4b787Eino-Ville Talvala * but a later use of prepareNextBuffer will require just as many 1524d44cad22ea925a651463f2d51d6586c14d4b787Eino-Ville Talvala * calls as if the earlier prepare attempt had not existed. 1534d44cad22ea925a651463f2d51d6586c14d4b787Eino-Ville Talvala * 1544d44cad22ea925a651463f2d51d6586c14d4b787Eino-Ville Talvala * Returns: 1554d44cad22ea925a651463f2d51d6586c14d4b787Eino-Ville Talvala * OK if cancellation succeeded, and transitions to the CONFIGURED state 1564d44cad22ea925a651463f2d51d6586c14d4b787Eino-Ville Talvala * INVALID_OPERATION if not in the PREPARING state 1574d44cad22ea925a651463f2d51d6586c14d4b787Eino-Ville Talvala * NO_INIT in case of a serious error from the HAL device 1584d44cad22ea925a651463f2d51d6586c14d4b787Eino-Ville Talvala */ 1594d44cad22ea925a651463f2d51d6586c14d4b787Eino-Ville Talvala virtual status_t cancelPrepare() = 0; 1604d44cad22ea925a651463f2d51d6586c14d4b787Eino-Ville Talvala 1614d44cad22ea925a651463f2d51d6586c14d4b787Eino-Ville Talvala /** 162b25e3c87724b6147ed1da7c1d6617c39bfce2fbfEino-Ville Talvala * Tear down memory for this stream. This frees all unused gralloc buffers 163b25e3c87724b6147ed1da7c1d6617c39bfce2fbfEino-Ville Talvala * allocated for this stream, but leaves it ready for operation afterward. 164b25e3c87724b6147ed1da7c1d6617c39bfce2fbfEino-Ville Talvala * 165b25e3c87724b6147ed1da7c1d6617c39bfce2fbfEino-Ville Talvala * May only be called in the CONFIGURED state, and keeps the stream in 166b25e3c87724b6147ed1da7c1d6617c39bfce2fbfEino-Ville Talvala * the CONFIGURED state. 167b25e3c87724b6147ed1da7c1d6617c39bfce2fbfEino-Ville Talvala * 168b25e3c87724b6147ed1da7c1d6617c39bfce2fbfEino-Ville Talvala * Returns: 169b25e3c87724b6147ed1da7c1d6617c39bfce2fbfEino-Ville Talvala * OK if teardown succeeded. 170b25e3c87724b6147ed1da7c1d6617c39bfce2fbfEino-Ville Talvala * INVALID_OPERATION if not in the CONFIGURED state 171b25e3c87724b6147ed1da7c1d6617c39bfce2fbfEino-Ville Talvala * NO_INIT in case of a serious error from the HAL device 172b25e3c87724b6147ed1da7c1d6617c39bfce2fbfEino-Ville Talvala */ 173b25e3c87724b6147ed1da7c1d6617c39bfce2fbfEino-Ville Talvala virtual status_t tearDown() = 0; 174b25e3c87724b6147ed1da7c1d6617c39bfce2fbfEino-Ville Talvala 175b25e3c87724b6147ed1da7c1d6617c39bfce2fbfEino-Ville Talvala /** 176ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * Fill in the camera3_stream_buffer with the next valid buffer for this 177ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * stream, to hand over to the HAL. 178ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * 179ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * This method may only be called once finishConfiguration has been called. 180ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * For bidirectional streams, this method applies to the output-side 181ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * buffers. 182ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * 183ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin */ 184ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin virtual status_t getBuffer(camera3_stream_buffer *buffer) = 0; 185ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin 186ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin /** 187ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * Return a buffer to the stream after use by the HAL. 188ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * 189ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * This method may only be called for buffers provided by getBuffer(). 190ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * For bidirectional streams, this method applies to the output-side buffers 191ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin */ 192ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin virtual status_t returnBuffer(const camera3_stream_buffer &buffer, 193ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin nsecs_t timestamp) = 0; 194ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin 195ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin /** 196ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * Fill in the camera3_stream_buffer with the next valid buffer for this 197ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * stream, to hand over to the HAL. 198ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * 199ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * This method may only be called once finishConfiguration has been called. 200ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * For bidirectional streams, this method applies to the input-side 201ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * buffers. 202ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * 203ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin */ 204ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin virtual status_t getInputBuffer(camera3_stream_buffer *buffer) = 0; 205ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin 206ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin /** 207ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * Return a buffer to the stream after use by the HAL. 208ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * 209ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * This method may only be called for buffers provided by getBuffer(). 210ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * For bidirectional streams, this method applies to the input-side buffers 211ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin */ 212ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin virtual status_t returnInputBuffer(const camera3_stream_buffer &buffer) = 0; 213ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin 214ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin /** 215618ff8a48a0c895a78f91f5692510c2a809425c3Chien-Yu Chen * Get the buffer producer of the input buffer queue. 216618ff8a48a0c895a78f91f5692510c2a809425c3Chien-Yu Chen * 217618ff8a48a0c895a78f91f5692510c2a809425c3Chien-Yu Chen * This method only applies to input streams. 218618ff8a48a0c895a78f91f5692510c2a809425c3Chien-Yu Chen */ 219618ff8a48a0c895a78f91f5692510c2a809425c3Chien-Yu Chen virtual status_t getInputBufferProducer(sp<IGraphicBufferProducer> *producer) = 0; 220618ff8a48a0c895a78f91f5692510c2a809425c3Chien-Yu Chen 221618ff8a48a0c895a78f91f5692510c2a809425c3Chien-Yu Chen /** 222ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * Whether any of the stream's buffers are currently in use by the HAL, 223ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * including buffers that have been returned but not yet had their 224ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * release fence signaled. 225ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin */ 226ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin virtual bool hasOutstandingBuffers() const = 0; 227ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin 228ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin enum { 229ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin TIMEOUT_NEVER = -1 230ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin }; 231f1e98d857ec377f2c9b916073d40732e6ebb7cedEino-Ville Talvala 232ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin /** 233f1e98d857ec377f2c9b916073d40732e6ebb7cedEino-Ville Talvala * Set the state tracker to use for signaling idle transitions. 234ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin */ 235f1e98d857ec377f2c9b916073d40732e6ebb7cedEino-Ville Talvala virtual status_t setStatusTracker(sp<StatusTracker> statusTracker) = 0; 236ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin 237ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin /** 238ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * Disconnect stream from its non-HAL endpoint. After this, 239ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * start/finishConfiguration must be called before the stream can be used 240ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * again. This cannot be called if the stream has outstanding dequeued 241ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * buffers. 242ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin */ 243ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin virtual status_t disconnect() = 0; 244ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin 245ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin /** 246ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin * Debug dump of the stream's state. 247ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin */ 248ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin virtual void dump(int fd, const Vector<String16> &args) const = 0; 249ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin 250ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin virtual void addBufferListener( 251ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin wp<Camera3StreamBufferListener> listener) = 0; 252ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin virtual void removeBufferListener( 253ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin const sp<Camera3StreamBufferListener>& listener) = 0; 254ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin}; 255ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin 256ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin} // namespace camera3 257ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin 258ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin} // namespace android 259ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin 260ae500e53efa1d26eb7c13e62d0ecc8d75db2473aIgor Murashkin#endif 261