View source for Super Mario Galaxy 2/Camera

This page describes the camera system in [[Super Mario Galaxy 2]] (and presumably large parts of [[Super Mario Galaxy]]).

== Parameters ==
There are plenty of parameters which are used to describe each camera. There are many different camera types, and different camera types use different parameters. Only parameters which are used are stored in the [[BCSV]] file. The following parameters have been observed:

{| class="wikitable"
|-
! Name !! Description
|-
| version || 
|-
| gflag.camendint || 
|-
| gflag.enableEndErpFrame || 
|-
| gflag.thru || 
|-
| num2 || 
|-
| num1 || Enables camera rotation.
|-
| angleB || X-rotation.
|-
| angleA || Y-rotation.
|-
| dist || Distance between the camera and the focus point.
|-
| flag.subjectiveoff || Disables first person.
|-
| vpanaxis.[X/Y/Z] || Vertical pan axis.
|-
| vpanuse || Enables vertical pan axis.
|-
| udown || 
|-
| pushdelaylow || Air move delay?
|-
| pushdelay || Ground move delay?
|-
| lplay || Min Y?
|-
| uplay || Max Y?
|-
| gndint || Transition ground time?
|-
| lower || Lower border?
|-
| upper || Upper border?
|-
| camint || Transition time.
|-
| fovy || Field of view angle.
|-
| roll || Roll.
|-
| loffsetv || Look offset vertical.
|-
| loffset || Look offset.
|-
| woffset.[X/Y/Z] || Camera look at point. Specifies the target position which the camera looks at.
|-
| camtype || Camera type.
|-
| id || Camera identifier.
|-
| string || 
|-
| flag.collisionoff || Disables collision.
|-
| flag.nofovy || Enables field of view.
|-
| evpriority || Event priority.
|-
| evfrm || Event frames.
|-
| eflag.enableErpFrame || Event use transition time.
|-
| camendint || End transition time.
|-
| eflag.enableEndErpFrame || Use event transition.
|-
| wpoint.[X/Y/Z] || World point. Global position of the camera.
|-
| axis.[X/Y/Z] || Player offset.
|-
| up.[X/Y/Z] ||  
|-
| flag.noreset || Disables reset. Prevents the camera rotation from resetting.
|-
| flag.antibluroff || Disables anti-blur.
|-
| flag.lofserpoff || 
|}

== Types ==
The following camera types have been observed:

{| class="wikitable"
|-
! Name !! Description
|-
| CAM_TYPE_2D_SLIDE || 
|-
| CAM_TYPE_ANIM || 
|-
| CAM_TYPE_BEHIND_DEBUG || 
|-
| CAM_TYPE_BLACK_HOLE || 
|-
| CAM_TYPE_BOSS_DONKETSU || 
|-
| CAM_TYPE_CHARMED_FIX || 
|-
| CAM_TYPE_CHARMED_VECREG || 
|-
| CAM_TYPE_CHARMED_VECREG_TOWER || 
|-
| CAM_TYPE_CUBE_PLANET || 
|-
| CAM_TYPE_DEAD || 
|-
| CAM_TYPE_DONKETSU_TEST || 
|-
| CAM_TYPE_DPD || 
|-
| CAM_TYPE_EYEPOS_FIX || Camera with fixed origin which looks at the player.
|-
| CAM_TYPE_EYEPOS_FIX_THERE || Camera with fixed origin which looks at the player. The origin is not specified and is instead decided by the game.
|-
| CAM_TYPE_EYE_FIXED_THERE_TEST || 
|-
| CAM_TYPE_FOLLOW || Camera which follows the player. The camera origin moves slower than the player.
|-
| CAM_TYPE_FOO_FIGHTER || 
|-
| CAM_TYPE_FOO_FIGHTER_PLANET || 
|-
| CAM_TYPE_FREEZE || 
|-
| CAM_TYPE_FRONT_AND_BACK || 
|-
| CAM_TYPE_GROUND || 
|-
| CAM_TYPE_ICECUBE_PLANET || 
|-
| CAM_TYPE_INNER_CYLINDER || 
|-
| CAM_TYPE_INWARD_SPHERE || 
|-
| CAM_TYPE_INWARD_TOWER || 
|-
| CAM_TYPE_INWARD_TOWER_TEST || 
|-
| CAM_TYPE_MEDIAN_PLANET || 
|-
| CAM_TYPE_MEDIAN_TOWER || 
|-
| CAM_TYPE_MTXREG_PARALLEL || 
|-
| CAM_TYPE_OBJ_PARALLEL || 
|-
| CAM_TYPE_POINT_FIX || 
|-
| CAM_TYPE_RACE_FOLLOW || 
|-
| CAM_TYPE_RAIL_DEMO || 
|-
| CAM_TYPE_RAIL_FOLLOW || 
|-
| CAM_TYPE_RAIL_WATCH || 
|-
| CAM_TYPE_SLIDER || 
|-
| CAM_TYPE_SPHERE_TRUNDLE || 
|-
| CAM_TYPE_SPIRAL_DEMO || 
|-
| CAM_TYPE_SUBJECTIVE || 
|-
| CAM_TYPE_TALK || 
|-
| CAM_TYPE_TOWER || Camera with a fixed target whose origin follows the player.
|-
| CAM_TYPE_TOWER_POS || 
|-
| CAM_TYPE_TRIPOD_PLANET || 
|-
| CAM_TYPE_TRUNDLE || 
|-
| CAM_TYPE_TWISTED_PASSAGE || 
|-
| CAM_TYPE_WATER_FOLLOW || 
|-
| CAM_TYPE_WATER_PLANET || 
|-
| CAM_TYPE_WATER_PLANET_BOSS || 
|-
| CAM_TYPE_WONDER_PLANET || 
|-
| CAM_TYPE_XZ_PARA || Camera which follows the player with a fixed angle.
|}

== IDs ==
A camera is identified and referenced by its "id" field which is a string. The field follows a specific format in order to work propertly, and many cameras have Japanese names. The numbers are always stored as hexadecimal integers with lowercase letters. The following formats are known:

{| class="wikitable"
|-
! ID !! Description
|-
| c:XXXX || Cube camera. Used for cameras controlled by CameraArea (which are placed in CameraCube). XXXX is an integer which is referenced by Obj_arg0.
|-
| e:____ || Event camera, triggered by a specific action (usually an object).
|-
| g:____ || Group camera.
|-
| o:____ || Other cameras.
|-
| s:XXXX || Start camera. Used for start points which is referenced by Mario (which is placed in Start). XXXX is an integer which is referenced by Camera_id.
|}

== Event Camera ==
There are multiple event cameras. The following are known:

{| class="wikitable"
|-
! Name !! Description
|-
| e:シナリオスターター:XXX:YY番目 || Scenario start camera. XXX represents the camera set and YY is the index.
|-
| e:スーパースピンドライバー:XXX:YY番目 || Launch star camera. XXX represents the camera set and YY is the index.
|}

[[Category:Super Mario Galaxy]]