Creating and Converting Hierarchy Files

The Hierarchy file describes how the groups in a figure are arranged. It outlines the parent-child relationships between groups. Once created it can be imported into Poser where it is converted to create a new figure CR2 file as shown in Converting Hierarchy Files, below.

Hierarchy File Structure

The hierarchy file specifies four important things:

• The geometry (.OBJ) file to use.
• The hierarchical connections (parent-child relationships) of the body parts.
• The desired rotation order of each body part.
• A specification of each Inverse Kinematics chain to be included in the figure.

Hierarchy files can be created in any text editor that can save documents in a text-only format.

The following is an example hierarchy file: It represents the full hierarchy for a horse -- including curve channels for the tails.

• objFile:Runtime:Geometries:horseHi:horseHiP3.obj
• 1 hip zxy
•    2 abdomen zyx
•       3 chest zyx
•          4 lShldr yzx
•             5 lUpArm yzx
•                6 lForeArm yzx
•                   7 lWrist yzx
•                      8 lHand yxz
•          4 rShldr yzx
•             5 rUpArm yzx
•                6 rForeArm yzx
•                   7 rWrist yzx
•                      8 rHand yxz
•          4 lowNeck zyx
•             5 upNeck zyx
•                6 head yzx
•    2 lThigh yzx
•       3 lLeg yzx
•          4 lShin yzx
•             5 lAnkle yzx
•                6 lFoot yxz
•    2 rThigh yzx
•       3 rLeg yzx
•          4 rShin yzx
•             5 rAnkle yzx
•                6 rFoot yxz
•    2 tail1 zyx curve
•       3 tail2 zyx curve
•          4 tail3 zyx curve
•             5 tail4 zyx curve
• ikChain LeftLeg lThigh lLeg lShin lAnkle
• ikChain RightLeg rThigh rLeg rShin rAnkle
• ikChain LeftHand lShldr lUpArm lForeArm lWrist lHand
• ikChain RightHand rShldr rUpArm rForeArm rWrist rHand

 

Here is another example of a typical human character hierarchy file:

objFile :Runtime:Geometries:Emily:Emily.obj
1 hip xyz 
    2 waist yzx 
        3 abdomen yzx 
            4 chest yzx 
                5 rCollar xzy 
                    6 rShldr xzy 
                        7 rForeArm xzy 
                            8 rHand xyx 
                                9 rThumb1 xyz 
                                    10 rThumb2 xyz 
                                        11 rThumb3 xyz 
                                9 rIndex0 xyz 
                                    10 rIndex1 xyz 
                                        11 rIndex2 xyz 
                                            12 rIndex3 xyz 
                                9 rMid0 xyz 
                                    10 rMid1 xyz 
                                        11 rMid2 xyz 
                                            12 rMid3 xyz 
                                9 rRing0 xyz 
                                    10 rRing1 xyz 
                                        11 rRing2 xyz 
                                            12 rRing3 xyz 
                                9 rPinky0 xyz 
                                    10 rPinky1 xyz 
                                        11 rPinky2 xyz 
                                            12 rPinky3 xyz 
                5 lCollar xzy 
                    6 lShldr xzy 
                        7 lForeArm xzy 
                            8 lHand xyx 
                                9 lThumb1 xyz 
                                    10 lThumb2 xyz 
                                        11 lThumb3 xyz 
                                9 lIndex0 xyz 
                                    10 lIndex1 xyz 
                                        11 lIndex2 xyz 
                                            12 lIndex3 xyz 
                                9 lMid0 xyz 
                                    10 lMid1 xyz 
                                        11 lMid2 xyz 
                                            12 lMid3 xyz 
                                9 lRing0 xyz 
                                    10 lRing1 xyz 
                                        11 lRing2 xyz 
                                            12 lRing3 xyz 
                                9 lPinky0 xyz 
                                    10 lPinky1 xyz 
                                        11 lPinky2 xyz 
                                            12 lPinky3 xyz 
                5 neck yzx 
                    6 head yzx 
                        7 tongue1 xyz 
                            8 tongue2 xyz 
                                9 tongue3 xyz 
                                    10 tongue4 xyz 
                                        11 tongue5 xyz 
                                            12 tongue6 xyz 
                        7 rEye xyz 
                        7 lEye xyz 
                        7 bttmTeeth xyz 
                        7 topTeeth xyz 
1 lButtock yzx 
    2 lThigh yzx 
        3 lShin yzx 
            4 lFoot yzx 
                5 lToe zyx 
                    6 lBigToe1 xyz 
                        7 lBigToe2 xyz 
                    6 lIndexToe1 xyz 
                        7 lIndexToe2 xyz 
                    6 lMidToe1 xyz 
                        7 lMidToe2 xyz 
                    6 lPinkyToe1 xyz 
                        7 lPinkyToe2 xyz 
                    6 lRingToe1 xyz 
                        7 lRingToe2 xyz 
1 rButtock yzx 
    2 rThigh yzx 
        3 rShin yzx 
            4 rFoot yzx 
                5 rToe zyx 
                    6 rIndexToe1 xyz 
                        7 rIndexToe2 xyz 
                    6 rRingToe1 xyz 
                        7 rRingToe2 xyz 
                    6 rPinkyToe1 xyz 
                        7 rPinkyToe2 xyz 
                    6 rMidToe1 xyz 
                        7 rMidToe2 xyz 
                    6 rBigToe1 xyz 
                        7 rBigToe2 xyz 
ikChain RightHand rShldr rForeArm rHand
ikChain LeftHand lShldr lForeArm lHand
ikChain LeftLeg lThigh lShin lFoot
ikChain RightLeg rThigh rShin rFoot

 

Converting a Hierarchy File

To convert a hierarchy file to a CR2 figure, follow these steps:

1. The first line of the PHI file specifies the location of the OBJ file, and you will need to place the OBJ file in that location before continuing. 
2. Choose File > Convert Hier File. 
3. Use Explorer or Finder to locate the PHI file that you want to convert, and press Enter or click Open.
4. Poser will prompt you to locate the OBJ file that corresponds with the hierarchy file. The OBJ file must contain groups that match those listed in the PHI file. After you locate the OBJ file, click Open to continue.
5. Poser will prompt you to enter a name for the new figure. Enter the name and choose OK. 
6. By default, a folder named New Figures will be added to your Poser 12 Content characters library, and the new figure will be placed there.

If you want to relocate the OBJ and CR2 to a specific runtime, you will need to relocate both the OBJ file and the CR2 file into that runtime folder. Create a subfolder in the Geometries runtime folder to store your OBJ file, and create a subfolder in the Figures library to store your CR2 file. Then edit the path in the CR2 to point to the new location of the OBJ file. The OBJ file location is listed twice in the CR2 file.

 

© 2020-2021 Bondware, Inc. Last updated November 23, 2021