3 * upkg: tool for manipulating Unreal Tournament packages.
4 * Copyright © 2020 Nick Bowler
6 * This program is free software: you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License as published by
8 * the Free Software Foundation, either version 3 of the License, or
9 * (at your option) any later version.
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
16 * You should have received a copy of the GNU General Public License
17 * along with this program. If not, see <http://www.gnu.org/licenses/>.
23 #include <uobject/loadable.h>
24 #include <uobject/exportable.h>
29 #include <uobject/uobject.h>
30 #include <engine/texture.h>
32 /* Hack to work around broken type parsing in GOB2. */
33 typedef float engine_mesh_vertex[3];
35 struct engine_mesh_face {
37 unsigned short verts[3];
38 unsigned short texture;
43 class Engine:Mesh from U:Object (dynamic)
44 (interface U:Object:Loadable)
45 (interface U:Object:Exportable)
47 private struct upkg_file pkg_file;
49 protected long vert_base;
50 protected long vert_num;
51 protected long tri_base;
52 protected long tri_num;
53 protected long conn_base;
54 protected long conn_num;
55 protected long vlink_base;
56 protected long vlink_num;
58 protected engine_mesh_vertex *vertices;
59 protected struct engine_mesh_face *faces;
61 protected long num_textures = 0;
62 protected Engine:Texture **textures destroy {
64 for (i = 0; i < self->num_textures; i++) {
66 g_object_unref(textures[i]);
71 private int skip_array(struct UObject *uo, long *nent, long entsz,
72 unsigned char *buf, size_t buflen)
74 struct upkg_file *f = uo->pkg_file;
75 unsigned long buf_offset = f->offset - buflen;
76 unsigned char mybuf[9];
81 buf_offset = f->offset;
82 buflen = upkg_export_read(f, mybuf, sizeof mybuf);
86 if (f->pkg->version >= 62) {
89 skip = unpack_32_le(buf);
93 pos += (sz = upkg_decode_index(nent, buf+pos, buflen-pos));
96 if (*nent > SIZE_MAX / entsz) {
97 u_warn(uo, "bogus array size");
100 sz = (size_t)*nent * entsz;
102 if (f->pkg->version >= 62 && sz != skip - f->base - buf_offset - pos) {
103 u_warn(uo, "array skip does not match array size");
107 if (upkg_export_seek(f, buf_offset + pos + sz, SEEK_SET) != 0)
113 private size_t fill_buf(struct upkg_file *f, unsigned char *buf,
114 size_t pos, size_t buflen)
116 size_t rc, rem = buflen - pos;
118 memmove(buf, buf+pos, rem);
119 rem += upkg_export_read(f, buf+rem, buflen-rem);
123 private int load_vertices(Self *self)
125 struct upkg_file *f = &self->_priv->pkg_file;
126 unsigned char buf[100];
130 if (upkg_export_seek(f, self->vert_base, SEEK_SET) != 0)
133 buflen = upkg_export_read(f, buf, sizeof buf);
134 pos = upkg_decode_index(&n, buf, buflen);
135 g_return_val_if_fail(pos && n == self->vert_num, -1);
137 if (self->vert_num > SIZE_MAX / sizeof self->vertices[0]) {
138 u_err(self, "failed to allocate memory");
142 self->vertices = malloc(self->vert_num * sizeof self->vertices[0]);
143 if (!self->vertices) {
144 u_err(self, "failed to allocate memory");
148 for (i = 0; i < n; i++) {
149 unsigned long vertex;
151 if (buflen - pos < 4) {
152 buflen = self_fill_buf(f, buf, pos, buflen);
156 if (buflen - pos < 4) {
157 u_err(self, "failed to read vertex data");
158 free(self->vertices);
162 vertex = unpack_32_le(buf+pos); pos += 4;
163 self->vertices[i][0] = (vertex & 0x7ff) / 8.0;
164 if (self->vertices[i][0] >= 128)
165 self->vertices[i][0] -= 256;
167 self->vertices[i][1] = ((vertex >> 11) & 0x7ff) / 8.0;
168 if (self->vertices[i][1] >= 128)
169 self->vertices[i][1] -= 256;
171 self->vertices[i][2] = ((vertex >> 22) & 0x3ff) / 4.0;
172 if (self->vertices[i][2] >= 128)
173 self->vertices[i][2] -= 256;
179 private int load_faces(Self *self)
181 struct upkg_file *f = &self->_priv->pkg_file;
182 unsigned char buf[100];
186 if (upkg_export_seek(f, self->tri_base, SEEK_SET) != 0)
189 buflen = upkg_export_read(f, buf, sizeof buf);
190 pos = upkg_decode_index(&n, buf, buflen);
191 g_return_val_if_fail(pos && n == self->tri_num, -1);
193 if (self->tri_num > SIZE_MAX / sizeof self->faces[0]) {
194 u_err(self, "failed to allocate memory");
198 self->faces = malloc(self->tri_num * sizeof self->faces[0]);
200 u_err(self, "failed to allocate memory");
204 for (i = 0; i < n; i++) {
205 struct engine_mesh_face *face = &self->faces[i];
209 if (buflen - pos < 20) {
210 buflen = self_fill_buf(f, buf, pos, buflen);
214 if (buflen - pos < 20)
217 for (j = 0; j < 3; j++) {
218 face->verts[j] = unpack_16_le(buf + pos + 2*j);
219 if (face->verts[j] >= self->vert_num)
222 face->uv[j][0] = buf[pos + 6 + 2*j] / 255.0;
223 face->uv[j][1] = 1 - buf[pos + 7 + 2*j] / 255.0;
226 face->flags = unpack_32_le(buf+pos+12);
228 tmp = unpack_32_le(buf+pos+16);
229 if (tmp > USHRT_MAX || tmp >= self->num_textures)
238 u_err(self, "failed to read triangle data");
244 interface U:Object:Loadable
245 private int load(U:Object *uo)
247 Self *self = SELF(uo);
249 if (self_load_vertices(self) != 0) {
250 u_err(self, "error loading vertex data");
254 if (self_load_faces(self) != 0) {
255 u_err(self, "error loading face data");
256 free(self->vertices);
263 interface U:Object:Loadable
264 private void unload(U:Object *uo)
266 Self *self = SELF(uo);
267 free(self->vertices);
271 interface U:Object:Exportable
272 private int export_name(U:Object *uo, char *buf, size_t n)
274 return snprintf(buf, n, "%s.obj", uo->pkg_file->name);
277 private int uv_compar(const void *a_, const void *b_)
279 const float *a = a_, *b = b_;
293 interface U:Object:Exportable
294 private int export(U:Object *uo, FILE *f)
296 Self *self = SELF(uo);
300 float (*uv_work)[2] = NULL;
303 long last_texture = -1;
305 if (fprintf(f, "mtllib %s.mtl\n", uo->pkg_file->name) < 0)
308 if (fprintf(f, "# %ld vertices\n", self->vert_num) < 0)
311 for (i = 0; i < self->vert_num; i++) {
312 float *v = self->vertices[i];
314 if (fprintf(f, "v %f %f %f\n", v[0], v[1], v[2]) < 0)
318 /* Optimize UV maps */
319 uv_work = malloc(3 * self->tri_num * sizeof uv_work[0]);
321 u_warn(uo, "failed to allocate memory");
322 uv_num = 3 * self->tri_num;
324 for (i = 0; i < self->tri_num; i++) {
327 for (j = 0; j < 3; j++) {
328 uv_work[3*i+j][0] = self->faces[i].uv[j][0];
329 uv_work[3*i+j][1] = self->faces[i].uv[j][1];
332 qsort(uv_work, 3 * self->tri_num, sizeof uv_work[0],
335 for (i = 0; i < 3 * self->tri_num; i++) {
336 if (i > 0 && !self_uv_compar(uv_work[i-1], uv_work[i]))
339 memmove(uv_work[uv_num], uv_work[i], sizeof uv_work[0]);
344 if (fprintf(f, "# %ld texture coords\n", uv_num) < 0)
347 for (i = 0; i < uv_num; i++) {
353 uv = self->faces[i/3].uv[i%3];
355 if (fprintf(f, "vt %f %f\n", uv[0], uv[1]) < 0)
359 if (fprintf(f, "# %ld triangles\n", self->tri_num) < 0)
362 for (i = 0; i < self->tri_num; i++) {
363 struct engine_mesh_face *face = &self->faces[i];
364 unsigned long uv_idx[3];
367 if (face->texture != last_texture) {
368 UObject *t = U_OBJECT(self->textures[face->texture]);
370 if (t && fprintf(f, "usemtl %s\n", t->pkg_name) < 0)
373 last_texture = face->texture;
376 for (j = 0; j < 3; j++) {
380 result = bsearch(&face->uv[j], uv_work,
381 uv_num, sizeof uv_work[0],
383 g_return_val_if_fail(result, -1);
385 uv_idx[j] = result - &uv_work[0] + 1;
387 uv_idx[j] = 3ul*i+j+1;
391 rc = fprintf(f, "f %lu/%lu %lu/%lu %lu/%lu\n",
392 face->verts[0]+1lu, uv_idx[0],
393 face->verts[1]+1lu, uv_idx[1],
394 face->verts[2]+1lu, uv_idx[2]);
406 deserialize_animations(Self *self, unsigned char *buf, size_t *bufsz)
408 struct upkg_file *f = U_OBJECT(self)->pkg_file;
409 size_t rc, buflen, pos = 0;
410 long i, j, anim_count;
412 buflen = upkg_export_read(f, buf, *bufsz);
413 pos += (rc = upkg_decode_index(&anim_count, buf, buflen));
417 for (i = 0; i < anim_count; i++) {
422 pos += (rc = upkg_decode_index(&x, buf+pos, buflen-pos));
425 s = upkg_get_name(f->pkg, x);
430 pos += (rc = upkg_decode_index(&x, buf+pos, buflen-pos));
434 /* Start/end frame */
440 pos += (rc = upkg_decode_index(&nfuncs, buf+pos, buflen-pos));
444 for (j = 0; j < nfuncs; j++) {
445 if (buflen - pos < 13) {
446 buflen = self_fill_buf(f, buf, pos, buflen);
456 rc = upkg_decode_index(&x, buf+pos, buflen-pos);
467 buflen = self_fill_buf(f, buf, pos, buflen);
472 memmove(buf, buf+pos, buflen-pos);
478 private int deserialize_textures(Self *self, unsigned char *buf, size_t bufsz)
480 struct upkg_file *f = U_OBJECT(self)->pkg_file;
481 size_t rc, buflen, pos = 0;
484 buflen = upkg_export_read(f, buf, bufsz);
485 pos += (rc = upkg_decode_index(&idx, buf, buflen));
486 if (rc == 0 || idx < 0 || idx > SIZE_MAX / sizeof self->textures[0]) {
487 u_warn(self, "invalid texture count");
490 self->num_textures = idx;
492 self->textures = malloc(self->num_textures * sizeof self->textures[0]);
493 if (!self->textures) {
494 u_warn(self, "failed to allocate memory");
498 for (i = 0; i < self->num_textures; i++) {
502 buflen = self_fill_buf(f, buf, pos, buflen);
506 pos += (rc = upkg_decode_index(&idx, buf+pos, buflen-pos));
508 u_warn(self, "invalid texture reference");
509 } else if (idx == 0) {
510 /* Seems these lists start with null references, ignore... */
512 obj = u_object_get_by_link(G_OBJECT(self), idx);
514 u_warn(self, "failed to load texture %ld %ld", idx);
517 self->textures[i] = ENGINE_TEXTURE(obj);
520 if (upkg_export_seek(f, (long)pos - (long)buflen, SEEK_CUR) != 0)
526 override (U:Object) int deserialize(U:Object *uo)
528 Self *self = SELF(uo);
529 struct upkg_file *f = uo->pkg_file;
530 const size_t sphere_sz = 12 + 4 * (f->pkg->version >= 62);
531 size_t buflen, pos = 0;
534 unsigned char buf[50];
538 buflen = upkg_export_read(f, buf, sizeof buf);
541 if (buflen - pos < 25)
545 /* Bounding sphere */
546 if (buflen - pos < sphere_sz)
550 self->vert_base = pos + 4*(f->pkg->version >= 61);
551 if (self_skip_array(uo, &self->vert_num, 4, buf+pos, buflen-pos) != 0) {
552 u_err(uo, "invalid vertex array");
556 self->tri_base = f->offset + 4*(f->pkg->version >= 61);
557 if (self_skip_array(uo, &self->tri_num, 20, NULL, 0) != 0) {
558 u_err(uo, "invalid triangle array");
562 if (self_deserialize_animations(self, buf, &buflen) != 0) {
566 self->conn_base = f->offset - buflen;
567 if (self_skip_array(uo, &self->conn_num, 8, buf, buflen) != 0) {
568 u_err(uo, "invalid connection array");
572 buflen = upkg_export_read(f, buf, sizeof buf);
575 /* Another bounding box? */
576 if (buflen - pos < 25)
580 /* Another bounding sphere? */
581 if (buflen - pos < sphere_sz)
585 self->vlink_base = f->offset - (buflen - pos);
586 if (self_skip_array(uo, &self->vlink_num, 4, buf+pos, buflen-pos)) {
587 u_err(uo, "invalid vertex link array");
591 if (self_deserialize_textures(self, buf, buflen) != 0) {
595 /* More bounding boxes!? */
596 buflen = upkg_export_read(f, buf, 5);
597 pos = upkg_decode_index(&idx, buf, buflen);
598 if (pos == 0 || idx < 0 || idx > LONG_MAX / 25) {
599 u_err(uo, "invalid bounding box array");
603 if (upkg_export_seek(f, (long)pos - 5 + idx * 25, SEEK_CUR) != 0)
606 /* More bounding spheres!? */
607 buflen = upkg_export_read(f, buf, 5);
608 pos = upkg_decode_index(&idx, buf, buflen);
609 if (pos == 0 || idx < 0 || idx > LONG_MAX / 16) {
610 u_err(uo, "invalid bounding sphere array");
614 if (upkg_export_seek(f, (long)pos - 5 + idx * sphere_sz, SEEK_CUR) != 0)
617 self->_priv->pkg_file = *f;