Animation (plugin) - Revision history

Daniel: /* Animation parameters */

2016-04-22T09:23:15Z

Animation parameters

← Older revision		Revision as of 11:23, 22 April 2016
Line 33:		Line 33:

	You'll also notice that when you select a step, the corresponding viewport is automatically applied.		You'll also notice that when you select a step, the corresponding viewport is automatically applied.

			Steps can be activated or deactivated with the checkbox on the left of their entry in the list.

	You can also change the total duration of the video with the 'total duration' field in the 'Animation' frame on the right. '''Warning: all steps duration will be modified proportionally to their current duration.'''		You can also change the total duration of the video with the 'total duration' field in the 'Animation' frame on the right. '''Warning: all steps duration will be modified proportionally to their current duration.'''

Daniel at 09:22, 22 April 2016

2016-04-22T09:22:15Z

← Older revision		Revision as of 11:22, 22 April 2016
Line 47:		Line 47:

	Note that the video output format is automatically guessed from the extension (mpg, mp4, avi, etc.). The available output formats depend on the codecs installed on your machine.		Note that the video output format is automatically guessed from the extension (mpg, mp4, avi, etc.). The available output formats depend on the codecs installed on your machine.

			== Previewing ==

			You can preview the animation at any time by clicking on the 'Preview button'.

			The ''Start preview from selected step'' checkbox will let you specify if the preview should always start from the selected step or from the first enabled one.

			Note that in preview mode the LOD mechanism will still be activated (if any) but it won't be during the real animation rendering.

	== Rendering ==		== Rendering ==

Daniel: /* Output video parameters */

2016-04-22T09:19:28Z

Output video parameters

← Older revision		Revision as of 11:19, 22 April 2016
Line 37:		Line 37:

	== Output video parameters ==		== Output video parameters ==

			First you can set whether the video will 'loop' or not (with the corresponding 'Loop' checkbox). This means that the last step will be considered as a real step (and connected to the first frame).

	In the lower part of the dialog, you'll find the video rendering options:		In the lower part of the dialog, you'll find the video rendering options:
	* the frame rate (in frame per second (fps) - ''24 or 25 fps should be the minimum'')		* the frame rate (in frame per second (fps) - ''24 or 25 fps should be the minimum'')
	* the bitrate (the higher, the better the video quality will be but the bigger the file - see [https://support.google.com/youtube/answer/1722171?hl=en Youtube recommendations] for instance)		* the bitrate (the higher, the better the video quality will be but the bigger the file - see [https://support.google.com/youtube/answer/1722171?hl=en Youtube recommendations] for instance)
	* and the ~~output filename~~		* the 'super resolution' parameter will be used to render the frames at a much bigger scale (''n'' times bigger) and then the frames will be rescled to the original video resolution. This gives a much smoother look and removes visual artifacts, etc.
			* the output filename
	~~Note that~~ the video ~~output format is automatically guessed from the extension (mpg, avi~~, etc.~~). The available~~ output ~~formats depend on the codecs installed on your machine.~~

	~~To setup~~ the ~~bitrate~~, ~~you can follow~~		Note that the video output format is automatically guessed from the extension (mpg, mp4, avi, etc.). The available output formats depend on the codecs installed on your machine.

	== Rendering ==		== Rendering ==

Daniel: /* Animation parameters */

2016-04-22T09:08:40Z

Animation parameters

← Older revision		Revision as of 11:08, 22 April 2016
Line 28:		Line 28:
	[[File:QAnimationPluginDialog.jpg\|center]]		[[File:QAnimationPluginDialog.jpg\|center]]

	In the upper part are listed all the animation 'steps' (i.e. the ~~interpolated path between each viewport~~).		In the upper part are listed all the animation 'steps' (i.e. the selected viewports).

	You can ~~highlight~~ a single step ~~at once~~ so as to setup its parameters (in the 'Current step' frame on the right). For now, only the step duration can be changed.		You can click on a single step so as to setup its parameters (in the 'Current step' frame on the right). For now, only the step duration can be changed.

	You'll also notice that when you ~~highlight~~ a step, the corresponding viewport is automatically applied.		You'll also notice that when you select a step, the corresponding viewport is automatically applied.

	You can also change the total duration of the video with the 'total duration' field in the 'Animation' frame on the right. '''Warning: all steps duration will be modified proportionally to their current duration.'''		You can also change the total duration of the video with the 'total duration' field in the 'Animation' frame on the right. '''Warning: all steps duration will be modified proportionally to their current duration.'''

Daniel: /* Output video parameters */

2015-10-08T07:50:43Z

Output video parameters

New page

= Introduction =

The qAnimation plugin can render animation as movie files (mpg, etc.). It relies on the [https://www.ffmpeg.org/ FFMPEG library].

This plugin has been initiated by [http://www.2grobotics.com/ 2G Robotics] [[File:2g_logo.jpg]].

= Usage =

== Creating viewport objects ==

Before starting the plugin, you must create [[Entities#Viewport | viewport objects]] along the path of the animation to render. The position and orientation of the camera will then be interpolated between each viewport.

To create the viewports, simply position the camera of the active 3D view in the right position and orientation and then use the 'Display > Save viewport as object' menu entry (or the CTRL+V shortcut).

Notes:
* for now the viewports must be created in the chronological order.
* viewport objects store almost all the display parameters (even the point size, etc.). When interpolating the frames between each viewport objects, CloudCompare will actually interpolate all those parameters.
* for more convenience, it is better to regularly sample the viewpoints (as the default duration of the output video between each viewpoint is the same - this can be changed for each step afterwards but this can be quite cumbersome if you have a lot of viewpoints).

[[File:QAnimationPluginViewports.jpg|center]]

Once all the viewports have been created, highlight them (''hold the CTRL key while selecting them in the DB tree'') and launch the plugin with the [[File:qAnimationIcon.png]] icon.

== Animation parameters ==

Once launched, the animation settings dialog will appear:
[[File:QAnimationPluginDialog.jpg|center]]

In the upper part are listed all the animation 'steps' (i.e. the interpolated path between each viewport).

You can highlight a single step at once so as to setup its parameters (in the 'Current step' frame on the right). For now, only the step duration can be changed.

You'll also notice that when you highlight a step, the corresponding viewport is automatically applied.

You can also change the total duration of the video with the 'total duration' field in the 'Animation' frame on the right. '''Warning: all steps duration will be modified proportionally to their current duration.'''

== Output video parameters ==

In the lower part of the dialog, you'll find the video rendering options:
* the frame rate (in frame per second (fps) - ''24 or 25 fps should be the minimum'')
* the bitrate (the higher, the better the video quality will be but the bigger the file - see [https://support.google.com/youtube/answer/1722171?hl=en Youtube recommendations] for instance)
* and the output filename

Note that the video output format is automatically guessed from the extension (mpg, avi, etc.). The available output formats depend on the codecs installed on your machine.

To setup the bitrate, you can follow

== Rendering ==

Before rendering you can preview the video in realtime with the 'Preview' button (''but without the compression effect'').

Once ready simply hit the 'Render' button to create the video file.

== Saving the parameters ==

The parameters of each step are saved as 'meta-data' of the associated viewport object. This way you can close the dialog and restart it without losing them.

It is possible to save the viewport objects together in a [[FILE_I/O | BIN]] file in order to save the animation for later editing or simply to re-use the same camera positions for another object.

= Tutorial =

A quick tutorial video has been uploaded by [http://ai2-3d.com/ Eugene Liscsio]: [https://www.youtube.com/watch?v=M3i16D0_Yac https://www.youtube.com/watch?v=M3i16D0_Yac] (note: this was the beta version of the plugin)