Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Invert default visibility #347

Merged

Conversation

klingbolt
Copy link
Contributor

@klingbolt klingbolt commented Sep 5, 2024

Changed Default_toggle to hide_category in the proto so the default can be 0. #151

@klingbolt
Copy link
Contributor Author

klingbolt commented Sep 5, 2024

I am still uncertain if hide_category or something like hide_by_default. "Hide_category = true" sounds good to me. I felt like adding the word default is unnecessary. On the other hand, the current behavior of Burrito is to hide all categories by default so we may want to change this behavior in the future.

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Full Diff
--- xml_converter/integration_tests/test_cases/default_toggle/output_proto/markers.bin.textproto._old	2024-09-05 01:20:42.741849646 +0000
+++ xml_converter/integration_tests/test_cases/default_toggle/output_proto/markers.bin.textproto._new	2024-09-05 01:20:42.749849660 +0000
@@ -0,0 +1,50 @@
+category {
+  name: "My Category"
+  icon {
+    map_id: 50
+    position {
+      x: 169.81
+      y: 210.65
+      z: 215.83
+    }
+  }
+  default_visibility: true
+  id: "(\350\314\006\302\223^\226"
+}
+category {
+  name: "My Category 2"
+  icon {
+    map_id: 50
+    position {
+      x: 169.81
+      y: 210.65
+      z: 215.83
+    }
+  }
+  id: "(\355i\3404\0141b"
+}
+category {
+  name: "My Category 3"
+  icon {
+    map_id: 50
+    position {
+      x: 169.81
+      y: 210.65
+      z: 215.83
+    }
+  }
+  default_visibility: true
+  id: "(\355i\3405\0141b"
+}
+category {
+  name: "My Category 4"
+  icon {
+    map_id: 50
+    position {
+      x: 169.81
+      y: 210.65
+      z: 215.83
+    }
+  }
+  id: "(\355i\3406\0141b"
+}

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Full Diff
--- xml_converter/integration_tests/test_cases/proto_hide_category/input/pack/markers.bin.textproto._old	2024-09-05 01:20:42.761849680 +0000
+++ xml_converter/integration_tests/test_cases/proto_hide_category/input/pack/markers.bin.textproto._new	2024-09-05 01:20:42.765849687 +0000
@@ -0,0 +1,50 @@
+category {
+  name: "My Category"
+  icon {
+    map_id: 50
+    position {
+      x: 169.81
+      y: 210.65
+      z: 215.83
+    }
+  }
+  default_visibility: true
+  id: "(\350\314\006\302\223^\226"
+}
+category {
+  name: "My Category 2"
+  icon {
+    map_id: 50
+    position {
+      x: 169.81
+      y: 210.65
+      z: 215.83
+    }
+  }
+  id: "(\355i\3404\0141b"
+}
+category {
+  name: "My Category 3"
+  icon {
+    map_id: 50
+    position {
+      x: 169.81
+      y: 210.65
+      z: 215.83
+    }
+  }
+  default_visibility: true
+  id: "(\355i\3405\0141b"
+}
+category {
+  name: "My Category 4"
+  icon {
+    map_id: 50
+    position {
+      x: 169.81
+      y: 210.65
+      z: 215.83
+    }
+  }
+  id: "(\355i\3406\0141b"
+}

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Full Diff
--- xml_converter/integration_tests/test_cases/proto_hide_category/output_proto/markers.bin.textproto._old	2024-09-05 01:20:42.773849700 +0000
+++ xml_converter/integration_tests/test_cases/proto_hide_category/output_proto/markers.bin.textproto._new	2024-09-05 01:20:42.781849713 +0000
@@ -0,0 +1,50 @@
+category {
+  name: "My Category"
+  icon {
+    map_id: 50
+    position {
+      x: 169.81
+      y: 210.65
+      z: 215.83
+    }
+  }
+  default_visibility: true
+  id: "(\350\314\006\302\223^\226"
+}
+category {
+  name: "My Category 2"
+  icon {
+    map_id: 50
+    position {
+      x: 169.81
+      y: 210.65
+      z: 215.83
+    }
+  }
+  id: "(\355i\3404\0141b"
+}
+category {
+  name: "My Category 3"
+  icon {
+    map_id: 50
+    position {
+      x: 169.81
+      y: 210.65
+      z: 215.83
+    }
+  }
+  default_visibility: true
+  id: "(\355i\3405\0141b"
+}
+category {
+  name: "My Category 4"
+  icon {
+    map_id: 50
+    position {
+      x: 169.81
+      y: 210.65
+      z: 215.83
+    }
+  }
+  id: "(\355i\3406\0141b"
+}

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Full Diff
--- xml_converter/integration_tests/test_cases/proto_hide_category/input/pack/markers.bin.textproto._old	2024-09-05 01:23:50.377220259 +0000
+++ xml_converter/integration_tests/test_cases/proto_hide_category/input/pack/markers.bin.textproto._new	2024-09-05 01:23:50.385220281 +0000
@@ -0,0 +1,50 @@
+category {
+  name: "My Category"
+  icon {
+    map_id: 50
+    position {
+      x: 169.81
+      y: 210.65
+      z: 215.83
+    }
+  }
+  default_visibility: true
+  id: "(\350\314\006\302\223^\226"
+}
+category {
+  name: "My Category 2"
+  icon {
+    map_id: 50
+    position {
+      x: 169.81
+      y: 210.65
+      z: 215.83
+    }
+  }
+  id: "(\355i\3404\0141b"
+}
+category {
+  name: "My Category 3"
+  icon {
+    map_id: 50
+    position {
+      x: 169.81
+      y: 210.65
+      z: 215.83
+    }
+  }
+  default_visibility: true
+  id: "(\355i\3405\0141b"
+}
+category {
+  name: "My Category 4"
+  icon {
+    map_id: 50
+    position {
+      x: 169.81
+      y: 210.65
+      z: 215.83
+    }
+  }
+  id: "(\355i\3406\0141b"
+}

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Full Diff
--- xml_converter/integration_tests/test_cases/proto_hide_category/output_proto/markers.bin.textproto._old	2024-09-05 01:23:50.389220292 +0000
+++ xml_converter/integration_tests/test_cases/proto_hide_category/output_proto/markers.bin.textproto._new	2024-09-05 01:23:50.397220314 +0000
@@ -0,0 +1,50 @@
+category {
+  name: "My Category"
+  icon {
+    map_id: 50
+    position {
+      x: 169.81
+      y: 210.65
+      z: 215.83
+    }
+  }
+  default_visibility: true
+  id: "(\350\314\006\302\223^\226"
+}
+category {
+  name: "My Category 2"
+  icon {
+    map_id: 50
+    position {
+      x: 169.81
+      y: 210.65
+      z: 215.83
+    }
+  }
+  id: "(\355i\3404\0141b"
+}
+category {
+  name: "My Category 3"
+  icon {
+    map_id: 50
+    position {
+      x: 169.81
+      y: 210.65
+      z: 215.83
+    }
+  }
+  default_visibility: true
+  id: "(\355i\3405\0141b"
+}
+category {
+  name: "My Category 4"
+  icon {
+    map_id: 50
+    position {
+      x: 169.81
+      y: 210.65
+      z: 215.83
+    }
+  }
+  id: "(\355i\3406\0141b"
+}

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Full Diff
--- xml_converter/integration_tests/test_cases/xml_default_toggle/output_proto/markers.bin.textproto._old	2024-09-05 01:23:50.405220336 +0000
+++ xml_converter/integration_tests/test_cases/xml_default_toggle/output_proto/markers.bin.textproto._new	2024-09-05 01:23:50.413220357 +0000
@@ -0,0 +1,50 @@
+category {
+  name: "My Category"
+  icon {
+    map_id: 50
+    position {
+      x: 169.81
+      y: 210.65
+      z: 215.83
+    }
+  }
+  default_visibility: true
+  id: "(\350\314\006\302\223^\226"
+}
+category {
+  name: "My Category 2"
+  icon {
+    map_id: 50
+    position {
+      x: 169.81
+      y: 210.65
+      z: 215.83
+    }
+  }
+  id: "(\355i\3404\0141b"
+}
+category {
+  name: "My Category 3"
+  icon {
+    map_id: 50
+    position {
+      x: 169.81
+      y: 210.65
+      z: 215.83
+    }
+  }
+  default_visibility: true
+  id: "(\355i\3405\0141b"
+}
+category {
+  name: "My Category 4"
+  icon {
+    map_id: 50
+    position {
+      x: 169.81
+      y: 210.65
+      z: 215.83
+    }
+  }
+  id: "(\355i\3406\0141b"
+}

