KMP Editing/Cameras

Under Construction

This article is not finished. Help improve it by adding accurate information or correcting grammar and spelling.

Introduction

Improperly configured camera settings can cause game crashes during opening pans, replays and post-match winning laps. Back up your KMP before you start editing.

Good cameras will make your level look much more professional, but editing them can be difficult to master.

CAME entry data structure (0x48 bytes)

Offset	Type	Description	Box name in SZS Modifier	Names in Wiimms Tools	Column name in KMP Modifier	Box name in KMP Cloud
0x00	Byte	Camera type.	Settings (box 1, first 2 digits)	type	Type	Type
0x01	Byte	Next camera entry index. Value 0xFF means: no next camera.	Settings (box 1, second 2 digits)	next	Next	Next
0x02	Byte	Camshake. Exact meanings unknown (always 0).	Settings (box 1, third 2 digits)	unknown	Shake	Shake
0x03	Byte	Route used by the camera. This is index link into the POTI section. The value 0xFF means "no route".	Settings (box 1, last 2 digits)	route	Route	Route
0x04	UInt16	Velocity of the camera point in units per 100/60 sec (=distance/1.67 sec).	Settings (box 2, first 4 digits)	v(came)	V(Cam)	Pointspeed
0x06	UInt16	Velocity of zooming in units per 100/60 sec (=units/1.67 sec) (tested with camera type 5).	Settings (box 2, last 4 digits)	v(zoom)	V(Zoom)	Zoomspeed
0x08	UInt16	Velocity of the view point in distance per 100/60 sec (=distance/1.67 sec) (tested with camera type 5).	Settings (box 3, first 4 digits)	v(v.pt)	V(View)	Viewspeed
0x0A	Byte	Start flag. Exact meanings unknown.	Settings (box 3, third 2 digits)	unknown	Flag (First 2 digits)	Start
0x0B	Byte	Movie flag. Exact meanings unknown.	Settings (box 3, last 2 digits)	unknown	Flag (Second 2 digits)	Movie
0x0C	Float[3]	A 3D position vector of the camera.	X, Y and Z	position (x,y,z)	X, Y and Z	PositionX, PositionY and PositionZ
0x18	Float[3]	A rotation 3D vector. Almost always 0,0,0.	X2, Y2 and Z2	rotation (x,y,z)	Roll, Yaw and Pitch	RotationX, RotationY and RotationZ
0x24	Float	Zoom start: The angle of view (field of view). Angles >180 create curious effects.	X3	zoom beg	Zoom	Zoomstart
0x28	Float	Zoom end. The camera changes the zoom to this value. Offset 0x06 (Velocity) controls the speed of zooming.	Y3	zoom end	Zoom2	Zoomend.
0x2C	Float[3]	Start vector of the view point (camera type 5) or the relative camera position (camera type 3).	Z3, X4 and Y4	view point beg (x,y,z)	View(x), View(y) and View(z)	ViewStartX, ViewStartY and ViewStartZ
0x38	Float[3]	(Destination) vector of the view point.	Z4, X5 and Y5	view point end (x,y,z)	View2(x), View2(y) and View2(z)	ViewEndX, ViewEndY and ViewEndZ
0x44	Float	The time how long this Camera is active. (in units of 1/60 seconds).	Z5	sec*60	Time	Time

Camera Editing/Step by Step guide

Cameras can be placed like any normal object. The position only matters when using certain camera settings. Cameras are found in the CAME section of the KMP Editor.

Opening Pans

On VS races a sequence of cameras is shown. The u8 value at offset 0x06 in the CAME section header is the index of the first camera. The next cameras are linked by the u8 value at offset 0x01. Normally 3 cameras are used, but any number can be used.

1000px

The first two digits in the first settings box indicate the type of camera. Opening pans have the setting 05. The length of time each camera is displayed is set in z5. Their values will be 220, 257 and 294; this is to synch the camera transitions with the opening music.
If you found these 3 Cameras, we come to editting them.

The last two numbers in the first settings box control the Route used. A value of FF means the camera does not use a route. You can find the Opening Route Sections so:

As example in the pic I used SNES Ghost Valley 2. Take the first CAME with the z5 as 220, here it is CAME ID 11. Take the Route Settings, here it is "0D", or only D.

And now use Hex Calculator: D+1=E
Now convert it to Decimal: E=14
Finally: The first Opening Route Section is Route Section 14.
It also works for Object.

Do it with the other two numbers and you have the Opening Routes for your Opening CAMEs.

