code wiki / _hdl_build / nx_vsubpel_q_gate.nx
nx_vsubpel_q_gate.nx source
↩ module page · 52 lines · 3126 B
1// nx_vsubpel_q_gate.nx -- proves QUARTER-pel motion (nx_vsubpel qp_refine) beats half-pel when content moves by a
2// quarter pixel: half-pel can only land on 0 / 0.5, so a 0.25px shift leaves a residual it can't remove, while
3// quarter-pel lands exactly on 0.25 -> ~zero residual. The H.264/VP9 motion-precision rung past half-pel.
4import "nx_syscalls.nx"
5import "nx_gate_emit_lib.nx"
6import "nx_vsubpel.nx"
7
8func g_abs(v: i64) -> i64 { if v < 0 { return 0 - v } return v }
9// SAD of cur's TxT block at (cx,cy) vs prev sampled at (px+.,py+.) with quarter offsets (qx,qy)
10func sad_at(cur: *u8, prev: *u8, W: i64, cx: i64, cy: i64, px: i64, py: i64, qx: i64, qy: i64, T: i64) -> i64 {
11 var s: i64=0; var ry: i64=0
12 while ry < T { var rx: i64=0
13 while rx < T { s = s + g_abs((cur[(cy+ry)*W+(cx+rx)] as i64) - qp_pixel(prev, W, px+rx, py+ry, qx, qy)); rx=rx+1 } ry=ry+1 }
14 return s
15}
16
17func main() -> i64 {
18 g_puts("nx_vsubpel quarter-pel gate (quarter-pel beats half-pel on a 0.25px shift, MEASURED)\n" as *u8)
19 var pass: i64 = 0; var total: i64 = 0
20 let W: i64 = 24; let H: i64 = 24; let T: i64 = 16
21 let cx: i64 = 4; let cy: i64 = 4
22
23 let A: *u8 = sys_mmap(W*H) as *u8
24 let B: *u8 = sys_mmap(W*H) as *u8
25 let mvq: *i64 = sys_mmap(2*8) as *i64
26
27 var y: i64 = 0
28 while y < H { var x: i64 = 0
29 while x < W { A[y*W+x] = (40 + ((x*11 + y*7) % 120)) as u8; x = x + 1 } y = y + 1 }
30 // B = A shifted +0.25px in x : B[x] = (3*A[x] + A[x+1] + 2)/4 (== qp_pixel at qx=1)
31 y = 0
32 while y < H { var x: i64 = 0
33 while x < W - 1 { B[y*W+x] = (((3*(A[y*W+x] as i64) + (A[y*W+(x+1)] as i64) + 2) / 4)) as u8; x = x + 1 }
34 B[y*W + (W-1)] = A[y*W + (W-1)]; y = y + 1 }
35
36 let int_sad: i64 = sad_at(B, A, W, cx, cy, cx, cy, 0, 0, T) // integer
37 var half_sad: i64 = sad_at(B, A, W, cx, cy, cx, cy, 2, 0, T) // best half (x-axis): 0 or 0.5
38 let half0: i64 = int_sad // half also includes (0,0)
39 if half0 < half_sad { half_sad = half0 }
40 let q_sad: i64 = qp_refine(B, A, W, H, cx, cy, 0, 0, T, mvq) // quarter-pel refine
41
42 g_puts(" [measure] residual SAD: integer=" as *u8); g_pn(int_sad); g_puts(" best-half=" as *u8); g_pn(half_sad); g_puts(" quarter=" as *u8); g_pn(q_sad)
43 g_puts(" best quarter MV=(" as *u8); g_pn(mvq[0]); g_puts("," as *u8); g_pn(mvq[1]); g_puts(")/4px\n" as *u8)
44
45 pass = pass + g_check("quarter-pel residual << half-pel residual (>= 4x smaller)" as *u8, q_sad * 4 < half_sad); total=total+1
46 pass = pass + g_check("quarter-pel found the true (0.25, 0) shift" as *u8, (mvq[0]==1) & (mvq[1]==0)); total=total+1
47 pass = pass + g_check("half-pel genuinely cannot match a 0.25 shift (half ~ integer)" as *u8, half_sad * 2 > int_sad); total=total+1
48
49 g_puts("---- vsubpel quarter gate: passed " as *u8); g_pn(pass); g_puts(" / " as *u8); g_pn(total); g_puts(" ----\n" as *u8)
50 if pass == total { g_puts("verdict=GREEN\n" as *u8); sys_exit(0); return 0 }
51 g_puts("verdict=RED\n" as *u8); sys_exit(1); return 1
52}