Animation Docs clean up #46430

New Issue

Aaron Carlisle · 2015-10-09T18:31:14+02:00

Aaron Carlisle commented

2015-10-09 18:31:14 +02:00

Short description of error

There are multiple animation pages with no text:

http:www.blender.org/manual/animation/techs.html- I think can be removed*http:www.blender.org/manual/animation/techs/object.html - I think can be removed
http:www.blender.org/manual/animation/techs/shape.html- I think can be removedhttp:www.blender.org/manual/animation/techs/shape/shape_keys/editing.html
http://www.blender.org/manual/animation/techs/shape/shape_keys/animating.html
http:www.blender.org/manual/animation/techs/shape/shape_keys/examples.html- I think can be removedhttp:*www.blender.org/manual/animation/techs/shape/indirect_animation.html
http://www.blender.org/manual/animation/techs/armatures.html
http://www.blender.org/manual/animation/techs/armatures/mocap.html

**Short description of error** There are multiple animation pages with no text: http:*www.blender.org/manual/animation/techs.html*- I think can be removed*http:*www.blender.org/manual/animation/techs/object.html *- I think can be removed* http:*www.blender.org/manual/animation/techs/shape.html*- I think can be removed*http:*www.blender.org/manual/animation/techs/shape/shape_keys/editing.html http://www.blender.org/manual/animation/techs/shape/shape_keys/animating.html http:*www.blender.org/manual/animation/techs/shape/shape_keys/examples.html*- I think can be removed*http:*www.blender.org/manual/animation/techs/shape/indirect_animation.html http://www.blender.org/manual/animation/techs/armatures.html http://www.blender.org/manual/animation/techs/armatures/mocap.html

Aaron Carlisle commented

2015-10-09 18:31:14 +02:00

Changed status to: 'Open'

Aaron Carlisle commented

2015-10-09 18:31:14 +02:00

Added subscriber: @Blendify

Aaron Carlisle commented

2015-10-09 19:08:32 +02:00

Added subscriber: @JoshuaLeung

Aaron Carlisle self-assigned this 2015-10-12 22:05:17 +02:00

Aaron Carlisle changed title from ~~Many Missing Animation pages~~ to Animation Docs clean up

2015-10-12 22:11:33 +02:00

Aaron Carlisle removed their assignment 2015-10-13 15:43:06 +02:00

koil commented

2015-10-13 20:51:27 +02:00

Added subscriber: @koilz

koil commented

2015-10-13 20:51:27 +02:00

I thought something like this below, for the camera page, may be a better read for animators.
But im not sure about the content.

Camera Animation

These are some basic tools and properties animators may use for the camera.

Switching Cameras

Switching cameras is done with the Timeline operator 'Bind Camera to Markers'.

The triangle above the camera will become shaded when active.

First in the Timeline, add a set of markers used to switch cameras.
Press M to add marker, then Ctrl M to rename, duplicated markers should retain the same name.

(1) In the 3D View, select the Camera the Markers will switch to.
(2) In the Timeline, select the Marker(s) to switch to the Camera.
(3) In the Timeline, press Ctrl B to Bind Cameras to Markers.

Camera Properties

The camera has a set of properties and tools via the Properties Editor.

These properties can be animated to produce various effects.

Pointing Cameras

.. add some methods

Moving Cameras on a Path

With animation, it can be easier to move cameras on a path, see "http://blender.org/manual/animation/techs/object/path.html" for more info.

