Panimator-Addon

panimator

Panimator V2

With the Panimator krpano plugin you can play hotspot camera and light animations in krpano.
The objects are animated in Blender and the required timelines are output with the Panimator Blender addon.

If you have any questions about the Panimator plugin, feel free to ask us in the krpano-forum.

This is the documentation for the Panimator Blender Addon

If you want to add panimations to your krpano project, you will need a blend file with the corresponding models on the right locations.
Add cameras, hotspot placeholder, 3D models or lights (point, sun, spot) to your scene and animate them with the Blender animation tools.

Depending on which object-type is selected, the various output options are visible in the addon.
You can select which values you want to output and how many decimal places the values should have.
Then click on the Print button to output a finished xml file in the Blender text editor.

Hotspot Animation

Text Hotspots

For text-hotspots add hotspots from the Panimator or PanoCamAdder Addon.

The setting options for texthotspots become visible when a MESH is selected and „Text“ is selected in the Type drop-down menu.

The following values can be output:

  • location (tx, ty, tz)
  • rotation (rx, ry, rz)
  • scale
  • width/height
  • alpha*
  • color

* = fake value (no visual feedback in the 3D viewport)

Image Hotspots:

For image-hotspots add image hotspots from the Panimator or PanoCamAdder Addon.

The setting options for image hotspots become visible when a MESH is selected and „Image“ is selected in the Type drop-down menu.

The following values can be output:

  • location (tx, ty, tz)
  • rotation (rx, ry, rz)
  • scale
  • alpha*

3D Hotspots

Import 3D models and animate them as threejs 3D Model hotspots.


Tip for importing 3D models:
3D models often already have a rotation around an axis after import. To avoid rotation problems, apply the rotation before you start the animation!

The setting options for 3D hotspots become visible when a MESH is selected and „3D“ is selected in the Type drop-down menu – or when an EMPTY is selected.

The following values can be output:

  • location (tx, ty, tz)
  • rotation (rx, ry, rz)
  • scale (scalex, scaley, scalez)

Camera Animation:

For camera animating it is important to rotate the cam only around the local z-axis (hlookat) and the local x-axis (vlookat). It is therefore best to use a PanoCam from the Panimator or PanoCamAdder add-on.

The setting options for cameras become visible when a CAMERA is selected.

The following values can be output:

  • location (tx, ty, tz)
  • hlookat
  • vlookat
  • camroll*
  • fov

* = fake value (no visual feedback in the 3D viewport )

Light Hotspots:

Add point, sun or spotlights and animate them as threejs 3D Light hotspots.

A note on the intensity: Blender and threeJS calculate the intensity of the light very differently. A direct conversion is not easily possible. The output values for the intensity are therefore inaccurate and may have to be adjusted.

Point Light

The setting options for point light become visible when a POINT LIGHT is selected.

The following values can be output:

  • intensity
  • color
  • location (tx, ty, tz)

Sun Light

The setting options for point light become visible when a SUN LIGHT is selected.

The following values can be output:

  • intensity
  • color
  • location (ath, atv)

Spot Light

The setting options for point light become visible when a SPOT LIGHT is selected.

A note on the distance: The distance is only visible and animatable if the “Custom distance” option is activated in the light data panel.

The following values can be output:

  • intensity
  • distance
  • color
  • location (tx, ty, tz)
  • target (targetx, targety, targetz)
  • angle
  • penumbra

Output XML:

Select the variables you want to print and hit the print-button. The ‚krpano-ready‘ animation path will be output as xml file in the text-editor. Open the text-editor and choose the xml file from the text drop-down menu. Go to Text/Save As.. to save the file.

Important:
Each animation needs an own Keyframe Number! (timekey_ for hotspots, waypoint_ for cameras, lightpoint_ for lights)

Optional:
Add a comment with info about the object name and the frames.

The Panimator bundle is a co-production from Tuur and DerMische