DI-Guy SDK Documentation  13.2
diguy_module_facefx.h
Go to the documentation of this file.
1 
2 /*********************************************************************
3  ** Copyright (c) 1992-2019 VT MAK
4  ** All rights reserved.
5  *********************************************************************/
6 
7 /*********************************************************************/
14 #ifndef __diguy_module_facefx_H
15 #define __diguy_module_facefx_H
16 
17 #include <declspec_diguy.h>
18 
19 extern "C" {
20 
21 
22 #include "bdiFaceFxInit.h"
23 
24 
25 /*****************************************************************************/
31 /*l
32  *b Description:
33  **
34  ** Fills out the init structure with default values. Selected entries can
35  ** then be changed before calling diguy_facefx_initialize().
36  **
37  ** The bdiFaceFxInit init structure has the following entries:
38  **
39  *a int placeholder - a placeholder value; ignored
40  **
41  *b Returns:
42  **
43  ** 0 on success, -1 on failure
44  */
45 BDI_DECLSPEC_diguy
46 int diguy_facefx_get_defaults(bdiFaceFxInit* init);
47 
48 
49 /*l
50  *b Description:
51  **
52  ** This function tells DI-Guy that it should make use
53  ** of expressive face software for animating character faces.
54  **
55  ** It should be called along with the other diguy_initialize_*
56  ** calls.
57  **
58  *b Arguments:
59  **
60  *a init - initial settings for the expressive face software; passing NULL
61  *a for the init structure will cause defaults to be
62  *a used for all values
63  **
64  ** Use diguy_facefx_get_defaults() to fill out the init structure
65  ** before changing specific entries.
66  **
67  *b Returns:
68  **
69  ** 0 on success, -1 on failure
70  **
71  *b Example:
72  **
73  *e diguy_ogl_initialize(NULL);
74  *e diguy_facefx_initialize(NULL);
75  */
76 BDI_DECLSPEC_diguy
77 int diguy_facefx_initialize(bdiFaceFxInit* init);
78 
79 /*l
80  *b Description:
81  **
82  ** This function tells DI-Guy that it should shut down the expressive face
83  ** software extensions. It should be called
84  ** along with the other diguy_deinitialize_* calls.
85  **
86  *b Returns:
87  **
88  ** 0 on success, -1 on failure
89  **
90  *b Example:
91  **
92  *e diguy_deinitialize();
93  *e diguy_facefx_deinitialize();
94  */
95 BDI_DECLSPEC_diguy
96 int diguy_facefx_deinitialize();
97 
98 } /* end extern "C" */
99 
100 
101 #endif /* __diguy_module_exface_H */
102 
103 
104 /*********************************************************************
105  ** Copyright (c) 1992-2019 VT MAK
106  ** All rights reserved.
107  *********************************************************************/
108 
bdiFaceFxInit
Definition: bdiFaceFXInit.h:16
declspec_diguy.h
diguy_facefx_deinitialize
int diguy_facefx_deinitialize()
This function tells DI-Guy that it should shut down the expressive face software extensions.
diguy_facefx_initialize
int diguy_facefx_initialize(bdiFaceFxInit *init)
This function tells DI-Guy that it should make use of expressive face software for animating characte...
diguy_facefx_get_defaults
int diguy_facefx_get_defaults(bdiFaceFxInit *init)
Fills out the init structure with default values.