songsenand
/
cgal
mirror of https://github.com/CGAL/cgal
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

update videos for the deformation package

This commit is contained in:
Sébastien Loriot 2014-08-15 08:49:45 +02:00
parent d4bdae3077
commit b1985a2674
2 changed files with 30 additions and 15 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
Documentation/cgal_stylesheet.css
View File

@ -161,6 +161,10 @@ div.cgal_figure_caption {
text-align: center;
}
div.cgal_video_caption {
text-align: center;
}
div.groupText {
font-style: none;
}

41
Surface_modeling/doc/Surface_modeling/Surface_modeling.txt
View File

@ -129,13 +129,13 @@ In particular, any vertex that is no longer inside the ROI will be assigned to i
`Deform_mesh::preprocess()` is first called.
The original positions can be updated by calling `Deform_mesh::overwrite_initial_geometry()` (
which will also require a new preprocessing step).
This behavior is illustrated in the video \ref Surface_Modeling_Demo_Tutorial.
This behavior is illustrated in \ref SModelingVideo_1 "Video 1".
\subsection Surface_modeling_arap_or_spokes_and_rims As-Rigid-As-Possible and Spokes-and-Rims Deformation Techniques
Two deformation techniques are provided by this package. This section summarizes from the user point of view what is
explained in details in the section \ref Surface_Modeling_Overview.
The As-Rigid-As-Possible deformation technique requires the use of a positive weighting scheme to garantee
The As-Rigid-As-Possible deformation technique requires the use of a positive weighting scheme to guarantee
the correct minimization of the energy. When using the default cotangent weighting scheme, this means that
the input surface mesh must be <em>clean</em>. That is, that for all edges in the surface mesh
the sum of the angles opposite to the edge in the incident triangles is less that \f$ \pi \f$.
@ -199,30 +199,41 @@ Another example is given in the manual page of the concept `::SurfaceModelingWei
\cgalExample{Surface_modeling/custom_weight_for_edges_example.cpp}
\section Surface_Modeling_Demo How to Use the Demo
\todo Update these videos when the demo is stable
A plugin for the polyhedron demo is available to test the algorithm. The following video tutorials explain how to use it.
When the deformation dock window is open, the picking of control vertices and of the ROI is done by pressing <i>Shift</i>
and clicking with the left button of the mouse.
The displacement of the vertices is triggered when the <i>Ctrl</i> button is pressed.
\subsection Surface_Modeling_Demo_Showcase An Introduction and Real World Example
@htmlonly
\anchor SModelingVideo_1
\htmlonly
<center>
<iframe width="420" height="315" src="http://www.youtube.com/embed/WvC47fVSPGU" frameborder="0" allowfullscreen></iframe>
<iframe width="420" height="315" src="http://www.youtube.com/embed/0oTi5aKdcmg" frameborder="0" allowfullscreen></iframe>
<iframe width="560" height="315" src="http://www.youtube.com/embed/akpYaDLuaUI?rel=0" frameborder="0" allowfullscreen></iframe>
</center>
@endhtmlonly
<div class="cgal_video_caption"> <a class="el" href="index.html#SModelingVideo_1">Video 1</a> Grouping of control vertices.</div>
\endhtmlonly
\subsection Surface_Modeling_Demo_Tutorial Demonstration for Deleting Control Vertices / ROI and Overwrite
@htmlonly
\anchor SModelingVideo_2
\htmlonly
<center>
<iframe width="420" height="315" src="http://www.youtube.com/embed/xPAG_AOLvU0" frameborder="0" allowfullscreen></iframe>
<iframe width="560" height="315" src="http://www.youtube.com/embed/1cpnkx_YG5E?rel=0" frameborder="0" allowfullscreen></iframe>
</center>
@endhtmlonly
<div class="cgal_video_caption"> <a class="el" href="index.html#SModelingVideo_2">Video 2</a>
Convergence: this video shows that upon fast changes of the positions of the control vertices,
more iteration steps are needed to reach the convergence.</div>
\endhtmlonly
\anchor SModelingVideo_3
\htmlonly
<center>
<iframe width="560" height="315" src="http://www.youtube.com/embed/-1rO-RdbudM?rel=0" frameborder="0" allowfullscreen></iframe>
</center>
<div class="cgal_video_caption"> <a class="el" href="index.html#SModelingVideo_3">Video 3</a> A complete example: changing the pose of a dinausor.</div>
\endhtmlonly
\section Surface_Modeling_Overview Deformation Techniques, Energies and Weighting Schemes
This section gives the theorical background to make the user manual self-contained
This section gives the theoretical background to make the user manual self-contained
and at the same time explains where the weights comes in. This allows advanced users
of this package to tune the weighting scheme by developing a model of the concept
`SurfaceModelingWeights` used in the class `Deform_mesh`.