feat(graphics): migrate native target to 640x360
Intrepid/Prometeu/Runtime/pipeline/head This commit looks good
Intrepid/Prometeu/Runtime/pipeline/head This commit looks good
Centralize the fixed 640x360 RGBA8888/60 Hz contract in the existing HAL. Preserve 8/16/32 tiles and composition, cover partial edges and mixed-size camera movement, and adapt firmware, fixtures, hosts and native tests. Share nearest-neighbor presentation geometry with pointer input. Measure actual framebuffer publications and successful host presentations separately from VM ticks, with bounded opt-in diagnostics and release harnesses. Validated with the complete tooling verify gate, native rendering tests, GPU readback, headless/process integration, formatting and strict clippy. The existing synchronous session path is documented; no worker/session architecture replacement or format compatibility layer is introduced. Work: WRK-0016 / DEC-0001 / PLN-0001 Commit and push explicitly authorized by the user after completion.
This commit is contained in:
@@ -0,0 +1,20 @@
|
||||
//! Fixed machine graphics contract. Host surfaces never change these dimensions.
|
||||
pub const WIDTH: usize = 640;
|
||||
pub const HEIGHT: usize = 360;
|
||||
pub const REFRESH_HZ: u32 = 60;
|
||||
/// Canonical RGBA8888, with tightly packed native rows.
|
||||
pub const BYTES_PER_PIXEL: usize = 4;
|
||||
pub const PIXELS: usize = WIDTH * HEIGHT;
|
||||
pub const STRIDE_PIXELS: usize = WIDTH;
|
||||
pub const STRIDE_BYTES: usize = STRIDE_PIXELS * BYTES_PER_PIXEL;
|
||||
pub const FRAME_BYTES: usize = STRIDE_BYTES * HEIGHT;
|
||||
|
||||
#[cfg(test)]
|
||||
mod tests {
|
||||
use super::*;
|
||||
#[test]
|
||||
fn native_graphics_contract_is_fixed() {
|
||||
assert_eq!((WIDTH, HEIGHT, REFRESH_HZ), (640, 360, 60));
|
||||
assert_eq!((PIXELS, STRIDE_BYTES, FRAME_BYTES), (230_400, 2_560, 921_600));
|
||||
}
|
||||
}
|
||||
@@ -12,6 +12,7 @@ pub mod debugger_protocol;
|
||||
pub mod gfx_bridge;
|
||||
pub mod glyph;
|
||||
pub mod glyph_bank;
|
||||
pub mod graphics_contract;
|
||||
pub mod host_context;
|
||||
pub mod host_return;
|
||||
pub mod input_signals;
|
||||
|
||||
@@ -64,7 +64,7 @@ pub trait RuntimePlatform {
|
||||
fn wall_clock(&self) -> &dyn WallClock;
|
||||
|
||||
fn display_size(&self) -> (usize, usize) {
|
||||
(480, 270)
|
||||
(crate::graphics_contract::WIDTH, crate::graphics_contract::HEIGHT)
|
||||
}
|
||||
|
||||
fn render_submission_sink(&mut self) -> &mut dyn RenderSubmissionSink;
|
||||
|
||||
@@ -224,6 +224,8 @@ impl SceneViewportResolver {
|
||||
scene_height_tiles: usize,
|
||||
) -> TileAnchor {
|
||||
let mut next = current;
|
||||
// Mixed layers must not step past the center and immediately step back.
|
||||
let trigger = self.hysteresis_trigger_px.max(tile_size_px / 2);
|
||||
|
||||
loop {
|
||||
let center_x_px = next.x * tile_size_px + tile_size_px / 2;
|
||||
@@ -231,11 +233,11 @@ impl SceneViewportResolver {
|
||||
if drift_x.abs() <= self.hysteresis_safe_px {
|
||||
break;
|
||||
}
|
||||
if drift_x > self.hysteresis_trigger_px {
|
||||
if drift_x > trigger {
|
||||
next.x += 1;
|
||||
continue;
|
||||
}
|
||||
if drift_x < -self.hysteresis_trigger_px {
|
||||
if drift_x < -trigger {
|
||||
next.x -= 1;
|
||||
continue;
|
||||
}
|
||||
@@ -248,11 +250,11 @@ impl SceneViewportResolver {
|
||||
if drift_y.abs() <= self.hysteresis_safe_px {
|
||||
break;
|
||||
}
|
||||
if drift_y > self.hysteresis_trigger_px {
|
||||
if drift_y > trigger {
|
||||
next.y += 1;
|
||||
continue;
|
||||
}
|
||||
if drift_y < -self.hysteresis_trigger_px {
|
||||
if drift_y < -trigger {
|
||||
next.y -= 1;
|
||||
continue;
|
||||
}
|
||||
@@ -433,20 +435,34 @@ mod tests {
|
||||
#[test]
|
||||
fn first_update_initializes_master_and_layer_anchors() {
|
||||
let scene = make_scene();
|
||||
let mut resolver = SceneViewportResolver::new(480, 270, 35, 21, 12, 20);
|
||||
let mut resolver = SceneViewportResolver::new(
|
||||
crate::graphics_contract::WIDTH as i32,
|
||||
crate::graphics_contract::HEIGHT as i32,
|
||||
45,
|
||||
27,
|
||||
12,
|
||||
20,
|
||||
);
|
||||
|
||||
let update = resolver.update(&scene, 0, 0);
|
||||
|
||||
assert_eq!(update.master_anchor, TileAnchor { x: 17, y: 10 });
|
||||
assert_eq!(update.layer_anchors[0], TileAnchor { x: 17, y: 10 });
|
||||
assert_eq!(update.layer_anchors[1], TileAnchor { x: 17, y: 10 });
|
||||
assert_eq!(update.master_anchor, TileAnchor { x: 22, y: 13 });
|
||||
assert_eq!(update.layer_anchors[0], TileAnchor { x: 22, y: 13 });
|
||||
assert_eq!(update.layer_anchors[1], TileAnchor { x: 22, y: 13 });
|
||||
assert_eq!(update.refresh_requests.len(), 4);
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn per_layer_copy_requests_follow_parallax_factor() {
|
||||
let scene = make_scene();
|
||||
let mut resolver = SceneViewportResolver::new(480, 270, 35, 21, 12, 20);
|
||||
let mut resolver = SceneViewportResolver::new(
|
||||
crate::graphics_contract::WIDTH as i32,
|
||||
crate::graphics_contract::HEIGHT as i32,
|
||||
45,
|
||||
27,
|
||||
12,
|
||||
20,
|
||||
);
|
||||
|
||||
let update = resolver.update(&scene, 32, 48);
|
||||
|
||||
@@ -461,24 +477,38 @@ mod tests {
|
||||
#[test]
|
||||
fn hysteresis_prevents_small_back_and_forth_refresh_churn() {
|
||||
let scene = make_scene();
|
||||
let mut resolver = SceneViewportResolver::new(480, 270, 35, 21, 12, 20);
|
||||
let mut resolver = SceneViewportResolver::new(
|
||||
crate::graphics_contract::WIDTH as i32,
|
||||
crate::graphics_contract::HEIGHT as i32,
|
||||
45,
|
||||
27,
|
||||
12,
|
||||
20,
|
||||
);
|
||||
|
||||
let _ = resolver.update(&scene, 0, 0);
|
||||
let update = resolver.update(&scene, 8, 0);
|
||||
|
||||
assert!(update.refresh_requests.is_empty());
|
||||
assert_eq!(update.master_anchor, TileAnchor { x: 17, y: 10 });
|
||||
assert_eq!(update.master_anchor, TileAnchor { x: 22, y: 13 });
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn repeated_high_speed_movement_advances_in_tile_steps() {
|
||||
let scene = make_scene();
|
||||
let mut resolver = SceneViewportResolver::new(480, 270, 35, 21, 12, 20);
|
||||
let mut resolver = SceneViewportResolver::new(
|
||||
crate::graphics_contract::WIDTH as i32,
|
||||
crate::graphics_contract::HEIGHT as i32,
|
||||
45,
|
||||
27,
|
||||
12,
|
||||
20,
|
||||
);
|
||||
|
||||
let _ = resolver.update(&scene, 0, 0);
|
||||
let update = resolver.update(&scene, 64, 0);
|
||||
|
||||
assert!(update.master_anchor.x > 17);
|
||||
assert!(update.master_anchor.x > 22);
|
||||
assert!(update.refresh_requests.iter().any(|request| matches!(
|
||||
request,
|
||||
CacheRefreshRequest::RefreshColumn { layer_index: 0, .. }
|
||||
@@ -489,18 +519,32 @@ mod tests {
|
||||
#[test]
|
||||
fn anchors_clamp_near_scene_edges() {
|
||||
let scene = make_scene();
|
||||
let mut resolver = SceneViewportResolver::new(480, 270, 35, 21, 12, 20);
|
||||
let mut resolver = SceneViewportResolver::new(
|
||||
crate::graphics_contract::WIDTH as i32,
|
||||
crate::graphics_contract::HEIGHT as i32,
|
||||
45,
|
||||
27,
|
||||
12,
|
||||
20,
|
||||
);
|
||||
|
||||
let update = resolver.update(&scene, 10_000, 10_000);
|
||||
|
||||
assert_eq!(update.master_anchor, TileAnchor { x: 46, y: 53 });
|
||||
assert_eq!(update.layer_anchors[0], TileAnchor { x: 46, y: 53 });
|
||||
assert_eq!(update.master_anchor, TileAnchor { x: 41, y: 50 });
|
||||
assert_eq!(update.layer_anchors[0], TileAnchor { x: 41, y: 50 });
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn corner_trigger_converts_to_non_overlapping_region_requests() {
|
||||
let scene = make_scene();
|
||||
let mut resolver = SceneViewportResolver::new(480, 270, 35, 21, 12, 20);
|
||||
let mut resolver = SceneViewportResolver::new(
|
||||
crate::graphics_contract::WIDTH as i32,
|
||||
crate::graphics_contract::HEIGHT as i32,
|
||||
45,
|
||||
27,
|
||||
12,
|
||||
20,
|
||||
);
|
||||
|
||||
let _ = resolver.update(&scene, 0, 0);
|
||||
let update = resolver.update(&scene, 64, 80);
|
||||
@@ -515,15 +559,22 @@ mod tests {
|
||||
.collect();
|
||||
|
||||
assert_eq!(regions.len(), 2);
|
||||
assert_eq!(regions[0].x + regions[0].width, 35);
|
||||
assert_eq!(regions[0].height, 21);
|
||||
assert_eq!(regions[1].width, 34);
|
||||
assert_eq!(regions[0].x + regions[0].width, 45);
|
||||
assert_eq!(regions[0].height, 27);
|
||||
assert_eq!(regions[1].width, 44);
|
||||
assert_eq!(regions[1].height, 2);
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn reset_scene_requests_full_invalidation_for_all_layers() {
|
||||
let mut resolver = SceneViewportResolver::new(480, 270, 35, 21, 12, 20);
|
||||
let mut resolver = SceneViewportResolver::new(
|
||||
crate::graphics_contract::WIDTH as i32,
|
||||
crate::graphics_contract::HEIGHT as i32,
|
||||
45,
|
||||
27,
|
||||
12,
|
||||
20,
|
||||
);
|
||||
|
||||
let requests = resolver.reset_scene();
|
||||
|
||||
|
||||
Reference in New Issue
Block a user