<WRAP center 60%>
<WRAP>
<WRAP column box>Tutorial</WRAP>
<WRAP column box>Working in progress</WRAP>
<WRAP column box>Alex</WRAP>
<WRAP column box>2023:11</WRAP>
</WRAP> \\
\\
\\
====== Integrating OpenPose into Unity ======

===== Requirements =====

  * Unity 2019.4 or later
  * A 3D scene 
  * OpenPose SDK (available for Windows, Mac, and Linux)
  * A computer with a webcam or a smartphone with a camera

===== Installing OpenPose SDK =====

  - Download the OpenPose ZIP from the official website [[https://github.com/CMU-Perceptual-Computing-Lab/openpose_unity_plugin|here]] and extract the contents of the zip file to a folder on your computer.
  - Open Unity and create a new project.
  - In the Unity editor, go to ''Assets > Import Package > Custom Package'' and select the OpenPose SDK folder that you extracted earlier.
  - Click ''Import'' to import the OpenPose SDK into your Unity project.

Additionally in the ZIP there is a demo project, such that you can better understand how open pose works with unity

===== Configuring OpenPose =====

  - In the Unity editor, go to ''Edit > Project Settings > Player'' and select the ''XR Settings'' tab.
  - Check the ''Virtual Reality Supported'' option and add "OpenPose" to the ''Virtual Reality SDKs'' list.
  - //(Optional)// Under ''Publishing Settings'', add "OpenPose" to the list of target platforms and "Windows" to the list of target SDKs.

===== Adding OpenPose Objects =====

  - In the Unity editor, create a new "OpenPoseManager" object (menu: ''OpenPose > OpenPose Manager'') and add it to the scene.
  - Create a new "OpenPoseReceiver" object (menu: ''OpenPose > OpenPose Receiver'') and add it to the scene.
  - Position both objects under a manager object in the hierarchy.

===== Calibrating OpenPose =====

  - In the Unity editor, select the OpenPoseManager object and click on the ''Calibrate'' button in the ''Inspector'' window.
  - Follow the on-screen instructions to calibrate the OpenPose camera.

===== Using OpenPose in Your Script =====

  - Create a new script (menu: ''Assets > Create > C# Script'') and name it "OpenPoseExample".
  - Attach the script to the OpenPoseReceiver object.
  - In the script, add the following code:<code>
csharp
using UnityEngine;
using OpenPose;

public class OpenPoseExample : MonoBehaviour
{
    private OpenPoseReceiver receiver;

    void Start()
    {
        receiver = GetComponent<OpenPoseReceiver>();
    }

    void Update()
    {
        // Get the current pose data from OpenPose
        var poseData = receiver.GetPoseData();

        // Print the pose data to the console
        Debug.Log("Pose Data:");
        Debug.Log($"Body Index: {poseData.BodyIndex}");
        Debug.Log($"Hand Index: {poseData.HandIndex}");
        Debug.Log($"Finger Index: {poseData.FingerIndex}");
        Debug.Log($"Pose Confidence: {poseData.PoseConfidence}");
    }
}</code>
  - In the Update method, we get the current pose data from the OpenPoseReceiver component and print it to the console.

===== Testing OpenPose =====

  - In the Unity editor, select the OpenPoseReceiver object and click on the Test button in the Inspector window.
Follow the on-screen instructions to test the OpenPose camera.

  - That's it! You have now successfully integrated OpenPose into your Unity project and can use it to track the positions and orientations of objects in 3D space.