feat: update BMapSharp

- finish BMTexture bindings and quater of BMMaterial.
- fix compile manual.

BMapBindings/BMapSharp/BMapSharp/BMapWrapper.cs

@@ -57,8 +57,8 @@ namespace BMapSharp.BMapWrapper {
         internal static void CKFaceIndicesAssigner(IntPtr pstruct, uint count, IEnumerable<CKFaceIndices> iem)
             => StructAssigner<CKFaceIndices>(pstruct, count, iem);
         internal static void CKShortFaceIndicesAssigner(IntPtr pstruct, uint count, IEnumerable<CKShortFaceIndices> iem)
-            => StructAssigner<CKShortFaceIndices>(pstruct, count, iem); // TODO: There is a padding bug!!!
-        
+            => StructAssigner<CKShortFaceIndices>(pstruct, count, iem);
+
         private static IEnumerable<T> StructIterator<T>(IntPtr pstruct, uint count) {
             var stride = Marshal.SizeOf<T>();
             for (uint i = 0; i < count; ++i) {
@@ -73,7 +73,7 @@ namespace BMapSharp.BMapWrapper {
         internal static IEnumerable<CKFaceIndices> CKFaceIndicesIterator(IntPtr pstruct, uint count)
             => StructIterator<CKFaceIndices>(pstruct, count);
         internal static IEnumerable<CKShortFaceIndices> CKShortFaceIndicesIterator(IntPtr pstruct, uint count)
-            => StructIterator<CKShortFaceIndices>(pstruct, count); // TODO: There is a padding bug!!!
+            => StructIterator<CKShortFaceIndices>(pstruct, count);
 
         #endregion
 
@@ -210,10 +210,69 @@ namespace BMapSharp.BMapWrapper {
 
     public class BMTexture : BMObject {
         internal BMTexture(IntPtr raw_pointer, uint ckid) : base(raw_pointer, ckid) { }
+
+        public string GetFileName() {
+            BMapException.ThrowIfFailed(BMap.BMTexture_GetFileName(getPointer(), getCKID(), out string out_filename));
+            return out_filename;
+        }
+
+        public void LoadImage(string filepath) {
+            BMapException.ThrowIfFailed(BMap.BMTexture_LoadImage(getPointer(), getCKID(), filepath));
+        }
+
+        public void SaveImage(string filepath) {
+            BMapException.ThrowIfFailed(BMap.BMTexture_SaveImage(getPointer(), getCKID(), filepath));
+        }
+
+        public CK_TEXTURE_SAVEOPTIONS GetSaveOptions() {
+            BMapException.ThrowIfFailed(BMap.BMTexture_GetSaveOptions(getPointer(), getCKID(), out uint out_saveopt));
+            return (CK_TEXTURE_SAVEOPTIONS)out_saveopt;
+        }
+
+        public void SetSaveOptions(CK_TEXTURE_SAVEOPTIONS opt) {
+            BMapException.ThrowIfFailed(BMap.BMTexture_SetSaveOptions(getPointer(), getCKID(), (uint)opt));
+        }
+
+        public VX_PIXELFORMAT GetVideoFormat() {
+            BMapException.ThrowIfFailed(BMap.BMTexture_GetVideoFormat(getPointer(), getCKID(), out uint out_vfmt));
+            return (VX_PIXELFORMAT)out_vfmt;
+        }
+
+        public void SetVideoFormat(VX_PIXELFORMAT vfmt) {
+            BMapException.ThrowIfFailed(BMap.BMTexture_SetVideoFormat(getPointer(), getCKID(), (uint)vfmt));
+        }
     }
 
     public class BMMaterial : BMObject {
         internal BMMaterial(IntPtr raw_pointer, uint ckid) : base(raw_pointer, ckid) { }
+
+        private delegate bool FctVxColorSetter(IntPtr bmf, uint id, VxColor col);
+        private delegate bool FctVxColorGetter(IntPtr bmf, uint id, out VxColor col);
+        private VxColor getVxColor(FctVxColorGetter fct) {
+            BMapException.ThrowIfFailed(fct(getPointer(), getCKID(), out VxColor out_col));
+            return out_col;
+        }
+        private void setVxColor(FctVxColorSetter fct, VxColor col) {
+            BMapException.ThrowIfFailed(fct(getPointer(), getCKID(), col));
+        }
+
+        public VxColor GetDiffuse() => getVxColor(BMap.BMMaterial_GetDiffuse);
+        public void SetDiffuse(VxColor col) => setVxColor(BMap.BMMaterial_SetDiffuse, col);
+        public VxColor GetAmbient() => getVxColor(BMap.BMMaterial_GetAmbient);
+        public void SetAmbient(VxColor col) => setVxColor(BMap.BMMaterial_SetAmbient, col);
+        public VxColor GetSpecular() => getVxColor(BMap.BMMaterial_GetSpecular);
+        public void SetSpecular(VxColor col) => setVxColor(BMap.BMMaterial_SetSpecular, col);
+        public VxColor GetEmissive() => getVxColor(BMap.BMMaterial_GetEmissive);
+        public void SetEmissive(VxColor col) => setVxColor(BMap.BMMaterial_SetEmissive, col);
+
+        public float GetSpecularPower() {
+            BMapException.ThrowIfFailed(BMap.BMMaterial_GetSpecularPower(getPointer(), getCKID(), out float out_val));
+            return out_val;
+        }
+        public void SetSpecularPower(float val) {
+            BMapException.ThrowIfFailed(BMap.BMMaterial_SetSpecularPower(getPointer(), getCKID(), val));
+        }
+
     }
 
     public class BMMesh : BMObject {

BMapBindings/BMapSharp/BMapSharpTestbench/Program.cs

@@ -31,30 +31,40 @@ namespace BMapSharpTestbench {
                 //     }
                 // }
 
-                Console.WriteLine("===== 3dObjects =====");
-                foreach (var obj in reader.Get3dObjects()) {
-                    Console.WriteLine(obj.GetName());
+                // Console.WriteLine("===== 3dObjects =====");
+                // foreach (var obj in reader.Get3dObjects()) {
+                //     Console.WriteLine(obj.GetName());
 
-                    var current_mesh = obj.GetCurrentMesh();
-                    var mesh_name = current_mesh is null ? "<null>" : current_mesh.GetName();
-                    Console.WriteLine($"\tMesh: {mesh_name}");
-                    Console.WriteLine($"\tVisibility: {obj.GetVisibility()}");
-                    Console.WriteLine($"\tMatrix: {obj.GetWorldMatrix().ToManaged()}");
-                }
+                //     var current_mesh = obj.GetCurrentMesh();
+                //     var mesh_name = current_mesh is null ? "<null>" : current_mesh.GetName();
+                //     Console.WriteLine($"\tMesh: {mesh_name}");
+                //     Console.WriteLine($"\tVisibility: {obj.GetVisibility()}");
+                //     Console.WriteLine($"\tMatrix: {obj.GetWorldMatrix().ToManaged()}");
+                // }
 
                 // Console.WriteLine("===== Meshes =====");
                 // foreach (var mesh in reader.GetMeshes()) {
                 //     Console.WriteLine(mesh.GetName());
                 // }
 
-                // Console.WriteLine("===== Materials =====");
-                // foreach (var mtl in reader.GetMaterials()) {
-                //     Console.WriteLine(mtl.GetName());
-                // }
+                Console.WriteLine("===== Materials =====");
+                foreach (var mtl in reader.GetMaterials()) {
+                    Console.WriteLine(mtl.GetName());
+
+                    Console.WriteLine($"\tDiffuse: {mtl.GetDiffuse().ToManagedRGBA()}");
+                    Console.WriteLine($"\tAmbient: {mtl.GetAmbient().ToManagedRGBA()}");
+                    Console.WriteLine($"\tSpecular: {mtl.GetSpecular().ToManagedRGBA()}");
+                    Console.WriteLine($"\tEmissive: {mtl.GetEmissive().ToManagedRGBA()}");
+                    Console.WriteLine($"\tSpecular Power: {mtl.GetSpecularPower()}");
+                }
 
                 // Console.WriteLine("===== Textures =====");
                 // foreach (var tex in reader.GetTextures()) {
                 //     Console.WriteLine(tex.GetName());
+
+                //     Console.WriteLine($"\tFile Name: {tex.GetFileName()}");
+                //     Console.WriteLine($"\tSave Options: {tex.GetSaveOptions()}");
+                //     Console.WriteLine($"\tVideo Format: {tex.GetVideoFormat()}");
                 // }
 
             }

COMPILE.md

@@ -18,13 +18,18 @@ Since libcmo21 0.2.0, we only provide it in CMake build system. So Windows user
 
 ### YYCCommonplace
 
-You should clone YYCCommonplace and switch to the latest release tag (or specified commit hash provided with libcmo21 release infos if you are building for specific libcmo21 version). Then compile it **in C++ 20 mode** (this is crucial because libcmo21 use C++ 20, and YYCCommonplace's ABI is incompatible between C++ 17 version and C++ 20 version). Finally install it as CMake package.
+You should clone YYCCommonplace and switch to the latest release tag (or specified commit hash provided with libcmo21 release infos if you are building for specific libcmo21 version). When configuring YYCCommonplace, you should notice following infos:
+
+* Please make sure that you have specified C++ 20 explicitly by passing `-DCMAKE_CXX_STANDARD=20` in command line. This is crucial because libcmo21 use C++ 20, and YYCCommonplace's ABI is incompatible between C++ 17 version and C++ 20 version.
+* If you need `BMap` in final libcmo21 built artifacts, and you are in non-Windows system now, please specify position independent code flag by passing `-DCMAKE_POSITION_INDEPENDENT_CODE=True` in command line. GCC and Clang will reject linking if you don't flag it.
+
+After configuring, you can normally build YYCCommonplace like a common CMake project.
 
 Please note if your final program or dynamic library is provided for end user, please choose `RelWithDebInfo` build type (`Release` is not suggested because it will strip all debug infos and it is not good for bug reporter, which is embedded in program, to report crash). If final program is served for programmer debugging, please choose `Debug` build type.
 
 ### stb
 
-You should clone stb repository first. In ideally scenario, we suggest you switch to the latest commit. However, all builds are actually only run on a specific commit hash `5736b15f7ea0ffb08dd38af21067c314d6a3aae9`. So if the latest commit is not work, please switch to this commit hash instead.
+You should clone stb repository first, then switch to a specific commit hash `5736b15f7ea0ffb08dd38af21067c314d6a3aae9`. In ideally scenario, people like to choose the latest commit. However, I hardly update this dependency so the latest commit is not work.
 
 ### zlib
 
@@ -54,7 +59,7 @@ The arguments in command should be replaced by:
 
 The switches in command can be switched as you wish:
 
-* `NEMO_BUILD_UNVIRT`: Build `unvirt`, a command line application debugging Virtools files.
+* `NEMO_BUILD_UNVIRT`: Build `Unvirt`, a command line application debugging Virtools files.
 * `NEMO_BUILD_BMAP`: Build `BMap`, a dynamic library specific used for loading Ballance map file.
 * `NEMO_BUILD_DOC`: Build the document of libcmo21.