Epok Engine

EPOK RUNTIME

Gte Geometry

gte_geometry.hpp · Geometry Transformation Engine math and register operations

Declarations are extracted from the pinned headers. Examples and general guidance are generated sketches, not verified complete programs; consult the linked source and guides for the actual contract.

Module

Geometry Transformation Engine math and register operations.

Header
gte_geometry.hpp
Include
#include "gte_geometry.hpp"
Stability
Epok runtime API

Include this module

C++ include
#include "gte_geometry.hpp"

Types

Functions and methods

begin_average_depthgte_average_depth in two halves, so CPU work can run during AVSZ.Functionbegin_loaded_projection_tripleBegins loaded projection triple as part of Geometry Transformation Engine math and register operations.Functionbegin_packed_vertexproject_packed_vertex in two halves, so independent CPU work can run while the GTE computes RTPS: begin loads the vertex and issues RTPS; finish (which waits for it) stores the same outputs and returns the same flag verdict.Functionbegin_projection_tripleBegins projection triple as part of Geometry Transformation Engine math and register operations.Functionchecked_compact_projection_inputPer-vertex form for a block whose bounds do not all fit: `sum` is the block center plus the lattice offset.Functioncompact_projection_inputPerforms `compact projection input` as part of Geometry Transformation Engine math and register operations.Functionfinish_packed_vertexPerforms `finish packed vertex` as part of Geometry Transformation Engine math and register operations.Functionfinish_projection_triplePerforms `finish projection triple` as part of Geometry Transformation Engine math and register operations.Functiongte_average_depthAverage of the SZ FIFO after RTPT (SZ1..3) or RTPT+RTPS (SZ0..3).Functiongte_vertex_bounds_fitPerforms `gte vertex bounds fit` as part of Geometry Transformation Engine math and register operations.Functionload_average_depth_scaleAVSZ3/AVSZ4 scale factors; see ordered_gte_depth_average for the contract.Functionload_compact_projection_inputLoads compact projection input as part of Geometry Transformation Engine math and register operations.Function templateload_geometry_matrixUse MAC1..3, not the saturated 16-bit IR registers: the existing renderer's Q12 camera coordinates regularly exceed +/-8 world units.Function templateload_projection_inputFeed each prepared corner straight into its vector registers.Function templateload_projection_matrixLoads projection matrix as part of Geometry Transformation Engine math and register operations.Function templateload_projection_screenH is the pixel focal length shared by both axes; offsets are the screen centre.Functionload_projection_translationCaller validates the signed Q8 translation and retains the loaded rotation.Functionload_projection_wordsLoads projection words as part of Geometry Transformation Engine math and register operations.Function templatepack_projection_inputPerforms `pack projection input` as part of Geometry Transformation Engine math and register operations.Functionproject_geometry_triplePerforms `project geometry triple` as part of Geometry Transformation Engine math and register operations.Functionproject_geometry_vertexCamera output is Q8 with Y up.Function templateproject_packed_vertexPerforms `project packed vertex` as part of Geometry Transformation Engine math and register operations.Functionread_average_depthReads average depth as part of Geometry Transformation Engine math and register operations.Functionstore_projection_tripleSame outputs as finish_projection_triple, stored even when the GTE flagged the projection; returns whether it was unflagged.Functiontransform_geometry_vertexPerforms `transform geometry vertex` as part of Geometry Transformation Engine math and register operations.Function

Fields, variables and values