blender/source/gameengine/VideoTexture
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
..
BlendType.h BGE: Making sure m_objType is initialized in the BlendType (VideoTexture) constructor. 2013-08-03 05:01:50 +00:00
blendVideoTex.cpp BGE: bge.texture API documentation enhancement 2015-07-06 21:48:25 +02:00
CMakeLists.txt Ghost Context Refactor 2014-10-07 15:47:32 -05:00
Common.h code cleanup: gpl header update (formatting) 2012-11-18 00:30:06 +00:00
Exception.cpp BGE: Making sure m_line is initialized in the Exception (VideoTexture) constructor. 2013-08-03 05:01:45 +00:00
Exception.h Code cleanup: doxy comments 2014-05-14 15:00:47 +10:00
FilterBase.cpp style cleanup 2013-03-29 06:21:28 +00:00
FilterBase.h style cleanup 2013-03-29 06:21:28 +00:00
FilterBlueScreen.cpp code cleanup: 2013-03-25 02:41:30 +00:00
FilterBlueScreen.h style cleanup 2013-03-29 06:21:28 +00:00
FilterColor.cpp style cleanup: 2013-03-26 07:29:01 +00:00
FilterColor.h code cleanup: gpl header update (formatting) 2012-11-18 00:30:06 +00:00
FilterNormal.cpp code cleanup: 2013-03-25 02:41:30 +00:00
FilterNormal.h style cleanup 2013-03-29 06:21:28 +00:00
FilterSource.cpp code cleanup: gpl header update (formatting) 2012-11-18 00:30:06 +00:00
FilterSource.h BGE: Making sure m_buffV, m_buffU, and m_pitchUV are initialized in the FilterYV12 constructor. 2013-08-03 05:01:40 +00:00
ImageBase.cpp missed last commit 2015-01-27 03:41:05 +11:00
ImageBase.h style cleanup 2013-03-29 06:21:28 +00:00
ImageBuff.cpp GSOC 2013 paint 2014-07-21 12:02:05 +02:00
ImageBuff.h code cleanup: gpl header update (formatting) 2012-11-18 00:30:06 +00:00
ImageMix.cpp style cleanup 2013-03-29 06:21:28 +00:00
ImageMix.h BGE: Making sure m_offset is initialized in the ImageSourceMix constructor. 2013-08-03 05:01:36 +00:00
ImageRender.cpp Fix 73841 : Game Engine - Camera Lens Shift 2015-06-29 10:45:27 -03:00
ImageRender.h BGE: Fix for precision lost in setBackground/getBackground at Video Texture 2015-06-16 00:05:25 +02:00
ImageViewport.cpp Ghost Context Refactor 2014-10-07 15:47:32 -05:00
ImageViewport.h style cleanup: 2013-03-26 07:29:01 +00:00
PyTypeList.cpp style cleanup 2013-03-29 06:21:28 +00:00
PyTypeList.h code cleanup: gpl header update (formatting) 2012-11-18 00:30:06 +00:00
SConscript Ghost Context Refactor 2014-10-07 15:47:32 -05:00
Texture.cpp Get rid og gluBuild2DMipmaps on game engine. 2015-03-16 16:18:37 +01:00
Texture.h Get rid of gluScaleImage in our game engine as well. 2015-02-27 14:47:39 +01:00
VideoBase.cpp style cleanup 2013-03-29 06:21:28 +00:00
VideoBase.h correction to previous warning cleanup, also quiet shadow-warning for thumbnail size 2013-04-05 00:10:33 +00:00
VideoFFmpeg.cpp BGE VideoTexture: refresh() on ImageFFmpeg should have no effect. 2014-12-04 23:55:53 +01:00
VideoFFmpeg.h BGE VideoTexture: refresh() on ImageFFmpeg should have no effect. 2014-12-04 23:55:53 +01:00