SVN maintenance.
[blender.git] / doc / python_api / examples / bge.texture.py
1 """
2 Basic Video Playback
3 ++++++++++++++++++++++
4 Example of how to replace a texture in game with a video. It needs to run everyframe
5 """
6 import bge
7 from bge import texture
8 from bge import logic
9
10 cont = logic.getCurrentController()
11 obj = cont.owner
12         
13 # the creation of the texture must be done once: save the 
14 # texture object in an attribute of bge.logic module makes it persistent
15 if not hasattr(logic, 'video'):
16         
17     # identify a static texture by name
18     matID = texture.materialID(obj, 'IMvideo.png')
19                 
20     # create a dynamic texture that will replace the static texture
21     logic.video = texture.Texture(obj, matID)
22
23     # define a source of image for the texture, here a movie
24     movie = logic.expandPath('//trailer_400p.ogg')
25     logic.video.source = texture.VideoFFmpeg(movie)
26     logic.video.source.scale = True
27                 
28     # quick off the movie, but it wont play in the background
29     logic.video.source.play()
30
31 # you need to call this function every frame to ensure update of the texture.
32 logic.video.refresh(True)