Add missing graphnode setters.

Documentation Updates.
This commit is contained in:
Anilforextra 2021-07-14 15:07:52 +05:45
parent 207fb165bf
commit d9e48a9c58
3 changed files with 160 additions and 9 deletions

View file

@ -33,7 +33,7 @@
<argument index="0" name="idx" type="int"> <argument index="0" name="idx" type="int">
</argument> </argument>
<description> <description>
Returns the color of the input connection [code]idx[/code]. Returns the [Color] of the input connection [code]idx[/code].
</description> </description>
</method> </method>
<method name="get_connection_input_count"> <method name="get_connection_input_count">
@ -67,7 +67,7 @@
<argument index="0" name="idx" type="int"> <argument index="0" name="idx" type="int">
</argument> </argument>
<description> <description>
Returns the color of the output connection [code]idx[/code]. Returns the [Color] of the output connection [code]idx[/code].
</description> </description>
</method> </method>
<method name="get_connection_output_count"> <method name="get_connection_output_count">
@ -101,7 +101,7 @@
<argument index="0" name="idx" type="int"> <argument index="0" name="idx" type="int">
</argument> </argument>
<description> <description>
Returns the color set to [code]idx[/code] left (input) slot. Returns the left (input) [Color] of the slot [code]idx[/code].
</description> </description>
</method> </method>
<method name="get_slot_color_right" qualifiers="const"> <method name="get_slot_color_right" qualifiers="const">
@ -110,7 +110,7 @@
<argument index="0" name="idx" type="int"> <argument index="0" name="idx" type="int">
</argument> </argument>
<description> <description>
Returns the color set to [code]idx[/code] right (output) slot. Returns the right (output) [Color] of the slot [code]idx[/code].
</description> </description>
</method> </method>
<method name="get_slot_type_left" qualifiers="const"> <method name="get_slot_type_left" qualifiers="const">
@ -119,7 +119,7 @@
<argument index="0" name="idx" type="int"> <argument index="0" name="idx" type="int">
</argument> </argument>
<description> <description>
Returns the (integer) type of left (input) [code]idx[/code] slot. Returns the left (input) type of the slot [code]idx[/code].
</description> </description>
</method> </method>
<method name="get_slot_type_right" qualifiers="const"> <method name="get_slot_type_right" qualifiers="const">
@ -128,7 +128,7 @@
<argument index="0" name="idx" type="int"> <argument index="0" name="idx" type="int">
</argument> </argument>
<description> <description>
Returns the (integer) type of right (output) [code]idx[/code] slot. Returns the right (output) type of the slot [code]idx[/code].
</description> </description>
</method> </method>
<method name="is_slot_enabled_left" qualifiers="const"> <method name="is_slot_enabled_left" qualifiers="const">
@ -137,7 +137,7 @@
<argument index="0" name="idx" type="int"> <argument index="0" name="idx" type="int">
</argument> </argument>
<description> <description>
Returns [code]true[/code] if left (input) slot [code]idx[/code] is enabled, [code]false[/code] otherwise. Returns [code]true[/code] if left (input) side of the slot [code]idx[/code] is enabled.
</description> </description>
</method> </method>
<method name="is_slot_enabled_right" qualifiers="const"> <method name="is_slot_enabled_right" qualifiers="const">
@ -146,7 +146,7 @@
<argument index="0" name="idx" type="int"> <argument index="0" name="idx" type="int">
</argument> </argument>
<description> <description>
Returns [code]true[/code] if right (output) slot [code]idx[/code] is enabled, [code]false[/code] otherwise. Returns [code]true[/code] if right (output) side of the slot [code]idx[/code] is enabled.
</description> </description>
</method> </method>
<method name="set_slot"> <method name="set_slot">
@ -177,6 +177,73 @@
[code]color_left[/code]/[code]right[/code] is the tint of the port's icon on this side. [code]color_left[/code]/[code]right[/code] is the tint of the port's icon on this side.
[code]custom_left[/code]/[code]right[/code] is a custom texture for this side's port. [code]custom_left[/code]/[code]right[/code] is a custom texture for this side's port.
[b]Note:[/b] This method only sets properties of the slot. To create the slot, add a [Control]-derived child to the GraphNode. [b]Note:[/b] This method only sets properties of the slot. To create the slot, add a [Control]-derived child to the GraphNode.
Individual properties can be set using one of the [code]set_slot_*[/code] methods. You must enable at least one side of the slot to do so.
</description>
</method>
<method name="set_slot_color_left">
<return type="void">
</return>
<argument index="0" name="idx" type="int">
</argument>
<argument index="1" name="color_left" type="Color">
</argument>
<description>
Sets the [Color] of the left (input) side of the slot [code]idx[/code] to [code]color_left[/code].
</description>
</method>
<method name="set_slot_color_right">
<return type="void">
</return>
<argument index="0" name="idx" type="int">
</argument>
<argument index="1" name="color_right" type="Color">
</argument>
<description>
Sets the [Color] of the right (output) side of the slot [code]idx[/code] to [code]color_right[/code].
</description>
</method>
<method name="set_slot_enabled_left">
<return type="void">
</return>
<argument index="0" name="idx" type="int">
</argument>
<argument index="1" name="enable_left" type="bool">
</argument>
<description>
Toggles the left (input) side of the slot [code]idx[/code]. If [code]enable_left[/code] is [code]true[/code], a port will appear on the left side and the slot will be able to be connected from this side.
</description>
</method>
<method name="set_slot_enabled_right">
<return type="void">
</return>
<argument index="0" name="idx" type="int">
</argument>
<argument index="1" name="enable_right" type="bool">
</argument>
<description>
Toggles the right (output) side of the slot [code]idx[/code]. If [code]enable_right[/code] is [code]true[/code], a port will appear on the right side and the slot will be able to be connected from this side.
</description>
</method>
<method name="set_slot_type_left">
<return type="void">
</return>
<argument index="0" name="idx" type="int">
</argument>
<argument index="1" name="type_left" type="int">
</argument>
<description>
Sets the left (input) type of the slot [code]idx[/code] to [code]type_left[/code].
</description>
</method>
<method name="set_slot_type_right">
<return type="void">
</return>
<argument index="0" name="idx" type="int">
</argument>
<argument index="1" name="type_right" type="int">
</argument>
<description>
Sets the right (output) type of the slot [code]idx[/code] to [code]type_right[/code].
</description> </description>
</method> </method>
</methods> </methods>

