graphic_buffer_queue.h File Reference

Graphics buffer queues data structures and functions. More...

#include <libtransistor/types.h>
#include <libtransistor/display/binder.h>
#include <libtransistor/display/graphic_buffer.h>
#include <libtransistor/display/fence.h>
#include <libtransistor/display/rect.h>

Include dependency graph for graphic_buffer_queue.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures
struct	igbp_t
	IGraphicBufferProducer object. More...
struct	compositor_timing_t
	Description here... More...
struct	frame_event_history_delta_t
	ToDo: maybe someday actually implement this. More...
struct	__attribute__
struct	queue_buffer_output_t
	Values received back from queueBuffer. More...

Enumerations
enum	pixel_format_t { RGBA_8888 = 0x1, RGBX_8888 = 0x2, RGB_888 = 0x3 }
	Various pixel formats. More...
enum	disconnect_mode_t { API, ALL_LOCAL }
	Disconnection mode. More...
enum	dataspace_t { UNKNOWN = 0x0 }

Functions
result_t	igbp_request_buffer (igbp_t *igbp, uint32_t slot, uint32_t *status, graphic_buffer_t *gb)
	Request a buffer from the IGraphicBufferProducer. More...
result_t	igbp_dequeue_buffer (igbp_t *igbp, uint32_t width, uint32_t height, pixel_format_t pixel_format, uint32_t usage, bool get_frame_timestamps, uint32_t *status, uint32_t *slot, fence_t *fence, frame_event_history_delta_t *out_timestamps)
	Dequeue a buffer from the IGraphicBufferProducer. More...
result_t	igbp_queue_buffer (igbp_t *igbp, int slot, queue_buffer_input_t *qbi, queue_buffer_output_t *qbo, int *status)
	Queue a buffer to the IGraphicBufferProducer. More...
result_t	igbp_cancel_buffer (igbp_t *igbp, int slot, fence_t *fence)
	Cancel a buffer on the IGraphicBufferProducer. More...
result_t	igbp_query (igbp_t *igbp, int what, int *status, int *value)
	Query values on the IGraphicBufferProducer. More...
result_t	igbp_connect (igbp_t *igbp, int api, bool producer_controlled_by_app, int *status, queue_buffer_output_t *qbo)
	Connect to the IGraphicBufferProducer. More...
result_t	igbp_disconnect (igbp_t *igbp, int api, disconnect_mode_t mode, int *status)
	Disconnect from the IGraphicBufferProducer. More...
result_t	igbp_set_preallocated_buffer (igbp_t *igbp, int slot, graphic_buffer_t *gb)
	Set a pre-allocated buffer on the IGraphicBufferProducer. More...

Detailed Description

Graphics buffer queues data structures and functions.

Enumeration Type Documentation

enum disconnect_mode_t

Disconnection mode.

https://source.android.com/reference/hidl/android/hardware/graphics/bufferqueue/1.0/IGraphicBufferProducer#disconnectmode

enum pixel_format_t

Various pixel formats.

There are more but these are probably the only ones we're ever going to use

Enumerator
RGBA_8888	Full RGBA channels.
RGBX_8888	RGB channels normal, X always 255 (Alpha is ignored)
RGB_888	Only RGB channels, no alpha.

Function Documentation

result_t igbp_cancel_buffer	(	igbp_t *	igbp,
		int	slot,
		fence_t *	fence
	)

Cancel a buffer on the IGraphicBufferProducer.

Parameters

igbp	IGraphicBufferProducer to cancel a buffer on
slot	Slot of the buffer to cancel
fence	Fence that must be waited on before it's ok to overwrite the buffer

https://source.android.com/reference/hidl/android/hardware/graphics/bufferqueue/1.0/IGraphicBufferProducer#cancelbuffer

result_t igbp_connect	(	igbp_t *	igbp,
		int	api,
		bool	producer_controlled_by_app,
		int *	status,
		queue_buffer_output_t *	qbo
	)

Connect to the IGraphicBufferProducer.

Parameters

igbp	IGBP to connect to
api	Description
producer_controlled_by_app	Description
status	Description
qbo	Description

https://source.android.com/reference/hidl/android/hardware/graphics/bufferqueue/1.0/IGraphicBufferProducer#connect

result_t igbp_dequeue_buffer	(	igbp_t *	igbp,
		uint32_t	width,
		uint32_t	height,
		pixel_format_t	pixel_format,
		uint32_t	usage,
		bool	get_frame_timestamps,
		uint32_t *	status,
		uint32_t *	slot,
		fence_t *	fence,
		frame_event_history_delta_t *	out_timestamps
	)

Dequeue a buffer from the IGraphicBufferProducer.

Parameters

igbp	IGraphicBufferProducer to dequeue buffer from
width	Width of buffer to dequeue
height	Height of buffer to dequeue
pixel_format	Pixel format of buffer to dequeue
usage	Usage flags of buffer to sequeue
get_frame_timestamps	Whether or not to get frame timestamps
status	The returned status from the IGraphicBufferProducer interface
slot	The slot of the buffer that was dequeued
fence	The fence to wait on before writing to the dequeued buffer
out_timestamps	Frame event timestamp history

https://source.android.com/reference/hidl/android/hardware/graphics/bufferqueue/1.0/IGraphicBufferProducer#dequeuebuffer

result_t igbp_disconnect	(	igbp_t *	igbp,
		int	api,
		disconnect_mode_t	mode,
		int *	status
	)

Disconnect from the IGraphicBufferProducer.

Parameters

igbp	IGBP to disconnect from
api	Description
mode	Disconnect mode
status	Status output

https://source.android.com/reference/hidl/android/hardware/graphics/bufferqueue/1.0/IGraphicBufferProducer#disconnect

result_t igbp_query	(	igbp_t *	igbp,
		int	what,
		int *	status,
		int *	value
	)

Query values on the IGraphicBufferProducer.

Parameters

igbp	IGBP to query
what	Which value to query
status	Returned status
value	Returned value

https://source.android.com/reference/hidl/android/hardware/graphics/bufferqueue/1.0/IGraphicBufferProducer#query

result_t igbp_queue_buffer	(	igbp_t *	igbp,
		int	slot,
		queue_buffer_input_t *	qbi,
		queue_buffer_output_t *	qbo,
		int *	status
	)

Queue a buffer to the IGraphicBufferProducer.

Parameters

igbp	IGraphicBufferProducer to queue buffer to
slot	Slot of the buffer to queue
qbi	Input parameters
qbo	Output values
status	Status returned from IGraphicBufferProducer

https://source.android.com/reference/hidl/android/hardware/graphics/bufferqueue/1.0/IGraphicBufferProducer#queuebuffer

result_t igbp_request_buffer	(	igbp_t *	igbp,
		uint32_t	slot,
		uint32_t *	status,
		graphic_buffer_t *	gb
	)

Request a buffer from the IGraphicBufferProducer.

Parameters

igbp	IGraphicBufferProducer to request buffer from
slot	Slot to request buffer from
status	The returned status from the IGraphicBufferProducer interface
gb	The requested GraphicBuffer

https://source.android.com/reference/hidl/android/hardware/graphics/bufferqueue/1.0/IGraphicBufferProducer#requestbuffer

result_t igbp_set_preallocated_buffer	(	igbp_t *	igbp,
		int	slot,
		graphic_buffer_t *	gb
	)

Set a pre-allocated buffer on the IGraphicBufferProducer.

Parameters

igbp	IGBP to preallocate a buffer on
slot	Slot to preallocate the buffer in
gb	Preallocated GraphicBuffer

This one seems to be Nintendo custom.