1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
|
# $Id$
"""
The VideoTexture module allows you to manipulate textures during the game.
Several sources for texture are possible: video files, image files,
video capture, memory buffer, camera render or a mix of that.
The video and image files can be loaded from the internet using an URL
instead of a file name. In addition, you can apply filters on the images
before sending them to the GPU, allowing video effect: blue screen,
color band, gray, normal map.
VideoTexture uses FFmpeg to load images and videos. All the formats and codecs
that FFmpeg supports are supported by VideoTexture, including but not limited to:
* AVI
* Ogg
* Xvid
* Theora
* dv1394 camera
* video4linux capture card (this includes many webcams)
* videoForWindows capture card (this includes many webcams)
* JPG
The principle is simple: first you identify a texture on an existing object using
the L{materialID} function, then you create a new texture with dynamic content
and swap the two textures in the GPU.
The GE is not aware of the substitution and continues to display the object as always,
except that you are now in control of the texture. At the end, the new texture is
deleted and the old texture restored.
Example:
import VideoTexture
import GameLogic
contr = GameLogic.getCurrentController()
obj = contr.getOwner()
# the creation of the texture must be done once: save the
# texture object in an attribute of GameLogic module makes it persistent
if not hasattr(GameLogic, 'video'):
# identify a static texture by name
matID = VideoTexture.materialID(obj, 'IMvideo.png')
# create a dynamic texture that will replace the static texture
GameLogic.video = VideoTexture.Texture(obj, matID)
# define a source of image for the texture, here a movie
movie = GameLogic.expandPath('//trailer_400p.ogg')
GameLogic.video.source = VideoTexture.VideoFFmpeg(movie)
GameLogic.video.source.scale = True
# quick off the movie, but it wont play in the background
GameLogic.video.source.play()
# you need to call this function every frame to ensure update of the texture.
GameLogic.video.refresh(True)
"""
def getLastError():
"""
Returns the description of the last error that occured in a VideoTexture function.
@rtype: string
"""
def imageToArray(image):
"""
Returns a string corresponding to the current image stored in a texture source object
@param image: Image source object.
@type image: object of type L{VideoFFmpeg}, L{ImageFFmpeg}, L{ImageBuff}, L{ImageMix}, L{ImageRender}, L{ImageMirror} or L{ImageViewport}
@rtype: string representing the image, 4 bytes per pixel in the RGBA order, line per line, starting from the bottom of the image.
"""
def materialID(object,name):
"""
Returns a numeric value that can be used in L{Texture} to create a dynamic texture.
The value corresponds to an internal material number that uses the texture identified
by name. name is a string representing a texture name with IM prefix if you want to
identify the texture directly. This method works for basic tex face and for material,
provided the material has a texture channel using that particular texture in first
position of the texture stack. name can also have MA prefix if you want to identify
the texture by material. In that case the material must have a texture channel in first
position.
If the object has no material that matches name, it generates a runtime error. Use try/catch to catch the exception.
Ex: VideoTexture.materialID(obj, 'IMvideo.png')
@param object: the game object that uses the texture you want to make dynamic
@type object: game object
@param name: name of the texture/material you want to make dynamic.
@type name: string
@rtype: integer
"""
def setLogFile():
"""
Does something
@rtype:
"""
def FilterBGR24():
"""
Does something
@rtype:
"""
def FilterBlueScreen():
"""
Does something
@rtype:
"""
def FilterColor():
"""
Does something
@rtype:
"""
def FilterGray():
"""
Does something
@rtype:
"""
def FilterLevel():
"""
Does something
@rtype:
"""
def FilterNormal():
"""
Does something
@rtype:
"""
def FilterRGB24():
"""
Does something
@rtype:
"""
def FilterRGBA32():
"""
Does something
@rtype:
"""
def ImageBuff():
"""
Does something
@rtype:
"""
def ImageFFmpeg():
"""
Does something
@rtype:
"""
def ImageMirror():
"""
Does something
@rtype:
"""
def ImageMix():
"""
Does something
@rtype:
"""
def ImageRender():
"""
Does something
@rtype:
"""
def ImageViewport():
"""
Does something
@rtype:
"""
def Texture():
"""
Does something
@rtype:
"""
def VideoFFmpeg():
"""
Does something
@rtype:
"""
|
