Merging r38237 through r38264 from trunk into soc-2011-tomato

Wrong tooltip for OBJECT_OT_make_links_scene() operator.

Bugfix #27761

Material nodes: when no output node was active, it sets one.
Not common to happen anymore, only for deleting output nodes
without clicking on nodes.

ghost multi-test builds again, now uses BLF font library

Fix #27888: Render artifacts in 2.58.1

It was a regression introduced in rev36301. Average normal calcilation
used to fail due to triangular faces which are too slight.

Do not use triangles with too small area for average normal calculation.

fix [#27915] Relax Pose crashes blender on bone with ChildOf constraint in linked rig

Fox #27866: Curve handle snaps/locks when it shouldnt

It was a precision error in calchandleNurb. Do not align handles
along handle which si too short.

== GPU Buffers ==

This patch attempts to clean up and document the GPU buffers
code. There are a few bug fixes as well.

Patch reviewed here: http://codereview.appspot.com/4631052/

Summary:

* Bugfix: make GPU_buffer_copy_normal convert from shorts to floats
  correctly, also fixed the use of cached face normal CustomData.

* Bugfix: changed the `mat_nr' field of GPUBufferMaterial from char to
  short.

* Changed color buffer setup to not alloc a temporary copy of color
  data, just passes the MCol data in directly.

* Changed the GPU buffer pool code to make clearer what operates
  specifically on the global pool.

* Lots of refactoring for GPU_drawobject_new; should operate mostly
  the same (except got rid of one unecessary allocation), just split
  into more functions and without macros now.

* Converted some #defines into enumerations.

* Made some stuff private, pulled out of header file.

* Deleted unused function GPU_buffer_pool_free_unused().

* Removed GPU_interleaved_setup and related #defines. (I think this
  was used for editmode VBOs, but those were disabled.)

* Added lots of comments.

* Added a few comments in the code signed `--nicholas' to note places
  where I am unsure about design or usage, would be good to address
  these better.

* Code formatting changed to be more consistent with the rest of
  Blender.

* Renamed some fields and variables to be more consistent with
  Blender's naming conventions.

* Renamed some fields and variables to use more descriptive names,
  e.g. renamed `redir' to `mat_orig_to_new'.

* Removed print outs with DEBUG_VBO -- don't feel too strongly about
  this one, just not used elsewhere in Blender, could be easily added
  back if others disagree though.

* Moved the PBVH drawing code down to the bottom of the file, before
  was sitting in the middle of the other VBO code

Camera tracking integration
===========================

- Made settings for tracking non-animatable.
- Fixed crash when enabling/disabling markers from
  "Specials" menu.
- Translate all coords to make first reconstructed camera
  be at position (0,0,0).
- Blender's camera now affects on reconstructed data.
  Bundles are "parented" to active scene camera. So now
  bundles' could could be scaled and rotated when camera
  is rotating/scaling.

Merging r38220 through r38236 from trunk into soc-2011-tomato

Fix #27897: mesh with negative scale disappears while sculpting, clipping
planes were wrong in that case.

Fix #26962: softbody collision doesn't respect subsurf+displace modifiers.

Softbody was still using a flag to determine if it should use the final or
deform derivedmesh, but this wans't exposed in the UI. Others systems use the
collision modifier, now softbody uses it also to get vertices and faces, but
with own collision code.

Fix #27900: file browser filter, sort, .. parameters were not saved. This is
useful if you have a screen setup with a file browser editor.

Fix #27891: IK stretch gives inaccurate results. Tweaked translation segment
convergence weight a bit to match angles better at typical scales.

Fix #27902: autokey bones with individual origins transform not working.

Camera tracking integration
===========================

- 32 bit linux compilation should be fixed now.
- Camrea reconstruction data should be better now
  when there's no reconstructed cameras.
- Implemented "Set Origin" operator
- Added "Specials" W-key menu for SpaceClip.
  Supports such operators:
  * Enable track
  * Disable track
  * Set origin

Merging r38197 through r38219 from trunk into soc-2011-tomato

example of Physics Constraints module :)
+ some small fixes in other docs.

A topic for later(soon?), I think we should name the modules according to the rest of Blender modules. So instead of:
Game Engine bge.logic Module

We would have it:
Game Logic (bge.logic)
...

