ra8_tile_prefetch_req_t Struct Reference

A predictive pan-prefetch request: what is visible + where it heads. More...

#include <ra8_tile_cache.h>

Collaboration diagram for ra8_tile_prefetch_req_t:

Data Fields
uint32_t	image_id
	Tile-cache key image id (the image panned).
ra8_tile_rect_t	view
	The tiles the viewport currently straddles.
uint16_t	tile_cols
	Image tile columns (lead-edge clamp bound).
uint16_t	tile_rows
	Image tile rows (lead-edge clamp bound).
uint16_t	zoom
	Zoom / mip level for the key (0 = native).
uint16_t	max_tiles
	Residency budget: warm at most this many.
ra8_tile_pan_dir_t	dir
	Direction of viewport travel.

Detailed Description

A predictive pan-prefetch request: what is visible + where it heads.

Describes the visible tile rectangle (view), the tile grid extent used to clamp the lead edge to the image (tile_cols / tile_rows), the direction of travel (dir), and the residency budget (max_tiles) that caps how many tiles the prefetch may warm so it never exceeds the cache's spare capacity.

Invariant

view.tx1 < tile_cols and view.ty1 < tile_rows.

See also

ra8_tile_cache_prefetch_pan

Since

0.1.0

Definition at line 220 of file ra8_tile_cache.h.

Field Documentation

dir

ra8_tile_pan_dir_t ra8_tile_prefetch_req_t::dir

Direction of viewport travel.

Definition at line 227 of file ra8_tile_cache.h.

Referenced by internal_pan_line().

image_id

uint32_t ra8_tile_prefetch_req_t::image_id

Tile-cache key image id (the image panned).

Definition at line 221 of file ra8_tile_cache.h.

Referenced by ra8_tile_cache_prefetch_pan().

max_tiles

uint16_t ra8_tile_prefetch_req_t::max_tiles

Residency budget: warm at most this many.

Definition at line 226 of file ra8_tile_cache.h.

Referenced by ra8_tile_cache_prefetch_pan().

tile_cols

uint16_t ra8_tile_prefetch_req_t::tile_cols

Image tile columns (lead-edge clamp bound).

Definition at line 223 of file ra8_tile_cache.h.

Referenced by internal_pan_line(), and internal_validate_req().

tile_rows

uint16_t ra8_tile_prefetch_req_t::tile_rows

Image tile rows (lead-edge clamp bound).

Definition at line 224 of file ra8_tile_cache.h.

Referenced by internal_pan_line(), and internal_validate_req().

view

ra8_tile_rect_t ra8_tile_prefetch_req_t::view

The tiles the viewport currently straddles.

Definition at line 222 of file ra8_tile_cache.h.

Referenced by internal_pan_line(), and internal_validate_req().

zoom

uint16_t ra8_tile_prefetch_req_t::zoom

Zoom / mip level for the key (0 = native).

Definition at line 225 of file ra8_tile_cache.h.

Referenced by ra8_tile_cache_prefetch_pan().

---

The documentation for this struct was generated from the following file:

• libs/ra8_mem/inc/ra8_tile_cache.h