blender/doc/python_api/rst
Quentin Wenger 6ed1a1abe2 BGE: bge.texture API documentation enhancement
This patch attempts to improve and review the documentation of bge.texture, as requested in the [[ http://wiki.blender.org/index.php/Dev:2.5/Source/Development/Todo/GameEngine#Video_Texture | TODO list ]].

More specifically, it

  - fixes the rst syntax, including titles of the examples bge.texture.py and bge.texture.1.py;

  - adds, standardizes and reviews description of the API elements, particularly signatures, types, etc.

  - adds SOURCE_* constants to the doc

  - splits the doc into thematical parts (Video, Image, Texture, and Filter Classes, Functions, Constants).

Notes:

  - The parameter "mode" of ImageBuff.plot has to be described better. Actually, the whole set of IMB_BLEND_* constants (from IMB_imbuf.h) should be exposed to Python. I'll do that in a future diff, and complete the doc at the same moment (adding those IMB_BLEND_* constants to the Constants part of this doc).

  - The option of using webcams in VideoFFmpeg is still particularly not well documented. I am planning to make a proposal about fixing T18634 (and its corresponding TODO in the list) by integrating OpenCV in the BGE (and Blender?). The idea would then probably be to add a new class, f.ex. ImageWebcam, making this functionnality more specialized. So for now I don't think it is worth to document that part much.

This patch fixes T44284 too.

Reviewers: moguri, kupoman, campbellbarton, panzergame, lordloki

Reviewed By: panzergame, lordloki

Subscribers: hg1

Projects: #game_engine, #game_python, #documentation

Maniphest Tasks: T44284

Differential Revision: https://developer.blender.org/D1352
2015-07-06 21:48:25 +02:00
..
bge_types BGE: Extend Python API for KX_BlenderMaterial (specular, diffuse…) 2015-07-03 11:47:48 +02:00
bge.app.rst BGE: Fix T43918: adding submodule bge.app including attribute version. 2015-06-15 21:46:56 +02:00
bge.constraints.rst BGE: Fix 57065a, missing dots. 2015-06-23 14:57:38 +02:00
bge.events.rst BGE doc cleanup: Some small cleanups in the BGE docs: 2014-03-31 22:22:04 -07:00
bge.logic.rst BGE: Fix 2dfilter actuator mode constants. 2015-06-24 15:31:55 +02:00
bge.render.rst BGE: New API method getDisplayDimensions 2015-04-07 18:32:25 +02:00
bge.texture.rst BGE: bge.texture API documentation enhancement 2015-07-06 21:48:25 +02:00
bge.types.rst BGE: Splitting up the bge.types docs so they are not all on the same page. This should make them much easier to browse. 2013-02-10 06:13:26 +00:00
bgl.rst Documentation update: references to OpenGL tutorials in the python bgl module 2015-02-21 12:16:19 +00:00
change_log.rst update autogenerated changelog. also correct typos in the generator. 2013-05-09 01:58:49 +00:00
gpu.rst Syntax correction for gpu docs, D124 2013-12-23 17:24:23 +11:00
include__bmesh.rst BMesh Py API: add bmesh.geometry.intersect_face_point() 2013-12-06 21:15:56 +11:00
info_api_reference.rst update hand written rst docs 2015-06-18 08:00:46 +10:00
info_best_practice.rst update hand written rst docs 2015-06-18 08:00:46 +10:00
info_gotcha.rst Make python gotchas more clear (regarding handling of stale data) 2015-04-13 11:00:22 +02:00
info_overview.rst update hand written rst docs 2015-06-18 08:00:46 +10:00
info_quickstart.rst update hand written rst docs 2015-06-18 08:00:46 +10:00
info_tips_and_tricks.rst update hand written rst docs 2015-06-18 08:00:46 +10:00
info_tutorial_addon.rst update hand written rst docs 2015-06-18 08:00:46 +10:00