image format arg parsing for creator.c
[blender.git] / doc / python_api / examples / bge.texture.1.py
1 """
2 Texture replacement
3 ++++++++++++++++++++++
4 Example of how to replace a texture in game with an external image.
5 createTexture() and removeTexture() are to be called from a module Python
6 Controller.
7 """
8 from bge import logic
9 from bge import texture
10
11
12 def createTexture(cont):
13     """Create a new Dynamic Texture"""
14     object = cont.owner
15
16     # get the reference pointer (ID) of the internal texture
17     ID = texture.materialID(object, 'IMoriginal.png')
18
19     # create a texture object
20     object_texture = texture.Texture(object, ID)
21
22     # create a new source with an external image
23     url = logic.expandPath("//newtexture.jpg")
24     new_source = texture.ImageFFmpeg(url)
25
26     # the texture has to be stored in a permanent Python object
27     logic.texture = object_texture
28
29     # update/replace the texture
30     logic.texture.source = new_source
31     logic.texture.refresh(False)
32
33
34 def removeTexture(cont):
35     """Delete the Dynamic Texture, reversing back the final to its original state."""
36     try:
37         del logic.texture
38     except:
39         pass