nmarshall commited on
Commit
7f999fd
·
1 Parent(s): c4dfa9d

assets: bounded md3 reader

Browse files
docs/ASSET_PIPELINE_TODO.md CHANGED
@@ -742,3 +742,6 @@ Research progress: RE-689 [report](research/QVM_MODEL_MULTI_HITS.md); remaining
742
 
743
 
744
  Research progress: RE-690 [report](research/QVM_GEOMETRIC_REWOUND_TRACE.md); remaining native/content/runtime/platform scope stays open.
 
 
 
 
742
 
743
 
744
  Research progress: RE-690 [report](research/QVM_GEOMETRIC_REWOUND_TRACE.md); remaining native/content/runtime/platform scope stays open.
745
+
746
+
747
+ Research progress: RE-692 [report](research/MD3_CONTRACT.md); remaining native/content/runtime/platform scope stays open.
docs/FINDINGS.md CHANGED
@@ -1088,3 +1088,6 @@ Bounded qagame paths recover bomb-plant/inactivity correction requests, direct f
1088
 
1089
 
1090
  **RE-690 — Rewound trace through actual model geometry and complete cleanup:** 291641 now reaches complete returns through actual geometric model hits or model misses followed by a supplied world retry, including actual rewind/restoration and cleanup. [Evidence](research/QVM_GEOMETRIC_REWOUND_TRACE.md).
 
 
 
 
1088
 
1089
 
1090
  **RE-690 — Rewound trace through actual model geometry and complete cleanup:** 291641 now reaches complete returns through actual geometric model hits or model misses followed by a supplied world retry, including actual rewind/restoration and cleanup. [Evidence](research/QVM_GEOMETRIC_REWOUND_TRACE.md).
1091
+
1092
+
1093
+ **RE-692 — Bounds-checked original MD3 reader and QVM layout contract:** Original MD3 version15 headers/surfaces match recovered model offsets; all eight selected LOD3 files parse, including case-mismatched orion/lower_3.MD3. [Evidence](research/MD3_CONTRACT.md).
docs/PROVISIONAL_TODO.md CHANGED
@@ -1074,3 +1074,6 @@ Research progress: RE-690 [report](research/QVM_GEOMETRIC_REWOUND_TRACE.md); rem
1074
 
1075
 
1076
  RE-681–690 batch complete: [source model geometry through rewound trace](research/QVM_GEOMETRY_TRACE_BATCH.md). RE-691 tracks original asset/reference validation and downstream contact/damage; playable Rust/Bevy/Solari integration remains open.
 
 
 
 
1074
 
1075
 
1076
  RE-681–690 batch complete: [source model geometry through rewound trace](research/QVM_GEOMETRY_TRACE_BATCH.md). RE-691 tracks original asset/reference validation and downstream contact/damage; playable Rust/Bevy/Solari integration remains open.
1077
+
1078
+
1079
+ Research progress: RE-692 [report](research/MD3_CONTRACT.md); remaining native/content/runtime/platform scope stays open.
docs/RESEARCH_LEDGER.md CHANGED
@@ -1102,3 +1102,8 @@ Actual star/nested model hierarchies generate categories1/3/5/6, then source sor
1102
  ## 2026-10-21 — RE-690 Rewound trace through actual model geometry and complete cleanup (separate task commit)
1103
 
1104
  291641 now reaches complete returns through actual geometric model hits or model misses followed by a supplied world retry, including actual rewind/restoration and cleanup. Two whole caller compositions independently check every leaf/context sort, numeric return, native candidate sequence, every rewind and all tracked restored entity records. Full suite: 1218 tests pass. Report regenerates byte-identically (953113 bytes). Storage/filter, links and whitespace checks pass. No assets/Rust runtime/shared VM evaluator changed; native/reference/legal/full platform scope remains open.
 
 
 
 
 
 
1102
  ## 2026-10-21 — RE-690 Rewound trace through actual model geometry and complete cleanup (separate task commit)
1103
 
1104
  291641 now reaches complete returns through actual geometric model hits or model misses followed by a supplied world retry, including actual rewind/restoration and cleanup. Two whole caller compositions independently check every leaf/context sort, numeric return, native candidate sequence, every rewind and all tracked restored entity records. Full suite: 1218 tests pass. Report regenerates byte-identically (953113 bytes). Storage/filter, links and whitespace checks pass. No assets/Rust runtime/shared VM evaluator changed; native/reference/legal/full platform scope remains open.
1105
+
1106
+
1107
+ ## 2026-10-21 — RE-692 Bounds-checked original MD3 reader and QVM layout contract (separate task commit)
1108
+
1109
+ Original MD3 version15 headers/surfaces match recovered model offsets; all eight selected LOD3 files parse, including case-mismatched orion/lower_3.MD3. Five parser/accessor tests independently check packed coordinates, tags, indices, UVs/shaders, malformed counts/ranges/signatures and original selected files. Full suite: 1223 tests pass. Report regenerates byte-identically (22517 bytes). Storage/filter, links and whitespace checks pass. No assets/Rust runtime/shared VM evaluator changed; native/reference/legal/full platform scope remains open.
docs/REVERSE_ENGINEERING_TODO.md CHANGED
@@ -1117,3 +1117,6 @@ Purpose: turn the supplied installation into an evidence-backed specification of
1117
 
1118
 
