├── .editorconfig
├── .github
└── FUNDING.yml
├── LICENSE
├── README.md
├── Replay Blender Importer
├── __init__.py
├── acrp_import.py
├── blender_manifest.toml
├── operators.py
└── panel.py
└── Replay Parser
├── CMakeLists.txt
├── TC-mingw.cmake
├── include
├── ACReplayParser.hpp
├── UtilsData.hpp
└── UtilsIO.hpp
├── main.cpp
└── src
├── ACReplayParser.cpp
└── UtilsIO.cpp
/.editorconfig:
--------------------------------------------------------------------------------
1 | [*]
2 | indent_style = tab
3 | indent_size = 4
--------------------------------------------------------------------------------
/.github/FUNDING.yml:
--------------------------------------------------------------------------------
1 | # These are supported funding model platforms
2 |
3 | github: # Replace with up to 4 GitHub Sponsors-enabled usernames e.g., [user1, user2]
4 | patreon: # Replace with a single Patreon username
5 | open_collective: # Replace with a single Open Collective username
6 | ko_fi: # Replace with a single Ko-fi username
7 | tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel
8 | community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry
9 | liberapay: # Replace with a single Liberapay username
10 | issuehunt: # Replace with a single IssueHunt username
11 | lfx_crowdfunding: # Replace with a single LFX Crowdfunding project-name e.g., cloud-foundry
12 | polar: # Replace with a single Polar username
13 | buy_me_a_coffee: abchouhan
14 | thanks_dev: # Replace with a single thanks.dev username
15 | custom: # Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2']
16 |
--------------------------------------------------------------------------------
/LICENSE:
--------------------------------------------------------------------------------
1 | GNU GENERAL PUBLIC LICENSE
2 | Version 3, 29 June 2007
3 |
4 | Copyright (C) 2007 Free Software Foundation, Inc.
5 | Everyone is permitted to copy and distribute verbatim copies
6 | of this license document, but changing it is not allowed.
7 |
8 | Preamble
9 |
10 | The GNU General Public License is a free, copyleft license for
11 | software and other kinds of works.
12 |
13 | The licenses for most software and other practical works are designed
14 | to take away your freedom to share and change the works. By contrast,
15 | the GNU General Public License is intended to guarantee your freedom to
16 | share and change all versions of a program--to make sure it remains free
17 | software for all its users. We, the Free Software Foundation, use the
18 | GNU General Public License for most of our software; it applies also to
19 | any other work released this way by its authors. You can apply it to
20 | your programs, too.
21 |
22 | When we speak of free software, we are referring to freedom, not
23 | price. Our General Public Licenses are designed to make sure that you
24 | have the freedom to distribute copies of free software (and charge for
25 | them if you wish), that you receive source code or can get it if you
26 | want it, that you can change the software or use pieces of it in new
27 | free programs, and that you know you can do these things.
28 |
29 | To protect your rights, we need to prevent others from denying you
30 | these rights or asking you to surrender the rights. Therefore, you have
31 | certain responsibilities if you distribute copies of the software, or if
32 | you modify it: responsibilities to respect the freedom of others.
33 |
34 | For example, if you distribute copies of such a program, whether
35 | gratis or for a fee, you must pass on to the recipients the same
36 | freedoms that you received. You must make sure that they, too, receive
37 | or can get the source code. And you must show them these terms so they
38 | know their rights.
39 |
40 | Developers that use the GNU GPL protect your rights with two steps:
41 | (1) assert copyright on the software, and (2) offer you this License
42 | giving you legal permission to copy, distribute and/or modify it.
43 |
44 | For the developers' and authors' protection, the GPL clearly explains
45 | that there is no warranty for this free software. For both users' and
46 | authors' sake, the GPL requires that modified versions be marked as
47 | changed, so that their problems will not be attributed erroneously to
48 | authors of previous versions.
49 |
50 | Some devices are designed to deny users access to install or run
51 | modified versions of the software inside them, although the manufacturer
52 | can do so. This is fundamentally incompatible with the aim of
53 | protecting users' freedom to change the software. The systematic
54 | pattern of such abuse occurs in the area of products for individuals to
55 | use, which is precisely where it is most unacceptable. Therefore, we
56 | have designed this version of the GPL to prohibit the practice for those
57 | products. If such problems arise substantially in other domains, we
58 | stand ready to extend this provision to those domains in future versions
59 | of the GPL, as needed to protect the freedom of users.
60 |
61 | Finally, every program is threatened constantly by software patents.
62 | States should not allow patents to restrict development and use of
63 | software on general-purpose computers, but in those that do, we wish to
64 | avoid the special danger that patents applied to a free program could
65 | make it effectively proprietary. To prevent this, the GPL assures that
66 | patents cannot be used to render the program non-free.
67 |
68 | The precise terms and conditions for copying, distribution and
69 | modification follow.
70 |
71 | TERMS AND CONDITIONS
72 |
73 | 0. Definitions.
74 |
75 | "This License" refers to version 3 of the GNU General Public License.
76 |
77 | "Copyright" also means copyright-like laws that apply to other kinds of
78 | works, such as semiconductor masks.
79 |
80 | "The Program" refers to any copyrightable work licensed under this
81 | License. Each licensee is addressed as "you". "Licensees" and
82 | "recipients" may be individuals or organizations.
83 |
84 | To "modify" a work means to copy from or adapt all or part of the work
85 | in a fashion requiring copyright permission, other than the making of an
86 | exact copy. The resulting work is called a "modified version" of the
87 | earlier work or a work "based on" the earlier work.
88 |
89 | A "covered work" means either the unmodified Program or a work based
90 | on the Program.
91 |
92 | To "propagate" a work means to do anything with it that, without
93 | permission, would make you directly or secondarily liable for
94 | infringement under applicable copyright law, except executing it on a
95 | computer or modifying a private copy. Propagation includes copying,
96 | distribution (with or without modification), making available to the
97 | public, and in some countries other activities as well.
98 |
99 | To "convey" a work means any kind of propagation that enables other
100 | parties to make or receive copies. Mere interaction with a user through
101 | a computer network, with no transfer of a copy, is not conveying.
102 |
103 | An interactive user interface displays "Appropriate Legal Notices"
104 | to the extent that it includes a convenient and prominently visible
105 | feature that (1) displays an appropriate copyright notice, and (2)
106 | tells the user that there is no warranty for the work (except to the
107 | extent that warranties are provided), that licensees may convey the
108 | work under this License, and how to view a copy of this License. If
109 | the interface presents a list of user commands or options, such as a
110 | menu, a prominent item in the list meets this criterion.
111 |
112 | 1. Source Code.
113 |
114 | The "source code" for a work means the preferred form of the work
115 | for making modifications to it. "Object code" means any non-source
116 | form of a work.
117 |
118 | A "Standard Interface" means an interface that either is an official
119 | standard defined by a recognized standards body, or, in the case of
120 | interfaces specified for a particular programming language, one that
121 | is widely used among developers working in that language.
122 |
123 | The "System Libraries" of an executable work include anything, other
124 | than the work as a whole, that (a) is included in the normal form of
125 | packaging a Major Component, but which is not part of that Major
126 | Component, and (b) serves only to enable use of the work with that
127 | Major Component, or to implement a Standard Interface for which an
128 | implementation is available to the public in source code form. A
129 | "Major Component", in this context, means a major essential component
130 | (kernel, window system, and so on) of the specific operating system
131 | (if any) on which the executable work runs, or a compiler used to
132 | produce the work, or an object code interpreter used to run it.
133 |
134 | The "Corresponding Source" for a work in object code form means all
135 | the source code needed to generate, install, and (for an executable
136 | work) run the object code and to modify the work, including scripts to
137 | control those activities. However, it does not include the work's
138 | System Libraries, or general-purpose tools or generally available free
139 | programs which are used unmodified in performing those activities but
140 | which are not part of the work. For example, Corresponding Source
141 | includes interface definition files associated with source files for
142 | the work, and the source code for shared libraries and dynamically
143 | linked subprograms that the work is specifically designed to require,
144 | such as by intimate data communication or control flow between those
145 | subprograms and other parts of the work.
146 |
147 | The Corresponding Source need not include anything that users
148 | can regenerate automatically from other parts of the Corresponding
149 | Source.
150 |
151 | The Corresponding Source for a work in source code form is that
152 | same work.
153 |
154 | 2. Basic Permissions.
155 |
156 | All rights granted under this License are granted for the term of
157 | copyright on the Program, and are irrevocable provided the stated
158 | conditions are met. This License explicitly affirms your unlimited
159 | permission to run the unmodified Program. The output from running a
160 | covered work is covered by this License only if the output, given its
161 | content, constitutes a covered work. This License acknowledges your
162 | rights of fair use or other equivalent, as provided by copyright law.
163 |
164 | You may make, run and propagate covered works that you do not
165 | convey, without conditions so long as your license otherwise remains
166 | in force. You may convey covered works to others for the sole purpose
167 | of having them make modifications exclusively for you, or provide you
168 | with facilities for running those works, provided that you comply with
169 | the terms of this License in conveying all material for which you do
170 | not control copyright. Those thus making or running the covered works
171 | for you must do so exclusively on your behalf, under your direction
172 | and control, on terms that prohibit them from making any copies of
173 | your copyrighted material outside their relationship with you.
174 |
175 | Conveying under any other circumstances is permitted solely under
176 | the conditions stated below. Sublicensing is not allowed; section 10
177 | makes it unnecessary.
178 |
179 | 3. Protecting Users' Legal Rights From Anti-Circumvention Law.
180 |
181 | No covered work shall be deemed part of an effective technological
182 | measure under any applicable law fulfilling obligations under article
183 | 11 of the WIPO copyright treaty adopted on 20 December 1996, or
184 | similar laws prohibiting or restricting circumvention of such
185 | measures.
186 |
187 | When you convey a covered work, you waive any legal power to forbid
188 | circumvention of technological measures to the extent such circumvention
189 | is effected by exercising rights under this License with respect to
190 | the covered work, and you disclaim any intention to limit operation or
191 | modification of the work as a means of enforcing, against the work's
192 | users, your or third parties' legal rights to forbid circumvention of
193 | technological measures.
194 |
195 | 4. Conveying Verbatim Copies.
196 |
197 | You may convey verbatim copies of the Program's source code as you
198 | receive it, in any medium, provided that you conspicuously and
199 | appropriately publish on each copy an appropriate copyright notice;
200 | keep intact all notices stating that this License and any
201 | non-permissive terms added in accord with section 7 apply to the code;
202 | keep intact all notices of the absence of any warranty; and give all
203 | recipients a copy of this License along with the Program.
204 |
205 | You may charge any price or no price for each copy that you convey,
206 | and you may offer support or warranty protection for a fee.
207 |
208 | 5. Conveying Modified Source Versions.
209 |
210 | You may convey a work based on the Program, or the modifications to
211 | produce it from the Program, in the form of source code under the
212 | terms of section 4, provided that you also meet all of these conditions:
213 |
214 | a) The work must carry prominent notices stating that you modified
215 | it, and giving a relevant date.
216 |
217 | b) The work must carry prominent notices stating that it is
218 | released under this License and any conditions added under section
219 | 7. This requirement modifies the requirement in section 4 to
220 | "keep intact all notices".
221 |
222 | c) You must license the entire work, as a whole, under this
223 | License to anyone who comes into possession of a copy. This
224 | License will therefore apply, along with any applicable section 7
225 | additional terms, to the whole of the work, and all its parts,
226 | regardless of how they are packaged. This License gives no
227 | permission to license the work in any other way, but it does not
228 | invalidate such permission if you have separately received it.
229 |
230 | d) If the work has interactive user interfaces, each must display
231 | Appropriate Legal Notices; however, if the Program has interactive
232 | interfaces that do not display Appropriate Legal Notices, your
233 | work need not make them do so.
234 |
235 | A compilation of a covered work with other separate and independent
236 | works, which are not by their nature extensions of the covered work,
237 | and which are not combined with it such as to form a larger program,
238 | in or on a volume of a storage or distribution medium, is called an
239 | "aggregate" if the compilation and its resulting copyright are not
240 | used to limit the access or legal rights of the compilation's users
241 | beyond what the individual works permit. Inclusion of a covered work
242 | in an aggregate does not cause this License to apply to the other
243 | parts of the aggregate.
244 |
245 | 6. Conveying Non-Source Forms.
246 |
247 | You may convey a covered work in object code form under the terms
248 | of sections 4 and 5, provided that you also convey the
249 | machine-readable Corresponding Source under the terms of this License,
250 | in one of these ways:
251 |
252 | a) Convey the object code in, or embodied in, a physical product
253 | (including a physical distribution medium), accompanied by the
254 | Corresponding Source fixed on a durable physical medium
255 | customarily used for software interchange.
256 |
257 | b) Convey the object code in, or embodied in, a physical product
258 | (including a physical distribution medium), accompanied by a
259 | written offer, valid for at least three years and valid for as
260 | long as you offer spare parts or customer support for that product
261 | model, to give anyone who possesses the object code either (1) a
262 | copy of the Corresponding Source for all the software in the
263 | product that is covered by this License, on a durable physical
264 | medium customarily used for software interchange, for a price no
265 | more than your reasonable cost of physically performing this
266 | conveying of source, or (2) access to copy the
267 | Corresponding Source from a network server at no charge.
268 |
269 | c) Convey individual copies of the object code with a copy of the
270 | written offer to provide the Corresponding Source. This
271 | alternative is allowed only occasionally and noncommercially, and
272 | only if you received the object code with such an offer, in accord
273 | with subsection 6b.
274 |
275 | d) Convey the object code by offering access from a designated
276 | place (gratis or for a charge), and offer equivalent access to the
277 | Corresponding Source in the same way through the same place at no
278 | further charge. You need not require recipients to copy the
279 | Corresponding Source along with the object code. If the place to
280 | copy the object code is a network server, the Corresponding Source
281 | may be on a different server (operated by you or a third party)
282 | that supports equivalent copying facilities, provided you maintain
283 | clear directions next to the object code saying where to find the
284 | Corresponding Source. Regardless of what server hosts the
285 | Corresponding Source, you remain obligated to ensure that it is
286 | available for as long as needed to satisfy these requirements.
287 |
288 | e) Convey the object code using peer-to-peer transmission, provided
289 | you inform other peers where the object code and Corresponding
290 | Source of the work are being offered to the general public at no
291 | charge under subsection 6d.
292 |
293 | A separable portion of the object code, whose source code is excluded
294 | from the Corresponding Source as a System Library, need not be
295 | included in conveying the object code work.
296 |
297 | A "User Product" is either (1) a "consumer product", which means any
298 | tangible personal property which is normally used for personal, family,
299 | or household purposes, or (2) anything designed or sold for incorporation
300 | into a dwelling. In determining whether a product is a consumer product,
301 | doubtful cases shall be resolved in favor of coverage. For a particular
302 | product received by a particular user, "normally used" refers to a
303 | typical or common use of that class of product, regardless of the status
304 | of the particular user or of the way in which the particular user
305 | actually uses, or expects or is expected to use, the product. A product
306 | is a consumer product regardless of whether the product has substantial
307 | commercial, industrial or non-consumer uses, unless such uses represent
308 | the only significant mode of use of the product.
309 |
310 | "Installation Information" for a User Product means any methods,
311 | procedures, authorization keys, or other information required to install
312 | and execute modified versions of a covered work in that User Product from
313 | a modified version of its Corresponding Source. The information must
314 | suffice to ensure that the continued functioning of the modified object
315 | code is in no case prevented or interfered with solely because
316 | modification has been made.
317 |
318 | If you convey an object code work under this section in, or with, or
319 | specifically for use in, a User Product, and the conveying occurs as
320 | part of a transaction in which the right of possession and use of the
321 | User Product is transferred to the recipient in perpetuity or for a
322 | fixed term (regardless of how the transaction is characterized), the
323 | Corresponding Source conveyed under this section must be accompanied
324 | by the Installation Information. But this requirement does not apply
325 | if neither you nor any third party retains the ability to install
326 | modified object code on the User Product (for example, the work has
327 | been installed in ROM).
328 |
329 | The requirement to provide Installation Information does not include a
330 | requirement to continue to provide support service, warranty, or updates
331 | for a work that has been modified or installed by the recipient, or for
332 | the User Product in which it has been modified or installed. Access to a
333 | network may be denied when the modification itself materially and
334 | adversely affects the operation of the network or violates the rules and
335 | protocols for communication across the network.
336 |
337 | Corresponding Source conveyed, and Installation Information provided,
338 | in accord with this section must be in a format that is publicly
339 | documented (and with an implementation available to the public in
340 | source code form), and must require no special password or key for
341 | unpacking, reading or copying.
342 |
343 | 7. Additional Terms.
344 |
345 | "Additional permissions" are terms that supplement the terms of this
346 | License by making exceptions from one or more of its conditions.
347 | Additional permissions that are applicable to the entire Program shall
348 | be treated as though they were included in this License, to the extent
349 | that they are valid under applicable law. If additional permissions
350 | apply only to part of the Program, that part may be used separately
351 | under those permissions, but the entire Program remains governed by
352 | this License without regard to the additional permissions.
353 |
354 | When you convey a copy of a covered work, you may at your option
355 | remove any additional permissions from that copy, or from any part of
356 | it. (Additional permissions may be written to require their own
357 | removal in certain cases when you modify the work.) You may place
358 | additional permissions on material, added by you to a covered work,
359 | for which you have or can give appropriate copyright permission.
360 |
361 | Notwithstanding any other provision of this License, for material you
362 | add to a covered work, you may (if authorized by the copyright holders of
363 | that material) supplement the terms of this License with terms:
364 |
365 | a) Disclaiming warranty or limiting liability differently from the
366 | terms of sections 15 and 16 of this License; or
367 |
368 | b) Requiring preservation of specified reasonable legal notices or
369 | author attributions in that material or in the Appropriate Legal
370 | Notices displayed by works containing it; or
371 |
372 | c) Prohibiting misrepresentation of the origin of that material, or
373 | requiring that modified versions of such material be marked in
374 | reasonable ways as different from the original version; or
375 |
376 | d) Limiting the use for publicity purposes of names of licensors or
377 | authors of the material; or
378 |
379 | e) Declining to grant rights under trademark law for use of some
380 | trade names, trademarks, or service marks; or
381 |
382 | f) Requiring indemnification of licensors and authors of that
383 | material by anyone who conveys the material (or modified versions of
384 | it) with contractual assumptions of liability to the recipient, for
385 | any liability that these contractual assumptions directly impose on
386 | those licensors and authors.
387 |
388 | All other non-permissive additional terms are considered "further
389 | restrictions" within the meaning of section 10. If the Program as you
390 | received it, or any part of it, contains a notice stating that it is
391 | governed by this License along with a term that is a further
392 | restriction, you may remove that term. If a license document contains
393 | a further restriction but permits relicensing or conveying under this
394 | License, you may add to a covered work material governed by the terms
395 | of that license document, provided that the further restriction does
396 | not survive such relicensing or conveying.
397 |
398 | If you add terms to a covered work in accord with this section, you
399 | must place, in the relevant source files, a statement of the
400 | additional terms that apply to those files, or a notice indicating
401 | where to find the applicable terms.
402 |
403 | Additional terms, permissive or non-permissive, may be stated in the
404 | form of a separately written license, or stated as exceptions;
405 | the above requirements apply either way.
406 |
407 | 8. Termination.
408 |
409 | You may not propagate or modify a covered work except as expressly
410 | provided under this License. Any attempt otherwise to propagate or
411 | modify it is void, and will automatically terminate your rights under
412 | this License (including any patent licenses granted under the third
413 | paragraph of section 11).
414 |
415 | However, if you cease all violation of this License, then your
416 | license from a particular copyright holder is reinstated (a)
417 | provisionally, unless and until the copyright holder explicitly and
418 | finally terminates your license, and (b) permanently, if the copyright
419 | holder fails to notify you of the violation by some reasonable means
420 | prior to 60 days after the cessation.
421 |
422 | Moreover, your license from a particular copyright holder is
423 | reinstated permanently if the copyright holder notifies you of the
424 | violation by some reasonable means, this is the first time you have
425 | received notice of violation of this License (for any work) from that
426 | copyright holder, and you cure the violation prior to 30 days after
427 | your receipt of the notice.
428 |
429 | Termination of your rights under this section does not terminate the
430 | licenses of parties who have received copies or rights from you under
431 | this License. If your rights have been terminated and not permanently
432 | reinstated, you do not qualify to receive new licenses for the same
433 | material under section 10.
434 |
435 | 9. Acceptance Not Required for Having Copies.
436 |
437 | You are not required to accept this License in order to receive or
438 | run a copy of the Program. Ancillary propagation of a covered work
439 | occurring solely as a consequence of using peer-to-peer transmission
440 | to receive a copy likewise does not require acceptance. However,
441 | nothing other than this License grants you permission to propagate or
442 | modify any covered work. These actions infringe copyright if you do
443 | not accept this License. Therefore, by modifying or propagating a
444 | covered work, you indicate your acceptance of this License to do so.
445 |
446 | 10. Automatic Licensing of Downstream Recipients.
447 |
448 | Each time you convey a covered work, the recipient automatically
449 | receives a license from the original licensors, to run, modify and
450 | propagate that work, subject to this License. You are not responsible
451 | for enforcing compliance by third parties with this License.
452 |
453 | An "entity transaction" is a transaction transferring control of an
454 | organization, or substantially all assets of one, or subdividing an
455 | organization, or merging organizations. If propagation of a covered
456 | work results from an entity transaction, each party to that
457 | transaction who receives a copy of the work also receives whatever
458 | licenses to the work the party's predecessor in interest had or could
459 | give under the previous paragraph, plus a right to possession of the
460 | Corresponding Source of the work from the predecessor in interest, if
461 | the predecessor has it or can get it with reasonable efforts.
462 |
463 | You may not impose any further restrictions on the exercise of the
464 | rights granted or affirmed under this License. For example, you may
465 | not impose a license fee, royalty, or other charge for exercise of
466 | rights granted under this License, and you may not initiate litigation
467 | (including a cross-claim or counterclaim in a lawsuit) alleging that
468 | any patent claim is infringed by making, using, selling, offering for
469 | sale, or importing the Program or any portion of it.
470 |
471 | 11. Patents.
472 |
473 | A "contributor" is a copyright holder who authorizes use under this
474 | License of the Program or a work on which the Program is based. The
475 | work thus licensed is called the contributor's "contributor version".
476 |
477 | A contributor's "essential patent claims" are all patent claims
478 | owned or controlled by the contributor, whether already acquired or
479 | hereafter acquired, that would be infringed by some manner, permitted
480 | by this License, of making, using, or selling its contributor version,
481 | but do not include claims that would be infringed only as a
482 | consequence of further modification of the contributor version. For
483 | purposes of this definition, "control" includes the right to grant
484 | patent sublicenses in a manner consistent with the requirements of
485 | this License.
486 |
487 | Each contributor grants you a non-exclusive, worldwide, royalty-free
488 | patent license under the contributor's essential patent claims, to
489 | make, use, sell, offer for sale, import and otherwise run, modify and
490 | propagate the contents of its contributor version.
491 |
492 | In the following three paragraphs, a "patent license" is any express
493 | agreement or commitment, however denominated, not to enforce a patent
494 | (such as an express permission to practice a patent or covenant not to
495 | sue for patent infringement). To "grant" such a patent license to a
496 | party means to make such an agreement or commitment not to enforce a
497 | patent against the party.
498 |
499 | If you convey a covered work, knowingly relying on a patent license,
500 | and the Corresponding Source of the work is not available for anyone
501 | to copy, free of charge and under the terms of this License, through a
502 | publicly available network server or other readily accessible means,
503 | then you must either (1) cause the Corresponding Source to be so
504 | available, or (2) arrange to deprive yourself of the benefit of the
505 | patent license for this particular work, or (3) arrange, in a manner
506 | consistent with the requirements of this License, to extend the patent
507 | license to downstream recipients. "Knowingly relying" means you have
508 | actual knowledge that, but for the patent license, your conveying the
509 | covered work in a country, or your recipient's use of the covered work
510 | in a country, would infringe one or more identifiable patents in that
511 | country that you have reason to believe are valid.
512 |
513 | If, pursuant to or in connection with a single transaction or
514 | arrangement, you convey, or propagate by procuring conveyance of, a
515 | covered work, and grant a patent license to some of the parties
516 | receiving the covered work authorizing them to use, propagate, modify
517 | or convey a specific copy of the covered work, then the patent license
518 | you grant is automatically extended to all recipients of the covered
519 | work and works based on it.
520 |
521 | A patent license is "discriminatory" if it does not include within
522 | the scope of its coverage, prohibits the exercise of, or is
523 | conditioned on the non-exercise of one or more of the rights that are
524 | specifically granted under this License. You may not convey a covered
525 | work if you are a party to an arrangement with a third party that is
526 | in the business of distributing software, under which you make payment
527 | to the third party based on the extent of your activity of conveying
528 | the work, and under which the third party grants, to any of the
529 | parties who would receive the covered work from you, a discriminatory
530 | patent license (a) in connection with copies of the covered work
531 | conveyed by you (or copies made from those copies), or (b) primarily
532 | for and in connection with specific products or compilations that
533 | contain the covered work, unless you entered into that arrangement,
534 | or that patent license was granted, prior to 28 March 2007.
535 |
536 | Nothing in this License shall be construed as excluding or limiting
537 | any implied license or other defenses to infringement that may
538 | otherwise be available to you under applicable patent law.
539 |
540 | 12. No Surrender of Others' Freedom.
541 |
542 | If conditions are imposed on you (whether by court order, agreement or
543 | otherwise) that contradict the conditions of this License, they do not
544 | excuse you from the conditions of this License. If you cannot convey a
545 | covered work so as to satisfy simultaneously your obligations under this
546 | License and any other pertinent obligations, then as a consequence you may
547 | not convey it at all. For example, if you agree to terms that obligate you
548 | to collect a royalty for further conveying from those to whom you convey
549 | the Program, the only way you could satisfy both those terms and this
550 | License would be to refrain entirely from conveying the Program.
551 |
552 | 13. Use with the GNU Affero General Public License.
553 |
554 | Notwithstanding any other provision of this License, you have
555 | permission to link or combine any covered work with a work licensed
556 | under version 3 of the GNU Affero General Public License into a single
557 | combined work, and to convey the resulting work. The terms of this
558 | License will continue to apply to the part which is the covered work,
559 | but the special requirements of the GNU Affero General Public License,
560 | section 13, concerning interaction through a network will apply to the
561 | combination as such.
562 |
563 | 14. Revised Versions of this License.
564 |
565 | The Free Software Foundation may publish revised and/or new versions of
566 | the GNU General Public License from time to time. Such new versions will
567 | be similar in spirit to the present version, but may differ in detail to
568 | address new problems or concerns.
569 |
570 | Each version is given a distinguishing version number. If the
571 | Program specifies that a certain numbered version of the GNU General
572 | Public License "or any later version" applies to it, you have the
573 | option of following the terms and conditions either of that numbered
574 | version or of any later version published by the Free Software
575 | Foundation. If the Program does not specify a version number of the
576 | GNU General Public License, you may choose any version ever published
577 | by the Free Software Foundation.
578 |
579 | If the Program specifies that a proxy can decide which future
580 | versions of the GNU General Public License can be used, that proxy's
581 | public statement of acceptance of a version permanently authorizes you
582 | to choose that version for the Program.
583 |
584 | Later license versions may give you additional or different
585 | permissions. However, no additional obligations are imposed on any
586 | author or copyright holder as a result of your choosing to follow a
587 | later version.
588 |
589 | 15. Disclaimer of Warranty.
590 |
591 | THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
592 | APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
593 | HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
594 | OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
595 | THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
596 | PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
597 | IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
598 | ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
599 |
600 | 16. Limitation of Liability.
601 |
602 | IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
603 | WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
604 | THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
605 | GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
606 | USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
607 | DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
608 | PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
609 | EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
610 | SUCH DAMAGES.
611 |
612 | 17. Interpretation of Sections 15 and 16.
613 |
614 | If the disclaimer of warranty and limitation of liability provided
615 | above cannot be given local legal effect according to their terms,
616 | reviewing courts shall apply local law that most closely approximates
617 | an absolute waiver of all civil liability in connection with the
618 | Program, unless a warranty or assumption of liability accompanies a
619 | copy of the Program in return for a fee.
620 |
621 | END OF TERMS AND CONDITIONS
622 |
623 | How to Apply These Terms to Your New Programs
624 |
625 | If you develop a new program, and you want it to be of the greatest
626 | possible use to the public, the best way to achieve this is to make it
627 | free software which everyone can redistribute and change under these terms.
628 |
629 | To do so, attach the following notices to the program. It is safest
630 | to attach them to the start of each source file to most effectively
631 | state the exclusion of warranty; and each file should have at least
632 | the "copyright" line and a pointer to where the full notice is found.
633 |
634 |
635 | Copyright (C)
636 |
637 | This program is free software: you can redistribute it and/or modify
638 | it under the terms of the GNU General Public License as published by
639 | the Free Software Foundation, either version 3 of the License, or
640 | (at your option) any later version.
641 |
642 | This program is distributed in the hope that it will be useful,
643 | but WITHOUT ANY WARRANTY; without even the implied warranty of
644 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
645 | GNU General Public License for more details.
646 |
647 | You should have received a copy of the GNU General Public License
648 | along with this program. If not, see .
649 |
650 | Also add information on how to contact you by electronic and paper mail.
651 |
652 | If the program does terminal interaction, make it output a short
653 | notice like this when it starts in an interactive mode:
654 |
655 | Copyright (C)
656 | This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
657 | This is free software, and you are welcome to redistribute it
658 | under certain conditions; type `show c' for details.
659 |
660 | The hypothetical commands `show w' and `show c' should show the appropriate
661 | parts of the General Public License. Of course, your program's commands
662 | might be different; for a GUI interface, you would use an "about box".
663 |
664 | You should also get your employer (if you work as a programmer) or school,
665 | if any, to sign a "copyright disclaimer" for the program, if necessary.
666 | For more information on this, and how to apply and follow the GNU GPL, see
667 | .
668 |
669 | The GNU General Public License does not permit incorporating your program
670 | into proprietary programs. If your program is a subroutine library, you
671 | may consider it more useful to permit linking proprietary applications with
672 | the library. If this is what you want to do, use the GNU Lesser General
673 | Public License instead of this License. But first, please read
674 | .
675 |
--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
1 | # acreplay-parser
2 | This software consists of two parts: a [parser](#parser) for Assetto Corsa replay (.acreplay) files, and an [addon](#addon) to import the parsed data into Blender.
3 | A video guide is available [here](https://youtube.com/watch?v=ZBwSbNptEmM).
4 |
5 | 
6 | 
7 |
8 | ## Parser
9 | ### Usage
10 | - Download and extract a 'ReplayParser' file from the [Releases](https://github.com/abchouhan/acreplay-parser/releases) page
11 | - Open an `.acreplay` file with the `acrp` executable and it will output data for each driver as `.json` files.
12 | - Import the `.json` files into Blender with the [addon](#addon).
13 |
14 | For more advanced options use the command line:
15 | ```
16 | acrp [OPTIONS] [INPUT FILE(S)] with options:
17 | -o, --output PATH
18 | Output path with optional file name.
19 | Default is ".json" in the directory of the executable.
20 | is concatenated to the end if all cars are to be parsed.
21 |
22 | --driver-name NAME
23 | Name of driver whose vehicle is to be parsed.
24 | Parses all cars if unspecified.
25 | ```
26 | ### Building
27 | Requirements:
28 | - A compiler supporting [C++23 extended floating-point types](https://en.cppreference.com/w/cpp/types/floating-point) (GCC recommended)
29 | - [zlib](https://github.com/madler/zlib)
30 | - CMake
31 |
32 | In the 'Replay Parser' folder, run the following command:
33 | ```
34 | cmake -B build -S .
35 | ```
36 | This will create a `Makefile` in the 'build' subfolder.
37 |
38 | Finish building the executable:
39 | ```
40 | cmake --build build --parallel
41 | ```
42 | The executable will be located in the 'build' subfolder.
43 |
44 | ## Addon
45 | ### Installation
46 | - For Blender versions ≥ 4.2.0
47 | - Install through [Blender Extensions](https://extensions.blender.org/add-ons/acreplay-importer/)
48 | - For Blender versions ≥ 3.0.0
49 | - Download the latest 'Replay Blender Importer' zip file from the [Releases](https://github.com/abchouhan/acreplay-parser/releases) page
50 | - In Blender go to Edit → Preferences and click 'Install', navigate to the downloaded file
51 | - Enable the addon
52 |
53 | ### Usage
54 | - Open the sidebar by going to View → Sidebar, or by pressing the N key
55 | - Go to the Animation tab and locate the 'AC Replay Importer' dropdown
56 | - Click 'Import .json' and navigate to the `.json` file outputted by the [parser](#parser)
57 | - Adjust framerate if necessary
58 | - Assign the Chassis and Wheel slots appropriately (see [video guide](https://youtube.com/watch?v=ZBwSbNptEmM))
59 |
60 | ### Building
61 | #### For Blender 4.2.0 and beyond
62 | In the 'Replay Blender Importer' folder, run the following command:
63 | ```
64 | blender --command extension build
65 | ```
66 | This creates a zip file 'acreplay_importer-x.x.x.zip' which can be installed in Blender.
67 | #### For Blender 3.0.0-4.1.x
68 | See the [0.2.0 Blender 3.0.0 branch](https://github.com/abchouhan/acreplay-parser/tree/0.2.0_blender-3.0.0?tab=readme-ov-file#building-1)
69 |
--------------------------------------------------------------------------------
/Replay Blender Importer/__init__.py:
--------------------------------------------------------------------------------
1 | import bpy
2 | from bpy.props import StringProperty, IntProperty, FloatProperty, PointerProperty
3 | from . import operators, panel
4 |
5 |
6 | class ACReplayImporterProperties(bpy.types.PropertyGroup):
7 | acrjson_filepath: StringProperty(default="")
8 | num_frames: IntProperty(default=0)
9 | recording_interval: FloatProperty(default=0.0) # in Hz
10 | target_framerate: FloatProperty(name="Target Frame Rate", default=30.0, min=1.0, precision=2)
11 | chassis_object: PointerProperty(name="Chassis", type=bpy.types.Object)
12 | wheelfl_object: PointerProperty(name="FL Wheel", type=bpy.types.Object)
13 | wheelfr_object: PointerProperty(name="FR Wheel", type=bpy.types.Object)
14 | wheelrl_object: PointerProperty(name="RL Wheel", type=bpy.types.Object)
15 | wheelrr_object: PointerProperty(name="RR Wheel", type=bpy.types.Object)
16 | wheelstaticfl_object: PointerProperty(name="FL Static", type=bpy.types.Object)
17 | wheelstaticfr_object: PointerProperty(name="FR Static", type=bpy.types.Object)
18 | wheelstaticrl_object: PointerProperty(name="RL Static", type=bpy.types.Object)
19 | wheelstaticrr_object: PointerProperty(name="RR Static", type=bpy.types.Object)
20 |
21 | def manual_map():
22 | url_manual_prefix = "https://github.com/abchouhan/acreplay-parser?tab=readme-ov-file#addon"
23 | url_manual_mapping = (("bpy.ops.scene.acreplay_import_json", ""),
24 | ("bpy.ops.scene.acreplay_animate", ""),)
25 | return url_manual_prefix, url_manual_mapping
26 |
27 | modules = (operators, panel)
28 |
29 |
30 | def register():
31 | bpy.utils.register_class(ACReplayImporterProperties)
32 | bpy.types.Scene.acreplay_importer_props = bpy.props.PointerProperty(type=ACReplayImporterProperties)
33 | for m in modules:
34 | m.register()
35 | bpy.utils.register_manual_map(manual_map)
36 |
37 | def unregister():
38 | bpy.utils.unregister_manual_map(manual_map)
39 | for m in modules:
40 | m.unregister()
41 | del bpy.types.Scene.acreplay_importer_props
42 | bpy.utils.unregister_class(ACReplayImporterProperties)
43 |
44 |
45 | if __name__ == "__main__":
46 | register()
47 |
--------------------------------------------------------------------------------
/Replay Blender Importer/acrp_import.py:
--------------------------------------------------------------------------------
1 | import os
2 | import bpy
3 | from math import pi
4 | from mathutils import Quaternion
5 | import numpy as np
6 |
7 |
8 | use_slots = (4, 4, 0) <= bpy.app.version
9 |
10 |
11 | class custom_property:
12 | def __init__(self, name, subtype, default, limits, interpolation, func, desc=None):
13 | self.name = name
14 | self.subtype = subtype
15 | self.default = default
16 | self.limits = limits
17 | self.interpolation = interpolation
18 | self.func = func
19 | self.desc= desc
20 | def assign(self, ui_prop):
21 | if type(self.default) is bool:
22 | ui_prop.update(
23 | subtype=self.subtype,
24 | default=self.default,
25 | description=self.desc)
26 | else:
27 | ui_prop.update(
28 | subtype=self.subtype,
29 | default=self.default,
30 | min=self.limits[0],
31 | max=self.limits[1],
32 | description=self.desc)
33 |
34 |
35 | legacy_properties = [
36 | custom_property("speedX", "NONE", 0.0, (-10000.0, 10000.0), "LINEAR", lambda x: x),
37 | custom_property("speedY", "NONE", 0.0, (-10000.0, 10000.0), "LINEAR", lambda x: x),
38 | custom_property("headlights", "NONE", False, None, "LINEAR", lambda x: x),
39 | custom_property("steering", "ANGLE", 0.0, (-360.0, 360.0), "LINEAR", lambda x: -x*pi/180.0)
40 | ]
41 | chassis_properties = [
42 | custom_property("gas", "PERCENTAGE", 0.0, (0.0, 100.0), "LINEAR", lambda x: x/2.55),
43 | custom_property("brake", "PERCENTAGE", 0.0, (0.0, 100.0), "LINEAR", lambda x: x/2.55),
44 | custom_property("velocity", "VELOCITY", [0.0,0.0,0.0], (-10000.0, 10000.0), "LINEAR", lambda x: x),
45 | custom_property("rpm", "NONE", 0.0, (0.0, 10000.0), "LINEAR", lambda x: x),
46 | custom_property("steerAngle", "ANGLE", 0.0, (-360.0, 360.0), "LINEAR", lambda x: -x*pi/180.0),
47 | custom_property("gear", "NONE", 0, ( -1, 10000), "CONSTANT", lambda x: x-1, "-1: reverse, 0: neutral, 1: 1st gear, 2: 2nd gear, etc"),
48 | custom_property("boost", "FACTOR", 0.0, (0.0, 1.0), "LINEAR", lambda x: x/255),
49 | custom_property("fuel", "PERCENTAGE", 0.0, (0.0, 100.0), "LINEAR", lambda x: x/2.55),
50 | custom_property("fuelPerLap", "PERCENTAGE", 0.0, (0.0, 100.0), "LINEAR", lambda x: x/2.55, "Amount of fuel predicted to be used, based on average per-lap fuel consumption"),
51 | custom_property("lights", "NONE", False, None, "CONSTANT", lambda x: x, "Whether headlights, taillights, instrument lights, etc. are on"),
52 | custom_property("horn", "NONE", False, None, "CONSTANT", lambda x: x),
53 | custom_property("dirt", "PERCENTAGE", 0.0, (0.0, 100.0), "LINEAR", lambda x: x/2.55, "Amount of dirt on car body"),
54 | custom_property("damageFront", "PERCENTAGE", 0.0, (0.0, 100.0), "LINEAR", lambda x: x/2.55),
55 | custom_property("damageFrontDeformation", "PERCENTAGE", 0.0, (0.0, 100.0), "LINEAR", lambda x: x/2.55, "Hood + bumper damage"),
56 | custom_property("damageRear", "PERCENTAGE", 0.0, (0.0, 100.0), "LINEAR", lambda x: x/2.55),
57 | custom_property("damageLeft", "PERCENTAGE", 0.0, (0.0, 100.0), "LINEAR", lambda x: x/2.55),
58 | custom_property("damageRight", "PERCENTAGE", 0.0, (0.0, 100.0), "LINEAR", lambda x: x/2.55),
59 | custom_property("engineHealth", "PERCENTAGE", 0.0, (0.0, 100.0), "LINEAR", lambda x: x/2.55),
60 | custom_property("gearboxBeingDamaged", "NONE", False, None, "CONSTANT", lambda x: x, "Whether the gearbox is being damaged (e.g. when changing gears without clutch)"),
61 | custom_property("bodyworkNoise", "NONE", 0.0, (0.0, 10000.0), "LINEAR", lambda x: x, "Amount of mechanical noise (in-game audio units) the car is making"),
62 | custom_property("drivetrainSpeed", "NONE", 0.0, (0.0, 10000.0), "LINEAR", lambda x: x),
63 | custom_property("currentLap", "NONE", 1, ( 1, 255), "CONSTANT", lambda x: x),
64 | custom_property("currentLapTime", "TIME_ABSOLUTE", 0.0, (0.0, 10000.0), "LINEAR", lambda x: x/1000.0),
65 | custom_property("lastLapTime", "TIME_ABSOLUTE", 0.0, (0.0, 10000.0), "LINEAR", lambda x: x/1000.0),
66 | custom_property("bestLapTime", "TIME_ABSOLUTE", 0.0, (0.0, 10000.0), "LINEAR", lambda x: x/1000.0),
67 | custom_property("cameraDir", "NONE", 0, ( 0, 3), "CONSTANT", lambda x: x, "Direction the in-game camera is pointing.\n0: forward, 1: left, 2: right, 3: backward")
68 | ]
69 | wheel_properties = [
70 | custom_property("tireDirt", "PERCENTAGE", 0.0, (0.0, 100.0), "LINEAR", lambda x: x, "Amount of dirt on tire"),
71 | custom_property("wheelAngularVelocity", "NONE", 0.0, (-10000.0, 10000.0), "LINEAR", lambda x: x),
72 | custom_property("slipAngle", "NONE", 0.0, (-10000.0, 10000.0), "LINEAR", lambda x: x, "Angle of heading vs. angle of travel.\nAC typically reports this as zero"),
73 | custom_property("slipRatio", "NONE", 0.0, (-10000.0, 10000.0), "LINEAR", lambda x: x, "Actual angular velocity vs. pure rolling angular velocity"),
74 | custom_property("ndSlip", "NONE", 0.0, (-10000.0, 10000.0), "LINEAR", lambda x: x),
75 | custom_property("load", "NONE", 0.0, (-10000.0, 10000.0), "LINEAR", lambda x: x, "Load on wheel in Newtons")
76 | ]
77 | extra_properties = [
78 | custom_property("clutch", "PERCENTAGE", 0.0, (0.0, 100.0), "LINEAR", lambda x: (255-x)/2.55),
79 | custom_property("handbrake", "PERCENTAGE", 0.0, (0.0, 100.0), "LINEAR", lambda x: x/2.55),
80 | custom_property("wipers", "NONE", 0, ( 0, 4), "CONSTANT", lambda x: x, "Front and rear windshield wipers.\n0: off, 1: lowest speed, ..., 4: highest speed"),
81 | custom_property("turnSignals", "NONE", 0, ( 0, 4), "CONSTANT", lambda x: x, "0: off, 1: left, 2: right, 3: only hazards, 4: hazards + extra dashboard hazard light"),
82 | custom_property("highBeams", "NONE", False, None, "CONSTANT", np.vectorize(lambda x: not x), "Whether high-beam lights are on"),
83 | custom_property("extraOptionA", "NONE", False, None, "CONSTANT", lambda x: x),
84 | custom_property("extraOptionB", "NONE", False, None, "CONSTANT", lambda x: x),
85 | custom_property("extraOptionC", "NONE", False, None, "CONSTANT", lambda x: x),
86 | custom_property("extraOptionD", "NONE", False, None, "CONSTANT", lambda x: x),
87 | custom_property("extraOptionE", "NONE", False, None, "CONSTANT", lambda x: x),
88 | custom_property("extraOptionF", "NONE", False, None, "CONSTANT", lambda x: x),
89 | custom_property("extraOptionG", "NONE", False, None, "CONSTANT", lambda x: x),
90 | custom_property("extraOptionH", "NONE", False, None, "CONSTANT", lambda x: x),
91 | custom_property("extraOptionI", "NONE", False, None, "CONSTANT", lambda x: x),
92 | custom_property("extraOptionJ", "NONE", False, None, "CONSTANT", lambda x: x)
93 | ]
94 |
95 |
96 | def keyframe_loc_rot(obj, action, frames, num_frames, loc, rot):
97 | anim_data = obj.animation_data_create()
98 | anim_data.action = action
99 | if use_slots:
100 | slot = action.slots.get("OB"+obj.name)
101 | if slot is None:
102 | slot = action.slots.new(id_type="OBJECT", name=obj.name)
103 | channelbag = action.layers[0].strips[0].channelbag(slot, ensure=True)
104 | transforms_group = channelbag.groups.get("Object Transforms")
105 | if transforms_group is None:
106 | transforms_group = channelbag.groups.new("Object Transforms")
107 | anim_data.action_slot = slot
108 | interpolation_values = np.full(shape=num_frames, fill_value=bpy.types.Keyframe.bl_rna.properties["interpolation"].enum_items["LINEAR"].value)
109 |
110 | # Keyframe translations
111 | for i in range(0, 3):
112 | if use_slots:
113 | fc_loc = channelbag.fcurves.new(data_path="location", index=i)
114 | fc_loc.group = transforms_group
115 | else:
116 | fc_loc = action.fcurves.new(data_path="location", index=i, action_group="Object Transforms")
117 | fc_loc.keyframe_points.add(count=num_frames)
118 | co = np.zeros(num_frames*2)
119 | co[0::2] = frames
120 | co[1::2] = loc[i]
121 | fc_loc.keyframe_points.foreach_set("co", co)
122 | fc_loc.keyframe_points.foreach_set("interpolation", interpolation_values)
123 | fc_loc.update()
124 |
125 | obj.rotation_mode = "QUATERNION"
126 | quat = np.zeros(shape=(num_frames, 4))
127 | x = (1.0, 0.0, 0.0)
128 | y = (0.0, 1.0, 0.0)
129 | z = (0.0, 0.0, 1.0)
130 |
131 | for i in range(0, num_frames):
132 | # Convert YXZ Euler angles (ZXY in Blender) to a quaternion
133 | quat[i][:] = (Quaternion(z, rot[2][i]) @
134 | Quaternion(x, rot[0][i]) @
135 | Quaternion(y, rot[1][i]))[:]
136 | # Negate the quaternion if it results in a smaller delta between frames
137 | # This prevents incorrect interpolation
138 | if i > 0:
139 | diff = np.linalg.norm(quat[i][:]-quat[i-1][:])
140 | negated_diff = np.linalg.norm(-1*quat[i][:]-quat[i-1][:])
141 | if negated_diff < diff:
142 | quat[i][:] *= -1
143 | quat = np.transpose(quat)
144 |
145 | # Keyframe rotations
146 | for i in range(0, 4):
147 | if use_slots:
148 | fc_rot = channelbag.fcurves.new(data_path="rotation_quaternion", index=i)
149 | fc_rot.group = transforms_group
150 | else:
151 | fc_rot = action.fcurves.new(data_path="rotation_quaternion", index=i, action_group="Object Transforms")
152 | fc_rot.keyframe_points.add(count=num_frames)
153 | co = np.zeros(num_frames*2)
154 | co[0::2] = frames
155 | co[1::2] = quat[i]
156 | fc_rot.keyframe_points.foreach_set("co", co)
157 | fc_rot.keyframe_points.foreach_set("interpolation", interpolation_values)
158 | fc_rot.update()
159 |
160 | def keyframe_custom_property(obj, action, frames, num_frames, prop, data):
161 | interpolation_values = np.full(shape=num_frames, fill_value=bpy.types.Keyframe.bl_rna.properties["interpolation"].enum_items[prop.interpolation].value)
162 | if prop.name not in obj:
163 | obj[prop.name] = prop.default
164 | ui_prop = obj.id_properties_ui(prop.name)
165 | prop.assign(ui_prop)
166 |
167 | if len(data) == num_frames:
168 | if use_slots:
169 | slot = action.slots.get("OB"+obj.name)
170 | if slot is None:
171 | slot = action.slots.new(id_type="OBJECT", name=obj.name)
172 | channelbag = action.layers[0].strips[0].channelbag(slot, ensure=True)
173 | custom_props_group = channelbag.groups.get("Custom Properties")
174 | if custom_props_group is None:
175 | custom_props_group = channelbag.groups.new("Custom Properties")
176 | fc = channelbag.fcurves.new(data_path='["' + prop.name + '"]', index=0)
177 | fc.group = custom_props_group
178 | else:
179 | fc = action.fcurves.new(data_path='["' + prop.name + '"]', index=0, action_group="Custom Properties")
180 | fc.keyframe_points.add(count=num_frames)
181 | co = np.zeros(num_frames*2)
182 | co[0::2] = frames
183 | co[1::2] = prop.func(data)
184 | fc.keyframe_points.foreach_set("co", co)
185 | fc.keyframe_points.foreach_set("interpolation", interpolation_values)
186 | fc.update()
187 | elif len(data[0]) == num_frames:
188 | for i in range(0, len(data)):
189 | if use_slots:
190 | slot = action.slots.get("OB"+obj.name)
191 | if slot is None:
192 | slot = action.slots.new(id_type="OBJECT", name=obj.name)
193 | channelbag = action.layers[0].strips[0].channelbag(slot, ensure=True)
194 | custom_props_group = channelbag.groups.get("Custom Properties")
195 | if custom_props_group is None:
196 | custom_props_group = channelbag.groups.new("Custom Properties")
197 | fc = channelbag.fcurves.new(data_path='["' + prop.name + '"]', index=i)
198 | fc.group = custom_props_group
199 | else:
200 | fc = action.fcurves.new(data_path='["' + prop.name + '"]', index=i, action_group="Custom Properties")
201 | fc.keyframe_points.add(count=num_frames)
202 | co = np.zeros(num_frames*2)
203 | co[0::2] = frames
204 | co[1::2] = prop.func(data[i])
205 | fc.keyframe_points.foreach_set("co", co)
206 | fc.keyframe_points.foreach_set("interpolation", interpolation_values)
207 | fc.update()
208 |
209 | def animate(self, acrp_props, data):
210 | # Get first 32 chars of filename as action names are limited to 63 chars
211 | filename = os.path.split(acrp_props.acrjson_filepath)[1][:32]
212 | name_index = 0
213 | if use_slots:
214 | new_filename = filename
215 | while True: # Create a new action with a unique name given the filename
216 | action = bpy.data.actions.get(new_filename)
217 | if action is None:
218 | action = bpy.data.actions.new(new_filename)
219 | layer = action.layers.new("Layer")
220 | strip = layer.strips.new(type="KEYFRAME")
221 | break
222 | else:
223 | name_index += 1
224 | new_filename = filename+"."+str(name_index).zfill(3)
225 | filename = new_filename
226 |
227 | if "x" in data and "y" in data and "z" in data:
228 | # Swap Y and Z axes for Blender, and negate Z axis
229 | loc = [np.array(data.get("x")),
230 | np.negative(data.get("z")),
231 | np.array(data.get("y"))]
232 | else:
233 | self.report({'ERROR'}, ".json file does not contain chassis position data!")
234 | return {'CANCELLED'}
235 |
236 | if "rotX" in data and "rotY" in data and "rotZ" in data:
237 | # Swap Y and Z axes for Blender, and negate X and Y axes
238 | rot = [np.negative(data.get("rotX")),
239 | np.array(data.get("rotZ")),
240 | np.negative(data.get("rotY"))]
241 | else:
242 | self.report({'ERROR'}, ".json file does not contain chassis rotation data!")
243 | return {'CANCELLED'}
244 |
245 | if "wheelX" in data and "wheelY" in data and "wheelZ" in data:
246 | wheel_loc = np.array([np.array(data.get("wheelX")),
247 | np.negative(data.get("wheelZ")),
248 | np.array(data.get("wheelY"))])
249 | else:
250 | self.report({'ERROR'}, ".json file does not contain wheel position data!")
251 | return {'CANCELLED'}
252 |
253 | if "wheelRotX" in data and "wheelRotY" in data and "wheelRotZ" in data:
254 | wheel_rot = np.array([np.negative(data.get("wheelRotX")),
255 | np.array(data.get("wheelRotZ")),
256 | np.negative(data.get("wheelRotY"))])
257 | else:
258 | self.report({'ERROR'}, ".json file does not contain wheel rotation data!")
259 | return {'CANCELLED'}
260 |
261 | containsStaticData = False
262 | if "wheelStaticX" in data and "wheelStaticY" in data and "wheelStaticZ" in data and \
263 | "wheelStaticRotX" in data and "wheelStaticRotY" in data and "wheelStaticRotZ" in data:
264 | containsStaticData = True
265 | wheel_static_loc = np.array([np.array(data.get("wheelStaticX")),
266 | np.negative(data.get("wheelStaticZ")),
267 | np.array(data.get("wheelStaticY"))])
268 |
269 | wheel_static_rot = np.array([np.negative(data.get("wheelStaticRotX")),
270 | np.array(data.get("wheelStaticRotZ")),
271 | np.negative(data.get("wheelStaticRotY"))])
272 |
273 | factor = acrp_props.target_framerate/(1000.0/acrp_props.recording_interval)
274 | frames = [factor*(i+1) for i in range(0, acrp_props.num_frames)]
275 |
276 | if acrp_props.chassis_object:
277 | action = bpy.data.actions.get(filename) if use_slots else bpy.data.actions.new("Chassis Action")
278 | keyframe_loc_rot(acrp_props.chassis_object, action, frames, acrp_props.num_frames, loc, rot)
279 | for prop in legacy_properties:
280 | if prop.name in data:
281 | keyframe_custom_property(acrp_props.chassis_object, action, frames, acrp_props.num_frames, prop, np.array(data.get(prop.name)))
282 | for prop in chassis_properties:
283 | if prop.name in data:
284 | keyframe_custom_property(acrp_props.chassis_object, action, frames, acrp_props.num_frames, prop, np.array(data.get(prop.name)))
285 | elif prop.name == "velocity" and "velocityX" in data and "velocityY" in data and "velocityZ" in data:
286 | velocity = np.array([np.array(data.get("velocityX")),
287 | np.negative(data.get("velocityZ")),
288 | np.array(data.get("velocityY"))])
289 | keyframe_custom_property(acrp_props.chassis_object, action, frames, acrp_props.num_frames, prop, velocity)
290 | for prop in extra_properties:
291 | if prop.name in data:
292 | keyframe_custom_property(acrp_props.chassis_object, action, frames, acrp_props.num_frames, prop, np.array(data.get(prop.name)))
293 | elif prop.name == "highBeams" and "lowBeams" in data:
294 | keyframe_custom_property(acrp_props.chassis_object, action, frames, acrp_props.num_frames, prop, np.array(data.get("lowBeams")))
295 |
296 | wheel_props = []
297 | for prop in wheel_properties:
298 | if prop.name in data:
299 | wheel_props.append((prop, np.array(data.get(prop.name))))
300 |
301 | if acrp_props.wheelfl_object:
302 | action = bpy.data.actions.get(filename) if use_slots else bpy.data.actions.new("FL Wheel Action")
303 | keyframe_loc_rot(acrp_props.wheelfl_object, action, frames, acrp_props.num_frames, wheel_loc[:,0], wheel_rot[:,0])
304 | for prop in wheel_props:
305 | keyframe_custom_property(acrp_props.wheelfl_object, action, frames, acrp_props.num_frames, prop[0], prop[1][0])
306 |
307 | if acrp_props.wheelfr_object:
308 | action = bpy.data.actions.get(filename) if use_slots else bpy.data.actions.new("FR Wheel Action")
309 | keyframe_loc_rot(acrp_props.wheelfr_object, action, frames, acrp_props.num_frames, wheel_loc[:,1], wheel_rot[:,1])
310 | for prop in wheel_props:
311 | keyframe_custom_property(acrp_props.wheelfr_object, action, frames, acrp_props.num_frames, prop[0], prop[1][1])
312 |
313 | if acrp_props.wheelrl_object:
314 | action = bpy.data.actions.get(filename) if use_slots else bpy.data.actions.new("RL Wheel Action")
315 | keyframe_loc_rot(acrp_props.wheelrl_object, action, frames, acrp_props.num_frames, wheel_loc[:,2], wheel_rot[:,2])
316 | for prop in wheel_props:
317 | keyframe_custom_property(acrp_props.wheelrl_object, action, frames, acrp_props.num_frames, prop[0], prop[1][2])
318 |
319 | if acrp_props.wheelrr_object:
320 | action = bpy.data.actions.get(filename) if use_slots else bpy.data.actions.new("RR Wheel Action")
321 | keyframe_loc_rot(acrp_props.wheelrr_object, action, frames, acrp_props.num_frames, wheel_loc[:,3], wheel_rot[:,3])
322 | for prop in wheel_props:
323 | keyframe_custom_property(acrp_props.wheelrr_object, action, frames, acrp_props.num_frames, prop[0], prop[1][3])
324 |
325 | if containsStaticData:
326 | if acrp_props.wheelstaticfl_object:
327 | action = bpy.data.actions.get(filename) if use_slots else bpy.data.actions.new("FL Wheel Static Action")
328 | keyframe_loc_rot(acrp_props.wheelstaticfl_object, action, frames, acrp_props.num_frames, wheel_static_loc[:,0], wheel_static_rot[:,0])
329 | if acrp_props.wheelstaticfr_object:
330 | action = bpy.data.actions.get(filename) if use_slots else bpy.data.actions.new("FR Wheel Static Action")
331 | keyframe_loc_rot(acrp_props.wheelstaticfr_object, action, frames, acrp_props.num_frames, wheel_static_loc[:,1], wheel_static_rot[:,1])
332 | if acrp_props.wheelstaticrl_object:
333 | action = bpy.data.actions.get(filename) if use_slots else bpy.data.actions.new("RL Wheel Static Action")
334 | keyframe_loc_rot(acrp_props.wheelstaticrl_object, action, frames, acrp_props.num_frames, wheel_static_loc[:,2], wheel_static_rot[:,2])
335 | if acrp_props.wheelstaticrr_object:
336 | action = bpy.data.actions.get(filename) if use_slots else bpy.data.actions.new("RR Wheel Static Action")
337 | keyframe_loc_rot(acrp_props.wheelstaticrr_object, action, frames, acrp_props.num_frames, wheel_static_loc[:,3], wheel_static_rot[:,3])
338 |
339 | return {'FINISHED'}
340 |
--------------------------------------------------------------------------------
/Replay Blender Importer/blender_manifest.toml:
--------------------------------------------------------------------------------
1 | schema_version = "1.0.0"
2 |
3 | id = "acreplay_importer"
4 | version = "0.2.1"
5 | name = "AC Replay Importer"
6 | tagline = "Animate your cars using Assetto Corsa replays"
7 | maintainer = "Abhyudaya Chouhan"
8 | type = "add-on"
9 |
10 | # Link to documentation, support, source files, etc
11 | website = "https://github.com/abchouhan/acreplay-parser"
12 |
13 | # Tag list defined by Blender and server, see:
14 | # https://docs.blender.org/manual/en/dev/advanced/extensions/tags.html
15 | tags = ["Animation"]
16 |
17 | blender_version_min = "4.2.0"
18 | # Blender version that the extension does not support, earlier versions are supported.
19 | # blender_version_max = "4.4.0"
20 |
21 | # License conforming to https://spdx.org/licenses/ (use "SPDX: prefix)
22 | # https://docs.blender.org/manual/en/dev/advanced/extensions/licenses.html
23 | license = [
24 | "SPDX:GPL-3.0-or-later",
25 | ]
26 |
27 | [permissions]
28 | files = "Import JSON from disk"
29 |
--------------------------------------------------------------------------------
/Replay Blender Importer/operators.py:
--------------------------------------------------------------------------------
1 | import json
2 | from math import ceil
3 | import bpy
4 | from bpy.types import Operator
5 | from bpy_extras.io_utils import ImportHelper
6 | from bpy.props import StringProperty
7 |
8 | from . import acrp_import
9 |
10 |
11 | class ACRI_OT_import_acrjson(Operator, ImportHelper):
12 | bl_idname = "scene.acreplay_import_json"
13 | bl_label = "Import .json"
14 | bl_description = "Import AC Replay animation data (*.json) that was outputted by AC Replay Parser"
15 |
16 | filename_ext = ".json"
17 |
18 | filter_glob: StringProperty(
19 | default="*.json",
20 | options={'HIDDEN'},
21 | maxlen=255, # Max internal buffer length, longer would be clamped.
22 | )
23 |
24 | def set_path(self, context, path):
25 | context.scene.acreplay_importer_props.acrjson_filepath = path
26 |
27 | def execute(self, context):
28 | self.set_path(context, self.filepath)
29 |
30 | try:
31 | with open(context.scene.acreplay_importer_props.acrjson_filepath, 'r') as f:
32 | first_three_lines = f.readline()+f.readline()+f.readline()[0:-2]+"}"
33 | data = json.loads(first_three_lines)
34 | except:
35 | self.set_path(context, "")
36 | self.report({'ERROR'}, "Invalid .json file!")
37 | return {'CANCELLED'}
38 |
39 | if "numFrames" not in data or "recordingInterval" not in data:
40 | self.set_path(context, "")
41 | self.report({'ERROR'}, "Invalid .json file!")
42 | return {'CANCELLED'}
43 |
44 | frames = data["numFrames"]
45 | hz = data["recordingInterval"]
46 |
47 | context.scene.acreplay_importer_props.num_frames = frames
48 | context.scene.acreplay_importer_props.recording_interval = hz
49 |
50 | return {'FINISHED'}
51 |
52 | class ACRI_OT_animate(Operator):
53 | bl_idname = "scene.acreplay_animate"
54 | bl_label = "Animate"
55 | bl_description = "Apply animation data to selected objects"
56 |
57 | def execute(self, context):
58 | context.window.cursor_set("WAIT")
59 |
60 | props = context.scene.acreplay_importer_props
61 | with open(props.acrjson_filepath, 'r') as f:
62 | data = json.loads(f.read())
63 | status = acrp_import.animate(self, props, data)
64 |
65 | if 'FINISHED' in status:
66 | context.window.cursor_modal_restore()
67 | context.scene.frame_end = ceil(props.target_framerate*props.num_frames*props.recording_interval/1000.0)
68 | return status
69 |
70 |
71 | classes = (ACRI_OT_import_acrjson,ACRI_OT_animate,)
72 | register, unregister = bpy.utils.register_classes_factory(classes)
73 |
74 | if __name__ == "__main__":
75 | register()
76 |
--------------------------------------------------------------------------------
/Replay Blender Importer/panel.py:
--------------------------------------------------------------------------------
1 | import os
2 | import bpy
3 | from bpy.types import Panel
4 |
5 |
6 | class ACRI_PT_panel(Panel):
7 | bl_label = "AC Replay Importer 0.2.1"
8 | bl_space_type = "VIEW_3D"
9 | bl_region_type = "UI"
10 | bl_category = "Animation"
11 | bl_context = "objectmode"
12 |
13 | def draw(self, context):
14 | layout = self.layout
15 | scn = context.scene
16 | props = scn.acreplay_importer_props
17 | acrjson_filepath = props.acrjson_filepath
18 | recording_interval = props.recording_interval
19 |
20 | row = layout.row()
21 | row.operator("scene.acreplay_import_json", text="Import .json", icon="FILE")
22 |
23 | if acrjson_filepath:
24 | row = layout.row()
25 | layout.label(text=os.path.split(acrjson_filepath)[1])
26 | if recording_interval != 0:
27 | layout.label(text=("Frame Rate: " + str((1000.0 / recording_interval))))
28 |
29 | row = layout.row()
30 | layout.prop(props, "target_framerate")
31 | row = layout.row()
32 | layout.prop_search(props, "chassis_object", scn, "objects", text="Chassis", icon="AUTO")
33 | layout.prop_search(props, "wheelfl_object", scn, "objects", text="FL Wheel", icon="DISC")
34 | layout.prop_search(props, "wheelfr_object", scn, "objects", text="FR Wheel", icon="DISC")
35 | layout.prop_search(props, "wheelrl_object", scn, "objects", text="RL Wheel", icon="DISC")
36 | layout.prop_search(props, "wheelrr_object", scn, "objects", text="RR Wheel", icon="DISC")
37 | layout.label(text="For static elements near the wheel that don't rotate (e.g. brake calipers):")
38 | layout.prop_search(props, "wheelstaticfl_object", scn, "objects", text="FL Static")
39 | layout.prop_search(props, "wheelstaticfr_object", scn, "objects", text="FR Static")
40 | layout.prop_search(props, "wheelstaticrl_object", scn, "objects", text="RL Static")
41 | layout.prop_search(props, "wheelstaticrr_object", scn, "objects", text="RR Static")
42 |
43 | if acrjson_filepath:
44 | row = layout.row()
45 | row.operator("scene.acreplay_animate", text="Animate", icon="NONE")
46 |
47 |
48 | classes = (ACRI_PT_panel,)
49 | register, unregister = bpy.utils.register_classes_factory(classes)
50 |
51 | if __name__ == "__main__":
52 | register()
53 |
--------------------------------------------------------------------------------
/Replay Parser/CMakeLists.txt:
--------------------------------------------------------------------------------
1 | cmake_minimum_required(VERSION 3.25)
2 | project(acrp LANGUAGES CXX)
3 |
4 | set(CMAKE_CXX_STANDARD 23)
5 | set(CMAKE_CXX_STANDARD_REQUIRED ON)
6 | set(CMAKE_CXX_EXTENSIONS OFF)
7 |
8 | if (CMAKE_SYSTEM_NAME STREQUAL "Windows") # Link statically if building for Windows
9 | set(ZLIB_USE_STATIC_LIBS ON)
10 | add_link_options(-static)
11 | endif()
12 |
13 | add_link_options(-Wall -pedantic)
14 |
15 | find_package(ZLIB REQUIRED)
16 | include_directories(${ZLIB_INCLUDE_DIRS})
17 |
18 | set(SOURCE_FILES
19 | main.cpp
20 | src/ACReplayParser.cpp
21 | src/UtilsIO.cpp)
22 |
23 | add_executable(${PROJECT_NAME} ${SOURCE_FILES})
24 | target_link_libraries(${PROJECT_NAME} ${ZLIB_LIBRARIES})
25 |
--------------------------------------------------------------------------------
/Replay Parser/TC-mingw.cmake:
--------------------------------------------------------------------------------
1 | # The name of the target operating system
2 | set(CMAKE_SYSTEM_NAME Windows)
3 |
4 | # Which compilers to use for C and C++
5 | set(CMAKE_C_COMPILER x86_64-w64-mingw32-gcc)
6 | set(CMAKE_CXX_COMPILER x86_64-w64-mingw32-g++)
7 |
8 | # Where is the target environment located
9 | set(CMAKE_FIND_ROOT_PATH /usr/x86_64-w64-mingw32)
10 |
11 | # Adjust the default behavior of the FIND_XXX() commands:
12 | # Search programs in the host environment
13 | set(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM NEVER)
14 |
15 | # Search headers and libraries in the target environment
16 | set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY)
17 | set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE ONLY)
18 |
--------------------------------------------------------------------------------
/Replay Parser/include/ACReplayParser.hpp:
--------------------------------------------------------------------------------
1 | #pragma once
2 |
3 | #include "UtilsIO.hpp"
4 | #include "UtilsData.hpp"
5 |
6 | #include
7 | #include
8 | #include
9 | #include
10 | #include
11 | #include
12 | #include
13 |
14 | /**
15 | * Parses and outputs .acreplay files.
16 | */
17 |
18 | // String present at the end of CSP .acreplay file
19 | std::string const POSTFIX_STR = "__AC_SHADERS_PATCH_v1__";
20 | // String present in .acreplay CSP data
21 | std::string const DRIVER_NAME_INI_STR = "DRIVER_NAME=";
22 |
23 | // String present in .acreplay CSP data
24 | std::string const EXT_PERCAR_STR = "EXT_PERCAR";
25 | int const EXT_PERCAR_VERSION_COUNT = 7;
26 | // Number of bytes in one frame of extra car data, given its version
27 | // A value of 0 means it is currently unknown
28 | std::array const EXT_PERCAR_BYTES_PER_FRAME = {
29 | /* Version 1 */ 0,
30 | /* Version 2 */ 0,
31 | /* Version 3 */ 0,
32 | /* Version 4 */ 0,
33 | /* Version 5 */ 0,//104,
34 | /* Version 6 */ 108,
35 | /* Version 7 */ 108
36 | };
37 |
38 | // Header of .acreplay file
39 | struct Header {
40 | uint32_t version;
41 | double recordingInterval;
42 | std::string weather;
43 | std::string track;
44 | std::string trackConfig;
45 | uint32_t numCars;
46 | uint32_t currentRecordingIndex; // Usually same as numFrames
47 | uint32_t numFrames;
48 | uint32_t numTrackObjects;
49 | };
50 | // Header of each car
51 | struct CarHeader {
52 | std::string carID;
53 | std::string driverName;
54 | std::string nationCode;
55 | std::string driverTeam;
56 | std::string carSkinID;
57 | uint32_t numFrames;
58 | uint32_t numWings; // Number of 'wings' used for game aero computations
59 | };
60 | // A frame of car data
61 | struct CarFrame {
62 | vector3 position; // X, Y (up), Z positions for car body
63 | vectorYXZ rotation; // X, Y, Z Euler angle rotations for car body in radians
64 |
65 | // 2-byte padding
66 |
67 | // Positions and rotations for elements near the wheel that don't rotate, e.g. brake calipers
68 | // 0: front left wheel, 1: front right wheel, 2: rear left wheel, 3: rear right wheel
69 | std::array, 4> wheelStaticPosition;
70 | std::array, 4> wheelStaticRotation;
71 | // Actual wheel positions and rotations
72 | std::array, 4> wheelPosition;
73 | std::array, 4> wheelRotation;
74 | vector3 velocity; // In m/s
75 |
76 | std::float16_t rpm; // Engine RPM
77 | std::array wheelAngularVelocity;
78 | std::array slipAngle; // Usually all 0s
79 | std::array slipRatio; // Actual angular velocity vs. pure rolling angular velocity
80 | std::array ndSlip;
81 | std::array load; // Load on each wheel in Newtons
82 | std::float16_t steerAngle; // Steering wheel rotation in degrees
83 | std::float16_t bodyworkNoise; // Amount of mechanical noise (in-game audio units) the car is making
84 | std::float16_t drivetrainSpeed;
85 | // Times in milliseconds
86 | uint32_t currentLapTime;
87 | uint32_t lastLapTime;
88 | uint32_t bestLapTime;
89 |
90 | // 2-byte padding
91 |
92 | uint8_t fuel; // Fuel amount from 0 to 255
93 | uint8_t fuelPerLap; // Amount of fuel from 0 to 255 predicted to be used, based on average per-lap fuel consumption
94 | uint8_t gear; // 0: reverse, 1: neutral, 2: 1st gear, 3: 2nd gear, etc.
95 | std::array tireDirt; // Tire dirt amount from 0 to 255
96 | // Damage to the front of the car from 0 to 255
97 | // Hood + bumper deformation
98 | uint8_t damageFrontDeformation;
99 | uint8_t damageRear; // Damage to the rear of the car from 0 to 255
100 | uint8_t damageLeft; // Damage to the left of the car from 0 to 255
101 | uint8_t damageRight; // Damage to the right of the car from 0 to 255
102 | // Damage to the front of the car from 0 to 255
103 | // Windshield cracks
104 | uint8_t damageFront;
105 | uint8_t gas; // Gas pedal pressed amount from 0 to 255
106 | uint8_t brake; // Brake pedal pressed amount from 0 to 255
107 | uint8_t currentLap; // 0: 1st lap, 1: 2nd lap, etc.
108 | uint8_t unknown; // Usually 0
109 |
110 | uint16_t status; // Represents the following (little endian):
111 | /*
112 | bool : 1;
113 | bool : 1;
114 | bool unknownBool : 1;
115 | bool horn : 1;
116 | unsigned int cameraDir : 2; // Direction the in-game camera is pointing, 0: forward (default), 1: left, 2: right, 3: backward
117 | unsigned int unknown2 : 2;
118 | bool : 1;
119 | bool gearboxBeingDamaged : 1; // Whether the gearbox is being damaged (e.g. when changing gears without clutch)
120 | bool unknownBool2 : 1;
121 | bool unknownBool3 : 1;
122 | bool lights : 1; // Whether headlights, taillights, instrument lights, license plate lights are on
123 | bool : 1;
124 | bool : 1;
125 | bool : 1;
126 | */
127 |
128 | uint16_t unknown2; // Possibly padding
129 |
130 | uint8_t dirt; // Amount of dirt on car body from 0 to 255
131 | uint8_t engineHealth; // Engine health from 0 to 255
132 | uint8_t boost; // Boost (turbo) amount from 0 to 255
133 |
134 | // 1-byte padding
135 | };
136 | // A frame of extra car data (CSP EXT_PERCAR)
137 | struct CarFrameExtra_v6 {
138 | uint32_t i;
139 | std::float16_t h;
140 |
141 | std::float16_t h2;
142 | std::float16_t h3;
143 | std::float16_t h4; // 00ff
144 | float f;
145 |
146 | std::float16_t h5;
147 | std::float16_t h6;
148 | std::float16_t h7;
149 | std::float16_t h8;
150 | std::float16_t h9; // Usually 0
151 |
152 | std::float16_t h10;
153 | std::float16_t h11;
154 | std::float16_t h12; // 00ff
155 | float f2;
156 |
157 | std::float16_t h13;
158 | std::float16_t h14;
159 |
160 | uint32_t i2;
161 | std::float16_t h15;
162 |
163 | std::float16_t h16;
164 | std::float16_t h17;
165 | std::float16_t h18; // 00ff
166 | float f3;
167 |
168 | std::float16_t h19;
169 | std::float16_t h20;
170 |
171 | uint32_t i3;
172 | std::float16_t h21;
173 |
174 | std::float16_t h22;
175 | std::float16_t h23;
176 | std::float16_t h24; // 00ff
177 | float f4;
178 |
179 | std::float16_t h25;
180 | std::float16_t h26;
181 |
182 | uint32_t i4;
183 | uint32_t i5;
184 |
185 | uint8_t b;
186 |
187 | uint8_t wipers; // 0: off, 1: lowest speed, ..., 4: highest speed
188 |
189 | uint16_t status; // Represents the following (little endian):
190 | /*
191 | unsigned int turnSignals : 3; // 0: off, 1: left, 2: right, 3: only hazards, 4: hazards + extra dashboard hazard light
192 | bool lowBeams : 1; // 0: off (high beams), 1: on (low beams)
193 | bool extraOptionA : 1;
194 | bool extraOptionB : 1;
195 | bool extraOptionC : 1;
196 | bool extraOptionD : 1;
197 | bool : 1;
198 | bool unknownBool : 1;
199 | bool extraOptionE : 1;
200 | bool extraOptionF : 1;
201 | bool extraOptionG : 1;
202 | bool extraOptionH : 1;
203 | bool extraOptionI : 1;
204 | bool extraOptionJ : 1;
205 | */
206 |
207 | uint8_t handbrake; // Handbrake amount from 0 to 255
208 | uint8_t b2; // Usually 2
209 |
210 | uint8_t b3;
211 | uint8_t b4;
212 |
213 | std::float16_t h27; // Usually 0
214 |
215 | uint8_t clutch; // Clutch pedal released amount from 0 (pedal pressed) to 255 (pedal released)
216 | uint8_t b5;
217 | uint32_t i6; // Usually 0
218 |
219 | // Sometimes 2A2A2A2A
220 | std::float16_t h28;
221 | std::float16_t h29;
222 | };
223 | struct CarFrameExtra_v7 {
224 | uint32_t i;
225 | std::float16_t h;
226 |
227 | std::float16_t h2;
228 | std::float16_t h3;
229 | std::float16_t h4; // 00ff
230 | float f;
231 |
232 | std::float16_t h5;
233 | std::float16_t h6;
234 | std::float16_t h7;
235 | std::float16_t h8;
236 | std::float16_t h9; // Usually 0
237 |
238 | std::float16_t h10;
239 | std::float16_t h11;
240 | std::float16_t h12; // 00ff
241 | float f2;
242 |
243 | std::float16_t h13;
244 | std::float16_t h14;
245 |
246 | uint32_t i2;
247 | std::float16_t h15;
248 |
249 | std::float16_t h16;
250 | std::float16_t h17;
251 | std::float16_t h18; // 00ff
252 | float f3;
253 |
254 | std::float16_t h19;
255 | std::float16_t h20;
256 |
257 | uint32_t i3;
258 | std::float16_t h21;
259 |
260 | std::float16_t h22;
261 | std::float16_t h23;
262 | std::float16_t h24; // 00ff
263 | float f4;
264 |
265 | std::float16_t h25;
266 | std::float16_t h26;
267 |
268 | uint32_t i4;
269 | uint32_t i5;
270 |
271 | uint16_t status; // Represents the following (little endian):
272 | /*
273 | unsigned int turnSignals : 3; // 0: off, 1: left, 2: right, 3: only hazards, 4: hazards + extra dashboard hazard light
274 | bool lowBeams : 1; // 0: off (high beams), 1: on (low beams)
275 | bool extraOptionA : 1;
276 | bool extraOptionB : 1;
277 | bool extraOptionC : 1;
278 | bool extraOptionD : 1;
279 | bool : 1;
280 | bool unknownBool : 1;
281 | bool extraOptionE : 1;
282 | bool extraOptionF : 1;
283 | bool extraOptionG : 1;
284 | bool extraOptionH : 1;
285 | bool extraOptionI : 1;
286 | bool extraOptionJ : 1;
287 | */
288 |
289 | uint8_t b;
290 |
291 | uint8_t wipers; // 0: off, 1: lowest speed, ..., 4: highest speed
292 |
293 | uint8_t handbrake; // Handbrake amount from 0 to 255
294 | uint8_t b2; // Usually 2
295 |
296 | uint8_t clutch; // Clutch pedal released amount from 0 (pedal pressed) to 255 (pedal released)
297 |
298 | uint8_t b3;
299 | uint8_t b4;
300 |
301 | uint8_t b5; // Usually 1
302 | uint8_t b6; // Likely padding
303 | uint32_t i6; // Usually 0
304 |
305 | // Sometimes 2A2A2A2A
306 | std::float16_t h28;
307 | std::float16_t h39;
308 | };
309 |
310 | /**
311 | * Get offset of the extra Custom Shaders Patch data in the given .acreplay file.
312 | *
313 | * @param inFile file to be read from. Stream position is not modified.
314 | * @return offset of CSP data if found.
315 | */
316 | std::optional getCSPDataOffset(std::ifstream &inFile);
317 |
318 | /**
319 | * Get names of drivers present in the given .acreplay file.
320 | *
321 | * @param inFile file to be read from. Stream position is not modified.
322 | * @param numDrivers number of drivers in the file, same as the number of cars.
323 | * @return vector of names of drivers in the file.
324 | */
325 | std::vector getDriverNames(std::ifstream &inFile, int numDrivers);
326 |
327 | /**
328 | * TODO: Use existing JSON utility
329 | * Parse and ouput given array of CarFrames into outStream in .json format.
330 | *
331 | * @param outStream output stream.
332 | * @param frames CarFrame array.
333 | * @param numFrames number of elements in the given CarFrame array.
334 | */
335 | void outputCarFrames(std::ostream &outStream, CarFrame *frames, uint32_t numFrames);
336 | void outputExtraCarFrames_v6(std::ostream &outStream, CarFrameExtra_v6 *frames, uint32_t numFrames);
337 | void outputExtraCarFrames_v7(std::ostream &outStream, CarFrameExtra_v7 *frames, uint32_t numFrames);
338 |
339 | /**
340 | * TODO: Use existing JSON utility
341 | * Parse and ouput given .acreplay file into a .json file.
342 | *
343 | * @param inPath path to input file.
344 | * @param outPath path to output file.
345 | * @param targetDriverName name of driver whose car data is to be ouputted.
346 | */
347 | void readAndOutput(std::string const inPath, std::string_view const outPath = "", std::string_view const targetDriverName = "");
348 |
--------------------------------------------------------------------------------
/Replay Parser/include/UtilsData.hpp:
--------------------------------------------------------------------------------
1 | #pragma once
2 |
3 | template
4 | struct vector3 {
5 | T x, y, z;
6 | };
7 | template
8 | struct vectorYXZ {
9 | T y, x, z;
10 | };
11 |
--------------------------------------------------------------------------------
/Replay Parser/include/UtilsIO.hpp:
--------------------------------------------------------------------------------
1 | #pragma once
2 |
3 | #include
4 | #include
5 | #include
6 | #include
7 | #include
8 | #include
9 | #include
10 |
11 | /**
12 | * Utility functions for common IO operations.
13 | * Some implementations included due to template use.
14 | */
15 |
16 | /**
17 | * Read and return char * from given stream at its current position.
18 | *
19 | * @param inStream stream to be read from.
20 | * @param size length of char * to be read.
21 | * @return heap-allocated string of chars that was read from inStream.
22 | */
23 | char *readChars(std::istream &inStream, uint32_t size);
24 | /**
25 | * Read and return string from given stream at its current position.
26 | *
27 | * @param inStream stream to be read from.
28 | * @param size length of string to be read.
29 | * @return string that was read from inStream.
30 | */
31 | std::string readString(std::istream &inStream, uint32_t size);
32 |
33 | /**
34 | * Read and output array of type T from given stream at its current position.
35 | *
36 | * @param inStream stream to be read from.
37 | * @param count number of Ts to be read.
38 | * @param out pointer to array of Ts that is to be written to.
39 | */
40 | template
41 | void readValueArray(std::istream &inStream, uint32_t count, T *const out) {
42 | inStream.read(reinterpret_cast(out), count*sizeof(T));
43 | }
44 | /**
45 | * Read and return value of type T from given stream at its current position.
46 | *
47 | * @param inStream stream to be read from.
48 | * @return value of type T that was read from inStream.
49 | */
50 | template
51 | T readValue(std::istream &inStream) {
52 | T var;
53 | inStream.read(reinterpret_cast(&var), sizeof(var));
54 | return var;
55 | }
56 | /**
57 | * Read and return char * value from given stream at its current position.
58 | * Specialized template function that first reads int for char * length and then reads char *.
59 | *
60 | * @param inStream stream to be read from.
61 | * @return char * value that was read from inStream.
62 | */
63 | template <>
64 | char *readValue(std::istream &inStream);
65 | /**
66 | * Read and return string value from given stream at its current position.
67 | * Specialized template function that first reads int for string length and then reads string.
68 | *
69 | * @param inStream stream to be read from.
70 | * @return string value that was read from inStream.
71 | */
72 | template <>
73 | std::string readValue(std::istream &inStream);
74 |
75 | /**
76 | * Determine whether type T is a string/char *, or not.
77 | */
78 | template
79 | struct isStringType {
80 | static bool const value = std::is_same::value || std::is_same::value;
81 | };
82 |
83 | /**
84 | * Read and print value of generic type T from given inStream at its current position.
85 | *
86 | * @param inStream stream to be read from.
87 | * @param prefix string to be prefixed before the target value.
88 | */
89 | template
90 | std::enable_if_t::value, void> printValue(std::istream &inStream, std::string_view prefix) {
91 | T var;
92 | inStream.read(reinterpret_cast(&var), sizeof(var));
93 | std::cout << prefix << var << std::endl;
94 | }
95 | /**
96 | * Read and print string value from given inStream at its current position.
97 | * Overloaded function that first reads int for string length and then reads string.
98 | *
99 | * @param inStream stream to be read from.
100 | * @param prefix string to be prefixed before the target value.
101 | */
102 | template
103 | std::enable_if_t::value, void> printValue(std::istream &inStream, std::string_view prefix) {
104 | uint32_t stringSize;
105 | inStream.read(reinterpret_cast(&stringSize), sizeof(stringSize));
106 | char *chars = readChars(inStream, stringSize);
107 | std::cout << prefix << chars << std::endl;
108 | delete[] chars;
109 | }
110 |
111 | /**
112 | * Return an output stream of a file with the given path.
113 | * If it already exists, make a new file with the same name with an appended "(n)".
114 | *
115 | * @param path path to target file.
116 | * @param extension extension of target file.
117 | * @return output stream to a new file.
118 | */
119 | std::ofstream getOutStreamFromPath(std::string path, std::string_view extension);
120 |
121 | /**
122 | * Overloaded function for base case of outputting vector to file.
123 | * Generally shouldn't be called explicitly.
124 | *
125 | * @param outFile file to write to.
126 | * @param val value to be outputted.
127 | */
128 | template
129 | void outputVectorToFile(std::ofstream &outFile, T val) {
130 | if (!std::is_fundamental::value) return;
131 |
132 | if (typeid(T) == typeid(uint8_t) || typeid(T) == typeid(int8_t)) {
133 | outFile << +val;
134 | } else {
135 | outFile << val;
136 | }
137 | }
138 | /**
139 | * Output given numerical n-dimensional vector (with n > 1) to given outFile with JSON syntax.
140 | *
141 | * @param outFile file to write to.
142 | * @param vec vector to be outputted.
143 | * @param name string to be prefixed before the vec's output value.
144 | */
145 | template
146 | void outputVectorToFile(std::ofstream &outFile, std::vector const &vec, std::string_view name = "", bool endWithComma = true) {
147 | if (!name.empty()) {
148 | outFile << "\"" << name << "\": [";
149 | } else {
150 | outFile << "[";
151 | }
152 | for (unsigned long i = 0; i < vec.size(); i++) {
153 | outputVectorToFile(outFile, vec[i]);
154 | if (i < vec.size()-1) outFile << ", ";
155 | }
156 | outFile << "]";
157 | if (!name.empty()) {
158 | if (endWithComma) outFile << ", ";
159 | outFile << std::endl;
160 | }
161 | }
162 |
163 | template
164 | void outputToFile(std::ostream &outStream, void *offset, size_t stride, size_t count, std::string_view name = "", bool endWithComma = true) {
165 | if (!name.empty()) {
166 | outStream << "\"" << name << "\": [";
167 | } else {
168 | outStream << "[";
169 | }
170 | for (size_t i = 0; i < stride*count; i += stride) {
171 | T value = *(T *)((uint8_t *)(offset)+i);
172 | if (std::isnan(value) || std::isinf(value)) outStream << "0";
173 | else outStream << +value;
174 | if (i+stride < stride*count) outStream << ", ";
175 | }
176 |
177 | outStream << "]";
178 | if (endWithComma) outStream << ", ";
179 | outStream << std::endl;
180 | }
181 |
182 | template
183 | void outputArrayToFile(std::ostream &outStream, void *offset, int elements, size_t interArrayStride, size_t stride, size_t count, std::string_view name = "", bool endWithComma = true) {
184 | if (!name.empty()) {
185 | outStream << "\"" << name << "\": [";
186 | } else {
187 | outStream << "[";
188 | }
189 |
190 | for (int i = 0; i < elements; i++) {
191 | if (i < elements-1) outputToFile(outStream, (uint8_t *)offset+i*interArrayStride, stride, count);
192 | else outputToFile(outStream, (uint8_t *)offset+i*interArrayStride, stride, count, "", false);
193 | }
194 |
195 | outStream << "]";
196 | if (endWithComma) outStream << ", ";
197 | outStream << std::endl;
198 | }
199 |
--------------------------------------------------------------------------------
/Replay Parser/main.cpp:
--------------------------------------------------------------------------------
1 | #include "include/ACReplayParser.hpp"
2 | #include
3 |
4 | int noInputError() {
5 | std::cerr << "An input file is required." << std::endl;
6 | std::cerr << "Use --help for a list of all options." << std::endl;
7 | return EXIT_FAILURE;
8 | }
9 |
10 | int main(int argc, char *argv[]) {
11 | if (argc < 2) {
12 | return noInputError();
13 | }
14 |
15 | std::vector inPaths;
16 | std::string outPath;
17 | std::string targetDriverName;
18 |
19 | for (int i = 1; i < argc; i++) {
20 | if (strcmp(argv[i], "-h") == 0 || strcmp(argv[i], "-help") == 0 || strcmp(argv[i], "--help") == 0) {
21 | std::cout << "Assetto Corsa Replay Parser 0.2.0" << std::endl;
22 | std::cout << "Usage: acrp [OPTIONS] [INPUT FILE(S)]\n\nwith options:" << std::endl;
23 | std::cout << "-o, --output PATH\n\tOutput path with optional file name." << std::endl;
24 | std::cout << "\tDefault is \".json\" in the directory of the executable." << std::endl;
25 | std::cout << "\t is concatenated to the end if all cars are to be parsed.\n" << std::endl;
26 | std::cout << "--driver-name NAME\n\tName of driver whose car is to be parsed." << std::endl;
27 | std::cout << "\tParses all cars if unspecified.\n" << std::endl;
28 | return EXIT_SUCCESS;
29 | } else if (strcmp(argv[i], "-o") == 0 || strcmp(argv[i], "--output") == 0) {
30 | if (i+1 < argc) {
31 | outPath = argv[++i];
32 | } else {
33 | std::cerr << "--output option requires one argument." << std::endl;
34 | return EXIT_FAILURE;
35 | }
36 | } else if (strcmp(argv[i], "--driver-name") == 0) {
37 | if (i+1 < argc) {
38 | targetDriverName = argv[++i];
39 | } else {
40 | std::cerr << "--driver-name option requires one argument." << std::endl;
41 | return EXIT_FAILURE;
42 | }
43 | } else {
44 | inPaths.push_back(argv[i]);
45 | }
46 | }
47 |
48 | if (inPaths.size() < 1) {
49 | return noInputError();
50 | }
51 |
52 | for (size_t i = 0; i < inPaths.size(); i++) {
53 | readAndOutput(inPaths[i], outPath, targetDriverName);
54 | if (i != inPaths.size()-1) {
55 | std::cout << "-----------------------------" << std::endl;
56 | }
57 | }
58 | return EXIT_SUCCESS;
59 | }
60 |
--------------------------------------------------------------------------------
/Replay Parser/src/ACReplayParser.cpp:
--------------------------------------------------------------------------------
1 | #include "../include/ACReplayParser.hpp"
2 |
3 | std::optional getCSPDataOffset(std::ifstream &inFile) {
4 | size_t originalPos = inFile.tellg();
5 |
6 | // Go to the end of the file, search for target footer string
7 | inFile.seekg(-POSTFIX_STR.length()-8, std::ios_base::end);
8 | std::string str = readString(inFile, POSTFIX_STR.length());
9 |
10 | if (str == POSTFIX_STR) {
11 | uint32_t offset = readValue(inFile);
12 | if (readValue(inFile) == 1) { // Version 1
13 | inFile.seekg(originalPos, std::ios_base::beg);
14 | return offset;
15 | }
16 | }
17 | inFile.seekg(originalPos, std::ios_base::beg);
18 | return {};
19 | }
20 |
21 | std::vector getDriverNames(std::ifstream &inFile, uint32_t offset, int numDrivers) {
22 | size_t originalPos = inFile.tellg();
23 | inFile.seekg(offset, std::ios_base::beg);
24 |
25 | std::vector names;
26 | names.reserve(numDrivers);
27 |
28 | // Skip until .ini data located (string length > 255)
29 | while (true) {
30 | uint32_t len = readValue(inFile);
31 | if (len > 255) { break; }
32 | inFile.seekg(len, std::ios_base::cur);
33 | }
34 |
35 | inFile.seekg(-4, std::ios_base::cur);
36 | std::string ini = readValue(inFile);
37 |
38 | // Find and loop through all driver name strings and add each to names vector
39 | int index = 0;
40 | size_t startIndex = ini.find(DRIVER_NAME_INI_STR);
41 | while (startIndex != std::string::npos && index < numDrivers) {
42 | startIndex += DRIVER_NAME_INI_STR.length();
43 | size_t endIndex = ini.find("\n", startIndex);
44 |
45 | // Remove single-quotes from driver name string
46 | std::string name = ini.substr(startIndex, endIndex-startIndex);
47 | if (name[0] == '\'' && name[name.length()-1] == '\'') {
48 | names.push_back((name.substr(1, name.length()-2)));
49 | } else {
50 | names.push_back(name);
51 | }
52 | startIndex = ini.find(DRIVER_NAME_INI_STR, startIndex+1);
53 | index++;
54 | }
55 |
56 | inFile.seekg(originalPos, std::ios_base::beg);
57 | return names;
58 | }
59 |
60 | // TODO: Not ideal to use addresses to iterate over the frames
61 | void outputCarFrames(std::ostream &outStream, CarFrame *frames, uint32_t numFrames) {
62 | unsigned int stride = sizeof(CarFrame);
63 |
64 | outputToFile(outStream, &(frames[0].position.x), stride, numFrames, "x");
65 | outputToFile(outStream, &(frames[0].position.y), stride, numFrames, "y");
66 | outputToFile(outStream, &(frames[0].position.z), stride, numFrames, "z");
67 | outputToFile(outStream, &(frames[0].rotation.x), stride, numFrames, "rotX");
68 | outputToFile(outStream, &(frames[0].rotation.y), stride, numFrames, "rotY");
69 | outputToFile(outStream, &(frames[0].rotation.z), stride, numFrames, "rotZ");
70 |
71 | unsigned int interArrayStride = (std::ptrdiff_t)&(frames[0].wheelStaticPosition[1].x)-(std::ptrdiff_t)&(frames[0].wheelStaticPosition[0].x);
72 | outputArrayToFile(outStream, &(frames[0].wheelStaticPosition[0].x), 4, interArrayStride, stride, numFrames, "wheelStaticX");
73 |
74 | interArrayStride = (std::ptrdiff_t)&(frames[0].wheelStaticPosition[1].y)-(std::ptrdiff_t)&(frames[0].wheelStaticPosition[0].y);
75 | outputArrayToFile(outStream, &(frames[0].wheelStaticPosition[0].y), 4, interArrayStride, stride, numFrames, "wheelStaticY");
76 |
77 | interArrayStride = (std::ptrdiff_t)&(frames[0].wheelStaticPosition[1].z)-(std::ptrdiff_t)&(frames[0].wheelStaticPosition[0].z);
78 | outputArrayToFile(outStream, &(frames[0].wheelStaticPosition[0].z), 4, interArrayStride, stride, numFrames, "wheelStaticZ");
79 |
80 | interArrayStride = (std::ptrdiff_t)&(frames[0].wheelStaticRotation[1].x)-(std::ptrdiff_t)&(frames[0].wheelStaticRotation[0].x);
81 | outputArrayToFile(outStream, &(frames[0].wheelStaticRotation[0].x), 4, interArrayStride, stride, numFrames, "wheelStaticRotX");
82 |
83 | interArrayStride = (std::ptrdiff_t)&(frames[0].wheelStaticRotation[1].y)-(std::ptrdiff_t)&(frames[0].wheelStaticRotation[0].y);
84 | outputArrayToFile(outStream, &(frames[0].wheelStaticRotation[0].y), 4, interArrayStride, stride, numFrames, "wheelStaticRotY");
85 |
86 | interArrayStride = (std::ptrdiff_t)&(frames[0].wheelStaticRotation[1].z)-(std::ptrdiff_t)&(frames[0].wheelStaticRotation[0].z);
87 | outputArrayToFile(outStream, &(frames[0].wheelStaticRotation[0].z), 4, interArrayStride, stride, numFrames, "wheelStaticRotZ");
88 |
89 | interArrayStride = (std::ptrdiff_t)&(frames[0].wheelPosition[1].x)-(std::ptrdiff_t)&(frames[0].wheelPosition[0].x);
90 | outputArrayToFile(outStream, &(frames[0].wheelPosition[0].x), 4, interArrayStride, stride, numFrames, "wheelX");
91 |
92 | interArrayStride = (std::ptrdiff_t)&(frames[0].wheelPosition[1].y)-(std::ptrdiff_t)&(frames[0].wheelPosition[0].y);
93 | outputArrayToFile(outStream, &(frames[0].wheelPosition[0].y), 4, interArrayStride, stride, numFrames, "wheelY");
94 |
95 | interArrayStride = (std::ptrdiff_t)&(frames[0].wheelPosition[1].z)-(std::ptrdiff_t)&(frames[0].wheelPosition[0].z);
96 | outputArrayToFile(outStream, &(frames[0].wheelPosition[0].z), 4, interArrayStride, stride, numFrames, "wheelZ");
97 |
98 | interArrayStride = (std::ptrdiff_t)&(frames[0].wheelRotation[1].x)-(std::ptrdiff_t)&(frames[0].wheelRotation[0].x);
99 | outputArrayToFile(outStream, &(frames[0].wheelRotation[0].x), 4, interArrayStride, stride, numFrames, "wheelRotX");
100 |
101 | interArrayStride = (std::ptrdiff_t)&(frames[0].wheelRotation[1].y)-(std::ptrdiff_t)&(frames[0].wheelRotation[0].y);
102 | outputArrayToFile(outStream, &(frames[0].wheelRotation[0].y), 4, interArrayStride, stride, numFrames, "wheelRotY");
103 |
104 | interArrayStride = (std::ptrdiff_t)&(frames[0].wheelRotation[1].z)-(std::ptrdiff_t)&(frames[0].wheelRotation[0].z);
105 | outputArrayToFile(outStream, &(frames[0].wheelRotation[0].z), 4, interArrayStride, stride, numFrames, "wheelRotZ");
106 |
107 | outputToFile(outStream, &(frames[0].velocity.x), stride, numFrames, "velocityX");
108 | outputToFile(outStream, &(frames[0].velocity.y), stride, numFrames, "velocityY");
109 | outputToFile(outStream, &(frames[0].velocity.z), stride, numFrames, "velocityZ");
110 |
111 | outputToFile(outStream, &(frames[0].rpm), stride, numFrames, "rpm");
112 |
113 | interArrayStride = (std::ptrdiff_t)&(frames[0].wheelAngularVelocity[1])-(std::ptrdiff_t)&(frames[0].wheelAngularVelocity[0]);
114 | outputArrayToFile(outStream, &(frames[0].wheelAngularVelocity[0]), 4, interArrayStride, stride, numFrames, "wheelAngularVelocity");
115 | interArrayStride = (std::ptrdiff_t)&(frames[0].slipAngle[1])-(std::ptrdiff_t)&(frames[0].slipAngle[0]);
116 | outputArrayToFile(outStream, &(frames[0].slipAngle[0]), 4, interArrayStride, stride, numFrames, "slipAngle");
117 | interArrayStride = (std::ptrdiff_t)&(frames[0].slipRatio[1])-(std::ptrdiff_t)&(frames[0].slipRatio[0]);
118 | outputArrayToFile(outStream, &(frames[0].slipRatio[0]), 4, interArrayStride, stride, numFrames, "slipRatio");
119 | interArrayStride = (std::ptrdiff_t)&(frames[0].ndSlip[1])-(std::ptrdiff_t)&(frames[0].ndSlip[0]);
120 | outputArrayToFile(outStream, &(frames[0].ndSlip[0]), 4, interArrayStride, stride, numFrames, "ndSlip");
121 | interArrayStride = (std::ptrdiff_t)&(frames[0].load[1])-(std::ptrdiff_t)&(frames[0].load[0]);
122 | outputArrayToFile(outStream, &(frames[0].load[0]), 4, interArrayStride, stride, numFrames, "load");
123 |
124 | outputToFile(outStream, &(frames[0].steerAngle), stride, numFrames, "steerAngle");
125 | outputToFile(outStream, &(frames[0].bodyworkNoise), stride, numFrames, "bodyworkNoise");
126 | outputToFile(outStream, &(frames[0].drivetrainSpeed), stride, numFrames, "drivetrainSpeed");
127 | outputToFile(outStream, &(frames[0].currentLapTime), stride, numFrames, "currentLapTime");
128 | outputToFile(outStream, &(frames[0].lastLapTime), stride, numFrames, "lastLapTime");
129 | outputToFile(outStream, &(frames[0].bestLapTime), stride, numFrames, "bestLapTime");
130 | outputToFile(outStream, &(frames[0].fuel), stride, numFrames, "fuel");
131 | outputToFile(outStream, &(frames[0].fuelPerLap), stride, numFrames, "fuelPerLap");
132 | outputToFile(outStream, &(frames[0].gear), stride, numFrames, "gear");
133 |
134 | interArrayStride = (std::ptrdiff_t)&(frames[0].tireDirt[1])-(std::ptrdiff_t)&(frames[0].tireDirt[0]);
135 | outputArrayToFile(outStream, &(frames[0].tireDirt[0]), 4, interArrayStride, stride, numFrames, "tireDirt");
136 |
137 | outputToFile(outStream, &(frames[0].damageFrontDeformation), stride, numFrames, "damageFrontDeformation");
138 | outputToFile(outStream, &(frames[0].damageRear), stride, numFrames, "damageRear");
139 | outputToFile(outStream, &(frames[0].damageLeft), stride, numFrames, "damageLeft");
140 | outputToFile(outStream, &(frames[0].damageRight), stride, numFrames, "damageRight");
141 | outputToFile(outStream, &(frames[0].damageFront), stride, numFrames, "damageFront");
142 | outputToFile(outStream, &(frames[0].gas), stride, numFrames, "gas");
143 | outputToFile(outStream, &(frames[0].brake), stride, numFrames, "brake");
144 | outputToFile(outStream, &(frames[0].currentLap), stride, numFrames, "currentLap");
145 |
146 | outStream << "\"horn\": [";
147 | for (int i = 0; i < numFrames; i++) {
148 | outStream << (((frames[i].status >> 3) & 0x1) ? "true" : "false");
149 | if (i < numFrames-1) outStream << ", ";
150 | }
151 | outStream << "],\n\"cameraDir\": [";
152 | for (int i = 0; i < numFrames; i++) {
153 | outStream << +(uint8_t)((frames[i].status >> 4) & 0b0011);
154 | if (i < numFrames-1) outStream << ", ";
155 | }
156 | outStream << "],\n\"gearboxBeingDamaged\": [";
157 | for (int i = 0; i < numFrames; i++) {
158 | outStream << (((frames[i].status >> 9) & 0x1) ? "true" : "false");
159 | if (i < numFrames-1) outStream << ", ";
160 | }
161 | outStream << "],\n\"lights\": [";
162 | for (int i = 0; i < numFrames; i++) {
163 | outStream << (((frames[i].status >> 12) & 0x1) ? "true" : "false");
164 | if (i < numFrames-1) outStream << ", ";
165 | }
166 | outStream << "],\n";
167 |
168 | outputToFile(outStream, &(frames[0].dirt), stride, numFrames, "dirt");
169 | outputToFile(outStream, &(frames[0].engineHealth), stride, numFrames, "engineHealth");
170 | outputToFile(outStream, &(frames[0].boost), stride, numFrames, "boost", false);
171 | }
172 | void outputExtraCarFrames_v6(std::ostream &outStream, CarFrameExtra_v6 *frames, uint32_t numFrames) {
173 | unsigned int stride = sizeof(CarFrameExtra_v6);
174 |
175 | outputToFile(outStream, &(frames[0].wipers), stride, numFrames, "wipers");
176 | outStream << "\"turnSignals\": [";
177 | for (int i = 0; i < numFrames; i++) {
178 | outStream << +(uint8_t)(frames[i].status & 0b0111);
179 | if (i < numFrames-1) outStream << ", ";
180 | }
181 | outStream << "],\n\"lowBeams\": [";
182 | for (int i = 0; i < numFrames; i++) {
183 | outStream << (((frames[i].status >> 3) & 0x1) ? "true" : "false");
184 | if (i < numFrames-1) outStream << ", ";
185 | }
186 | outStream << "],\n\"extraOptionA\": [";
187 | for (int i = 0; i < numFrames; i++) {
188 | outStream << (((frames[i].status >> 4) & 0x1) ? "true" : "false");
189 | if (i < numFrames-1) outStream << ", ";
190 | }
191 | outStream << "],\n\"extraOptionB\": [";
192 | for (int i = 0; i < numFrames; i++) {
193 | outStream << (((frames[i].status >> 5) & 0x1) ? "true" : "false");
194 | if (i < numFrames-1) outStream << ", ";
195 | }
196 | outStream << "],\n\"extraOptionC\": [";
197 | for (int i = 0; i < numFrames; i++) {
198 | outStream << (((frames[i].status >> 6) & 0x1) ? "true" : "false");
199 | if (i < numFrames-1) outStream << ", ";
200 | }
201 | outStream << "],\n\"extraOptionD\": [";
202 | for (int i = 0; i < numFrames; i++) {
203 | outStream << (((frames[i].status >> 7) & 0x1) ? "true" : "false");
204 | if (i < numFrames-1) outStream << ", ";
205 | }
206 | outStream << "],\n\"extraOptionE\": [";
207 | for (int i = 0; i < numFrames; i++) {
208 | outStream << (((frames[i].status >> 10) & 0x1) ? "true" : "false");
209 | if (i < numFrames-1) outStream << ", ";
210 | }
211 | outStream << "],\n\"extraOptionF\": [";
212 | for (int i = 0; i < numFrames; i++) {
213 | outStream << (((frames[i].status >> 11) & 0x1) ? "true" : "false");
214 | if (i < numFrames-1) outStream << ", ";
215 | }
216 | outStream << "],\n\"extraOptionG\": [";
217 | for (int i = 0; i < numFrames; i++) {
218 | outStream << (((frames[i].status >> 12) & 0x1) ? "true" : "false");
219 | if (i < numFrames-1) outStream << ", ";
220 | }
221 | outStream << "],\n\"extraOptionH\": [";
222 | for (int i = 0; i < numFrames; i++) {
223 | outStream << (((frames[i].status >> 13) & 0x1) ? "true" : "false");
224 | if (i < numFrames-1) outStream << ", ";
225 | }
226 | outStream << "],\n\"extraOptionI\": [";
227 | for (int i = 0; i < numFrames; i++) {
228 | outStream << (((frames[i].status >> 14) & 0x1) ? "true" : "false");
229 | if (i < numFrames-1) outStream << ", ";
230 | }
231 | outStream << "],\n\"extraOptionJ\": [";
232 | for (int i = 0; i < numFrames; i++) {
233 | outStream << (((frames[i].status >> 15) & 0x1) ? "true" : "false");
234 | if (i < numFrames-1) outStream << ", ";
235 | }
236 | outStream << "],\n";
237 | outputToFile(outStream, &(frames[0].handbrake), stride, numFrames, "handbrake");
238 | outputToFile(outStream, &(frames[0].clutch), stride, numFrames, "clutch", false);
239 | }
240 | void outputExtraCarFrames_v7(std::ostream &outStream, CarFrameExtra_v7 *frames, uint32_t numFrames) {
241 | // Need to compute size of CarFrame manually due to use of bit-fields
242 | unsigned int stride = (std::ptrdiff_t)&(frames[1])-(std::ptrdiff_t)&(frames[0]);
243 |
244 | outputToFile(outStream, &(frames[0].wipers), stride, numFrames, "wipers");
245 | outStream << "\"turnSignals\": [";
246 | for (int i = 0; i < numFrames; i++) {
247 | outStream << +(uint8_t)(frames[i].status & 0b0111);
248 | if (i < numFrames-1) outStream << ", ";
249 | }
250 | outStream << "],\n\"lowBeams\": [";
251 | for (int i = 0; i < numFrames; i++) {
252 | outStream << (((frames[i].status >> 3) & 0x1) ? "true" : "false");
253 | if (i < numFrames-1) outStream << ", ";
254 | }
255 | outStream << "],\n\"extraOptionA\": [";
256 | for (int i = 0; i < numFrames; i++) {
257 | outStream << (((frames[i].status >> 4) & 0x1) ? "true" : "false");
258 | if (i < numFrames-1) outStream << ", ";
259 | }
260 | outStream << "],\n\"extraOptionB\": [";
261 | for (int i = 0; i < numFrames; i++) {
262 | outStream << (((frames[i].status >> 5) & 0x1) ? "true" : "false");
263 | if (i < numFrames-1) outStream << ", ";
264 | }
265 | outStream << "],\n\"extraOptionC\": [";
266 | for (int i = 0; i < numFrames; i++) {
267 | outStream << (((frames[i].status >> 6) & 0x1) ? "true" : "false");
268 | if (i < numFrames-1) outStream << ", ";
269 | }
270 | outStream << "],\n\"extraOptionD\": [";
271 | for (int i = 0; i < numFrames; i++) {
272 | outStream << (((frames[i].status >> 7) & 0x1) ? "true" : "false");
273 | if (i < numFrames-1) outStream << ", ";
274 | }
275 | outStream << "],\n\"extraOptionE\": [";
276 | for (int i = 0; i < numFrames; i++) {
277 | outStream << (((frames[i].status >> 10) & 0x1) ? "true" : "false");
278 | if (i < numFrames-1) outStream << ", ";
279 | }
280 | outStream << "],\n\"extraOptionF\": [";
281 | for (int i = 0; i < numFrames; i++) {
282 | outStream << (((frames[i].status >> 11) & 0x1) ? "true" : "false");
283 | if (i < numFrames-1) outStream << ", ";
284 | }
285 | outStream << "],\n\"extraOptionG\": [";
286 | for (int i = 0; i < numFrames; i++) {
287 | outStream << (((frames[i].status >> 12) & 0x1) ? "true" : "false");
288 | if (i < numFrames-1) outStream << ", ";
289 | }
290 | outStream << "],\n\"extraOptionH\": [";
291 | for (int i = 0; i < numFrames; i++) {
292 | outStream << (((frames[i].status >> 13) & 0x1) ? "true" : "false");
293 | if (i < numFrames-1) outStream << ", ";
294 | }
295 | outStream << "],\n\"extraOptionI\": [";
296 | for (int i = 0; i < numFrames; i++) {
297 | outStream << (((frames[i].status >> 14) & 0x1) ? "true" : "false");
298 | if (i < numFrames-1) outStream << ", ";
299 | }
300 | outStream << "],\n\"extraOptionJ\": [";
301 | for (int i = 0; i < numFrames; i++) {
302 | outStream << (((frames[i].status >> 15) & 0x1) ? "true" : "false");
303 | if (i < numFrames-1) outStream << ", ";
304 | }
305 | outStream << "],\n";
306 | outputToFile(outStream, &(frames[0].handbrake), stride, numFrames, "handbrake");
307 | outputToFile(outStream, &(frames[0].clutch), stride, numFrames, "clutch", false);
308 | }
309 |
310 | void readAndOutput(std::string const inPath, std::string_view const outPath, std::string_view const targetDriverName) {
311 | std::ifstream inFile(inPath, std::ios::binary);
312 |
313 | if (!inFile) {
314 | std::cerr << "File \'" << inPath << "\' not found!" << std::endl;
315 | return;
316 | } else {
317 | std::cout << inPath << std::endl;
318 | }
319 |
320 | uint32_t version = readValue(inFile);
321 | std::cout << "Version: " << version << std::endl;
322 | if (version != 16) {
323 | std::cerr << "Only version 16 .acreplay files are supported at this time" << std::endl;
324 | return;
325 | }
326 |
327 | // Read file header
328 | Header header = {
329 | .version = version,
330 | .recordingInterval = readValue(inFile),
331 | .weather = readValue(inFile),
332 | .track = readValue(inFile),
333 | .trackConfig = readValue(inFile),
334 | .numCars = readValue(inFile),
335 | .currentRecordingIndex = readValue(inFile),
336 | .numFrames = readValue(inFile),
337 | .numTrackObjects = readValue(inFile),
338 | };
339 |
340 | std::cout << "Recording Interval: " << header.recordingInterval << " ms" << std::endl;
341 | std::cout << "Weather: " << header.weather << std::endl;
342 | std::cout << "Track: " << header.track << std::endl;
343 | std::cout << "Track Config: " << header.trackConfig << std::endl;
344 | std::cout << "Number of Cars: " << header.numCars << std::endl;
345 | std::cout << "Number of Frames: " << header.numFrames << std::endl;
346 |
347 | std::optional cspOffset = getCSPDataOffset(inFile);
348 | if (cspOffset.has_value()) {
349 | // Print all driver names
350 | bool driverFound = false;
351 | std::cout << "Driver Names: " << std::endl;
352 | std::vector names = getDriverNames(inFile, cspOffset.value(), header.numCars);
353 | for (size_t i = 0; i < names.size(); i++) {
354 | if (targetDriverName == names[i]) {
355 | std::cout << "\t" << names[i] << "\t<< SELECTED" << std::endl;
356 | driverFound = true;
357 | } else {
358 | std::cout << "\t" << names[i] << std::endl;
359 | }
360 | }
361 |
362 | if (!driverFound && !targetDriverName.empty()) {
363 | std::cout << "Driver \"" << targetDriverName << "\" was not found!" << std::endl;
364 | return;
365 | }
366 | }
367 |
368 | // Skip sun angles and track object data
369 | inFile.seekg((2 + 2 + 12 * header.numTrackObjects) * header.numFrames, std::ios_base::cur);
370 |
371 | for (int c = 0; c < header.numCars; c++) {
372 | CarHeader carHeader = {
373 | .carID = readValue(inFile),
374 | .driverName = readValue(inFile),
375 | .nationCode = readValue(inFile),
376 | .driverTeam = readValue(inFile),
377 | .carSkinID = readValue(inFile),
378 | .numFrames = readValue(inFile),
379 | .numWings = readValue(inFile)
380 | };
381 |
382 | // If targetIndex is set but it is not the current iteration of the loop,
383 | // then setup inFile stream position to next driver
384 | if (!targetDriverName.empty() && targetDriverName != carHeader.driverName) {
385 | inFile.seekg(20+(255+(21+carHeader.numWings*4))*(carHeader.numFrames-1)
386 | + (255+(5+carHeader.numWings*4)), std::ios_base::cur);
387 | continue;
388 | }
389 |
390 | std::cout << "\nCar ID: " << carHeader.carID << std::endl;
391 | std::cout << "Driver Name: " << carHeader.driverName << std::endl;
392 | std::cout << "Nation Code: " << carHeader.nationCode << std::endl;
393 | std::cout << "Driver Team: " << carHeader.driverTeam << std::endl;
394 | std::cout << "Car Skin ID: " << carHeader.carSkinID << std::endl;
395 |
396 | inFile.seekg(20, std::ios_base::cur);
397 |
398 | CarFrame *frames = new CarFrame[carHeader.numFrames];
399 | for (int i = 0; i < carHeader.numFrames; i++) {
400 | CarFrame frame = readValue(inFile);
401 | frames[i] = frame;
402 | if (i < carHeader.numFrames-1) {
403 | inFile.seekg(20+carHeader.numWings*4, std::ios_base::cur);
404 | } else {
405 | inFile.seekg(4+carHeader.numWings*4, std::ios_base::cur);
406 | }
407 | }
408 |
409 | std::stringstream out;
410 | out << outPath;
411 | // Add input filename to out if not specified
412 | if (outPath.empty() || outPath.find_last_of("/\\") == outPath.length()-1) {
413 | out << inPath.substr(0, inPath.find_last_of('.')).substr(inPath.find_last_of("/\\") + 1);
414 | }
415 | if (targetDriverName.empty()) out << "_" << carHeader.driverName;
416 | out << ".json";
417 |
418 | std::ofstream outFile = getOutStreamFromPath(out.str(), ".json");
419 | outFile << "{" << std::endl;
420 | outFile << "\"numFrames\": " << carHeader.numFrames << "," << std::endl;
421 | outFile << "\"recordingInterval\": " << header.recordingInterval << "," << std::endl;
422 | outputCarFrames(outFile, frames, carHeader.numFrames);
423 | delete[] frames;
424 |
425 | // Read CSP extra car data
426 | if (cspOffset.has_value()) {
427 | size_t originalPos = inFile.tellg();
428 | inFile.seekg(cspOffset.value(), std::ios_base::beg);
429 |
430 | int version = -1;
431 | uint32_t bytesPerFrame = 0;
432 | // Skip until extra car data located
433 | while (true) {
434 | uint32_t len = readValue(inFile);
435 | size_t resetPos = inFile.tellg();
436 | if (readString(inFile, EXT_PERCAR_STR.length()) == EXT_PERCAR_STR) {
437 | inFile.seekg(-EXT_PERCAR_STR.length(), std::ios_base::cur);
438 | std::string tag = readString(inFile, len);
439 | int versionIndex = tag.find("_v")+2;
440 | int separatorIndex = tag.find(":");
441 |
442 | std::string versionStr = tag.substr(versionIndex, separatorIndex-versionIndex);
443 | std::string carIndexStr = tag.substr(separatorIndex+1, len-separatorIndex-1);
444 | try {
445 | version = std::stoi(versionStr);
446 | int carIndex = std::stoi(carIndexStr);
447 | if (version > 0 && version <= EXT_PERCAR_BYTES_PER_FRAME.size()) {
448 | bytesPerFrame = EXT_PERCAR_BYTES_PER_FRAME[version-1];
449 | }
450 | if (c == carIndex) {
451 | if (bytesPerFrame == 0) {
452 | std::cerr << "Unsupported EXT_PERCAR version: " << version << std::endl;
453 | }
454 | break;
455 | }
456 | } catch (...) {
457 | std::cerr << "Malformed data encountered at offset " <<
458 | std::hex << inFile.tellg() << std::dec <<
459 | std::endl;
460 | break;
461 | }
462 | }
463 | inFile.seekg(resetPos+len, std::ios_base::beg);
464 | }
465 |
466 | // If it exists, read and output extra data
467 | if (version >= 0 && version <= EXT_PERCAR_VERSION_COUNT && bytesPerFrame > 0) {
468 | uint32_t compressedSize = readValue(inFile);
469 | uint8_t *compressedData = new uint8_t[compressedSize];
470 | readValueArray(inFile, compressedSize, compressedData);
471 |
472 | unsigned long uncompressedSize = bytesPerFrame*header.numFrames;
473 | uint8_t *uncompressedData = new uint8_t[uncompressedSize];
474 | int status = uncompress(uncompressedData, &uncompressedSize, compressedData, compressedSize);
475 | if (status != Z_OK) {
476 | std::cerr << "Decompression failed with error code " << status << std::endl;
477 | }
478 |
479 | // Read uncompressed data as a stream without copying
480 | std::ispanstream inStreamPerCar(
481 | std::span(reinterpret_cast(uncompressedData), uncompressedSize),
482 | std::ios::binary);
483 |
484 | switch (version) {
485 | default: break;
486 | case 6: {
487 | CarFrameExtra_v6 *extraFrames = new CarFrameExtra_v6[carHeader.numFrames];
488 | readValueArray(inStreamPerCar, carHeader.numFrames, extraFrames);
489 | outFile << ", ";
490 | outputExtraCarFrames_v6(outFile, extraFrames, carHeader.numFrames);
491 | delete[] extraFrames;
492 | break;
493 | }
494 | case 7: {
495 | CarFrameExtra_v7 *extraFrames = new CarFrameExtra_v7[carHeader.numFrames];
496 | readValueArray(inStreamPerCar, carHeader.numFrames, extraFrames);
497 | outFile << ", ";
498 | outputExtraCarFrames_v7(outFile, extraFrames, carHeader.numFrames);
499 | delete[] extraFrames;
500 | break;
501 | }
502 | }
503 | delete[] uncompressedData;
504 | delete[] compressedData;
505 | }
506 | inFile.seekg(originalPos, std::ios_base::beg);
507 | }
508 | outFile << "}" << std::endl;
509 | outFile.close();
510 | std::cout << "Done!" << std::endl;
511 | }
512 | inFile.close();
513 | }
514 |
--------------------------------------------------------------------------------
/Replay Parser/src/UtilsIO.cpp:
--------------------------------------------------------------------------------
1 | #include "../include/UtilsIO.hpp"
2 |
3 | char *readChars(std::istream &inStream, uint32_t size) {
4 | char *ret = new char[size+1];
5 | inStream.read(ret, size);
6 | ret[size] = '\0';
7 | return ret;
8 | }
9 |
10 | std::string readString(std::istream &inStream, uint32_t size) {
11 | char *chars = readChars(inStream, size);
12 | std::string ret = chars;
13 | delete[] chars;
14 | return ret;
15 | }
16 |
17 | template <>
18 | char *readValue(std::istream &inStream) {
19 | uint32_t size;
20 | inStream.read(reinterpret_cast(&size), sizeof(size));
21 | return readChars(inStream, size);
22 | }
23 |
24 | template <>
25 | std::string readValue(std::istream &inStream) {
26 | uint32_t size;
27 | inStream.read(reinterpret_cast(&size), sizeof(size));
28 | return readString(inStream, size);
29 | }
30 |
31 | std::ofstream getOutStreamFromPath(std::string path, std::string_view extension) {
32 | std::ofstream outFile(path, std::ofstream::out|std::ios::in);
33 | std::string newPath = path;
34 |
35 | int i = 2;
36 | while (outFile) {
37 | outFile.close();
38 | std::stringstream outDuplicate;
39 | outDuplicate << path.substr(0, path.length()-extension.length()) << " (" << i << ")" << extension;
40 | newPath = outDuplicate.str();
41 | outFile.open(newPath, std::ofstream::out|std::ios::in);
42 | i++;
43 | }
44 |
45 | outFile.close();
46 | outFile.open(newPath);
47 | return outFile;
48 | }
49 |
--------------------------------------------------------------------------------