Bläddra i källkod

[godot] More in-editor docs.

Mario Zechner 3 år sedan
förälder
incheckning
2ab6f361cb

+ 9 - 0
spine-godot/spine_godot/docs/SpineIkConstraint.xml

@@ -13,26 +13,32 @@
 		<method name="get_bend_direction">
 		<method name="get_bend_direction">
 			<return type="int" />
 			<return type="int" />
 			<description>
 			<description>
+				For two bone IK, controls the bend direction of the IK bones, either 1 or -1.
 			</description>
 			</description>
 		</method>
 		</method>
 		<method name="get_bones">
 		<method name="get_bones">
 			<return type="Array" />
 			<return type="Array" />
 			<description>
 			<description>
+				The bones that will be modified by this IK constraint. Modifying the array has no effect.
 			</description>
 			</description>
 		</method>
 		</method>
 		<method name="get_compress">
 		<method name="get_compress">
 			<return type="bool" />
 			<return type="bool" />
 			<description>
 			<description>
+				For one bone IK, when true and the target is too close, the bone is scaled to reach it.
 			</description>
 			</description>
 		</method>
 		</method>
 		<method name="get_data">
 		<method name="get_data">
 			<return type="SpineIkConstraintData" />
 			<return type="SpineIkConstraintData" />
 			<description>
 			<description>
+				The IK constraint's setup pose data.
 			</description>
 			</description>
 		</method>
 		</method>
 		<method name="get_mix">
 		<method name="get_mix">
 			<return type="float" />
 			<return type="float" />
 			<description>
 			<description>
+				A percentage (0-1) that controls the mix between the constrained and unconstrained rotation.
+				For two bone IK: if the parent bone has local nonuniform scale, the child bone's local Y translation is set to 0.
 			</description>
 			</description>
 		</method>
 		</method>
 		<method name="get_order">
 		<method name="get_order">
@@ -43,16 +49,19 @@
 		<method name="get_softness">
 		<method name="get_softness">
 			<return type="float" />
 			<return type="float" />
 			<description>
 			<description>
+				For two bone IK, the target bone's distance from the maximum reach of the bones where rotation begins to slow. The bones will not straighten completely until the target is this far out of range.
 			</description>
 			</description>
 		</method>
 		</method>
 		<method name="get_stretch">
 		<method name="get_stretch">
 			<return type="bool" />
 			<return type="bool" />
 			<description>
 			<description>
+				When true and the target is out of range, the parent bone is scaled to reach it. For two bone IK: 1) the child bone's local Y translation is set to 0, 2) stretch is not applied if softness is > 0, and 3) if the parent bone has local nonuniform scale, stretch is not applied.
 			</description>
 			</description>
 		</method>
 		</method>
 		<method name="get_target">
 		<method name="get_target">
 			<return type="SpineBone" />
 			<return type="SpineBone" />
 			<description>
 			<description>
+				The bone that is the IK target.
 			</description>
 			</description>
 		</method>
 		</method>
 		<method name="is_active">
 		<method name="is_active">

+ 13 - 0
spine-godot/spine_godot/docs/SpineIkConstraintData.xml

@@ -1,8 +1,11 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <?xml version="1.0" encoding="UTF-8" ?>
 <class name="SpineIkConstraintData" inherits="SpineConstraintData" version="3.4">
 <class name="SpineIkConstraintData" inherits="SpineConstraintData" version="3.4">
 	<brief_description>
 	<brief_description>
+		Stores the setup pose for an [code]SpineIkConstraint[/code].
 	</brief_description>
 	</brief_description>
 	<description>
 	<description>
+		Stores the setup pose for an [code]SpineIkConstraint[/code].
+		See [url]http://esotericsoftware.com/spine-ik-constraints[/url] in the Spine User Guide.
 	</description>
 	</description>
 	<tutorials>
 	<tutorials>
 	</tutorials>
 	</tutorials>
@@ -10,41 +13,51 @@
 		<method name="get_bend_direction">
 		<method name="get_bend_direction">
 			<return type="int" />
 			<return type="int" />
 			<description>
 			<description>
+				For two bone IK, controls the bend direction of the IK bones, either 1 or -1.
 			</description>
 			</description>
 		</method>
 		</method>
 		<method name="get_bones">
 		<method name="get_bones">
 			<return type="Array" />
 			<return type="Array" />
 			<description>
 			<description>
+				The bones that are constrained by this IK constraint.
 			</description>
 			</description>
 		</method>
 		</method>
 		<method name="get_compress">
 		<method name="get_compress">
 			<return type="bool" />
 			<return type="bool" />
 			<description>
 			<description>
+				For one bone IK, when true and the target is too close, the bone is scaled to reach it.
 			</description>
 			</description>
 		</method>
 		</method>
 		<method name="get_mix">
 		<method name="get_mix">
 			<return type="float" />
 			<return type="float" />
 			<description>
 			<description>
+				A percentage (0-1) that controls the mix between the constrained and unconstrained rotation.
+				For two bone IK: if the parent bone has local nonuniform scale, the child bone's local Y translation is set to 0.
 			</description>
 			</description>
 		</method>
 		</method>
 		<method name="get_softness">
 		<method name="get_softness">
 			<return type="float" />
 			<return type="float" />
 			<description>
 			<description>
+				For two bone IK, the target bone's distance from the maximum reach of the bones where rotation begins to slow. The bones will not straighten completely until the target is this far out of range.
 			</description>
 			</description>
 		</method>
 		</method>
 		<method name="get_stretch">
 		<method name="get_stretch">
 			<return type="bool" />
 			<return type="bool" />
 			<description>
 			<description>
+				When true and the target is out of range, the parent bone is scaled to reach it.
+				For two bone IK: 1) the child bone's local Y translation is set to 0, 2) stretch is not applied if softness is > 0, and 3) if the parent bone has local nonuniform scale, stretch is not applied.
 			</description>
 			</description>
 		</method>
 		</method>
 		<method name="get_target">
 		<method name="get_target">
 			<return type="SpineBoneData" />
 			<return type="SpineBoneData" />
 			<description>
 			<description>
+				The bone that is the IK target.
 			</description>
 			</description>
 		</method>
 		</method>
 		<method name="get_uniform">
 		<method name="get_uniform">
 			<return type="bool" />
 			<return type="bool" />
 			<description>
 			<description>
+				When true and compress or stretch is used, the bone is scaled on both the X and Y axes.
 			</description>
 			</description>
 		</method>
 		</method>
 		<method name="set_bend_direction">
 		<method name="set_bend_direction">

+ 11 - 0
spine-godot/spine_godot/docs/SpinePathConstraint.xml

@@ -1,8 +1,11 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <?xml version="1.0" encoding="UTF-8" ?>
 <class name="SpinePathConstraint" inherits="SpineObjectWrapper" version="3.4">
 <class name="SpinePathConstraint" inherits="SpineObjectWrapper" version="3.4">
 	<brief_description>
 	<brief_description>
+		Stores the current pose for a path constraint.
 	</brief_description>
 	</brief_description>
 	<description>
 	<description>
+		Stores the current pose for a path constraint. A path constraint adjusts the rotation, translation, and scale of the constrained bones so they follow a {@link PathAttachment}.
+		See [url]http://esotericsoftware.com/spine-path-constraints[/url] in the Spine User Guide.
 	</description>
 	</description>
 	<tutorials>
 	<tutorials>
 	</tutorials>
 	</tutorials>
@@ -10,26 +13,31 @@
 		<method name="get_bones">
 		<method name="get_bones">
 			<return type="Array" />
 			<return type="Array" />
 			<description>
 			<description>
+				The bones that will be modified by this path constraint. Modifying the array has no effect.
 			</description>
 			</description>
 		</method>
 		</method>
 		<method name="get_data">
 		<method name="get_data">
 			<return type="SpinePathConstraintData" />
 			<return type="SpinePathConstraintData" />
 			<description>
 			<description>
+				The path constraint's setup pose data.
 			</description>
 			</description>
 		</method>
 		</method>
 		<method name="get_mix_rotate">
 		<method name="get_mix_rotate">
 			<return type="float" />
 			<return type="float" />
 			<description>
 			<description>
+				A percentage (0-1) that controls the mix between the constrained and unconstrained rotation.
 			</description>
 			</description>
 		</method>
 		</method>
 		<method name="get_mix_x">
 		<method name="get_mix_x">
 			<return type="float" />
 			<return type="float" />
 			<description>
 			<description>
+				A percentage (0-1) that controls the mix between the constrained and unconstrained translation X.
 			</description>
 			</description>
 		</method>
 		</method>
 		<method name="get_mix_y">
 		<method name="get_mix_y">
 			<return type="float" />
 			<return type="float" />
 			<description>
 			<description>
+				A percentage (0-1) that controls the mix between the constrained and unconstrained translation Y.
 			</description>
 			</description>
 		</method>
 		</method>
 		<method name="get_order">
 		<method name="get_order">
@@ -40,16 +48,19 @@
 		<method name="get_position">
 		<method name="get_position">
 			<return type="float" />
 			<return type="float" />
 			<description>
 			<description>
+				The position along the path.
 			</description>
 			</description>
 		</method>
 		</method>
 		<method name="get_spacing">
 		<method name="get_spacing">
 			<return type="float" />
 			<return type="float" />
 			<description>
 			<description>
+				The spacing between bones.
 			</description>
 			</description>
 		</method>
 		</method>
 		<method name="get_target">
 		<method name="get_target">
 			<return type="SpineSlot" />
 			<return type="SpineSlot" />
 			<description>
 			<description>
+				The slot whose path attachment will be used to constrained the bones.
 			</description>
 			</description>
 		</method>
 		</method>
 		<method name="is_active">
 		<method name="is_active">

+ 11 - 0
spine-godot/spine_godot/docs/SpinePathConstraintData.xml

@@ -10,56 +10,67 @@
 		<method name="get_bones">
 		<method name="get_bones">
 			<return type="Array" />
 			<return type="Array" />
 			<description>
 			<description>
+				The bones that will be modified by this path constraint. Modifying the array has no effect.
 			</description>
 			</description>
 		</method>
 		</method>
 		<method name="get_mix_rotate">
 		<method name="get_mix_rotate">
 			<return type="float" />
 			<return type="float" />
 			<description>
 			<description>
+				A percentage (0-1) that controls the mix between the constrained and unconstrained rotation.
 			</description>
 			</description>
 		</method>
 		</method>
 		<method name="get_mix_x">
 		<method name="get_mix_x">
 			<return type="float" />
 			<return type="float" />
 			<description>
 			<description>
+				A percentage (0-1) that controls the mix between the constrained and unconstrained translation X.
 			</description>
 			</description>
 		</method>
 		</method>
 		<method name="get_mix_y">
 		<method name="get_mix_y">
 			<return type="float" />
 			<return type="float" />
 			<description>
 			<description>
+				A percentage (0-1) that controls the mix between the constrained and unconstrained translation Y.
 			</description>
 			</description>
 		</method>
 		</method>
 		<method name="get_offset_rotation">
 		<method name="get_offset_rotation">
 			<return type="float" />
 			<return type="float" />
 			<description>
 			<description>
+				An offset added to the constrained bone rotation.
 			</description>
 			</description>
 		</method>
 		</method>
 		<method name="get_position">
 		<method name="get_position">
 			<return type="float" />
 			<return type="float" />
 			<description>
 			<description>
+				The position along the path.
 			</description>
 			</description>
 		</method>
 		</method>
 		<method name="get_position_mode">
 		<method name="get_position_mode">
 			<return type="int" enum="SpineConstant.PositionMode" />
 			<return type="int" enum="SpineConstant.PositionMode" />
 			<description>
 			<description>
+				The mode for positioning the first bone on the path.
 			</description>
 			</description>
 		</method>
 		</method>
 		<method name="get_rotate_mode">
 		<method name="get_rotate_mode">
 			<return type="int" enum="SpineConstant.RotateMode" />
 			<return type="int" enum="SpineConstant.RotateMode" />
 			<description>
 			<description>
+				The mode for adjusting the rotation of the bones.
 			</description>
 			</description>
 		</method>
 		</method>
 		<method name="get_spacing">
 		<method name="get_spacing">
 			<return type="float" />
 			<return type="float" />
 			<description>
 			<description>
+				The spacing between bones.
 			</description>
 			</description>
 		</method>
 		</method>
 		<method name="get_spacing_mode">
 		<method name="get_spacing_mode">
 			<return type="int" enum="SpineConstant.SpacingMode" />
 			<return type="int" enum="SpineConstant.SpacingMode" />
 			<description>
 			<description>
+				The mode for positioning the bones after the first bone on the path.
 			</description>
 			</description>
 		</method>
 		</method>
 		<method name="get_target">
 		<method name="get_target">
 			<return type="SpineSlotData" />
 			<return type="SpineSlotData" />
 			<description>
 			<description>
+				The slot whose path attachment will be used to constrained the bones.
 			</description>
 			</description>
 		</method>
 		</method>
 		<method name="set_mix_rotate">
 		<method name="set_mix_rotate">