After we found out the routes of this cameras, go to this Routes and drag them how you like it. You can drag them in the near of special objects or some buildings. The Camera will move how you dragged this route. It is advisable to drag the last Opening Camera Route to the Startline. Also you can change your Routes:
Search after the Route Section, where the Camera should move, as example Route Section 18.
Convert the Decimal number to Hex: 18=12
Then subtract it with 1 on Hex Calculator: 12-1=11

And now write down this number in the Route Setting Box where the Route IDs are.
For testing, it is good to link the last opening camera to the first to have an unlimited view. You can make it so:

This Settings are the next Camera in Hex, so. CAME 11 has the the next CAME 12 (Convert Hex to Decimal; 0C=12), The CAME 12 has next CAME 13 and CAME 13 has none(=FF). Change the FF to the Hex digit of the first CAME. Example:
The first Camera is CAME 11 so Convert the 11 to Hex: 11=0B
So I change the FF to 0B and now the Cameras are looped.

For Wimm's analysis go to Wiimms Opening Pan Analysis.

File:CAME4 LuigiM.png

Now we define the points where the Cameras watch. The Start View Point shows where the Camera watch at the begin and the End View Point at the end of the Camera Intros. x3 and y3 controlls the zoom.
This is how to do:
First you search an object or a place, where the camera should look. Then you take the x, y and z values and take it to the z3, x4 and y4 values (x to x4; y to y4; z to z3). Make the y4 value about 1000 higher. And then take it to the End View Points, too. Then you can change there the y5 values, that makes the Camera watchs higher while replay, or you change the other 2 values or all 3.

As example you can watch the Opening Pans of Haunted Woods and Kalimari Desert, which Cameras are made by Wiimm.

Cameras while replays and after Race

Now we come to the Cameras after Race. There you need knowledge about CAME Types and AREA.

AREA

First I come to AREA.

File:AREA-LuigiM.png
File:AREA LuigiM 2.png

	menu      AREAtype  7
	item      Camera  0
	item      ObjClip  1
	item      EfControl  2
	item      FogControl  3
	item      PullControl  4
	item      EnemyFall  5
	item      2DmapArea  6

The list of the types can be found in the XML file /Race/Course/koopa_course.szs/course.0
(for other AREA infos go to AREA and Cameras/Reference)

AREA with Type Camera 00 are the acctivators for the CAMEs after the race. If you drive in the near of one AREA after the race, it will acctivate the CAME that is written in the Settings (watch at the pics). The other AREA types are unimportant. Don't change it!
Drag the first AREA to a point in the near of the Stage. And then do it with all other AREAs. Make sure that there are in the right order. It's easier for CAME Editting.

CAME

Cameras after Race have some diffrent types:

• 00 = Camera immediately after finishing (the one that looks at you.)
• 01 = ObjClip: Stays in one position but always points to the player. Used during replays.
• 02 = PathSearch
• 03 = KartFollow
• 06 = OP_PathMoveAt
  

(for all other types go to CAME and Cameras/Reference)

Camera Types 00, 01 and 03 can be used without any routes (Route IDs=FF). Camera Type 02 and 06 need Routes. All these have a x3 and y3 values. If you drive while a replay or after a race in the near of one AREA it will activates the CAME, which is written in the Settings. The Type defines how the Camera is watching at the person. PathSearch activates the Route that is looking at you. ObjClip stays in one position and looks at you. KartFollow is a Camera that follows you all the time. It needs after the Settings x3 and y3 the Settings from z3 to x5, like the Camera 00 and 06.

Camera Analysis by MrBean35000vr and Wiimm

Go here Cameras/Reference

Links

Custom Track Tutorials

Main Tutorials
Introduction – Textures – Scale – Modeling ⇒ Using Blender – BRRES: CTools
BRRES: BrawlBox – BRRES: RiiStudio – Minimap – Solidity – KCL: Wiimms Tools – KMP Editing
Object Editing – Cameras – Cannons – Post-effects – Videos

Battle Arenas
Battle Arenas – Enemy routes in battle arenas ⇒ Using Wiimm's Tools – Coins

Misc. Tutorials
Getting Files – BrawlBox Tricks – Animations – Shadows – Mipmaps
Custom Effects – Moving Terrain – Music – Ports – Paint Remakes – Tutorial Archive
Extended presence flags: Track Tutorial – LE-CODE Track FAQ

Testing and Reviewing
Testing a Track – Visual Review – Track Transformation – Fixing Errors

Software
3D Tools – BrawlBox – CTools Pack – KMP3D – KMP Cloud – KMP Modifier
Lorenzi's KMP Editor – MagicY – Material Tool – Post-Effect Editor – Wiimms SZS Tools – Wiimm's Tool Manager

Other
KMP Objects – Custom Objects – Model Database – Tutorial Archive