1DTK_LOAD_VIDEO_TEST(3)        Draw Toolkit manual       DTK_LOAD_VIDEO_TEST(3)
2
3
4

NAME

6       dtk_load_video_test - Load an test video as a texture
7

SYNOPSIS

9       #include <dtk_video.h>
10
11       dtk_htex dtk_load_video_test(int flags);
12

DESCRIPTION

14       This function loads a test video file as a dynamic texture. The texture
15       will then been tracked by an internal texture manager so that the  next
16       call will return the same texture handle, thus sparing the resources of
17       the system.  If not specified by flags the video  will  not  be  played
18       immediately and dtk_video_exec(3) should be called to do start playing.
19
20       The argument flags is used to modify the creation. It should contains a
21       bitwise OR combination of the following flags:
22
23              DTK_AUTOSTART : Indicates that the video  should  start  immedi‐
24              ately after creation.
25
26              DTK_NOBLOCKING : Indicates that the creation function should not
27              block waiting that the video pipeline is fully running.
28
29       A dynamic texture can be used the same way as  a  static  texture  (for
30       example  image  file).  The  only difference is that the content of the
31       texture changes automatically with the stream of video. This means that
32       every time a shape using this texture is drawn, the latest frame avail‐
33       able from the video stream will be mapped on the shape.
34
35       There is no need for a valid window to create successfully  a  texture,
36       i.e.   creation  of textures are completely decoupled from the creation
37       of others resources and can even be created in one thread to be used in
38       another one.
39
40       Once  a  the  texture  is stopped being used, it should be destroyed by
41       dtk_destroy_texture(3).
42

RETURN VALUE

44       In case of success, the function returns the handle to the created tex‐
45       ture.  In case of failure, NULL is returned.
46

THREAD SAFETY

48       dtk_load_video_test() is thread-safe.
49

SEE ALSO

51       dtk_destroy_texture(3), dtk_video_exec(3), dtk_video_getstate(3)
52
53
54
55
56
57EPFL                                 2011               DTK_LOAD_VIDEO_TEST(3)
Impressum