1119
  - [ ] RE-691 Connect original model assets and reference traces to recovered geometry, then continue contact/damage, shared/pellet aggregation and remaining runtime/lifecycle work toward a verified Rust gameplay slice. See the [next ten tasks](research/QVM_GEOMETRY_TRACE_BATCH.md#next-ten-concrete-tasks).
 
 
 
 
1117
 
1118
 
1119
  - [ ] RE-691 Connect original model assets and reference traces to recovered geometry, then continue contact/damage, shared/pellet aggregation and remaining runtime/lifecycle work toward a verified Rust gameplay slice. See the [next ten tasks](research/QVM_GEOMETRY_TRACE_BATCH.md#next-ten-concrete-tasks).
1120
+
1121
+
1122
+ - [x] RE-692 Bounds-checked original MD3 reader and QVM layout contract ([report](research/MD3_CONTRACT.md)).
docs/research/MD3_CONTRACT.md ADDED
@@ -0,0 +1,7 @@
 
 
 
 
 
 
 
 
1
+ # Bounds-checked original MD3 reader and QVM layout contract
2
+
3
+ RE-692. Reproduce with `python3 scripts/analyze_md3_contract.py`; check with `python3 scripts/test_md3_contract.py`. The [machine report](md3-contract.json) retains source identity and bounded fixtures.
4
+
5
+ A bounded MD3 reader preserves original byte offsets and validates header/surface ranges, frame agreement, triangle indices and surface chain termination. Accessors expose frames,112-byte tags,12-byte triangles, UVs/shaders and eight-byte signed vertex records without converting originals. All eight selected Athena/Orion LOD3 files parse. The source requests orion/lower_3.md3 while extraction preserves lower_3.MD3; inventory uses suffix case-folding without renaming or choosing a runtime precedence rule. Linux resolution must handle this evidence explicitly. This establishes file layout compatibility, not rendering/native buffer ownership or complete runtime asset resolution.
6
+
7
+ No original executable/full QVM/native collision/physics/rendering executes. Native responses and legal input domains are supplied or unverified where stated; full runtime/macOS/Linux Rust/Bevy/Solari gameplay remains open.
docs/research/README.md CHANGED
@@ -675,3 +675,6 @@ The extension collector adds five focused tests for native tail calls, command-r
675
 
676
 
677
  [RE-681–690: Source model geometry through rewound trace](QVM_GEOMETRY_TRACE_BATCH.md), with validation limits and the next ten concrete tasks.
 
 
 
 
675
 
676
 
677
  [RE-681–690: Source model geometry through rewound trace](QVM_GEOMETRY_TRACE_BATCH.md), with validation limits and the next ten concrete tasks.
678
+
679
+
680
+ [RE-692: Bounds-checked original MD3 reader and QVM layout contract](MD3_CONTRACT.md). Reproduce with `python3 scripts/analyze_md3_contract.py`; check with `python3 scripts/test_md3_contract.py`.
docs/research/md3-contract.json ADDED
@@ -0,0 +1,925 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "limits": "Original bytes parsed only; version15/declared ranges/surface chain/frame counts/triangle indices checked. No renderer/full runtime. Coordinate scale and fields are cross-linked to recovered QVM offsets, not external format assumptions.",
3
+ "models": [
4
+ {
5
+ "bytes": 3092,
6
+ "first_frame": {
7
+ "maxs": [
8
+ 5.916663646697998,
9
+ 3.9339609146118164,
10
+ 9.352885246276855
11
+ ],
12
+ "mins": [
13
+ -4.893303394317627,
14
+ -3.656599760055542,
15
+ -1.845400094985962
16
+ ],
17
+ "name": "(from 3DSMax)",
18
+ "origin": [
19
+ 0.0,
20
+ 0.0,
21
+ 0.0
22
+ ],
23
+ "radius": 11.745613098144531
24
+ },
25
+ "first_tags": [
26
+ {
27
+ "axis": [
28
+ [
29
+ 1.0,
30
+ 4.8268422374005745e-15,
31
+ 8.346185782694571e-15
32
+ ],
33
+ [
34
+ 3.3944144441452233e-15,
35
+ 0.9999999403953552,
36
+ -2.05560920254989e-16
37
+ ],
38
+ [
39
+ -1.0582109664990062e-15,
40
+ 1.4228268018531658e-14,
41
+ 1.0
42
+ ]
43
+ ],
44
+ "name": "tag_head",
45
+ "offset": 164,
46
+ "origin": [
47
+ -1.5079593129740942e-09,
48
+ -9.933220912472507e-11,
49
+ 3.2111285008795676e-07
50
+ ]
51
+ }
52
+ ],
53
+ "frames": 1,
54
+ "name": "models/players/athena/head_3.md33md3",
55
+ "offsets": {
56
+ "end": 3092,
57
+ "frames": 108,
58
+ "surfaces": 276,
59
+ "tags": 164
60
+ },
61
+ "path": "assets/extracted/zUrT43_005.pk3/members/000698/models/players/athena/head_3.md3",
62
+ "sha256": "5c486f223ef44dcfd913a45d8385ae68fef4e3c3cb599c6eabb3ba1153630458",
63
+ "surfaces": [
64
+ {
65
+ "end": 2816,
66
+ "flags": 0,
67
+ "frames": 1,
68
+ "name": "h_head",
69
+ "offset": 276,
70
+ "shaders": 1,
71
+ "shaders_offset": 108,
72
+ "triangles": 44,
73
+ "triangles_offset": 176,
74
+ "uv_offset": 704,
75
+ "vertices": 132,
76
+ "vertices_offset": 1760
77
+ }
78
+ ],
79
+ "tags": 1
80
+ },
81
+ {
82
+ "bytes": 2420,
83
+ "first_frame": {
84
+ "maxs": [
85
+ 7.012399196624756,
86
+ 4.579596519470215,
87
+ 9.718878746032715
88
+ ],
89
+ "mins": [
90
+ -5.060676097869873,
91
+ -4.731232166290283,
92
+ 1.2850357294082642
93
+ ],
94
+ "name": "(from 3DSMax)",
95
+ "origin": [
96
+ 0.0,
97
+ 0.0,
98
+ 0.0
99
+ ],
100
+ "radius": 12.884676933288574
101
+ },
102
+ "first_tags": [
103
+ {
104
+ "axis": [
105
+ [
106
+ 1.0,
107
+ 0.0,
108
+ 0.0
109
+ ],
110
+ [
111
+ 0.0,
112
+ 1.0,
113
+ 0.0
114
+ ],
115
+ [
116
+ 0.0,
117
+ 0.0,
118
+ 1.0
119
+ ]
120
+ ],
121
+ "name": "tag_head",
122
+ "offset": 164,
123
+ "origin": [
124
+ -1.9990831212624016e-10,
125
+ -7.291174608514694e-11,
126
+ 0.0
127
+ ]
128
+ }
129
+ ],
130
+ "frames": 1,
131
+ "name": "models/players/athena/helmet_3.md3",
132
+ "offsets": {
133
+ "end": 2420,
134
+ "frames": 108,
135
+ "surfaces": 276,
136
+ "tags": 164
137
+ },
138
+ "path": "assets/extracted/zUrT43_005.pk3/members/000754/models/players/athena/helmet_3.md3",
139
+ "sha256": "80c5b490aecb8ab022290350d21529add230bb1b0677551f8eeaf42c4dcc0c1b",
140
+ "surfaces": [
141
+ {
142
+ "end": 2144,
143
+ "flags": 0,
144
+ "frames": 1,
145
+ "name": "g_helmet",
146
+ "offset": 276,
147
+ "shaders": 1,
148
+ "shaders_offset": 108,
149
+ "triangles": 72,
150
+ "triangles_offset": 176,
151
+ "uv_offset": 1040,
152
+ "vertices": 69,
153
+ "vertices_offset": 1592
154
+ }
155
+ ],
156
+ "tags": 1
157
+ },
158
+ {
159
+ "bytes": 1475608,
160
+ "first_frame": {
161
+ "maxs": [
162
+ 6.827688694000244,
163
+ 7.543880462646484,
164
+ 24.065277099609375
165
+ ],
166
+ "mins": [
167
+ -6.157504558563232,
168
+ -7.524542331695557,
169
+ -23.248598098754883
170
+ ],
171
+ "name": "(from 3DSMax)",
172
+ "origin": [
173
+ 0.0,
174
+ 0.0,
175
+ 0.0
176
+ ],
177
+ "radius": 26.127859115600586
178
+ },
179
+ "first_tags": [
180
+ {
181
+ "axis": [
182
+ [
183
+ 1.0,
184
+ 0.0,
185
+ 0.0
186
+ ],
187
+ [
188
+ 0.0,
189
+ 1.0,
190
+ 0.0
191
+ ],
192
+ [
193
+ 0.0,
194
+ 0.0,
195
+ 1.0
196
+ ]
197
+ ],
198
+ "name": "tag_torso",
199
+ "offset": 46924,
200
+ "origin": [
201
+ 0.2727545201778412,
202
+ 0.004881937988102436,
203
+ 19.955394744873047
204
+ ]
205
+ }
206
+ ],
207
+ "frames": 836,
208
+ "name": "C:/Users/Windows/Desktop/new_HM/female/lower_3.md3",
209
+ "offsets": {
210
+ "end": 1475608,
211
+ "frames": 108,
212
+ "surfaces": 140556,
213
+ "tags": 46924
214
+ },
215
+ "path": "assets/extracted/zUrT43_005.pk3/members/000800/models/players/athena/lower_3.md3",
216
+ "sha256": "1728841be5608858885be41b22dee516294ce4f91ffe21fae51b8e0d4da82630",
217
+ "surfaces": [
218
+ {
219
+ "end": 161000,
220
+ "flags": 0,
221
+ "frames": 836,
222
+ "name": "l_groin",
223
+ "offset": 140556,
224
+ "shaders": 0,
225
+ "shaders_offset": 108,
226
+ "triangles": 10,
227
+ "triangles_offset": 176,
228
+ "uv_offset": 296,
229
+ "vertices": 24,
230
+ "vertices_offset": 488
231
+ },
232
+ {
233
+ "end": 274988,
234
+ "flags": 0,
235
+ "frames": 836,
236
+ "name": "l_butt",
237
+ "offset": 301556,
238
+ "shaders": 0,
239
+ "shaders_offset": 108,
240
+ "triangles": 23,
241
+ "triangles_offset": 176,
242
+ "uv_offset": 452,
243
+ "vertices": 41,
244
+ "vertices_offset": 780
245
+ },
246
+ {
247
+ "end": 120800,
248
+ "flags": 0,
249
+ "frames": 836,
250
+ "name": "l_lleg",
251
+ "offset": 576544,
252
+ "shaders": 0,
253
+ "shaders_offset": 108,
254
+ "triangles": 8,
255
+ "triangles_offset": 176,
256
+ "uv_offset": 272,
257
+ "vertices": 18,
258
+ "vertices_offset": 416
259
+ },
260
+ {
261
+ "end": 187832,
262
+ "flags": 0,
263
+ "frames": 836,
264
+ "name": "l_lfoot",
265
+ "offset": 697344,
266
+ "shaders": 0,
267
+ "shaders_offset": 108,
268
+ "triangles": 14,
269
+ "triangles_offset": 176,
270
+ "uv_offset": 344,
271
+ "vertices": 28,
272
+ "vertices_offset": 568
273
+ },
274
+ {
275
+ "end": 120800,
276
+ "flags": 0,
277
+ "frames": 836,
278
+ "name": "l_rleg",
279
+ "offset": 885176,
280
+ "shaders": 0,
281
+ "shaders_offset": 108,
282
+ "triangles": 8,
283
+ "triangles_offset": 176,
284
+ "uv_offset": 272,
285
+ "vertices": 18,
286
+ "vertices_offset": 416
287
+ },
288
+ {
289
+ "end": 187832,
290
+ "flags": 0,
291
+ "frames": 836,
292
+ "name": "l_rfoot",
293
+ "offset": 1005976,
294
+ "shaders": 0,
295
+ "shaders_offset": 108,
296
+ "triangles": 14,
297
+ "triangles_offset": 176,
298
+ "uv_offset": 344,
299
+ "vertices": 28,
300
+ "vertices_offset": 568
301
+ },
302
+ {
303
+ "end": 140900,
304
+ "flags": 0,
305
+ "frames": 836,
306
+ "name": "l_rthigh",
307
+ "offset": 1193808,
308
+ "shaders": 1,
309
+ "shaders_offset": 108,
310
+ "triangles": 9,
311
+ "triangles_offset": 176,
312
+ "uv_offset": 284,
313
+ "vertices": 21,
314
+ "vertices_offset": 452
315
+ },
316
+ {
317
+ "end": 140900,
318
+ "flags": 0,
319
+ "frames": 836,
320
+ "name": "l_lthigh",
321
+ "offset": 1334708,
322
+ "shaders": 1,
323
+ "shaders_offset": 108,
324
+ "triangles": 9,
325
+ "triangles_offset": 176,
326
+ "uv_offset": 284,
327
+ "vertices": 21,
328
+ "vertices_offset": 452
329
+ }
330
+ ],
331
+ "tags": 1
332
+ },
333
+ {
334
+ "bytes": 3233268,
335
+ "first_frame": {
336
+ "maxs": [
337
+ 6.256061553955078,
338
+ 15.82502555847168,
339
+ 21.967098236083984
340
+ ],
341
+ "mins": [
342
+ -6.123725414276123,
343
+ -15.853873252868652,
344
+ -8.523422241210938
345
+ ],
346
+ "name": "(from 3DSMax)",
347
+ "origin": [
348
+ 0.0,
349
+ 0.0,
350
+ 0.0
351
+ ],
352
+ "radius": 27.803543090820312
353
+ },
354
+ "first_tags": [
355
+ {
356
+ "axis": [
357
+ [
358
+ 0.9999999403953552,
359
+ 9.050260274534594e-08,
360
+ 2.0926363220041821e-07
361
+ ],
362
+ [
363
+ -9.049764315705033e-08,
364
+ 0.9999998807907104,
365
+ 2.4192985392801347e-07
366
+ ],
367
+ [
368
+ -2.2672014665658935e-07,
369
+ -2.4193300873776025e-07,
370
+ 1.0000001192092896
371
+ ]
372
+ ],
373
+ "name": "tag_head",
374
+ "offset": 54932,
375
+ "origin": [
376
+ -1.435609221458435,
377
+ -0.00030710449209436774,
378
+ 20.255207061767578
379
+ ]
380
+ },
381
+ {
382
+ "axis": [
383
+ [
384
+ 1.0,
385
+ 0.0,
386
+ 0.0
387
+ ],
388
+ [
389
+ 0.0,
390
+ 1.0,
391
+ 0.0
392
+ ],
393
+ [
394
+ 0.0,
395
+ 0.0,
396
+ 1.0
397
+ ]
398
+ ],
399
+ "name": "tag_torso",
400
+ "offset": 55044,
401
+ "origin": [
402
+ -7.953614988842617e-10,
403
+ 1.9953094732017007e-10,
404
+ 0.0
405
+ ]
406
+ }
407
+ ],
408
+ "frames": 979,
409
+ "name": "models/players/athena/upper_3.md3.md3",
410
+ "offsets": {
411
+ "end": 3233268,
412
+ "frames": 108,
413
+ "surfaces": 274228,
414
+ "tags": 54932
415
+ },
416
+ "path": "assets/extracted/zUrT43_006.pk3/members/000006/models/players/athena/upper_3.md3",
417
+ "sha256": "aa0b90d2da99e9aff2ec9cc698773aecfd4f4406d1fa5d777c4d0f809c71b786",
418
+ "surfaces": [
419
+ {
420
+ "end": 518048,
421
+ "flags": 0,
422
+ "frames": 979,
423
+ "name": "u_armr",
424
+ "offset": 274228,
425
+ "shaders": 1,
426
+ "shaders_offset": 108,
427
+ "triangles": 36,
428
+ "triangles_offset": 176,
429
+ "uv_offset": 608,
430
+ "vertices": 66,
431
+ "vertices_offset": 1136
432
+ },
433
+ {
434
+ "end": 1922944,
435
+ "flags": 0,
436
+ "frames": 979,
437
+ "name": "u_torso",
438
+ "offset": 792276,
439
+ "shaders": 1,
440
+ "shaders_offset": 108,
441
+ "triangles": 164,
442
+ "triangles_offset": 176,
443
+ "uv_offset": 2144,
444
+ "vertices": 245,
445
+ "vertices_offset": 4104
446
+ },
447
+ {
448
+ "end": 518048,
449
+ "flags": 0,
450
+ "frames": 979,
451
+ "name": "u_arml",
452
+ "offset": 2715220,
453
+ "shaders": 1,
454
+ "shaders_offset": 108,
455
+ "triangles": 36,
456
+ "triangles_offset": 176,
457
+ "uv_offset": 608,
458
+ "vertices": 66,
459
+ "vertices_offset": 1136
460
+ }
461
+ ],
462
+ "tags": 2
463
+ },
464
+ {
465
+ "bytes": 2612,
466
+ "first_frame": {
467
+ "maxs": [
468
+ 7.199967384338379,
469
+ 3.379535675048828,
470
+ 10.142528533935547
471
+ ],
472
+ "mins": [
473
+ -5.0725297927856445,
474
+ -4.360363960266113,
475
+ -1.6285820007324219
476
+ ],
477
+ "name": "(from 3DSMax)",
478
+ "origin": [
479
+ 0.0,
480
+ 0.0,
481
+ 0.0
482
+ ],
483
+ "radius": 13.18040943145752
484
+ },
485
+ "first_tags": [
486
+ {
487
+ "axis": [
488
+ [
489
+ 1.0,
490
+ 0.0,
491
+ 0.0
492
+ ],
493
+ [
494
+ 0.0,
495
+ 1.0,
496
+ 0.0
497
+ ],
498
+ [
499
+ 0.0,
500
+ 0.0,
501
+ 1.0
502
+ ]
503
+ ],
504
+ "name": "tag_head",
505
+ "offset": 164,
506
+ "origin": [
507
+ -1.9506065651597737e-09,
508
+ -1.8283007330310852e-09,
509
+ 0.0
510
+ ]
511
+ }
512
+ ],
513
+ "frames": 1,
514
+ "name": "models/players/orion/head_3.md3d3",
515
+ "offsets": {
516
+ "end": 2612,
517
+ "frames": 108,
518
+ "surfaces": 276,
519
+ "tags": 164
520
+ },
521
+ "path": "assets/extracted/zUrT43_007.pk3/members/000042/models/players/orion/head_3.md3",
522
+ "sha256": "74721f3f369ba5ecb827d292f4cc86e9039886ff479239dc4a66294833486630",
523
+ "surfaces": [
524
+ {
525
+ "end": 2336,
526
+ "flags": 0,
527
+ "frames": 1,
528
+ "name": "h_head",
529
+ "offset": 276,
530
+ "shaders": 0,
531
+ "shaders_offset": 108,
532
+ "triangles": 36,
533
+ "triangles_offset": 176,
534
+ "uv_offset": 608,
535
+ "vertices": 108,
536
+ "vertices_offset": 1472
537
+ }
538
+ ],
539
+ "tags": 1
540
+ },
541
+ {
542
+ "bytes": 2812,
543
+ "first_frame": {
544
+ "maxs": [
545
+ 8.65123462677002,
546
+ 4.434142589569092,
547
+ 10.694853782653809
548
+ ],
549
+ "mins": [
550
+ -5.758604049682617,
551
+ -5.336203575134277,
552
+ 0.9205818176269531
553
+ ],
554
+ "name": "(from 3DSMax)",
555
+ "origin": [
556
+ 0.0,
557
+ 0.0,
558
+ 0.0
559
+ ],
560
+ "radius": 14.754620552062988
561
+ },
562
+ "first_tags": [
563
+ {
564
+ "axis": [
565
+ [
566
+ 1.0,
567
+ -1.8522045634808144e-16,
568
+ -4.176852447083674e-15
569
+ ],
570
+ [
571
+ 1.412696240158401e-16,
572
+ 1.0,
573
+ 1.3331593434854098e-15
574
+ ],
575
+ [
576
+ -2.3560037198212336e-15,
577
+ -4.888040261960579e-16,
578
+ 1.0000001192092896
579
+ ]
580
+ ],
581
+ "name": "tag_head",
582
+ "offset": 164,
583
+ "origin": [
584
+ -5.772439415352437e-09,
585
+ 1.6540664393716042e-09,
586
+ -3.114860476216563e-07
587
+ ]
588
+ }
589
+ ],
590
+ "frames": 1,
591
+ "name": "models/players/orion/helmet_3.md3md3",
592
+ "offsets": {
593
+ "end": 2812,
594
+ "frames": 108,
595
+ "surfaces": 276,
596
+ "tags": 164
597
+ },
598
+ "path": "assets/extracted/zUrT43_007.pk3/members/000099/models/players/orion/helmet_3.md3",
599
+ "sha256": "ce6fc8d410d5e4263a491314f33c660412e95c81cbe813e9f770e7b3eb0a9bf6",
600
+ "surfaces": [
601
+ {
602
+ "end": 2536,
603
+ "flags": 0,
604
+ "frames": 1,
605
+ "name": "g_helmet",
606
+ "offset": 276,
607
+ "shaders": 0,
608
+ "shaders_offset": 108,
609
+ "triangles": 94,
610
+ "triangles_offset": 176,
611
+ "uv_offset": 1304,
612
+ "vertices": 77,
613
+ "vertices_offset": 1920
614
+ }
615
+ ],
616
+ "tags": 1
617
+ },
618
+ {
619
+ "bytes": 1495708,
620
+ "first_frame": {
621
+ "maxs": [
622
+ 6.851175308227539,
623
+ 7.528242111206055,
624
+ 24.065204620361328
625
+ ],
626
+ "mins": [
627
+ -6.161566734313965,
628
+ -7.492788791656494,
629
+ -23.25568389892578
630
+ ],
631
+ "name": "(from 3DSMax)",
632
+ "origin": [
633
+ 0.0,
634
+ 0.0,
635
+ 0.0
636
+ ],
637
+ "radius": 26.129430770874023
638
+ },
639
+ "first_tags": [
640
+ {
641
+ "axis": [
642
+ [
643
+ 1.0,
644
+ -1.286586837068171e-07,
645
+ 2.219511259227147e-07
646
+ ],
647
+ [
648
+ 1.28524263232066e-07,
649
+ 0.9999998807907104,
650
+ -7.397434054201568e-11
651
+ ],
652
+ [
653
+ -2.7253599910181947e-07,
654
+ 1.4987239893571314e-08,
655
+ 0.9999999403953552
656
+ ]
657
+ ],
658
+ "name": "tag_torso",
659
+ "offset": 46924,
660
+ "origin": [
661
+ 0.09215898811817169,
662
+ 0.010374296456575394,
663
+ 19.902698516845703
664
+ ]
665
+ }
666
+ ],
667
+ "frames": 836,
668
+ "name": "C:/Users/Windows/Desktop/new_HM/male/lower_3.MD3",
669
+ "offsets": {
670
+ "end": 1495708,
671
+ "frames": 108,
672
+ "surfaces": 140556,
673
+ "tags": 46924
674
+ },
675
+ "path": "assets/extracted/zUrT43_007.pk3/members/000145/models/players/orion/lower_3.MD3",
676
+ "sha256": "26936617763f8b307f221cf2162993e2bfa63a2804839d65445d74a7e2762e07",
677
+ "surfaces": [
678
+ {
679
+ "end": 181100,
680
+ "flags": 0,
681
+ "frames": 836,
682
+ "name": "l_groin",
683
+ "offset": 140556,
684
+ "shaders": 0,
685
+ "shaders_offset": 108,
686
+ "triangles": 11,
687
+ "triangles_offset": 176,
688
+ "uv_offset": 308,
689
+ "vertices": 27,
690
+ "vertices_offset": 524
691
+ },
692
+ {
693
+ "end": 274988,
694
+ "flags": 0,
695
+ "frames": 836,
696
+ "name": "l_butt",
697
+ "offset": 321656,
698
+ "shaders": 0,
699
+ "shaders_offset": 108,
700
+ "triangles": 23,
701
+ "triangles_offset": 176,
702
+ "uv_offset": 452,
703
+ "vertices": 41,
704
+ "vertices_offset": 780
705
+ },
706
+ {
707
+ "end": 120800,
708
+ "flags": 0,
709
+ "frames": 836,
710
+ "name": "l_lleg",
711
+ "offset": 596644,
712
+ "shaders": 0,
713
+ "shaders_offset": 108,
714
+ "triangles": 8,
715
+ "triangles_offset": 176,
716
+ "uv_offset": 272,
717
+ "vertices": 18,
718
+ "vertices_offset": 416
719
+ },
720
+ {
721
+ "end": 120800,
722
+ "flags": 0,
723
+ "frames": 836,
724
+ "name": "l_rleg",
725
+ "offset": 717444,
726
+ "shaders": 0,
727
+ "shaders_offset": 108,
728
+ "triangles": 8,
729
+ "triangles_offset": 176,
730
+ "uv_offset": 272,
731
+ "vertices": 18,
732
+ "vertices_offset": 416
733
+ },
734
+ {
735
+ "end": 187832,
736
+ "flags": 0,
737
+ "frames": 836,
738
+ "name": "l_rfoot",
739
+ "offset": 838244,
740
+ "shaders": 0,
741
+ "shaders_offset": 108,
742
+ "triangles": 14,
743
+ "triangles_offset": 176,
744
+ "uv_offset": 344,
745
+ "vertices": 28,
746
+ "vertices_offset": 568
747
+ },
748
+ {
749
+ "end": 187832,
750
+ "flags": 0,
751
+ "frames": 836,
752
+ "name": "l_lfoot",
753
+ "offset": 1026076,
754
+ "shaders": 0,
755
+ "shaders_offset": 108,
756
+ "triangles": 14,
757
+ "triangles_offset": 176,
758
+ "uv_offset": 344,
759
+ "vertices": 28,
760
+ "vertices_offset": 568
761
+ },
762
+ {
763
+ "end": 140900,
764
+ "flags": 0,
765
+ "frames": 836,
766
+ "name": "l_lthigh",
767
+ "offset": 1213908,
768
+ "shaders": 0,
769
+ "shaders_offset": 108,
770
+ "triangles": 9,
771
+ "triangles_offset": 176,
772
+ "uv_offset": 284,
773
+ "vertices": 21,
774
+ "vertices_offset": 452
775
+ },
776
+ {
777
+ "end": 140900,
778
+ "flags": 0,
779
+ "frames": 836,
780
+ "name": "l_rthigh",
781
+ "offset": 1354808,
782
+ "shaders": 0,
783
+ "shaders_offset": 108,
784
+ "triangles": 9,
785
+ "triangles_offset": 176,
786
+ "uv_offset": 284,
787
+ "vertices": 21,
788
+ "vertices_offset": 452
789
+ }
790
+ ],
791
+ "tags": 1
792
+ },
793
+ {
794
+ "bytes": 2771644,
795
+ "first_frame": {
796
+ "maxs": [
797
+ 6.6534271240234375,
798
+ 15.166171073913574,
799
+ 21.055191040039062
800
+ ],
801
+ "mins": [
802
+ -7.807436943054199,
803
+ -15.437268257141113,
804
+ -12.154400825500488
805
+ ],
806
+ "name": "(from 3DSMax)",
807
+ "origin": [
808
+ 0.0,
809
+ 0.0,
810
+ 0.0
811
+ ],
812
+ "radius": 27.250438690185547
813
+ },
814
+ "first_tags": [
815
+ {
816
+ "axis": [
817
+ [
818
+ 1.0000001192092896,
819
+ 1.8568309201327793e-07,
820
+ -2.815226594066189e-07
821
+ ],
822
+ [
823
+ -1.8585521388558846e-07,
824
+ 1.0,
825
+ 4.51199930751045e-08
826
+ ],
827
+ [
828
+ 3.62100365691731e-07,
829
+ -6.053197409983113e-08,
830
+ 0.9999999403953552
831
+ ]
832
+ ],
833
+ "name": "tag_head",
834
+ "offset": 54932,
835
+ "origin": [
836
+ -1.4975870847702026,
837
+ 0.03643219172954559,
838
+ 19.20456314086914
839
+ ]
840
+ },
841
+ {
842
+ "axis": [
843
+ [
844
+ 1.0,
845
+ 4.560243275933493e-15,
846
+ -1.6186670873021697e-14
847
+ ],
848
+ [
849
+ 6.317532556658102e-15,
850
+ 1.0,
851
+ 2.6171382467524506e-18
852
+ ],
853
+ [
854
+ 5.658454526333637e-15,
855
+ -1.5070995709073301e-15,
856
+ 0.9999999403953552
857
+ ]
858
+ ],
859
+ "name": "tag_torso",
860
+ "offset": 55044,
861
+ "origin": [
862
+ 2.2859194537261374e-09,
863
+ -4.86234906504901e-11,
864
+ -2.045771907432936e-08
865
+ ]
866
+ }
867
+ ],
868
+ "frames": 979,
869
+ "name": "models/players/orion/upper_3.md3.md3",
870
+ "offsets": {
871
+ "end": 2771644,
872
+ "frames": 108,
873
+ "surfaces": 274228,
874
+ "tags": 54932
875
+ },
876
+ "path": "assets/extracted/zUrT43_007.pk3/members/000241/models/players/orion/upper_3.md3",
877
+ "sha256": "6cd8e57f38a4910bb61463f842bc36e5b55a3ded44729e46db74032e7baf4a30",
878
+ "surfaces": [
879
+ {
880
+ "end": 604840,
881
+ "flags": 0,
882
+ "frames": 979,
883
+ "name": "u_armr",
884
+ "offset": 274228,
885
+ "shaders": 1,
886
+ "shaders_offset": 108,
887
+ "triangles": 82,
888
+ "triangles_offset": 176,
889
+ "uv_offset": 1160,
890
+ "vertices": 77,
891
+ "vertices_offset": 1776
892
+ },
893
+ {
894
+ "end": 1107224,
895
+ "flags": 0,
896
+ "frames": 979,
897
+ "name": "u_torso",
898
+ "offset": 879068,
899
+ "shaders": 1,
900
+ "shaders_offset": 108,
901
+ "triangles": 134,
902
+ "triangles_offset": 176,
903
+ "uv_offset": 1784,
904
+ "vertices": 141,
905
+ "vertices_offset": 2912
906
+ },
907
+ {
908
+ "end": 785352,
909
+ "flags": 0,
910
+ "frames": 979,
911
+ "name": "u_arml",
912
+ "offset": 1986292,
913
+ "shaders": 1,
914
+ "shaders_offset": 108,
915
+ "triangles": 98,
916
+ "triangles_offset": 176,
917
+ "uv_offset": 1352,
918
+ "vertices": 100,
919
+ "vertices_offset": 2152
920
+ }
921
+ ],
922
+ "tags": 2
923
+ }
924
+ ]
925
+ }
scripts/analyze_md3_contract.py ADDED
@@ -0,0 +1,15 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ #!/usr/bin/env python3
2
+ """Parse original player LOD3 model layout against the recovered QVM offsets."""
3
+ import hashlib
4
+ from dataclasses import asdict
5
+ from pathlib import Path
6
+ from md3 import MD3
7
+ from analyze_qvm import write_json
8
+
9
+ def selected():return sorted(p for p in Path('assets/extracted').rglob('*') if p.is_file() and '/models/players/' in str(p) and p.parent.name in ['athena','orion'] and p.name.lower() in ['lower_3.md3','upper_3.md3','head_3.md3','helmet_3.md3'])
10
+ def main():
11
+ rows=[]
12
+ for p in selected():
13
+ raw=p.read_bytes();m=MD3(raw);rows.append({'path':str(p),'sha256':hashlib.sha256(raw).hexdigest(),'bytes':len(raw),'name':m.name,'frames':m.frames,'tags':m.tags,'surfaces':[asdict(s) for s in m.surfaces],'offsets':{'frames':m.frames_offset,'tags':m.tags_offset,'surfaces':m.surfaces_offset,'end':m.end},'first_frame':m.frame(0),'first_tags':[m.tag(0,j) for j in range(m.tags)]})
14
+ write_json(Path('docs/research/md3-contract.json'),{'models':rows,'limits':'Original bytes parsed only; version15/declared ranges/surface chain/frame counts/triangle indices checked. No renderer/full runtime. Coordinate scale and fields are cross-linked to recovered QVM offsets, not external format assumptions.'})
15
+ if __name__=='__main__':main()
scripts/md3.py ADDED
@@ -0,0 +1,61 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ """Bounds-checked little-endian MD3 reader; source offsets retained for QVM research."""
2
+ import math,struct
3
+ from dataclasses import dataclass
4
+
5
+ def name(raw):return raw.split(b'\0',1)[0].decode('ascii','backslashreplace')
6
+ def region(offset,count,stride,end,minimum=0):
7
+ if min(offset,count,stride)<0 or (count and offset<minimum) or offset>end or count*stride>end-offset:raise ValueError('MD3 region outside declared bounds')
8
+
9
+ def finite(values):
10
+ if not all(math.isfinite(v) for v in values):raise ValueError('nonfinite MD3 geometry')
11
+ return values
12
+
13
+ @dataclass(frozen=True)
14
+ class Surface:
15
+ offset:int
16
+ name:str
17
+ flags:int
18
+ frames:int
19
+ shaders:int
20
+ vertices:int
21
+ triangles:int
22
+ triangles_offset:int
23
+ shaders_offset:int
24
+ uv_offset:int
25
+ vertices_offset:int
26
+ end:int
27
+
28
+ class MD3:
29
+ def __init__(self,data):
30
+ self.data=bytes(data)
31
+ if len(data)<108:raise ValueError('truncated MD3 header')
32
+ magic,version,raw,*v=struct.unpack_from('<4si64s9i',data)
33
+ if magic!=b'IDP3' or version!=15:raise ValueError('unsupported MD3 signature/version')
34
+ self.name=name(raw);self.flags,self.frames,self.tags,self.surface_count,self.skins,self.frames_offset,self.tags_offset,self.surfaces_offset,self.end=v
35
+ if min(v[1:])<0 or self.end!=len(data) or self.end<108:raise ValueError('invalid MD3 counts/end')
36
+ region(self.frames_offset,self.frames,56,self.end,108);region(self.tags_offset,self.frames*self.tags,112,self.end,108);region(self.surfaces_offset,self.surface_count,108,self.end,108)
37
+ self.surfaces=[];offset=self.surfaces_offset
38
+ for _ in range(self.surface_count):
39
+ region(offset,1,108,self.end,108);ident,raw,*s=struct.unpack_from('<4s64s10i',data,offset)
40
+ if ident!=b'IDP3':raise ValueError('invalid MD3 surface signature')
41
+ flags,frames,shaders,vertices,triangles,tri,shader,uv,xyz,end=s
42
+ if min(s[1:])<0 or frames!=self.frames or end<108 or end>self.end-offset:raise ValueError('invalid MD3 surface counts/end')
43
+ for start,count,stride in [(tri,triangles,12),(shader,shaders,68),(uv,vertices,8),(xyz,frames*vertices,8)]:region(start,count,stride,end,108)
44
+ surface=Surface(offset,name(raw),flags,frames,shaders,vertices,triangles,tri,shader,uv,xyz,end);self.surfaces.append(surface)
45
+ for j in range(triangles):
46
+ if any(k<0 or k>=vertices for k in self.triangle(surface,j)):raise ValueError('MD3 triangle index outside vertex range')
47
+ offset+=end
48
+ if self.surface_count and offset!=self.end:raise ValueError('MD3 surface chain does not end at EOF')
49
+
50
+ def frame(self,index):
51
+ region(index,1,1,self.frames);v=struct.unpack_from('<10f16s',self.data,self.frames_offset+56*index);finite(v[:10]);return {'mins':list(v[:3]),'maxs':list(v[3:6]),'origin':list(v[6:9]),'radius':v[9],'name':name(v[10])}
52
+ def tag(self,frame,index):
53
+ region(frame,1,1,self.frames);region(index,1,1,self.tags);p=self.tags_offset+(frame*self.tags+index)*112;v=struct.unpack_from('<64s12f',self.data,p);finite(v[1:]);return {'offset':p,'name':name(v[0]),'origin':list(v[1:4]),'axis':[list(v[4+3*j:7+3*j]) for j in range(3)]}
54
+ def triangle(self,s,index):
55
+ region(index,1,1,s.triangles);return list(struct.unpack_from('<3i',self.data,s.offset+s.triangles_offset+12*index))
56
+ def vertex(self,s,frame,index):
57
+ region(frame,1,1,s.frames);region(index,1,1,s.vertices);p=s.offset+s.vertices_offset+(frame*s.vertices+index)*8;v=struct.unpack_from('<3hH',self.data,p);return {'offset':p,'packed':list(v[:3]),'position':[x/64 for x in v[:3]],'normal_word':v[3]}
58
+ def uv(self,s,index):
59
+ region(index,1,1,s.vertices);return list(finite(struct.unpack_from('<2f',self.data,s.offset+s.uv_offset+8*index)))
60
+ def shader(self,s,index):
61
+ region(index,1,1,s.shaders);raw,value=struct.unpack_from('<64si',self.data,s.offset+s.shaders_offset+68*index);return {'name':name(raw),'index':value}
scripts/test_md3_contract.py ADDED
@@ -0,0 +1,29 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ import json,struct,unittest
2
+ from pathlib import Path
3
+ from md3 import MD3
4
+
5
+ def minimal():
6
+ end=512;d=bytearray(end);struct.pack_into('<4si64s9i',d,0,b'IDP3',15,b'test',0,1,1,1,0,108,164,276,end);struct.pack_into('<10f16s',d,108,-1,-1,-1,1,1,1,0,0,0,2,b'frame');struct.pack_into('<64s12f',d,164,b'tag_head',1,2,3,1,0,0,0,1,0,0,0,1);struct.pack_into('<4s64s10i',d,276,b'IDP3',b'h_head',0,1,1,3,1,108,120,188,212,236);struct.pack_into('<3i',d,384,0,1,2);struct.pack_into('<64si',d,396,b'texture',7)
7
+ for j in range(3):struct.pack_into('<2f',d,464+8*j,j*.25,j*.5);struct.pack_into('<3hH',d,488+8*j,64*j,-64*j,32,0x1234)
8
+ return d
9
+ class MD3ContractTests(unittest.TestCase):
10
+ def test_original_available_player_models(self):
11
+ r=json.loads(Path('docs/research/md3-contract.json').read_text());self.assertEqual(len(r['models']),8)
12
+ for row in r['models']:
13
+ m=MD3(Path(row['path']).read_bytes());self.assertEqual(m.frames,row['frames']);self.assertEqual(m.end,row['bytes']);self.assertEqual(len(m.surfaces),len(row['surfaces']))
14
+ def test_independent_minimal_coordinates_indices_uv_and_metadata(self):
15
+ m=MD3(minimal());s=m.surfaces[0];self.assertEqual(m.triangle(s,0),[0,1,2]);self.assertEqual(m.vertex(s,0,2),{'offset':504,'packed':[128,-128,32],'position':[2,-2,.5],'normal_word':0x1234});self.assertEqual(m.uv(s,2),[.5,1]);self.assertEqual(m.shader(s,0),{'name':'texture','index':7});self.assertEqual(m.tag(0,0)['origin'],[1,2,3])
16
+ def test_truncation_signature_and_declared_ends_rejected(self):
17
+ for d in [minimal()[:100],minimal()[:-1],b'XXXX'+bytes(minimal()[4:])]:
18
+ with self.assertRaises(ValueError):MD3(d)
19
+ def test_out_of_bounds_regions_counts_and_triangle_indices_rejected(self):
20
+ for offset,value in [(80,-1),(100,510),(276+80,1),(384,3),(276+100,10000)]:
21
+ d=minimal();struct.pack_into('<i',d,offset,value)
22
+ with self.assertRaises(ValueError):MD3(d)
23
+ def test_accessors_reject_negative_and_upper_bounds(self):
24
+ m=MD3(minimal());s=m.surfaces[0]
25
+ for index in [-1,1]:
26
+ with self.assertRaises(ValueError):m.frame(index)
27
+ with self.assertRaises(ValueError):m.tag(0,index)
28
+ with self.assertRaises(ValueError):m.vertex(s,0,3)
29
+ if __name__=='__main__':unittest.main()