fix: add error report for invalid file path when importing or exporting virtools file.

- add error report for invalid file path when importing or exporting virtools to avoid BMapException was thrown. Reported by SongRui

.gitattributes

@@ -1,7 +1,6 @@
-# all png are binary
+# All PNG image are binary
 *.png binary
-# our generated mesh should be save as binary
-*.bin binary
-# the raw json data should be binary
-# although i edit it manually
-bbp_ng/raw_jsons/*.json    binary
+# Element placeholder mesh should be save as binary
+*.ph binary
+# Raw json data should be binary, although i edit it manually
+assets/jsons/*.json    binary

.gitignore

@@ -1,3 +1,3 @@
 ## ===== Personal =====
-# Disable distribution build folder
-redist/
+# Disable VSCode
+.vscode/

assets/jsons/1x1.json5

@@ -84,6 +84,7 @@
         "identifier": "floor_normal_1x1",
         "showcase": {
             "title": "Normal 1x1",
+            "category": "1x1 Blocks",
             "icon": "Normal1x1",
             "type": "floor",
             "cfgs": [
@@ -134,6 +135,7 @@
         "identifier": "floor_sink_1x1",
         "showcase": {
             "title": "Sink 1x1",
+            "category": "1x1 Blocks",
             "icon": "Sink1x1",
             "type": "floor",
             "cfgs": [

assets/jsons/borders.json5

@@ -49,6 +49,7 @@
         "identifier": "floor_normal_border",
         "showcase": {
             "title": "Normal Border",
+            "category": "Borders",
             "icon": "NormalBorder",
             "type": "floor",
             "cfgs": [
@@ -112,6 +113,7 @@
         "identifier": "floor_sink_border",
         "showcase": {
             "title": "Sink Border",
+            "category": "Borders",
             "icon": "SinkBorder",
             "type": "floor",
             "cfgs": [
@@ -175,6 +177,7 @@
         "identifier": "floor_ribbon_border",
         "showcase": {
             "title": "Ribbon Border",
+            "category": "Borders",
             "icon": "RibbonBorder",
             "type": "floor",
             "cfgs": [

assets/jsons/chris_vanilla.json5

@@ -1,4 +1,12 @@
 [
+    // One of Chris suggested more vanilla prototypes.
+    // This prototype represent a half of a normal, sink or double ribbon border,
+    // which looks like trapezoid from top to bottom.
+    // 
+    // The bottom edge of trapezoid is from origin to +X with `long_edge_length` length.
+    // The length of top edge is `short_edge_length` and it just like moving bottom edge to +Y direction.
+    // The offset between top edge and bottom edge is always 2.5.
+    // The distance from the closest point of top edge, to Y axis is `short_edge_offset`.
     {
         "identifier": "cv_trapezoid_side",
         "showcase": null,
@@ -153,6 +161,11 @@
             }
         ]
     },
+    // Same as previous one, but looks like triangle from top to bottom.
+    // 
+    // The bottom edge is from origin to +X with `edge_length` length.
+    // The tip is going to +Y.
+    // The height of this triangle is always 2.5 and the offset between tip and Y axis is `tip_offset`.
     {
         "identifier": "cv_triangle_side",
         "showcase": null,

assets/jsons/corners.json5

@@ -149,6 +149,7 @@
         "identifier": "floor_normal_inner_corner",
         "showcase": {
             "title": "Normal Inner Corner",
+            "category": "Half Block Corners",
             "icon": "NormalInnerCorner",
             "type": "floor",
             "cfgs": [
@@ -201,6 +202,7 @@
         "identifier": "floor_sink_inner_corner",
         "showcase": {
             "title": "Sink Inner Corner",
+            "category": "Half Block Corners",
             "icon": "SinkInnerCorner",
             "type": "floor",
             "cfgs": [
@@ -253,6 +255,7 @@
         "identifier": "floor_ribbon_inner_corner",
         "showcase": {
             "title": "Ribbon Inner Corner",
+            "category": "Half Block Corners",
             "icon": "RibbonInnerCorner",
             "type": "floor",
             "cfgs": [
@@ -305,6 +308,7 @@
         "identifier": "floor_normal_outter_corner",
         "showcase": {
             "title": "Normal Outter Corner",
+            "category": "Half Block Corners",
             "icon": "NormalOutterCorner",
             "type": "floor",
             "cfgs": [
@@ -357,6 +361,7 @@
         "identifier": "floor_sink_outter_corner",
         "showcase": {
             "title": "Sink Outter Corner",
+            "category": "Half Block Corners",
             "icon": "SinkOutterCorner",
             "type": "floor",
             "cfgs": [
@@ -409,6 +414,7 @@
         "identifier": "floor_ribbon_outter_corner",
         "showcase": {
             "title": "Ribbon Outter Corner",
+            "category": "Half Block Corners",
             "icon": "RibbonOutterCorner",
             "type": "floor",
             "cfgs": [

assets/jsons/crossings.json5

@@ -228,6 +228,7 @@
         "identifier": "floor_normal_l_crossing",
         "showcase": {
             "title": "Normal L Crossing",
+            "category": "Floor Crossings",
             "icon": "NormalLCrossing",
             "type": "floor",
             "cfgs": [
@@ -278,6 +279,7 @@
         "identifier": "floor_sink_l_crossing",
         "showcase": {
             "title": "Sink L Crossing",
+            "category": "Floor Crossings",
             "icon": "SinkLCrossing",
             "type": "floor",
             "cfgs": [
@@ -328,6 +330,7 @@
         "identifier": "floor_normal_t_crossing",
         "showcase": {
             "title": "Normal T Crossing",
+            "category": "Floor Crossings",
             "icon": "NormalTCrossing",
             "type": "floor",
             "cfgs": [
@@ -378,6 +381,7 @@
         "identifier": "floor_sink_t_crossing",
         "showcase": {
             "title": "Sink T Crossing",
+            "category": "Floor Crossings",
             "icon": "SinkTCrossing",
             "type": "floor",
             "cfgs": [
@@ -428,6 +432,7 @@
         "identifier": "floor_normal_x_crossing",
         "showcase": {
             "title": "Normal X Crossing",
+            "category": "Floor Crossings",
             "icon": "NormalXCrossing",
             "type": "floor",
             "cfgs": [
@@ -478,6 +483,7 @@
         "identifier": "floor_sink_x_crossing",
         "showcase": {
             "title": "Sink X Crossing",
+            "category": "Floor Crossings",
             "icon": "SinkXCrossing",
             "type": "floor",
             "cfgs": [

assets/jsons/flat.json5

@@ -3,6 +3,7 @@
         "identifier": "floor_flat",
         "showcase": {
             "title": "Flat",
+            "category": "Miscellaneous",
             "icon": "Flat",
             "type": "floor",
             "cfgs": [
@@ -36,7 +37,7 @@
                 },
                 {
                     "field": "is_sink_",
-                    "type": "float",
+                    "type": "bool",
                     "title": "Is Sink",
                     "desc": "Whether this flat floor is used for sink floor.",
                     "default": "False"

assets/jsons/platforms.json5

@@ -116,6 +116,7 @@
         "identifier": "floor_normal_platform",
         "showcase": {
             "title": "Normal Platform",
+            "category": "Platforms",
             "icon": "NormalPlatform",
             "type": "floor",
             "cfgs": [
@@ -191,6 +192,7 @@
         "identifier": "floor_sink_platform",
         "showcase": {
             "title": "Sink Platform",
+            "category": "Platforms",
             "icon": "SinkPlatform",
             "type": "floor",
             "cfgs": [
@@ -266,6 +268,7 @@
         "identifier": "floor_ribbon_platform",
         "showcase": {
             "title": "Ribbon Platform",
+            "category": "Platforms",
             "icon": "RibbonPlatform",
             "type": "floor",
             "cfgs": [

assets/jsons/streets.json5

@@ -3,6 +3,7 @@
         "identifier": "floor_normal_straight",
         "showcase": {
             "title": "Normal Floor",
+            "category": "Floors",
             "icon": "NormalFloor",
             "type": "floor",
             "cfgs": [
@@ -142,6 +143,7 @@
         "identifier": "floor_sink_straight",
         "showcase": {
             "title": "Sink Floor",
+            "category": "Floors",
             "icon": "SinkFloor",
             "type": "floor",
             "cfgs": [

assets/jsons/terminals.json5

@@ -1,4 +1,5 @@
 [
+    // The shared template prototype used by all floor terminals.
     {
         "identifier": "raw_floor_terminal",
         "showcase": null,
@@ -22,26 +23,30 @@
         "faces": [],
         "instances": [
             {
-                "identifier": "cv_triangle_side",
+                "identifier": "cv_trapezoid_side",
                 "skip": "False",
                 "params": {
-                    "edge_length": "2.5",
-                    "tip_offset": "2.5",
+                    "long_edge_length": "5.0",
+                    "short_edge_offset": "2.5",
+                    "short_edge_length": "2.5",
                     "height": "height",
-                    "face": "(face[0], False, False, face[3], face[4], None)",
-                    "is_sink": "is_sink"
+                    "face": "(face[0], False, False, face[3], face[4], False)",
+                    "is_sink": "is_sink",
+                    "is_ribbon": "False"
                 },
                 "transform": "ident()"
             },
             {
-                "identifier": "cv_triangle_side",
+                "identifier": "cv_trapezoid_side",
                 "skip": "False",
                 "params": {
-                    "edge_length": "2.5",
-                    "tip_offset": "2.5",
+                    "long_edge_length": "5.0",
+                    "short_edge_offset": "2.5",
+                    "short_edge_length": "2.5",
                     "height": "height",
-                    "face": "(face[0], False, False, face[3], face[5], None)",
-                    "is_sink": "is_sink"
+                    "face": "(face[0], False, False, face[3], face[5], False)",
+                    "is_sink": "is_sink",
+                    "is_ribbon": "False"
                 },
                 "transform": "move(0, 5, 0) @ scale(1, -1, 1)"
             },
@@ -61,7 +66,7 @@
                 "identifier": "floor_rectangle_bottom",
                 "skip": "not face[1]",
                 "params": {
-                    "length": "2.5",
+                    "length": "5",
                     "width": "5"
                 },
                 "transform": "move(0, 0, -height)"
@@ -72,6 +77,7 @@
         "identifier": "floor_normal_terminal",
         "showcase": {
             "title": "Normal Floor Terminal",
+            "category": "Floors",
             "icon": "NormalFloorTerminal",
             "type": "floor",
             "cfgs": [
@@ -122,6 +128,7 @@
         "identifier": "floor_sink_terminal",
         "showcase": {
             "title": "Sink Floor Terminal",
+            "category": "Floors",
             "icon": "SinkFloorTerminal",
             "type": "floor",
             "cfgs": [

assets/jsons/trafos.json5

@@ -137,6 +137,7 @@
         "identifier": "wood_trafo",
         "showcase": {
             "title": "Wood Trafo",
+            "category": "Trafo",
             "icon": "WoodTrafo",
             "type": "floor",
             "cfgs": [
@@ -187,6 +188,7 @@
         "identifier": "stone_trafo",
         "showcase": {
             "title": "Stone Trafo",
+            "category": "Trafo",
             "icon": "StoneTrafo",
             "type": "floor",
             "cfgs": [
@@ -237,6 +239,7 @@
         "identifier": "paper_trafo",
         "showcase": {
             "title": "Paper Trafo",
+            "category": "Trafo",
             "icon": "PaperTrafo",
             "type": "floor",
             "cfgs": [

assets/jsons/transitions.json5

@@ -111,6 +111,7 @@
         "identifier": "floor_transition",
         "showcase": {
             "title": "Transition",
+            "category": "Miscellaneous",
             "icon": "Transition",
             "type": "floor",
             "cfgs": [
@@ -191,6 +192,7 @@
         "identifier": "floor_narrow_transition",
         "showcase": {
             "title": "Narrow Transition",
+            "category": "Miscellaneous",
             "icon": "NarrowTransition",
             "type": "floor",
             "cfgs": [

assets/jsons/wide_floors.json5

@@ -3,6 +3,7 @@
         "identifier": "floor_wide_straight",
         "showcase": {
             "title": "Wide Floor",
+            "category": "Wide Floors",
             "icon": "WideFloor",
             "type": "floor",
             "cfgs": [
@@ -106,6 +107,7 @@
         "identifier": "floor_wide_terminal",
         "showcase": {
             "title": "Wide Floor Terminal",
+            "category": "Wide Floors",
             "icon": "WideFloorTerminal",
             "type": "floor",
             "cfgs": [
@@ -166,34 +168,50 @@
                 "transform": "rot(0, 0, 90) @ scale(1, -1, 1)"
             },
             {
-                "identifier": "cv_triangle_side",
+                "identifier": "cv_trapezoid_side",
                 "skip": "False",
                 "params": {
-                    "edge_length": "2.5",
-                    "tip_offset": "2.5",
+                    "long_edge_length": "5.0",
+                    "short_edge_offset": "2.5",
+                    "short_edge_length": "2.5",
                     "height": "height",
-                    "face": "(face[0], False, False, face[3], face[4], None)",
-                    "is_sink": "True"
+                    "face": "(face[0], False, False, face[3], face[4], False)",
+                    "is_sink": "True",
+                    "is_ribbon": "False"
                 },
                 "transform": "ident()"
             },
             {
-                "identifier": "cv_triangle_side",
+                "identifier": "cv_trapezoid_side",
                 "skip": "False",
                 "params": {
-                    "edge_length": "2.5",
-                    "tip_offset": "2.5",
+                    "long_edge_length": "5.0",
+                    "short_edge_offset": "2.5",
+                    "short_edge_length": "2.5",
                     "height": "height",
-                    "face": "(face[0], False, False, face[3], face[5], None)",
-                    "is_sink": "True"
+                    "face": "(face[0], False, False, face[3], face[5], False)",
+                    "is_sink": "True",
+                    "is_ribbon": "False"
                 },
                 "transform": "move(0, width + 5, 0) @ scale(1, -1, 1)"
             },
+            {
+                "identifier": "floor_flat",
+                "skip": "False",
+                "params": {
+                    "height": "height",
+                    "length": "2.5",
+                    "width": "width",
+                    "face": "(face[0], False, False, face[3], False, False)",
+                    "is_sink": "True"
+                },
+                "transform": "move(2.5, 2.5, 0)"
+            },
             {
                 "identifier": "floor_rectangle_bottom",
                 "skip": "not face[1]",
                 "params": {
-                    "length": "2.5",
+                    "length": "5",
                     "width": "5 + width"
                 },
                 "transform": "move(0, 0, -height)"
@@ -204,6 +222,7 @@
         "identifier": "floor_wide_l_crossing",
         "showcase": {
             "title": "Wide Floor L Crossing",
+            "category": "Wide Floors",
             "icon": "WideLCrossing",
             "type": "floor",
             "cfgs": [
@@ -336,6 +355,7 @@
         "identifier": "floor_wide_t_crossing",
         "showcase": {
             "title": "Wide Floor T Crossing",
+            "category": "Wide Floors",
             "icon": "WideTCrossing",
             "type": "floor",
             "cfgs": [
@@ -459,6 +479,7 @@
         "identifier": "floor_wide_x_crossing",
         "showcase": {
             "title": "Wide Floor X Crossing",
+            "category": "Wide Floors",
             "icon": "WideXCrossing",
             "type": "floor",
             "cfgs": [