fix issue raised by [#27819] Unwrap Menu (U) -> Lightmap Pack throws Python Exception.   But use a different fix.

patch [#27885] bge.constraints documentation
by Solano Felicio (solano)

fix for example

bge.texture doc, needed whitespace to format correctly.

Camera tracking integration
===========================

- Disallow negative size for bundles.
- Fixed bug with passing disabled markers to solver.

some corrections to bge.texture docs

Camera tracking integration
===========================

- ColaMD moved from OpenNL to extern/.
  It'll be needed for libmv. Also, it's a bit updated from
  year 1999 to 2007.
  Need to be tested for regressions.
- Updated bundling script for libmv. Now it uses fuller
  subset of this library.
- Bundled new libmv.
- Request from Keir: add command line argument to toggle logging
  stuff on. Currently, if Blender is launched with -d argument
  libmv would start printing logging messages. There's no
  argument to increase verbosity, but there's API in libmv-capi,
  so it'll be easy to add.
- Finally fixed crash when ibuf is acquiring with user=NULL.
- Added ActiveClip property to the scene. This clip is used
  as default value for new match-moving constraints.
- Added some flags to Display panel of View3D. Related on
  displaying match-moving stuff.
- Internal change: bundles data moved inside to MovieTrackingTrack.
- Initial implementation of 3d reconstruction.
- Added constraint "Camera Solver". This constraint is supposed
  to be used to make camera follow the reconstructed camera path.
- Added "reference" property to "Follow Track" constraint.
  Now object could be "parented" to 2D track position or to
  3D bundle position.

The very quick guide:

To use reconstruction you should have footage with tracked markers,
choose two keyframes in "Tracking settings" panel. There should be
quite noticeable parallax effect between this two frames. This
is used to initialize reconstruction stuff.
Camera data (focal length and optical center) should be filled in
"Camera Data" panel. Optical center is often the center of image,
so it'll be filled in automatically.
You should also set values for undistortion (K1, K2 and K3). Currently,
there's no any visualization for this parameters and approach of
"change value -> reconstruct -> see what've changed" is the only way
for now.
Libmv team is working on auto-calibration tool, so it should be
easier to gather this coefficients in nearest (i hope) future.
There's also no scene orientation stuff.

Basic workflow:
- Open footage.
- Set markers and track them.
- Fill in camera data and keyframes.
- Hit "Solve Camera" button.
- Add "Camera Solver" constraint to camera in scene.
- Choose movieclip in that constraint.
- To see bundles in 3D viewport active clip should be set
  in scene buttons.

Merging r38036 through r38196 from trunk into soc-2011-tomato

Allow pose matrix to be set for Benjy Cook's GSOC project.
this uses the same function as pose mode snapping.

Fix compile with scons, after thread commit in r38185

Fix part of #26811: absolute shape keys should not show influence value in list.

The Blenderplayer wasn't freeing GPU_Textures since according to BLI_threads, GPU_free_image() was never being called from the main thread. Calling BLI_threadapi_init() when the Blenderplayer starts sets the current thread as the main thread and solves the problem.

Tiny tweak: hierarchy lines in outliner were nearly invisible. Color is
blend between backdrop and text color (black), made it blend 0.4 instead
of 0.2

[#27854] Collada import doesn't handle UVW mapping
Reported by David Roy
Patch by Brecht van Lommel

UV import code wasn't taking possible stride into account (always assuming stride==2), thus reading UV coords totally wrong.

The material index did not work when FSAA was turned on.
The information was written in the temp exr files, but was not read back.
After checking I saw that the pass was not merged back in the rendercore.

After adding this it worked. tested with all FSAA settings.

Fix #27879: sequencer didn't draw overlapping strips well, selected were drawn
under unselected, and active strips red border color for active strips was not
clear enough.

Fix #27883: object actions did not get duplicated on full scene copy.

Ergh! first compile and test then commit!

Making Blender compile for C90 standard, var declared after code :)

Also cleaned a line of code that was horribly spread over 4 lines.

Fix #27880: sequencer separate images operator lost strip properties like
blend mode, opacity, etc.

Fix #27877: writing .avi files > 4 GB not working on windows.

Solution is to replace "long" by "int64_t" and "fseek" by "_fseeki64", because
long on 64 bit windows is still 32 bit.

Fix #27876: particles instancing a whole group didn't take group offset into account.

Fix #27875: different texture nodes result after decompose/compose.

Fix #27873: nan pixels in render with degenerate faces.

an example for blf - a basic Hello World (for bge, not blender)

new example for bge.texture, a basic texture replacement
fresh simple and didactic example straight from my bge book, enjoy it ;)
video texture documentation online ... tears dropping.

moving bge.texture example to an external file

patch [#27871] bge.texture documentation from Solano Felício (+ changes from me) it still needs work
... and I can't test rst in windows so for now let's pretend it builds. If someone can generate the docs and see how it goes please let me know.

(plus a small fix for bge.logic rst)

Fix #27865: weird mouse warping with continuous grab on OS X.

Fix #27777: vertex color disabled when in a reused node material.

Patch #27829: fix X11 compile problem due to missing XF86XK_AudioForward define
on Debian Lenny. Patch by "dungeoneer".

Patch #27842: build fix for solaris, missing finite(). Patch by A. Hettinger.

Fix small part of #27815: recognize m2ts as video file extension.

Fix #27848: sequencer strip hard cut looses soft trim on second strip.

Fix compile for msvc (broken in r38119)

Fix #27855: crash on enabling high resolution smoke.

Wavelet tile generation code was reading outside of array bounds, and as a
result could give a noise.wavelets file with nan values. Now that problem
is fixed, and existing files with nan are ignored.

Fix part of #27858: crash trying to apply subsurf modifier as shape key,
fix found by Bastian Schreiber.

Fix #27826: bone envelope head/tail radius not dynamically updated in viewport.

Fix #27846: time extend / E key not work in sequence editor.

Fix #27810: bones drawn blue in 2.49 file, was still checking stride bone
flag for drawing even though that feature is no longer in 2.5.

Fix #27863: converting curve spline type from python crashes.

Fix: #27861 bevel angle limit at 90° wasn't working well on cube, tweaked
epsilon value to be a bit smaller.

fix [#27862] OpenGL render animation don't respect .png RGB option.

Fix for [#27182] particle/collision kill interacting strangely
* Particle die time wasn't taken correctly into account in certain situations when calculating dynamics.

Fix for [#27579] Particles Cache Problem
* Horrors from the ancient world of deprecated code: object animation offset can't really work correctly with particles unless point cache takes full control of particle system timing.
* Disabled the non-working offset control from effecting particles so that for now particles will work consistently and the offset is only applied to the object.

Fix for [#27347] Particle x-axis mirror editing not working as expected.
* The x-mirror editing didn't mirror strand lengths.

blenderplayer bundle in OSX doesn't need script folder (untested)
I can't test this here, somehow blender+scons is failing in my building env.
but it should work. Basically it skips the copy of the script folder for the blenderplayer.app

I will test it once buildbot get pass this review ;)

Updated the indent, sorry!

====== Proposal: Nodes property windows enhancement ======

===== Situation before this patch =====

in the current situation inside the node editor there is a properties panel (press 'n'-key). This pabel displays some information about the node, backdrop and grease pencil. The UI of the property panel is typically vertical oriented. Nodes in the other hand are not oriented in a direction. Both area's are draw via the same draw function.

With some nodes this will create not user-friendly UI. Try the color-balance for instance). The 3 color circles are drawn next to each other, it would be better to draw them below each other.

When creating more complex nodes you don't want to display all handles in the node-panel and in the properties panel. For instance fine-tuning handles you only want to appear in the property panel to reduce place in the node itself.

===== Situation after this patch  =====

This patch separates the draw functions of the property panel and the node panel.
When no special draw function is created for the property panel, the draw function of the node will be used as 'fallback'

===== Impact =====

==== BKE_node.h ====

add a new uifunc (called uifuncbut) to the bNodeType struct. The definition is the same as the uifunc.

==== node_buttons.c ====

if the uifuncbut is set, call it. currently calls the uifunc method

==== drawnode.c ====

static void node_composit_set_butfunc(bNodeType *ntype). set the uifuncbut function where needed. When at the end of the method uifuncbut is still empty, set uifuncbut to the uifunc.

===== Final note =====

! PS. this is not limited to the compositor it also works for Materials and Textures !
! PPS. For other branching creating their own node-tree. Please make sure that your uifuncbut is set NULL or a valid draw function !

Current situation

A mesh can consist out of multiple material. Take a character with clothing's. the skin can be a different material as the different clothing's. During compositing it is a common use-case to only do a part of the composit on only a specific material. Currently this can not be done.

In blender movies this feature is known to be implemented, but until now it never got integrated into trunk.
Proposal

With material index the Blender internal renderer will be capable of creating a buffer containing the material indexes of the first pixel-hit. This will be implemented in the same manner as the object index.

In the compositor the ID Mask node can be used to extract the information out of the Render pass.
Impact
User interface

On the properties-space the next changes will be done

    Scene⇒Render layer⇒Passes⇒Material index will be added
    Material⇒Options⇒Pass index will be added

DNA

    Material struct will get an new field called “index”. this will be a short-type.
    Material struct the field pad will be removed.
    A new Render-layer pass will be added (bit 1«18)

RNA

    Material RNA is updated (based on “pass index” from object)
    Render layer RNA is updated (based on IndexOB)

Blender internal renderer

The Blender internal renderer will process the render pass as a copy of the Object index.
Blender compositor

The render layer input will get a new output socket called “IndexMA”
Usage

An example on how to use material index can be found at:

https://svn.blender.org/svnroot/bf-blender/trunk/lib/tests/compositing/composite_materialindex.blend

This is also example of a commit message longer than the commit itself :)

bind marker camera now uses active object rather then scene camera (was requested a few times)

Fix #27849: 3D manipulator widget lost on mesh in edge mode.

The manipulator was always using vertex selection flags, but those are only
valid in vertex mode, as selection flag flushing only happens in the direction
vertex -> edge -> face. Now use edge/face selection flags when needed.

Paths: remove some temporary code that was only needed for 2.57.

Fix #27785: blenderplayer + eltopo linking error.

Bug report (IRC)

Knife cut with long mouse trails failed, increased max amount of input points
4 fold (1024).

Fix #27850: keyboards with a comma instead of a dot on the numpad now get
converted to a dot when typing into number buttons, for easier number entry.

Apply patch 4636051. COLLADA: Export selection.
Original patch by Jan Diederich, adapted by Pelle Johnsen. Review assistance by Daniel Tavares.

This patch adds an option to export only the selection.

fix for own error in intersect_line_sphere_2d(), using 3d function on 2d vectors

fix for crash when setting layers or saving when there is no active scene - only really happens when running python scripts on startup.

fix for building WITH_PYTHON_MODULE

As per discussion: allow bone transforms again for proxy'ed bones.

CMake file to build ghost tests again.

changed the max decimal points to show from 7 to 6, since with float precision problems the median point of a selection could be 0.0000003

fix 2 bugs in project from view from a camera object
- panorama mode was scaled 2x too high.
- scaled camera objects would incorrectly effect the result.

fix [#27839] UV 'Project from view' ignores camera lens shift

fix for python error when pinning a non mesh object in mesh editmode.

fix for error when moving module, broke fracture tools and select internal face operator.

Camera tracking integration
===========================

- Removed TRACK_PROCESSED flag which is actually unneeded now.
- When libmv fails to track marker for next frame, add marker
  for new frame with old position and set it up as Disabled.
- "Break" track path when markers sequence is "broken".
  This means path wouldn't be drawed over frames, during which
  racking object was lost.
- Update Properties Editor for SpaceClip during playback.
  Track preview button should now update nicely.

Camera tracking integration
===========================

- Fixed bug with swapped width/height used for per-pixel cycle
  when disabling color channel to be used for tracking.
- Marker preview is now using sub-pixel precision.
- Tracking stuff uses the same imbug generation function
  as preview area does. Sub-pixel precision should be ok
  now here too.

Merging r38023 through r38035 from trunk into soc-2011-tomato

fix for error in cmake files

Camera tracking integration
===========================

- Removed unneeded checking of marker==NULL
- Tracks could be named now.
- Implemented "Follow Track" constraint to "parent"
  objects to tracks from movie clip.
- Added operator to create such constraint for active object
  using clip and track from current context.

Merging r37952 through r38022 from trunk into soc-2011-tomato

fix for building headless

Packaging variable named 'a' for release

update checksums for x3d tests

quick explode failed if executed with no active object

uv mirror poll function wasnt checking UV's were available on the mesh.

cmake was installing text as a directory rather then coping the files within it.

minor pep8 edits

add 'bgl' OpenGL doc to sphinx

moving BGL to rst format, first move file.