I thought something like this below, for the camera page, may be a better read for animators. But im not sure about the content. ---------------- **Camera Animation** These are some basic tools and properties animators may use for the camera. **Switching Cameras** Switching cameras is done with the Timeline operator 'Bind Camera to Markers'. The triangle above the camera will become shaded when active. ![anim_camera_bind.png](https://archive.blender.org/developer/F244752/anim_camera_bind.png) First in the Timeline, add a set of markers used to switch cameras. Press M to add marker, then Ctrl M to rename, duplicated markers should retain the same name. (1) In the 3D View, select the Camera the Markers will switch to. (2) In the Timeline, select the Marker(s) to switch to the Camera. (3) In the Timeline, press Ctrl B to Bind Cameras to Markers. **Camera Properties** The camera has a set of properties and tools via the Properties Editor. ![anim_camera_prop.png](https://archive.blender.org/developer/F244754/anim_camera_prop.png) These properties can be animated to produce various effects. **Pointing Cameras** .. add some methods **Moving Cameras on a Path** With animation, it can be easier to move cameras on a path, see "http://blender.org/manual/animation/techs/object/path.html" for more info. ----------------

Campbell Barton commented

2015-10-14 07:55:24 +02:00

Added subscriber: @ideasman42

Campbell Barton commented

2015-10-14 07:55:24 +02:00

Agree this can be cleaned up. But think its not always needed to immediately remove place-holder content.

Instead, if someone is adding the documentation - they can make the decision on what to remove and keep.

(Note that animation/techs is a bit of strange organization... what belongs in animation/techs/armatures compared to manual/rigging/armatures for eg?).

We could also remove all animation/techs and then think of the best place to add docs for shape-keys, animating cameras etc.

Suggest to remove subdirectories (basics, techs) and simply have:

%%%############

Animation

.. toctree::

 :maxdepth: 2

 introduction.rst
 key_frames.rst
 keying_sets.rst
 actions.rst
 drivers.rst
 markers.rst
 motion_paths.rst

 shape_keys.rst
 camera_animation.rst

%%%

Agree this can be cleaned up. But think its not always needed to immediately remove place-holder content. Instead, if someone is adding the documentation - they can make the decision on what to remove and keep. (Note that `animation/techs` is a bit of strange organization... what belongs in `animation/techs/armatures` compared to `manual/rigging/armatures` for eg?). We could also remove all `animation/techs` and then think of the best place to add docs for shape-keys, animating cameras etc. ---- Suggest to remove subdirectories (basics, techs) and simply have: %%%############ ``` Animation ``` **** .. toctree:: ``` :maxdepth: 2 ``` ``` introduction.rst key_frames.rst keying_sets.rst actions.rst drivers.rst markers.rst motion_paths.rst ``` ``` shape_keys.rst camera_animation.rst ``` %%%

Sergey Sharybin commented

2015-10-14 20:53:43 +02:00

Added subscriber: @Sergey

koil commented

2015-10-14 22:53:02 +02:00

I think its nice to reference the 2.4 anim tech pages.. somewhere, for if people want to copy or rewrite them.
http://wiki.blender.org/index.php/Doc:2.4/Manual/Animation/Techs

..

For the armature.
The armature to a rigger is a system which has to be setup so its easy for the animator to use.
The armature to an animator, is a genric object which can be keyframed, posed, animated.
Tools like Armature Ghost, Pose Library, Keying Sets, Motion Capture, Moving objects on a Path, are used more by animators.

I think its nice to reference the 2.4 anim tech pages.. somewhere, for if people want to copy or rewrite them. http://wiki.blender.org/index.php/Doc:2.4/Manual/Animation/Techs .. For the armature. The armature to a rigger is a system which has to be setup so its easy for the animator to use. The armature to an animator, is a genric object which can be keyframed, posed, animated. Tools like Armature Ghost, Pose Library, Keying Sets, Motion Capture, Moving objects on a Path, are used more by animators.

koil commented

2015-10-15 14:06:15 +02:00

I found its best to use the track to constraint to keep the camera focused.

I added an rst file for the camera page, and one more picture.
The page uses the 3 pictures and the dolly zoom video from the original page.

Im not great at making patches, so I probably wont update the manual myself.

camera.rst

..

I like the idea of removing the sub directories (basics, techs), but I think the 2.4 tech pages should be referenced somewhere, maybe if its just in a tracker task or something.

I found its best to use the track to constraint to keep the camera focused. I added an rst file for the camera page, and one more picture. The page uses the 3 pictures and the dolly zoom video from the original page. Im not great at making patches, so I probably wont update the manual myself. [camera.rst](https://archive.blender.org/developer/F245164/camera.rst) ![anim_camera_track.png](https://archive.blender.org/developer/F245165/anim_camera_track.png) .. I like the idea of removing the sub directories (basics, techs), but I think the 2.4 tech pages should be referenced somewhere, maybe if its just in a tracker task or something.

Campbell Barton commented

2015-10-19 04:56:26 +02:00

Removed rBM818,

techs/lamp.rst
techs/camera.rst
techs/material.rst

Their style was not at all in keeping with a reference manual. also since so many attributes can be animated, dont think we need docs on animating specific data - unless they have special behavior - like armatures.

Removed rBM818, - techs/lamp.rst - techs/camera.rst - techs/material.rst Their style was not at all in keeping with a reference manual. also since so many attributes can be animated, dont think we need docs on animating specific data - unless they have special behavior - like armatures.

Campbell Barton commented

2015-10-23 06:38:41 +02:00

Changed status from 'Open' to: 'Resolved'

Campbell Barton closed this issue

2015-10-23 06:38:41 +02:00

Campbell Barton self-assigned this 2015-10-23 06:38:41 +02:00

Campbell Barton commented

2015-10-23 06:38:41 +02:00

rBM852: Committed re-organization/removal of dummy pages.

Note that dummy pages can be OK if they form some agreed on structure that just needs filling in.
But in this case it wasn't really helping to keep them around (IMHO) since its been years without having content added.
So its probably easier just to remove and add pages as we need.

rBM853: Added the camera animation page from @koilz, but removed most of the content on Moving/Positioning Cameras.
It turned we had camera navigation docs in 2 places already:
(manual/render/camera/introduction & manual/editors/3dview/navigate/camera_view),
So moved most out of render, and link to these pages instead.

See animation index:
https://www.blender.org/manual/animation/index.html

Closing this task as resolved, further work can be done here, but think the clean-up part is done.

rBM852: Committed re-organization/removal of dummy pages. Note that dummy pages can be OK if they form some agreed on structure that just needs filling in. But in this case it wasn't really helping to keep them around (IMHO) since its been years without having content added. So its probably easier just to remove and add pages as we need. ---- rBM853: Added the camera animation page from @koilz, but removed most of the content on **Moving/Positioning Cameras**. It turned we had camera navigation docs in 2 places already: (`manual/render/camera/introduction` & `manual/editors/3dview/navigate/camera_view`), So moved most out of render, and link to these pages instead. ---- See animation index: https://www.blender.org/manual/animation/index.html Closing this task as resolved, further work can be done here, but think the clean-up part is done.

Sign in to join this conversation.

No Label

Download

What's New

Blender Studio

Manual

Developers Blog

Documentation

Benchmark

Blender Conference

Development Fund

One-time Donations

Animation Docs clean up #46430