@@ -21,7 +21,7 @@ message Category {
repeated Icon icon = 3;
repeated Trail trail = 4;
bool is_separator = 5;
bool default_visibility = 6;
bool hide_category = 6;
Copy link
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What were other names that were considered here and why did you decide on hide_category?
As it is written now this field is Category.hide_category which seems redundant.
Just removing category and making it Category.hide might look like a good idea initially but will it make intuitive sense when combined with the hidden/shown safe file data too?

Copy link
Contributor Author

@klingbolt klingbolt Sep 5, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The other top names I considered were hide_by_default and default_hide_category.
There is another field in the XML called hide that we made trigger.action_hide_category so I used that naming convention. Though on further thought, that field is a Category object and this one is a bool so maybe they don't need to be similar.
I considered using hide but was concerned that it was too similar to the Godot function hide() and that when accessing this field, Category.get_hide() isn't descriptive enough.

Copy link
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

My gut tells me that hide_category is too imperative / verb-ish when it should be more declarative / noun-ish.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I agree

How about is_hidden? This makes it clear its a property not a command. Also fits with some other attributes like is_separator and is_wall.

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Full Diff
--- xml_converter/integration_tests/test_cases/proto_hide_category/input/pack/markers.bin.textproto._old	2024-09-08 00:48:04.767466414 +0000
+++ xml_converter/integration_tests/test_cases/proto_hide_category/input/pack/markers.bin.textproto._new	2024-09-08 00:48:04.775466387 +0000
@@ -0,0 +1,50 @@
+category {
+  name: "My Category"
+  icon {
+    map_id: 50
+    position {
+      x: 169.81
+      y: 210.65
+      z: 215.83
+    }
+  }
+  default_visibility: true
+  id: "(\350\314\006\302\223^\226"
+}
+category {
+  name: "My Category 2"
+  icon {
+    map_id: 50
+    position {
+      x: 169.81
+      y: 210.65
+      z: 215.83
+    }
+  }
+  id: "(\355i\3404\0141b"
+}
+category {
+  name: "My Category 3"
+  icon {
+    map_id: 50
+    position {
+      x: 169.81
+      y: 210.65
+      z: 215.83
+    }
+  }
+  default_visibility: true
+  id: "(\355i\3405\0141b"
+}
+category {
+  name: "My Category 4"
+  icon {
+    map_id: 50
+    position {
+      x: 169.81
+      y: 210.65
+      z: 215.83
+    }
+  }
+  id: "(\355i\3406\0141b"
+}

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Full Diff
--- xml_converter/integration_tests/test_cases/proto_hide_category/output_proto/markers.bin.textproto._old	2024-09-08 00:48:04.795466321 +0000
+++ xml_converter/integration_tests/test_cases/proto_hide_category/output_proto/markers.bin.textproto._new	2024-09-08 00:48:04.803466295 +0000
@@ -0,0 +1,50 @@
+category {
+  name: "My Category"
+  icon {
+    map_id: 50
+    position {
+      x: 169.81
+      y: 210.65
+      z: 215.83
+    }
+  }
+  default_visibility: true
+  id: "(\350\314\006\302\223^\226"
+}
+category {
+  name: "My Category 2"
+  icon {
+    map_id: 50
+    position {
+      x: 169.81
+      y: 210.65
+      z: 215.83
+    }
+  }
+  id: "(\355i\3404\0141b"
+}
+category {
+  name: "My Category 3"
+  icon {
+    map_id: 50
+    position {
+      x: 169.81
+      y: 210.65
+      z: 215.83
+    }
+  }
+  default_visibility: true
+  id: "(\355i\3405\0141b"
+}
+category {
+  name: "My Category 4"
+  icon {
+    map_id: 50
+    position {
+      x: 169.81
+      y: 210.65
+      z: 215.83
+    }
+  }
+  id: "(\355i\3406\0141b"
+}

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Full Diff
--- xml_converter/integration_tests/test_cases/xml_default_toggle/output_proto/markers.bin.textproto._old	2024-09-08 00:48:04.807466282 +0000
+++ xml_converter/integration_tests/test_cases/xml_default_toggle/output_proto/markers.bin.textproto._new	2024-09-08 00:48:04.815466255 +0000
@@ -0,0 +1,50 @@
+category {
+  name: "My Category"
+  icon {
+    map_id: 50
+    position {
+      x: 169.81
+      y: 210.65
+      z: 215.83
+    }
+  }
+  default_visibility: true
+  id: "(\350\314\006\302\223^\226"
+}
+category {
+  name: "My Category 2"
+  icon {
+    map_id: 50
+    position {
+      x: 169.81
+      y: 210.65
+      z: 215.83
+    }
+  }
+  id: "(\355i\3404\0141b"
+}
+category {
+  name: "My Category 3"
+  icon {
+    map_id: 50
+    position {
+      x: 169.81
+      y: 210.65
+      z: 215.83
+    }
+  }
+  default_visibility: true
+  id: "(\355i\3405\0141b"
+}
+category {
+  name: "My Category 4"
+  icon {
+    map_id: 50
+    position {
+      x: 169.81
+      y: 210.65
+      z: 215.83
+    }
+  }
+  id: "(\355i\3406\0141b"
+}

@AsherGlick AsherGlick merged commit 335463d into AsherGlick:xml_converter Sep 8, 2024
7 checks passed
@klingbolt klingbolt deleted the invert_default_visibility branch September 8, 2024 00:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants