JointNode

19. JointList

(1) JointList

u32 joint_list_tag
Describes the tags of JointList. Please set the tags shown below.
TAG_JOINT_LIST 0x00250000
u32 joint_list_header_size Describes the JointListHeader byte size.

u32 joint_list_size Describes the JointList byte size.

u32 joint_num Describes the Joint number.

u32 joint_num_byte Describes the byte size of each Joint.

Joint This is the Joint area.
Appendix ... about IK System
Go to the data chunk

(2) Joint

u32 joint_tag
Describes the tags of Joint. Please set the tags shown below.
TAG_JOINT 0x00250100
u32 this_joint_index Describes the index number for this Joint.

u32 joint_size Describes the Joint byte size.

u32 joint_name_index Describes the Joint name with the index number in NameList.
u32 joint_type
Describes the Joint type.
In NIFF2.0, IK-Chain only handles a 2-joint-chain. The following flags are defined:
NIFF2_1ST_JOINT 0x00000000 NIFF2_2ND_JOINT 0x00000001 NIFF2_JOINT_UP 0x00000000 NIFF2_JOINT_DOWN 0x00010000
Set NIFF2_1ST_JOINT for the 1st Joint.
Set NIFF2_2ND_JOINT for the 2nd Joint.
With NIFF2_JOINT_UP, IK-Chain moves forward in response to the movement of an Effector. Thus, IK-Chain bends when the Effector moves in the positive direction along the Y axis of the 1st Joint.
With NIFF2_JOINT_DOWN, IK-Chain moves in the reverse direction in response to the movement of an Effector. Thus, IK-Chain bends when the Effector moves in the negative direction along the Y axis of the 1st Joint.
NIFF2_1ST_JOINT, NIFF2_2ND_JOINT and NIFF2_JOINT_UP, NIFF2_JOINT_DOWN are described with bitOR.
float joint_length Describes the Joint length.

float resplane_axis_x
float resplane_axis_y
float respalne_axis_z This vector indicates divergence from the direction of the Z axis. It indicates the normal vector of the IK resolution plane. Please set toward the Z axis (x,y,z)=(0,0,1).

u32 obj_num Describes the Obj number linked to Joint.

u32 external_obj_num Describes the Obj number linked to Joint referencing an external file.
u32 joint_index
Describes the index number of a Joint linked by this Joint. When linking this Joint to an Effector, please describe the following flag:
NIFF2_NO_LINK_TO_JOINT 0xffffffff
u32 effector_index
Describes the index number of the Effector linked to this Joint. When linking this Joint to a Joint, please describe the following flag:
NIFF2_NO_LINK_TO_EFFECTOR 0xffffffff
u32 anim_index Describes the index number of the AnimGroup linked to this Joint. For the 1st Joint, the resolution plane can be determined using the PreferredAxisConstraint channel or the UpVectorConstraint channel. If these constraints are not used, then the resolution plane will run parallel to the Z axis of ChainRoot. For Joint rotation, highest priority goes to rotation around the X axis. The actual resolution plane becomes the plane that faces the Z axis without conflicting with rotation around the X axis. When there is a link to PreferredAxisConstraint, the Joint's Z axis is adjusted in the direction of the object which has that constraint. Of course, rotation around the X axis has the highest priority. When there is a link to UpVectorConstraint, the origin point of the 1st Joint and the origin points of Effector and Constraint objects are calculated so they lay on the resolution plane. The 2nd Joint is ignored, even when linked to animation. If there are no links to animation, please describe anim_index = 0xffffffff.

u32 obj_index Describes the index number for the Obj linked from the Joint
When obj_num = 0, this field is not described.

u32 external_obj_file_name_index When the Obj that is linked from the Joint references an external file, this file name is described with an ExternalNameList index number.
Please do not include the directory name etc. when describing the file name.
When external_obj_num = 0, this field is not described.

u32 external_obj_name_index When the Obj that is linked from the Joint references an external file, that Obj name is described with an ExternalNameList index number.
When external_obj_num = 0, this field is not described.
Appendix ... about IK System
Go to the data chunk

u32 joint_list_tag	Describes the tags of JointList. Please set the tags shown below. TAG_JOINT_LIST 0x00250000
u32 joint_list_header_size	Describes the JointListHeader byte size.
u32 joint_list_size	Describes the JointList byte size.
u32 joint_num	Describes the Joint number.
u32 joint_num_byte	Describes the byte size of each Joint.
Joint	This is the Joint area.

u32 joint_tag	Describes the tags of Joint. Please set the tags shown below. TAG_JOINT 0x00250100
u32 this_joint_index	Describes the index number for this Joint.
u32 joint_size	Describes the Joint byte size.
u32 joint_name_index	Describes the Joint name with the index number in NameList.
u32 joint_type	Describes the Joint type. In NIFF2.0, IK-Chain only handles a 2-joint-chain. The following flags are defined: NIFF2_1ST_JOINT 0x00000000 NIFF2_2ND_JOINT 0x00000001 NIFF2_JOINT_UP 0x00000000 NIFF2_JOINT_DOWN 0x00010000 Set NIFF2_1ST_JOINT for the 1st Joint. Set NIFF2_2ND_JOINT for the 2nd Joint. With NIFF2_JOINT_UP, IK-Chain moves forward in response to the movement of an Effector. Thus, IK-Chain bends when the Effector moves in the positive direction along the Y axis of the 1st Joint. With NIFF2_JOINT_DOWN, IK-Chain moves in the reverse direction in response to the movement of an Effector. Thus, IK-Chain bends when the Effector moves in the negative direction along the Y axis of the 1st Joint. NIFF2_1ST_JOINT, NIFF2_2ND_JOINT and NIFF2_JOINT_UP, NIFF2_JOINT_DOWN are described with bitOR.
float joint_length	Describes the Joint length.
float resplane_axis_x float resplane_axis_y float respalne_axis_z	This vector indicates divergence from the direction of the Z axis. It indicates the normal vector of the IK resolution plane. Please set toward the Z axis (x,y,z)=(0,0,1).
u32 obj_num	Describes the Obj number linked to Joint.
u32 external_obj_num	Describes the Obj number linked to Joint referencing an external file.
u32 joint_index	Describes the index number of a Joint linked by this Joint. When linking this Joint to an Effector, please describe the following flag: NIFF2_NO_LINK_TO_JOINT 0xffffffff
u32 effector_index	Describes the index number of the Effector linked to this Joint. When linking this Joint to a Joint, please describe the following flag: NIFF2_NO_LINK_TO_EFFECTOR 0xffffffff
u32 anim_index	Describes the index number of the AnimGroup linked to this Joint. For the 1st Joint, the resolution plane can be determined using the PreferredAxisConstraint channel or the UpVectorConstraint channel. If these constraints are not used, then the resolution plane will run parallel to the Z axis of ChainRoot. For Joint rotation, highest priority goes to rotation around the X axis. The actual resolution plane becomes the plane that faces the Z axis without conflicting with rotation around the X axis. When there is a link to PreferredAxisConstraint, the Joint's Z axis is adjusted in the direction of the object which has that constraint. Of course, rotation around the X axis has the highest priority. When there is a link to UpVectorConstraint, the origin point of the 1st Joint and the origin points of Effector and Constraint objects are calculated so they lay on the resolution plane. The 2nd Joint is ignored, even when linked to animation. If there are no links to animation, please describe anim_index = 0xffffffff.
u32 obj_index	Describes the index number for the Obj linked from the Joint When obj_num = 0, this field is not described.
u32 external_obj_file_name_index	When the Obj that is linked from the Joint references an external file, this file name is described with an ExternalNameList index number. Please do not include the directory name etc. when describing the file name. When external_obj_num = 0, this field is not described.
u32 external_obj_name_index	When the Obj that is linked from the Joint references an external file, that Obj name is described with an ExternalNameList index number. When external_obj_num = 0, this field is not described.