| 12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273 |
- <html>
- <head>
- <title>Blitz3D Docs</title>
- <link rel=stylesheet href=../css/commands.css type=text/css>
- </head>
- <body>
- <h1>CreatePivot ( [parent] )</h1>
- <h1>Parameters</h1>
- <table>
- <tr>
- <td>
- parent (optional) - parent entity of pivot
- </td>
- </tr>
- </table>
- <h1>Description</h1>
- <table>
- <tr>
- <td>
- Creates a pivot entity.
<br />
-
<br />
- A pivot entity is an invisible point in 3D space that's main use is to act as a parent entity to other entities. The pivot can then be used to control lots of entities at once, or act as new centre of rotation for other entities.
<br />
-
<br />
- To enforce this relationship; use EntityParent or make use of the optional parent entity parameter available with all entity load/creation commands.
<br />
-
<br />
- Indeed, this parameter is also available with the CreatePivot command if you wish for the pivot to have a parent entity itself.
- </td>
- </tr>
- </table>
- <h1><a href=../3d_examples/CreatePivot.bb>Example</a></h1>
- <table>
- <tr>
- <td>
- ; CreatePivot Example
<br />
- ; -------------------
<br />
-
<br />
- Graphics3D 640,480
<br />
- SetBuffer BackBuffer()
<br />
-
<br />
- camera=CreateCamera()
<br />
- PositionEntity camera,0,0,-10
<br />
-
<br />
- light=CreateLight()
<br />
- RotateEntity light,90,0,0
<br />
-
<br />
- ; Create pivot. This is invisible.
<br />
- pivot=CreatePivot()
<br />
-
<br />
- ; Create planet (i.e. a sphere). Make the pivot the parent of the planet.
<br />
- planet=CreateSphere(16,pivot)
<br />
-
<br />
- ; Position planet so that it is offset from the pivot
<br />
- PositionEntity planet,5,0,0
<br />
-
<br />
- While Not KeyDown(1)
<br />
-
<br />
- ; Turn pivot, thus making planet spin around it
<br />
- TurnEntity pivot,0,1,0
<br />
-
<br />
- RenderWorld
<br />
- Flip
<br />
-
<br />
- Wend
<br />
-
<br />
- End
- </td>
- </tr>
- </table>
- <br>
- <a target=_top href=../index.htm>Index</a><br>
- <br>
- Click <a href=http://www.blitzbasic.co.nz/b3ddocs/command.php?name=CreatePivot&ref=comments target=_blank>here</a> to view the latest version of this page online</body>
- </html>
|