View file

@ -389,7 +389,7 @@ void GraphNode::_notification(int p_what) {
} }
void GraphNode::set_slot(int p_idx, bool p_enable_left, int p_type_left, const Color &p_color_left, bool p_enable_right, int p_type_right, const Color &p_color_right, const Ref<Texture> &p_custom_left, const Ref<Texture> &p_custom_right) { void GraphNode::set_slot(int p_idx, bool p_enable_left, int p_type_left, const Color &p_color_left, bool p_enable_right, int p_type_right, const Color &p_color_right, const Ref<Texture> &p_custom_left, const Ref<Texture> &p_custom_right) {
ERR_FAIL_COND(p_idx < 0); ERR_FAIL_COND_MSG(p_idx < 0, vformat("Cannot set slot with p_idx (%d) lesser than zero.", p_idx));
if (!p_enable_left && p_type_left == 0 && p_color_left == Color(1, 1, 1, 1) && !p_enable_right && p_type_right == 0 && p_color_right == Color(1, 1, 1, 1)) { if (!p_enable_left && p_type_left == 0 && p_color_left == Color(1, 1, 1, 1) && !p_enable_right && p_type_right == 0 && p_color_right == Color(1, 1, 1, 1)) {
slot_info.erase(p_idx); slot_info.erase(p_idx);
@ -429,6 +429,26 @@ bool GraphNode::is_slot_enabled_left(int p_idx) const {
return slot_info[p_idx].enable_left; return slot_info[p_idx].enable_left;
} }
void GraphNode::set_slot_enabled_left(int p_idx, bool p_enable_left) {
ERR_FAIL_COND_MSG(p_idx < 0, vformat("Cannot set enable_left for the slot with p_idx (%d) lesser than zero.", p_idx));
slot_info[p_idx].enable_left = p_enable_left;
update();
connpos_dirty = true;
emit_signal("slot_updated", p_idx);
}
void GraphNode::set_slot_type_left(int p_idx, int p_type_left) {
ERR_FAIL_COND_MSG(!slot_info.has(p_idx), vformat("Cannot set type_left for the slot '%d' because it hasn't been enabled.", p_idx));
slot_info[p_idx].type_left = p_type_left;
update();
connpos_dirty = true;
emit_signal("slot_updated", p_idx);
}
int GraphNode::get_slot_type_left(int p_idx) const { int GraphNode::get_slot_type_left(int p_idx) const {
if (!slot_info.has(p_idx)) { if (!slot_info.has(p_idx)) {
return 0; return 0;
@ -436,6 +456,16 @@ int GraphNode::get_slot_type_left(int p_idx) const {
return slot_info[p_idx].type_left; return slot_info[p_idx].type_left;
} }
void GraphNode::set_slot_color_left(int p_idx, const Color &p_color_left) {
ERR_FAIL_COND_MSG(!slot_info.has(p_idx), vformat("Cannot set color_left for the slot '%d' because it hasn't been enabled.", p_idx));
slot_info[p_idx].color_left = p_color_left;
update();
connpos_dirty = true;
emit_signal("slot_updated", p_idx);
}
Color GraphNode::get_slot_color_left(int p_idx) const { Color GraphNode::get_slot_color_left(int p_idx) const {
if (!slot_info.has(p_idx)) { if (!slot_info.has(p_idx)) {
return Color(1, 1, 1, 1); return Color(1, 1, 1, 1);
@ -450,6 +480,26 @@ bool GraphNode::is_slot_enabled_right(int p_idx) const {
return slot_info[p_idx].enable_right; return slot_info[p_idx].enable_right;
} }
void GraphNode::set_slot_enabled_right(int p_idx, bool p_enable_right) {
ERR_FAIL_COND_MSG(p_idx < 0, vformat("Cannot set enable_right for the slot with p_idx (%d) lesser than zero.", p_idx));
slot_info[p_idx].enable_right = p_enable_right;
update();
connpos_dirty = true;
emit_signal("slot_updated", p_idx);
}
void GraphNode::set_slot_type_right(int p_idx, int p_type_right) {
ERR_FAIL_COND_MSG(!slot_info.has(p_idx), vformat("Cannot set type_right for the slot '%d' because it hasn't been enabled.", p_idx));
slot_info[p_idx].type_right = p_type_right;
update();
connpos_dirty = true;
emit_signal("slot_updated", p_idx);
}
int GraphNode::get_slot_type_right(int p_idx) const { int GraphNode::get_slot_type_right(int p_idx) const {
if (!slot_info.has(p_idx)) { if (!slot_info.has(p_idx)) {
return 0; return 0;
@ -457,6 +507,16 @@ int GraphNode::get_slot_type_right(int p_idx) const {
return slot_info[p_idx].type_right; return slot_info[p_idx].type_right;
} }
void GraphNode::set_slot_color_right(int p_idx, const Color &p_color_right) {
ERR_FAIL_COND_MSG(!slot_info.has(p_idx), vformat("Cannot set color_right for the slot '%d' because it hasn't been enabled.", p_idx));
slot_info[p_idx].color_right = p_color_right;
update();
connpos_dirty = true;
emit_signal("slot_updated", p_idx);
}
Color GraphNode::get_slot_color_right(int p_idx) const { Color GraphNode::get_slot_color_right(int p_idx) const {
if (!slot_info.has(p_idx)) { if (!slot_info.has(p_idx)) {
return Color(1, 1, 1, 1); return Color(1, 1, 1, 1);
@ -758,11 +818,23 @@ void GraphNode::_bind_methods() {
ClassDB::bind_method(D_METHOD("set_slot", "idx", "enable_left", "type_left", "color_left", "enable_right", "type_right", "color_right", "custom_left", "custom_right"), &GraphNode::set_slot, DEFVAL(Ref<Texture>()), DEFVAL(Ref<Texture>())); ClassDB::bind_method(D_METHOD("set_slot", "idx", "enable_left", "type_left", "color_left", "enable_right", "type_right", "color_right", "custom_left", "custom_right"), &GraphNode::set_slot, DEFVAL(Ref<Texture>()), DEFVAL(Ref<Texture>()));
ClassDB::bind_method(D_METHOD("clear_slot", "idx"), &GraphNode::clear_slot); ClassDB::bind_method(D_METHOD("clear_slot", "idx"), &GraphNode::clear_slot);
ClassDB::bind_method(D_METHOD("clear_all_slots"), &GraphNode::clear_all_slots); ClassDB::bind_method(D_METHOD("clear_all_slots"), &GraphNode::clear_all_slots);
ClassDB::bind_method(D_METHOD("is_slot_enabled_left", "idx"), &GraphNode::is_slot_enabled_left); ClassDB::bind_method(D_METHOD("is_slot_enabled_left", "idx"), &GraphNode::is_slot_enabled_left);
ClassDB::bind_method(D_METHOD("set_slot_enabled_left", "idx", "enable_left"), &GraphNode::set_slot_enabled_left);
ClassDB::bind_method(D_METHOD("set_slot_type_left", "idx", "type_left"), &GraphNode::set_slot_type_left);
ClassDB::bind_method(D_METHOD("get_slot_type_left", "idx"), &GraphNode::get_slot_type_left); ClassDB::bind_method(D_METHOD("get_slot_type_left", "idx"), &GraphNode::get_slot_type_left);
ClassDB::bind_method(D_METHOD("set_slot_color_left", "idx", "color_left"), &GraphNode::set_slot_color_left);
ClassDB::bind_method(D_METHOD("get_slot_color_left", "idx"), &GraphNode::get_slot_color_left); ClassDB::bind_method(D_METHOD("get_slot_color_left", "idx"), &GraphNode::get_slot_color_left);
ClassDB::bind_method(D_METHOD("is_slot_enabled_right", "idx"), &GraphNode::is_slot_enabled_right); ClassDB::bind_method(D_METHOD("is_slot_enabled_right", "idx"), &GraphNode::is_slot_enabled_right);
ClassDB::bind_method(D_METHOD("set_slot_enabled_right", "idx", "enable_right"), &GraphNode::set_slot_enabled_right);
ClassDB::bind_method(D_METHOD("set_slot_type_right", "idx", "type_right"), &GraphNode::set_slot_type_right);
ClassDB::bind_method(D_METHOD("get_slot_type_right", "idx"), &GraphNode::get_slot_type_right); ClassDB::bind_method(D_METHOD("get_slot_type_right", "idx"), &GraphNode::get_slot_type_right);
ClassDB::bind_method(D_METHOD("set_slot_color_right", "idx", "color_right"), &GraphNode::set_slot_color_right);
ClassDB::bind_method(D_METHOD("get_slot_color_right", "idx"), &GraphNode::get_slot_color_right); ClassDB::bind_method(D_METHOD("get_slot_color_right", "idx"), &GraphNode::get_slot_color_right);
ClassDB::bind_method(D_METHOD("set_offset", "offset"), &GraphNode::set_offset); ClassDB::bind_method(D_METHOD("set_offset", "offset"), &GraphNode::set_offset);

View file

@ -114,11 +114,23 @@ public:
void set_slot(int p_idx, bool p_enable_left, int p_type_left, const Color &p_color_left, bool p_enable_right, int p_type_right, const Color &p_color_right, const Ref<Texture> &p_custom_left = Ref<Texture>(), const Ref<Texture> &p_custom_right = Ref<Texture>()); void set_slot(int p_idx, bool p_enable_left, int p_type_left, const Color &p_color_left, bool p_enable_right, int p_type_right, const Color &p_color_right, const Ref<Texture> &p_custom_left = Ref<Texture>(), const Ref<Texture> &p_custom_right = Ref<Texture>());
void clear_slot(int p_idx); void clear_slot(int p_idx);
void clear_all_slots(); void clear_all_slots();
bool is_slot_enabled_left(int p_idx) const; bool is_slot_enabled_left(int p_idx) const;
void set_slot_enabled_left(int p_idx, bool p_enable_left);
void set_slot_type_left(int p_idx, int p_type_left);
int get_slot_type_left(int p_idx) const; int get_slot_type_left(int p_idx) const;
void set_slot_color_left(int p_idx, const Color &p_color_left);
Color get_slot_color_left(int p_idx) const; Color get_slot_color_left(int p_idx) const;
bool is_slot_enabled_right(int p_idx) const; bool is_slot_enabled_right(int p_idx) const;
void set_slot_enabled_right(int p_idx, bool p_enable_right);
void set_slot_type_right(int p_idx, int p_type_right);
int get_slot_type_right(int p_idx) const; int get_slot_type_right(int p_idx) const;
void set_slot_color_right(int p_idx, const Color &p_color_right);
Color get_slot_color_right(int p_idx) const; Color get_slot_color_right(int p_idx) const;
void set_title(const String &p_title); void set_title(const String &p_title);