Lines Matching refs:to
10 * Unless required by applicable law or agreed to in writing, software
35 * the consumer. Calling this may cause some buffer slots to be emptied. If
50 * - @p maxDequeuedBuffers is greater than or equal to 1.
51 * - @p maxDequeuedBuffers is greater than or equal to the number of
53 * If any of these conditions do not hold, or if the request to set the new
68 * Assigns a newly created buffer to the given slot index. The client is
69 * expected to mirror the slot-to-buffer mapping so that it is not necessary
70 * to transfer a `HardwareBuffer` object for every dequeue operation.
72 * If @p slot is not a valid slot index corresponding to a dequeued buffer,
73 * the call shall fail with @p status set to `BAD_VALUE`.
77 * @return buffer New buffer associated to the given slot index.
80 * with `bufferNeedsReallocation` set to `true`, @p generationNumber must
94 * Sets the async flag: whether the producer intends to asynchronously queue
96 * and/or when the swap interval is set to zero.
98 * Enabling async mode may internally allocate an additional buffer to allow
103 * adjustment to the number of slots cannot be made, @p status shall be set
104 * to `BAD_VALUE`.
118 * to dequeue.
125 * glGetIntegerv()). An error due to invalid dimensions may not be reported
162 * Whether the client must discard the mirrored slot-to-buffer
170 * otherwise, the buffer must not be written to until the fence signals.
176 * Requests a new buffer slot for the client to use. Ownership of the slot
177 * is transfered to the client, meaning that the server shall not use the
186 * requestBuffer() to assign a new buffer to that slot.
188 * Once the client is done filling this buffer, it is expected to transfer
189 * buffer ownership back to the server with either cancelBuffer() on
190 * the dequeued slot or to fill in the contents of its associated buffer
193 * If dequeueBuffer() returns with `output.releaseAllBuffers` set to `true`,
194 * the client is expected to release all of the mirrored slot-to-buffer
197 * If dequeueBuffer() returns with `output.bufferNeedsReallocation` set to
198 * `true`, the client is expected to call requestBuffer() immediately.
200 * The returned `output.fence` shall be updated to hold the fence associated
205 * This call shall block until a buffer is available to be dequeued. If
211 * buffers to be violated (such as the maximum number of dequeued buffers),
212 * @p status shall be set to `INVALID_OPERATION` to indicate failure.
237 * Attempts to remove all ownership of the buffer in the given slot from the
241 * to obtain the buffer from this interface. The freed slot shall remain
242 * unallocated until either it is selected to hold a freshly allocated
243 * buffer in dequeueBuffer() or a buffer is attached to the slot. The buffer
257 * Dequeues a buffer slot, requests the buffer associated to the slot, and
258 * detaches it from the buffer queue. This is equivalent to calling
261 * 1. It is unnecessary to provide a #DequeueBufferInput object.
263 * buffer to return, it shall return an error instead.
266 * and the oldest of those shall be returned. @p buffer is equivalent to the
268 * equivalent to the fence that would be returned from dequeueBuffer().
272 * @return fence Fence associated to @p buffer.
284 * Attempts to transfer ownership of a buffer to the buffer queue.
288 * buffer would cause too many buffers to be simultaneously dequeued.
290 * If the returned @p releaseAllBuffers is `true`, the caller is expected to
291 * release all of the mirrored slot-to-buffer mappings.
293 * See dequeueBuffer() for conditions that may cause the call to fail.
295 * @param buffer Buffer to attach to the buffer queue.
298 * must fail with @p status set to `BAD_VALUE`.
300 * @return slot Slot index assigned to @p buffer.
301 * @return releaseAllBuffers Whether the caller is expected to release all
302 * of the mirrored slot-to-buffer mappings.
331 * Crop rectangle that is used as a hint to the consumer.
390 * After a successful queueBuffer() call, #bufferReplaced shall be set to
399 * buffer associated with slot and transfers ownership of that slot back to
402 * @p status may be set to `BAD_VALUE` if any of the following conditions
413 * (refer to the documentation of @ref QueueBufferOutput).
431 * Indicates that the client does not wish to fill in the buffer associated
432 * with the slot and transfers ownership of the slot back to the server. The
453 * @param what What to query. @p what must be one of the values in
469 * Attempts to connect the client as a producer of the buffer queue.
478 * - The number of available slots cannot be adjusted to accommodate the
482 * client wants to be notified when the consumer releases a buffer back
483 * to the buffer queue.
484 * @param api How the client shall write to buffers.
505 * Attempts to disconnect the client from the producer end of the buffer
508 * Calling this method shall cause any subsequent calls to other
509 * @ref IGraphicBufferProducer methods apart from connect() to fail.
510 * A successful connect() call afterwards may allow other methods to succeed
516 * @param api The type of connection to disconnect. Supplying the value of
517 * `CURRENTLY_CONNECTED` to @p api has the same effect as supplying the
534 * This function shall allocate up to the maximum number of buffers
538 * way as for dequeueBuffer() to ensure that the correct number of buffers
539 * are allocated. This is most useful to avoid an allocation delay during
546 * @param width Width of buffers to allocate.
547 * @param height Height of buffers to allocate.
548 * @param format Format of buffers to allocate.
549 * @param usage Usage of bufferes to allocate.
562 * Sets whether dequeueBuffer() is allowed to allocate new buffers.
568 * allows the producer to restrict the eligible slots to those which already
573 * @param allow Whether to allow new buffers to be allocated in
587 * buffer queue, and any attempts to attach a buffer with a different
590 * number defaults to 0, i.e., buffers allocated before the first call to
595 * number if it wants to deprecate old buffers.
605 * Sets how long dequeueBuffer() shall wait for a buffer to become available
612 * By default, the buffer queue shall wait forever, which is equivalent to
613 * setting @p timeoutNs equal to any negative number (such as `-1`). If
615 * non-blocking mode and its corresponding spare buffer (which is used to
619 * setAsyncMode().) If the adjustment to the number of buffers inside the
620 * buffer queue is not feasible, @p status shall be set to `BAD_VALUE`.
622 * @param timeoutNs Amount of time dequeueBuffer() is allowed to block
624 * dequeueBuffer() shall not be able to return `TIMED_OUT`. Instead, it