cb_pop_front
-
void cb_pop_front(int32_t operand, int32_t num_pages)
-
Pops a specified number of tiles from the front of the specified CB. This also frees this number of tiles in the circular buffer. This call is used by the consumer to free up the space in the CB.
We use the convention that the producer pushes tiles into the “back” of the CB queue and the consumer consumes tiles from the “front” of the CB queue.
Note that the act of reading of the tile data from the CB does not free up the space in the CB. Waiting on available tiles and popping them is separated in order to allow the consumer to: 1) read the tile data from the CB via multiple reads of sub-tiles 2) access the tiles (or their sub-tiles) that are visible to the consumer by random access of the valid section of the CB
Return value: None
Argument
Description
Type
Valid Range
Required
cb_id
The index of the circular buffer (CB)
uint32_t
0 to 31
True
num_tiles
The number of tiles to be popped
uint32_t
It must be less or equal than the size of the CB (the total number of tiles that fit into the CB)
True