1 /************************************************************************************

2

3 Filename : OVR_CAPI.h

4 Content : Keys for CAPI calls

5 Created : September 25, 2014

6 Authors :

7

8 Copyright : Copyright 2014 Oculus VR, LLC All Rights reserved.

9

10 Licensed under the Oculus VR Rift SDK License Version 3.2 (the "License");

11 you may not use the Oculus VR Rift SDK except in compliance with the License,

12 which is provided at the time of installation or download, or which

13 otherwise accompanies this software in either electronic or hard copy form.

14

15 You may obtain a copy of the License at

16

17 http://www.oculusvr.com/licenses/LICENSE-3.2

18

19 Unless required by applicable law or agreed to in writing, the Oculus VR SDK

20 distributed under the License is distributed on an "AS IS" BASIS,

21 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

22 See the License for the specific language governing permissions and

23 limitations under the License.

24

25 ************************************************************************************/

26

27

28

29 #define OVR_KEY_USER "User" // string

30 #define OVR_KEY_NAME "Name" // string

31 #define OVR_KEY_GENDER "Gender" // string

32 #define OVR_KEY_PLAYER_HEIGHT "PlayerHeight" // float

33 #define OVR_KEY_EYE_HEIGHT "EyeHeight" // float

34 #define OVR_KEY_IPD "IPD" // float

35 #define OVR_KEY_NECK_TO_EYE_DISTANCE "NeckEyeDistance" // float[2]

36 #define OVR_KEY_EYE_RELIEF_DIAL "EyeReliefDial" // int

37 #define OVR_KEY_EYE_TO_NOSE_DISTANCE "EyeToNoseDist" // float[2]

38 #define OVR_KEY_MAX_EYE_TO_PLATE_DISTANCE "MaxEyeToPlateDist" // float[2]

39 #define OVR_KEY_EYE_CUP "EyeCup" // char[16]

40 #define OVR_KEY_CUSTOM_EYE_RENDER "CustomEyeRender" // bool

41 #define OVR_KEY_CAMERA_POSITION "CenteredFromWorld" // double[7]

42

43 // Default measurements empirically determined at Oculus to make us happy

44 // The neck model numbers were derived as an average of the male and female averages from ANSUR-88

45 // NECK_TO_EYE_HORIZONTAL = H22 - H43 = INFRAORBITALE_BACK_OF_HEAD - TRAGION_BACK_OF_HEAD

46 // NECK_TO_EYE_VERTICAL = H21 - H15 = GONION_TOP_OF_HEAD - ECTOORBITALE_TOP_OF_HEAD

47 // These were determined to be the best in a small user study, clearly beating out the previous default values

48 #define OVR_DEFAULT_GENDER "Unknown"

49 #define OVR_DEFAULT_PLAYER_HEIGHT 1.778f

50 #define OVR_DEFAULT_EYE_HEIGHT 1.675f

51 #define OVR_DEFAULT_IPD 0.064f

52 #define OVR_DEFAULT_NECK_TO_EYE_HORIZONTAL 0.0805f

53 #define OVR_DEFAULT_NECK_TO_EYE_VERTICAL 0.075f

54 #define OVR_DEFAULT_EYE_RELIEF_DIAL 3

55 #define OVR_DEFAULT_CAMERA_POSITION {0,0,0,1,0,0,0}

56