yyc12345/libcmo21
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
238 Commits 1 Branch 1 Tag 1.5 MiB
C++ 64.8%
C# 14.6%
Python 10.9%
Java 7.1%
HTML 1.1%
Other 1.3%
512729ed05
Go to file
yyc12345 512729ed05 feat: improve PyBMap 
- re-raise exception for run out of next() function to make end user know this is their fault, not PyBMap.
- write some primitive type getter setter for short code and less latent bugs.
- remove bmfile parameter in BMMeshTrans::Parse.
2024-11-07 20:56:16 +08:00
BMap fix: update YYCC dependency 2024-11-03 19:05:27 +08:00
BMapBindings feat: improve PyBMap 2024-11-07 20:56:16 +08:00
CMake fix: update YYCC dependency 2024-11-03 19:05:27 +08:00
CodeGen feat: update BMapSharp 2024-10-31 17:15:06 +08:00
Documents fix: update YYCC dependency 2024-11-03 19:05:27 +08:00
LibCmo dep: update stb. 2024-11-04 17:19:51 +08:00
Redist ready for first release 2024-01-22 14:57:40 +08:00
Scripts chore: update build script. 2024-11-04 14:58:53 +08:00
Tools ready for first release 2024-01-22 14:57:40 +08:00
Unvirt fix: update YYCC dependency 2024-11-03 19:05:27 +08:00
.gitattributes chore: switch to CMake build system instead of native Visual Studio project 2024-08-15 22:20:51 +08:00
.gitignore chore: switch to CMake build system instead of native Visual Studio project 2024-08-15 22:20:51 +08:00
CMakeLists.txt fix: fix linux build issue 2024-08-27 20:48:27 +08:00
COMPILE.md dep: update stb. 2024-11-04 17:19:51 +08:00
CONTRIBUTING.md finish linux related code writting. remove all offensive content. 2023-03-26 20:32:13 +08:00
LICENSE ready for first release 2024-01-22 14:57:40 +08:00
README.md doc: fix compile manual 2024-10-18 15:04:54 +08:00

README.md

libcmo21

The Library for CMO (also accept NMO, VMO and NMS) File Read/Write. Also the Minimalist Virtools Environment.
Write with one Library and Load Virtools File Everywhere.

Status

This is a long time project.
This project welcome everyone's contribution, except the employee of Dassault, which created Virtools.

Introduction

The aim of this project is creating a universal library which can read / write CMO files or any other Virtools files without any Virtools dependencies.
This project will not link any original Virtools dynamic library. So this project can be ported to any platform if the compiler supports.
This project only involving specific Virtools version, 2.1. Other Virtools versions are not considered by this project.
This project is based on reverse work of CK2.dll, VxMath.dll and CK2_3D.dll. The program unvirt created by Luigi Auriemma, which is licensed by GPL-v2, also help my work.

The difference between this project and other Virtools libraries (e.g. doyaGu/CK2), is that we are not focusing on re-creating the whole Virtools engine. We only focus on the Virtools files RW, and we only just implement a minimalist Virtools environment for achieving this.

Goals

The ultimate goals of this project are:

  • Create a library which can read Virtools file and do not limited on x86 platform by original Virtools implement.
  • Create a universal dynamic library for Ballance Map file loading.
    • Create a Python binding for the loader. And allow user can export Ballance Map from Blender on Linux platform natively.
    • Create a C# binding for the loader to enable that I can load Ballance Map in Godot on Linux / Android platform natively.

There is still a long way to go. But I will try my best.

Project Layout

  • LibCmo: Core library. It is a static library. Link to your program freely because I don't want to process export table things.
  • IronPad: A tiny Crashpad like static library. Used by Unvirt and BMap. Report crash log and coredump only on Windows (Because I assume all Linux users have capacity to enable coredump and deliver it to developer.).
  • Unvirt: Interactive Virtools file viewer. Can provide more detail than Luigi Auriemma's unvirt but only can accept version limited Virtools file (< 4.0 I guess).
  • BMap: A dynamic library which is specific for Ballance Map loading by using LibCmo.

Contributions

However, not all contribution will be accepted. Just like I said, we create Minimalist Virtools Environment. The basic RW functions is enough. We do not accept complex function implementations.
There are 3 lists which indicate our accept guideline.

Wanted Features

These features will be accepted as soon as possible.

  • The bug fix of any existing code.

Not Urgent Features

These features are in plan, but not urge to merge.

  • The CK_ID remap system of Reader.
  • CK3dEntity hierarchy system.
  • Other CK classes implementations.
  • Non-Virtools 2.1 implementations.

Don't Care Features

These features explicitly will not be merged.

  • Run Virtools file.
  • Plugin system.

Compile

See Compile Manual