VirtualDisplaySurface.cpp revision 3559fbf93801e2c0d9d8fb246fb9b867a361b464 
1/*
2 * Copyright 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// #define LOG_NDEBUG 0
18#include "VirtualDisplaySurface.h"
19#include "HWComposer.h"
20
21#include <gui/BufferItem.h>
22#include <gui/IProducerListener.h>
23
24// ---------------------------------------------------------------------------
25namespace android {
26// ---------------------------------------------------------------------------
27
28#if defined(FORCE_HWC_COPY_FOR_VIRTUAL_DISPLAYS)
29static const bool sForceHwcCopy = true;
30#else
31static const bool sForceHwcCopy = false;
32#endif
33
34#define VDS_LOGE(msg, ...) ALOGE("[%s] " msg, \
35        mDisplayName.string(), ##__VA_ARGS__)
36#define VDS_LOGW_IF(cond, msg, ...) ALOGW_IF(cond, "[%s] " msg, \
37        mDisplayName.string(), ##__VA_ARGS__)
38#define VDS_LOGV(msg, ...) ALOGV("[%s] " msg, \
39        mDisplayName.string(), ##__VA_ARGS__)
40
41static const char* dbgCompositionTypeStr(DisplaySurface::CompositionType type) {
42    switch (type) {
43        case DisplaySurface::COMPOSITION_UNKNOWN: return "UNKNOWN";
44        case DisplaySurface::COMPOSITION_GLES:    return "GLES";
45        case DisplaySurface::COMPOSITION_HWC:     return "HWC";
46        case DisplaySurface::COMPOSITION_MIXED:   return "MIXED";
47        default:                                  return "<INVALID>";
48    }
49}
50
51VirtualDisplaySurface::VirtualDisplaySurface(HWComposer& hwc, int32_t dispId,
52        const sp<IGraphicBufferProducer>& sink,
53        const sp<IGraphicBufferProducer>& bqProducer,
54        const sp<IGraphicBufferConsumer>& bqConsumer,
55        const String8& name)
56:   ConsumerBase(bqConsumer),
57    mHwc(hwc),
58    mDisplayId(dispId),
59    mDisplayName(name),
60    mSource{},
61    mDefaultOutputFormat(HAL_PIXEL_FORMAT_IMPLEMENTATION_DEFINED),
62    mOutputFormat(HAL_PIXEL_FORMAT_IMPLEMENTATION_DEFINED),
63    mOutputUsage(GRALLOC_USAGE_HW_COMPOSER),
64    mProducerSlotSource(0),
65    mProducerBuffers(),
66    mQueueBufferOutput(),
67    mSinkBufferWidth(0),
68    mSinkBufferHeight(0),
69    mCompositionType(COMPOSITION_UNKNOWN),
70    mFbFence(Fence::NO_FENCE),
71    mOutputFence(Fence::NO_FENCE),
72    mFbProducerSlot(BufferQueue::INVALID_BUFFER_SLOT),
73    mOutputProducerSlot(BufferQueue::INVALID_BUFFER_SLOT),
74    mDbgState(DBG_STATE_IDLE),
75    mDbgLastCompositionType(COMPOSITION_UNKNOWN),
76    mMustRecompose(false)
77{
78    mSource[SOURCE_SINK] = sink;
79    mSource[SOURCE_SCRATCH] = bqProducer;
80
81    resetPerFrameState();
82
83    int sinkWidth, sinkHeight;
84    sink->query(NATIVE_WINDOW_WIDTH, &sinkWidth);
85    sink->query(NATIVE_WINDOW_HEIGHT, &sinkHeight);
86    mSinkBufferWidth = sinkWidth;
87    mSinkBufferHeight = sinkHeight;
88
89    // Pick the buffer format to request from the sink when not rendering to it
90    // with GLES. If the consumer needs CPU access, use the default format
91    // set by the consumer. Otherwise allow gralloc to decide the format based
92    // on usage bits.
93    int sinkUsage;
94    sink->query(NATIVE_WINDOW_CONSUMER_USAGE_BITS, &sinkUsage);
95    if (sinkUsage & (GRALLOC_USAGE_SW_READ_MASK | GRALLOC_USAGE_SW_WRITE_MASK)) {
96        int sinkFormat;
97        sink->query(NATIVE_WINDOW_FORMAT, &sinkFormat);
98        mDefaultOutputFormat = sinkFormat;
99    } else {
100        mDefaultOutputFormat = HAL_PIXEL_FORMAT_IMPLEMENTATION_DEFINED;
101    }
102    mOutputFormat = mDefaultOutputFormat;
103
104    ConsumerBase::mName = String8::format("VDS: %s", mDisplayName.string());
105    mConsumer->setConsumerName(ConsumerBase::mName);
106    mConsumer->setConsumerUsageBits(GRALLOC_USAGE_HW_COMPOSER);
107    mConsumer->setDefaultBufferSize(sinkWidth, sinkHeight);
108    sink->setAsyncMode(true);
109    IGraphicBufferProducer::QueueBufferOutput output;
110    mSource[SOURCE_SCRATCH]->connect(NULL, NATIVE_WINDOW_API_EGL, false, &output);
111}
112
113VirtualDisplaySurface::~VirtualDisplaySurface() {
114    mSource[SOURCE_SCRATCH]->disconnect(NATIVE_WINDOW_API_EGL);
115}
116
117status_t VirtualDisplaySurface::beginFrame(bool mustRecompose) {
118    if (mDisplayId < 0)
119        return NO_ERROR;
120
121    mMustRecompose = mustRecompose;
122
123    VDS_LOGW_IF(mDbgState != DBG_STATE_IDLE,
124            "Unexpected beginFrame() in %s state", dbgStateStr());
125    mDbgState = DBG_STATE_BEGUN;
126
127    return refreshOutputBuffer();
128}
129
130status_t VirtualDisplaySurface::prepareFrame(CompositionType compositionType) {
131    if (mDisplayId < 0)
132        return NO_ERROR;
133
134    VDS_LOGW_IF(mDbgState != DBG_STATE_BEGUN,
135            "Unexpected prepareFrame() in %s state", dbgStateStr());
136    mDbgState = DBG_STATE_PREPARED;
137
138    mCompositionType = compositionType;
139    if (sForceHwcCopy && mCompositionType == COMPOSITION_GLES) {
140        // Some hardware can do RGB->YUV conversion more efficiently in hardware
141        // controlled by HWC than in hardware controlled by the video encoder.
142        // Forcing GLES-composed frames to go through an extra copy by the HWC
143        // allows the format conversion to happen there, rather than passing RGB
144        // directly to the consumer.
145        //
146        // On the other hand, when the consumer prefers RGB or can consume RGB
147        // inexpensively, this forces an unnecessary copy.
148        mCompositionType = COMPOSITION_MIXED;
149    }
150
151    if (mCompositionType != mDbgLastCompositionType) {
152        VDS_LOGV("prepareFrame: composition type changed to %s",
153                dbgCompositionTypeStr(mCompositionType));
154        mDbgLastCompositionType = mCompositionType;
155    }
156
157    if (mCompositionType != COMPOSITION_GLES &&
158            (mOutputFormat != mDefaultOutputFormat ||
159             mOutputUsage != GRALLOC_USAGE_HW_COMPOSER)) {
160        // We must have just switched from GLES-only to MIXED or HWC
161        // composition. Stop using the format and usage requested by the GLES
162        // driver; they may be suboptimal when HWC is writing to the output
163        // buffer. For example, if the output is going to a video encoder, and
164        // HWC can write directly to YUV, some hardware can skip a
165        // memory-to-memory RGB-to-YUV conversion step.
166        //
167        // If we just switched *to* GLES-only mode, we'll change the
168        // format/usage and get a new buffer when the GLES driver calls
169        // dequeueBuffer().
170        mOutputFormat = mDefaultOutputFormat;
171        mOutputUsage = GRALLOC_USAGE_HW_COMPOSER;
172        refreshOutputBuffer();
173    }
174
175    return NO_ERROR;
176}
177
178#ifndef USE_HWC2
179status_t VirtualDisplaySurface::compositionComplete() {
180    return NO_ERROR;
181}
182#endif
183
184status_t VirtualDisplaySurface::advanceFrame() {
185    if (mDisplayId < 0)
186        return NO_ERROR;
187
188    if (mCompositionType == COMPOSITION_HWC) {
189        VDS_LOGW_IF(mDbgState != DBG_STATE_PREPARED,
190                "Unexpected advanceFrame() in %s state on HWC frame",
191                dbgStateStr());
192    } else {
193        VDS_LOGW_IF(mDbgState != DBG_STATE_GLES_DONE,
194                "Unexpected advanceFrame() in %s state on GLES/MIXED frame",
195                dbgStateStr());
196    }
197    mDbgState = DBG_STATE_HWC;
198
199    if (mOutputProducerSlot < 0 ||
200            (mCompositionType != COMPOSITION_HWC && mFbProducerSlot < 0)) {
201        // Last chance bailout if something bad happened earlier. For example,
202        // in a GLES configuration, if the sink disappears then dequeueBuffer
203        // will fail, the GLES driver won't queue a buffer, but SurfaceFlinger
204        // will soldier on. So we end up here without a buffer. There should
205        // be lots of scary messages in the log just before this.
206        VDS_LOGE("advanceFrame: no buffer, bailing out");
207        return NO_MEMORY;
208    }
209
210    sp<GraphicBuffer> fbBuffer = mFbProducerSlot >= 0 ?
211            mProducerBuffers[mFbProducerSlot] : sp<GraphicBuffer>(NULL);
212    sp<GraphicBuffer> outBuffer = mProducerBuffers[mOutputProducerSlot];
213    VDS_LOGV("advanceFrame: fb=%d(%p) out=%d(%p)",
214            mFbProducerSlot, fbBuffer.get(),
215            mOutputProducerSlot, outBuffer.get());
216
217    // At this point we know the output buffer acquire fence,
218    // so update HWC state with it.
219    mHwc.setOutputBuffer(mDisplayId, mOutputFence, outBuffer);
220
221    status_t result = NO_ERROR;
222    if (fbBuffer != NULL) {
223#ifdef USE_HWC2
224        // TODO: Correctly propagate the dataspace from GL composition
225        result = mHwc.setClientTarget(mDisplayId, mFbFence, fbBuffer,
226                HAL_DATASPACE_UNKNOWN);
227#else
228        result = mHwc.fbPost(mDisplayId, mFbFence, fbBuffer);
229#endif
230    }
231
232    return result;
233}
234
235void VirtualDisplaySurface::onFrameCommitted() {
236    if (mDisplayId < 0)
237        return;
238
239    VDS_LOGW_IF(mDbgState != DBG_STATE_HWC,
240            "Unexpected onFrameCommitted() in %s state", dbgStateStr());
241    mDbgState = DBG_STATE_IDLE;
242
243#ifdef USE_HWC2
244    sp<Fence> retireFence = mHwc.getRetireFence(mDisplayId);
245#else
246    sp<Fence> fbFence = mHwc.getAndResetReleaseFence(mDisplayId);
247#endif
248    if (mCompositionType == COMPOSITION_MIXED && mFbProducerSlot >= 0) {
249        // release the scratch buffer back to the pool
250        Mutex::Autolock lock(mMutex);
251        int sslot = mapProducer2SourceSlot(SOURCE_SCRATCH, mFbProducerSlot);
252        VDS_LOGV("onFrameCommitted: release scratch sslot=%d", sslot);
253#ifdef USE_HWC2
254        addReleaseFenceLocked(sslot, mProducerBuffers[mFbProducerSlot],
255                retireFence);
256#else
257        addReleaseFenceLocked(sslot, mProducerBuffers[mFbProducerSlot], fbFence);
258#endif
259        releaseBufferLocked(sslot, mProducerBuffers[mFbProducerSlot],
260                EGL_NO_DISPLAY, EGL_NO_SYNC_KHR);
261    }
262
263    if (mOutputProducerSlot >= 0) {
264        int sslot = mapProducer2SourceSlot(SOURCE_SINK, mOutputProducerSlot);
265        QueueBufferOutput qbo;
266#ifndef USE_HWC2
267        sp<Fence> outFence = mHwc.getLastRetireFence(mDisplayId);
268#endif
269        VDS_LOGV("onFrameCommitted: queue sink sslot=%d", sslot);
270        if (mMustRecompose) {
271            status_t result = mSource[SOURCE_SINK]->queueBuffer(sslot,
272                    QueueBufferInput(
273                        systemTime(), false /* isAutoTimestamp */,
274                        HAL_DATASPACE_UNKNOWN,
275                        Rect(mSinkBufferWidth, mSinkBufferHeight),
276                        NATIVE_WINDOW_SCALING_MODE_FREEZE, 0 /* transform */,
277#ifdef USE_HWC2
278                        retireFence),
279#else
280                        outFence),
281#endif
282                    &qbo);
283            if (result == NO_ERROR) {
284                updateQueueBufferOutput(qbo);
285            }
286        } else {
287            // If the surface hadn't actually been updated, then we only went
288            // through the motions of updating the display to keep our state
289            // machine happy. We cancel the buffer to avoid triggering another
290            // re-composition and causing an infinite loop.
291#ifdef USE_HWC2
292            mSource[SOURCE_SINK]->cancelBuffer(sslot, retireFence);
293#else
294            mSource[SOURCE_SINK]->cancelBuffer(sslot, outFence);
295#endif
296        }
297    }
298
299    resetPerFrameState();
300}
301
302void VirtualDisplaySurface::dumpAsString(String8& /* result */) const {
303}
304
305void VirtualDisplaySurface::resizeBuffers(const uint32_t w, const uint32_t h) {
306    uint32_t tmpW, tmpH, transformHint, numPendingBuffers;
307    mQueueBufferOutput.deflate(&tmpW, &tmpH, &transformHint, &numPendingBuffers);
308    mQueueBufferOutput.inflate(w, h, transformHint, numPendingBuffers);
309
310    mSinkBufferWidth = w;
311    mSinkBufferHeight = h;
312}
313
314#ifdef USE_HWC2
315const sp<Fence>& VirtualDisplaySurface::getClientTargetAcquireFence() const {
316    return mFbFence;
317}
318#endif
319
320status_t VirtualDisplaySurface::requestBuffer(int pslot,
321        sp<GraphicBuffer>* outBuf) {
322    if (mDisplayId < 0)
323        return mSource[SOURCE_SINK]->requestBuffer(pslot, outBuf);
324
325    VDS_LOGW_IF(mDbgState != DBG_STATE_GLES,
326            "Unexpected requestBuffer pslot=%d in %s state",
327            pslot, dbgStateStr());
328
329    *outBuf = mProducerBuffers[pslot];
330    return NO_ERROR;
331}
332
333status_t VirtualDisplaySurface::setMaxDequeuedBufferCount(
334        int maxDequeuedBuffers) {
335    return mSource[SOURCE_SINK]->setMaxDequeuedBufferCount(maxDequeuedBuffers);
336}
337
338status_t VirtualDisplaySurface::setAsyncMode(bool async) {
339    return mSource[SOURCE_SINK]->setAsyncMode(async);
340}
341
342status_t VirtualDisplaySurface::dequeueBuffer(Source source,
343        PixelFormat format, uint32_t usage, int* sslot, sp<Fence>* fence) {
344    LOG_FATAL_IF(mDisplayId < 0, "mDisplayId=%d but should not be < 0.", mDisplayId);
345
346    status_t result = mSource[source]->dequeueBuffer(sslot, fence,
347            mSinkBufferWidth, mSinkBufferHeight, format, usage);
348    if (result < 0)
349        return result;
350    int pslot = mapSource2ProducerSlot(source, *sslot);
351    VDS_LOGV("dequeueBuffer(%s): sslot=%d pslot=%d result=%d",
352            dbgSourceStr(source), *sslot, pslot, result);
353    uint64_t sourceBit = static_cast<uint64_t>(source) << pslot;
354
355    if ((mProducerSlotSource & (1ULL << pslot)) != sourceBit) {
356        // This slot was previously dequeued from the other source; must
357        // re-request the buffer.
358        result |= BUFFER_NEEDS_REALLOCATION;
359        mProducerSlotSource &= ~(1ULL << pslot);
360        mProducerSlotSource |= sourceBit;
361    }
362
363    if (result & RELEASE_ALL_BUFFERS) {
364        for (uint32_t i = 0; i < BufferQueue::NUM_BUFFER_SLOTS; i++) {
365            if ((mProducerSlotSource & (1ULL << i)) == sourceBit)
366                mProducerBuffers[i].clear();
367        }
368    }
369    if (result & BUFFER_NEEDS_REALLOCATION) {
370        result = mSource[source]->requestBuffer(*sslot, &mProducerBuffers[pslot]);
371        if (result < 0) {
372            mProducerBuffers[pslot].clear();
373            mSource[source]->cancelBuffer(*sslot, *fence);
374            return result;
375        }
376        VDS_LOGV("dequeueBuffer(%s): buffers[%d]=%p fmt=%d usage=%#x",
377                dbgSourceStr(source), pslot, mProducerBuffers[pslot].get(),
378                mProducerBuffers[pslot]->getPixelFormat(),
379                mProducerBuffers[pslot]->getUsage());
380    }
381
382    return result;
383}
384
385status_t VirtualDisplaySurface::dequeueBuffer(int* pslot, sp<Fence>* fence,
386        uint32_t w, uint32_t h, PixelFormat format, uint32_t usage) {
387    if (mDisplayId < 0)
388        return mSource[SOURCE_SINK]->dequeueBuffer(pslot, fence, w, h, format, usage);
389
390    VDS_LOGW_IF(mDbgState != DBG_STATE_PREPARED,
391            "Unexpected dequeueBuffer() in %s state", dbgStateStr());
392    mDbgState = DBG_STATE_GLES;
393
394    VDS_LOGV("dequeueBuffer %dx%d fmt=%d usage=%#x", w, h, format, usage);
395
396    status_t result = NO_ERROR;
397    Source source = fbSourceForCompositionType(mCompositionType);
398
399    if (source == SOURCE_SINK) {
400
401        if (mOutputProducerSlot < 0) {
402            // Last chance bailout if something bad happened earlier. For example,
403            // in a GLES configuration, if the sink disappears then dequeueBuffer
404            // will fail, the GLES driver won't queue a buffer, but SurfaceFlinger
405            // will soldier on. So we end up here without a buffer. There should
406            // be lots of scary messages in the log just before this.
407            VDS_LOGE("dequeueBuffer: no buffer, bailing out");
408            return NO_MEMORY;
409        }
410
411        // We already dequeued the output buffer. If the GLES driver wants
412        // something incompatible, we have to cancel and get a new one. This
413        // will mean that HWC will see a different output buffer between
414        // prepare and set, but since we're in GLES-only mode already it
415        // shouldn't matter.
416
417        usage |= GRALLOC_USAGE_HW_COMPOSER;
418        const sp<GraphicBuffer>& buf = mProducerBuffers[mOutputProducerSlot];
419        if ((usage & ~buf->getUsage()) != 0 ||
420                (format != 0 && format != buf->getPixelFormat()) ||
421                (w != 0 && w != mSinkBufferWidth) ||
422                (h != 0 && h != mSinkBufferHeight)) {
423            VDS_LOGV("dequeueBuffer: dequeueing new output buffer: "
424                    "want %dx%d fmt=%d use=%#x, "
425                    "have %dx%d fmt=%d use=%#x",
426                    w, h, format, usage,
427                    mSinkBufferWidth, mSinkBufferHeight,
428                    buf->getPixelFormat(), buf->getUsage());
429            mOutputFormat = format;
430            mOutputUsage = usage;
431            result = refreshOutputBuffer();
432            if (result < 0)
433                return result;
434        }
435    }
436
437    if (source == SOURCE_SINK) {
438        *pslot = mOutputProducerSlot;
439        *fence = mOutputFence;
440    } else {
441        int sslot;
442        result = dequeueBuffer(source, format, usage, &sslot, fence);
443        if (result >= 0) {
444            *pslot = mapSource2ProducerSlot(source, sslot);
445        }
446    }
447    return result;
448}
449
450status_t VirtualDisplaySurface::detachBuffer(int /* slot */) {
451    VDS_LOGE("detachBuffer is not available for VirtualDisplaySurface");
452    return INVALID_OPERATION;
453}
454
455status_t VirtualDisplaySurface::detachNextBuffer(
456        sp<GraphicBuffer>* /* outBuffer */, sp<Fence>* /* outFence */) {
457    VDS_LOGE("detachNextBuffer is not available for VirtualDisplaySurface");
458    return INVALID_OPERATION;
459}
460
461status_t VirtualDisplaySurface::attachBuffer(int* /* outSlot */,
462        const sp<GraphicBuffer>& /* buffer */) {
463    VDS_LOGE("attachBuffer is not available for VirtualDisplaySurface");
464    return INVALID_OPERATION;
465}
466
467status_t VirtualDisplaySurface::queueBuffer(int pslot,
468        const QueueBufferInput& input, QueueBufferOutput* output) {
469    if (mDisplayId < 0)
470        return mSource[SOURCE_SINK]->queueBuffer(pslot, input, output);
471
472    VDS_LOGW_IF(mDbgState != DBG_STATE_GLES,
473            "Unexpected queueBuffer(pslot=%d) in %s state", pslot,
474            dbgStateStr());
475    mDbgState = DBG_STATE_GLES_DONE;
476
477    VDS_LOGV("queueBuffer pslot=%d", pslot);
478
479    status_t result;
480    if (mCompositionType == COMPOSITION_MIXED) {
481        // Queue the buffer back into the scratch pool
482        QueueBufferOutput scratchQBO;
483        int sslot = mapProducer2SourceSlot(SOURCE_SCRATCH, pslot);
484        result = mSource[SOURCE_SCRATCH]->queueBuffer(sslot, input, &scratchQBO);
485        if (result != NO_ERROR)
486            return result;
487
488        // Now acquire the buffer from the scratch pool -- should be the same
489        // slot and fence as we just queued.
490        Mutex::Autolock lock(mMutex);
491        BufferItem item;
492        result = acquireBufferLocked(&item, 0);
493        if (result != NO_ERROR)
494            return result;
495        VDS_LOGW_IF(item.mSlot != sslot,
496                "queueBuffer: acquired sslot %d from SCRATCH after queueing sslot %d",
497                item.mSlot, sslot);
498        mFbProducerSlot = mapSource2ProducerSlot(SOURCE_SCRATCH, item.mSlot);
499        mFbFence = mSlots[item.mSlot].mFence;
500
501    } else {
502        LOG_FATAL_IF(mCompositionType != COMPOSITION_GLES,
503                "Unexpected queueBuffer in state %s for compositionType %s",
504                dbgStateStr(), dbgCompositionTypeStr(mCompositionType));
505
506        // Extract the GLES release fence for HWC to acquire
507        int64_t timestamp;
508        bool isAutoTimestamp;
509        android_dataspace dataSpace;
510        Rect crop;
511        int scalingMode;
512        uint32_t transform;
513        input.deflate(&timestamp, &isAutoTimestamp, &dataSpace, &crop,
514                &scalingMode, &transform, &mFbFence);
515
516        mFbProducerSlot = pslot;
517        mOutputFence = mFbFence;
518    }
519
520    *output = mQueueBufferOutput;
521    return NO_ERROR;
522}
523
524status_t VirtualDisplaySurface::cancelBuffer(int pslot,
525        const sp<Fence>& fence) {
526    if (mDisplayId < 0)
527        return mSource[SOURCE_SINK]->cancelBuffer(mapProducer2SourceSlot(SOURCE_SINK, pslot), fence);
528
529    VDS_LOGW_IF(mDbgState != DBG_STATE_GLES,
530            "Unexpected cancelBuffer(pslot=%d) in %s state", pslot,
531            dbgStateStr());
532    VDS_LOGV("cancelBuffer pslot=%d", pslot);
533    Source source = fbSourceForCompositionType(mCompositionType);
534    return mSource[source]->cancelBuffer(
535            mapProducer2SourceSlot(source, pslot), fence);
536}
537
538int VirtualDisplaySurface::query(int what, int* value) {
539    switch (what) {
540        case NATIVE_WINDOW_WIDTH:
541            *value = mSinkBufferWidth;
542            break;
543        case NATIVE_WINDOW_HEIGHT:
544            *value = mSinkBufferHeight;
545            break;
546        default:
547            return mSource[SOURCE_SINK]->query(what, value);
548    }
549    return NO_ERROR;
550}
551
552status_t VirtualDisplaySurface::connect(const sp<IProducerListener>& listener,
553        int api, bool producerControlledByApp,
554        QueueBufferOutput* output) {
555    QueueBufferOutput qbo;
556    status_t result = mSource[SOURCE_SINK]->connect(listener, api,
557            producerControlledByApp, &qbo);
558    if (result == NO_ERROR) {
559        updateQueueBufferOutput(qbo);
560        *output = mQueueBufferOutput;
561    }
562    return result;
563}
564
565status_t VirtualDisplaySurface::disconnect(int api) {
566    return mSource[SOURCE_SINK]->disconnect(api);
567}
568
569status_t VirtualDisplaySurface::setSidebandStream(const sp<NativeHandle>& /*stream*/) {
570    return INVALID_OPERATION;
571}
572
573void VirtualDisplaySurface::allocateBuffers(uint32_t /* width */,
574        uint32_t /* height */, PixelFormat /* format */, uint32_t /* usage */) {
575    // TODO: Should we actually allocate buffers for a virtual display?
576}
577
578status_t VirtualDisplaySurface::allowAllocation(bool /* allow */) {
579    return INVALID_OPERATION;
580}
581
582status_t VirtualDisplaySurface::setGenerationNumber(uint32_t /* generation */) {
583    ALOGE("setGenerationNumber not supported on VirtualDisplaySurface");
584    return INVALID_OPERATION;
585}
586
587String8 VirtualDisplaySurface::getConsumerName() const {
588    return String8("VirtualDisplaySurface");
589}
590
591uint64_t VirtualDisplaySurface::getNextFrameNumber() const {
592    return 0;
593}
594
595status_t VirtualDisplaySurface::setSharedBufferMode(bool /*sharedBufferMode*/) {
596    ALOGE("setSharedBufferMode not supported on VirtualDisplaySurface");
597    return INVALID_OPERATION;
598}
599
600status_t VirtualDisplaySurface::setAutoRefresh(bool /*autoRefresh*/) {
601    ALOGE("setAutoRefresh not supported on VirtualDisplaySurface");
602    return INVALID_OPERATION;
603}
604
605status_t VirtualDisplaySurface::setDequeueTimeout(nsecs_t /* timeout */) {
606    ALOGE("setDequeueTimeout not supported on VirtualDisplaySurface");
607    return INVALID_OPERATION;
608}
609
610void VirtualDisplaySurface::updateQueueBufferOutput(
611        const QueueBufferOutput& qbo) {
612    uint32_t w, h, transformHint, numPendingBuffers;
613    qbo.deflate(&w, &h, &transformHint, &numPendingBuffers);
614    mQueueBufferOutput.inflate(w, h, 0, numPendingBuffers);
615}
616
617void VirtualDisplaySurface::resetPerFrameState() {
618    mCompositionType = COMPOSITION_UNKNOWN;
619    mFbFence = Fence::NO_FENCE;
620    mOutputFence = Fence::NO_FENCE;
621    mOutputProducerSlot = -1;
622    mFbProducerSlot = -1;
623}
624
625status_t VirtualDisplaySurface::refreshOutputBuffer() {
626    if (mOutputProducerSlot >= 0) {
627        mSource[SOURCE_SINK]->cancelBuffer(
628                mapProducer2SourceSlot(SOURCE_SINK, mOutputProducerSlot),
629                mOutputFence);
630    }
631
632    int sslot;
633    status_t result = dequeueBuffer(SOURCE_SINK, mOutputFormat, mOutputUsage,
634            &sslot, &mOutputFence);
635    if (result < 0)
636        return result;
637    mOutputProducerSlot = mapSource2ProducerSlot(SOURCE_SINK, sslot);
638
639    // On GLES-only frames, we don't have the right output buffer acquire fence
640    // until after GLES calls queueBuffer(). So here we just set the buffer
641    // (for use in HWC prepare) but not the fence; we'll call this again with
642    // the proper fence once we have it.
643    result = mHwc.setOutputBuffer(mDisplayId, Fence::NO_FENCE,
644            mProducerBuffers[mOutputProducerSlot]);
645
646    return result;
647}
648
649// This slot mapping function is its own inverse, so two copies are unnecessary.
650// Both are kept to make the intent clear where the function is called, and for
651// the (unlikely) chance that we switch to a different mapping function.
652int VirtualDisplaySurface::mapSource2ProducerSlot(Source source, int sslot) {
653    if (source == SOURCE_SCRATCH) {
654        return BufferQueue::NUM_BUFFER_SLOTS - sslot - 1;
655    } else {
656        return sslot;
657    }
658}
659int VirtualDisplaySurface::mapProducer2SourceSlot(Source source, int pslot) {
660    return mapSource2ProducerSlot(source, pslot);
661}
662
663VirtualDisplaySurface::Source
664VirtualDisplaySurface::fbSourceForCompositionType(CompositionType type) {
665    return type == COMPOSITION_MIXED ? SOURCE_SCRATCH : SOURCE_SINK;
666}
667
668const char* VirtualDisplaySurface::dbgStateStr() const {
669    switch (mDbgState) {
670        case DBG_STATE_IDLE:      return "IDLE";
671        case DBG_STATE_PREPARED:  return "PREPARED";
672        case DBG_STATE_GLES:      return "GLES";
673        case DBG_STATE_GLES_DONE: return "GLES_DONE";
674        case DBG_STATE_HWC:       return "HWC";
675        default:                  return "INVALID";
676    }
677}
678
679const char* VirtualDisplaySurface::dbgSourceStr(Source s) {
680    switch (s) {
681        case SOURCE_SINK:    return "SINK";
682        case SOURCE_SCRATCH: return "SCRATCH";
683        default:             return "INVALID";
684    }
685}
686
687// ---------------------------------------------------------------------------
688} // namespace android
689// ---------------------------------------------------------------------------
690