rev |
line source |
nuclear@0
|
1 #ifndef GOAT3D_H_
|
nuclear@0
|
2 #define GOAT3D_H_
|
nuclear@0
|
3
|
nuclear@0
|
4 #include <stdio.h>
|
nuclear@0
|
5 #include <stdlib.h>
|
nuclear@0
|
6
|
nuclear@41
|
7 #ifdef WIN32
|
nuclear@41
|
8 #define GOAT3DAPI __declspec(dllexport)
|
nuclear@41
|
9 #else
|
nuclear@43
|
10 #define GOAT3DAPI
|
nuclear@41
|
11 #endif
|
nuclear@41
|
12
|
nuclear@15
|
13 #define GOAT3D_MAT_ATTR_DIFFUSE "diffuse"
|
nuclear@15
|
14 #define GOAT3D_MAT_ATTR_SPECULAR "specular"
|
nuclear@15
|
15 #define GOAT3D_MAT_ATTR_SHININESS "shininess"
|
nuclear@15
|
16 #define GOAT3D_MAT_ATTR_NORMAL "normal"
|
nuclear@15
|
17 #define GOAT3D_MAT_ATTR_BUMP "bump"
|
nuclear@15
|
18 #define GOAT3D_MAT_ATTR_REFLECTION "reflection"
|
nuclear@15
|
19 #define GOAT3D_MAT_ATTR_TRANSMISSION "transmission"
|
nuclear@15
|
20 #define GOAT3D_MAT_ATTR_IOR "ior"
|
nuclear@40
|
21 #define GOAT3D_MAT_ATTR_ALPHA "alpha"
|
nuclear@15
|
22
|
nuclear@15
|
23 enum goat3d_mesh_attrib {
|
nuclear@15
|
24 GOAT3D_MESH_ATTR_VERTEX,
|
nuclear@15
|
25 GOAT3D_MESH_ATTR_NORMAL,
|
nuclear@15
|
26 GOAT3D_MESH_ATTR_TANGENT,
|
nuclear@15
|
27 GOAT3D_MESH_ATTR_TEXCOORD,
|
nuclear@15
|
28 GOAT3D_MESH_ATTR_SKIN_WEIGHT,
|
nuclear@15
|
29 GOAT3D_MESH_ATTR_SKIN_MATRIX,
|
nuclear@15
|
30 GOAT3D_MESH_ATTR_COLOR,
|
nuclear@15
|
31
|
nuclear@15
|
32 NUM_GOAT3D_MESH_ATTRIBS
|
nuclear@15
|
33 };
|
nuclear@15
|
34
|
nuclear@25
|
35 enum goat3d_node_type {
|
nuclear@26
|
36 GOAT3D_NODE_NULL,
|
nuclear@25
|
37 GOAT3D_NODE_MESH,
|
nuclear@25
|
38 GOAT3D_NODE_LIGHT,
|
nuclear@25
|
39 GOAT3D_NODE_CAMERA
|
nuclear@25
|
40 };
|
nuclear@25
|
41
|
nuclear@15
|
42 /* immediate mode mesh construction primitive type */
|
nuclear@15
|
43 enum goat3d_im_primitive {
|
nuclear@15
|
44 GOAT3D_TRIANGLES,
|
nuclear@15
|
45 GOAT3D_QUADS
|
nuclear@15
|
46 };
|
nuclear@15
|
47
|
nuclear@15
|
48
|
nuclear@15
|
49 enum goat3d_option {
|
nuclear@15
|
50 GOAT3D_OPT_SAVEXML, /* save in XML format */
|
nuclear@15
|
51
|
nuclear@15
|
52 NUM_GOAT3D_OPTIONS
|
nuclear@15
|
53 };
|
nuclear@15
|
54
|
nuclear@0
|
55 struct goat3d;
|
nuclear@15
|
56 struct goat3d_material;
|
nuclear@15
|
57 struct goat3d_mesh;
|
nuclear@15
|
58 struct goat3d_light;
|
nuclear@15
|
59 struct goat3d_camera;
|
nuclear@15
|
60 struct goat3d_node;
|
nuclear@0
|
61
|
nuclear@0
|
62 struct goat3d_io {
|
nuclear@0
|
63 void *cls; /* closure data */
|
nuclear@0
|
64
|
nuclear@11
|
65 long (*read)(void *buf, size_t bytes, void *uptr);
|
nuclear@13
|
66 long (*write)(const void *buf, size_t bytes, void *uptr);
|
nuclear@0
|
67 long (*seek)(long offs, int whence, void *uptr);
|
nuclear@0
|
68 };
|
nuclear@0
|
69
|
nuclear@0
|
70 #ifdef __cplusplus
|
nuclear@0
|
71 extern "C" {
|
nuclear@0
|
72 #endif
|
nuclear@0
|
73
|
nuclear@0
|
74 /* construction/destruction */
|
nuclear@41
|
75 GOAT3DAPI struct goat3d *goat3d_create(void);
|
nuclear@41
|
76 GOAT3DAPI void goat3d_free(struct goat3d *g);
|
nuclear@0
|
77
|
nuclear@41
|
78 GOAT3DAPI void goat3d_setopt(struct goat3d *g, enum goat3d_option opt, int val);
|
nuclear@41
|
79 GOAT3DAPI int goat3d_getopt(const struct goat3d *g, enum goat3d_option opt);
|
nuclear@15
|
80
|
nuclear@0
|
81 /* load/save */
|
nuclear@41
|
82 GOAT3DAPI int goat3d_load(struct goat3d *g, const char *fname);
|
nuclear@41
|
83 GOAT3DAPI int goat3d_save(const struct goat3d *g, const char *fname);
|
nuclear@0
|
84
|
nuclear@41
|
85 GOAT3DAPI int goat3d_load_file(struct goat3d *g, FILE *fp);
|
nuclear@41
|
86 GOAT3DAPI int goat3d_save_file(const struct goat3d *g, FILE *fp);
|
nuclear@0
|
87
|
nuclear@41
|
88 GOAT3DAPI int goat3d_load_io(struct goat3d *g, struct goat3d_io *io);
|
nuclear@41
|
89 GOAT3DAPI int goat3d_save_io(const struct goat3d *g, struct goat3d_io *io);
|
nuclear@0
|
90
|
nuclear@47
|
91 /* load/save animation files (g must already be loaded to load animations) */
|
nuclear@47
|
92 GOAT3DAPI int goat3d_load_anim(struct goat3d *g, const char *fname);
|
nuclear@55
|
93 GOAT3DAPI int goat3d_save_anim(const struct goat3d *g, const char *fname);
|
nuclear@47
|
94
|
nuclear@47
|
95 GOAT3DAPI int goat3d_load_anim_file(struct goat3d *g, FILE *fp);
|
nuclear@55
|
96 GOAT3DAPI int goat3d_save_anim_file(const struct goat3d *g, FILE *fp);
|
nuclear@47
|
97
|
nuclear@47
|
98 GOAT3DAPI int goat3d_load_anim_io(struct goat3d *g, struct goat3d_io *io);
|
nuclear@55
|
99 GOAT3DAPI int goat3d_save_anim_io(const struct goat3d *g, struct goat3d_io *io);
|
nuclear@47
|
100
|
nuclear@0
|
101 /* misc scene properties */
|
nuclear@41
|
102 GOAT3DAPI int goat3d_set_name(struct goat3d *g, const char *name);
|
nuclear@41
|
103 GOAT3DAPI const char *goat3d_get_name(const struct goat3d *g);
|
nuclear@0
|
104
|
nuclear@41
|
105 GOAT3DAPI void goat3d_set_ambient(struct goat3d *g, const float *ambient);
|
nuclear@41
|
106 GOAT3DAPI void goat3d_set_ambient3f(struct goat3d *g, float ar, float ag, float ab);
|
nuclear@41
|
107 GOAT3DAPI const float *goat3d_get_ambient(const struct goat3d *g);
|
nuclear@0
|
108
|
nuclear@15
|
109 /* materials */
|
nuclear@41
|
110 GOAT3DAPI void goat3d_add_mtl(struct goat3d *g, struct goat3d_material *mtl);
|
nuclear@57
|
111 GOAT3DAPI int goat3d_get_mtl_count(struct goat3d *g);
|
nuclear@57
|
112 GOAT3DAPI struct goat3d_material *goat3d_get_mtl(struct goat3d *g, int idx);
|
nuclear@57
|
113 GOAT3DAPI struct goat3d_material *goat3d_get_mtl_by_name(struct goat3d *g, const char *name);
|
nuclear@27
|
114
|
nuclear@41
|
115 GOAT3DAPI struct goat3d_material *goat3d_create_mtl(void);
|
nuclear@41
|
116 GOAT3DAPI void goat3d_destroy_mtl(struct goat3d_material *mtl);
|
nuclear@0
|
117
|
nuclear@41
|
118 GOAT3DAPI void goat3d_set_mtl_name(struct goat3d_material *mtl, const char *name);
|
nuclear@41
|
119 GOAT3DAPI const char *goat3d_get_mtl_name(const struct goat3d_material *mtl);
|
nuclear@15
|
120
|
nuclear@41
|
121 GOAT3DAPI void goat3d_set_mtl_attrib(struct goat3d_material *mtl, const char *attrib, const float *val);
|
nuclear@41
|
122 GOAT3DAPI void goat3d_set_mtl_attrib1f(struct goat3d_material *mtl, const char *attrib, float val);
|
nuclear@41
|
123 GOAT3DAPI void goat3d_set_mtl_attrib3f(struct goat3d_material *mtl, const char *attrib, float r, float g, float b);
|
nuclear@41
|
124 GOAT3DAPI void goat3d_set_mtl_attrib4f(struct goat3d_material *mtl, const char *attrib, float r, float g, float b, float a);
|
nuclear@41
|
125 GOAT3DAPI const float *goat3d_get_mtl_attrib(struct goat3d_material *mtl, const char *attrib);
|
nuclear@15
|
126
|
nuclear@41
|
127 GOAT3DAPI void goat3d_set_mtl_attrib_map(struct goat3d_material *mtl, const char *attrib, const char *mapname);
|
nuclear@41
|
128 GOAT3DAPI const char *goat3d_get_mtl_attrib_map(struct goat3d_material *mtl, const char *attrib);
|
nuclear@15
|
129
|
nuclear@27
|
130 /* meshes */
|
nuclear@41
|
131 GOAT3DAPI void goat3d_add_mesh(struct goat3d *g, struct goat3d_mesh *mesh);
|
nuclear@41
|
132 GOAT3DAPI int goat3d_get_mesh_count(struct goat3d *g);
|
nuclear@41
|
133 GOAT3DAPI struct goat3d_mesh *goat3d_get_mesh(struct goat3d *g, int idx);
|
nuclear@41
|
134 GOAT3DAPI struct goat3d_mesh *goat3d_get_mesh_by_name(struct goat3d *g, const char *name);
|
nuclear@15
|
135
|
nuclear@41
|
136 GOAT3DAPI struct goat3d_mesh *goat3d_create_mesh(void);
|
nuclear@41
|
137 GOAT3DAPI void goat3d_destroy_mesh(struct goat3d_mesh *mesh);
|
nuclear@15
|
138
|
nuclear@41
|
139 GOAT3DAPI void goat3d_set_mesh_name(struct goat3d_mesh *mesh, const char *name);
|
nuclear@41
|
140 GOAT3DAPI const char *goat3d_get_mesh_name(const struct goat3d_mesh *mesh);
|
nuclear@15
|
141
|
nuclear@41
|
142 GOAT3DAPI void goat3d_set_mesh_mtl(struct goat3d_mesh *mesh, struct goat3d_material *mtl);
|
nuclear@41
|
143 GOAT3DAPI struct goat3d_material *goat3d_get_mesh_mtl(struct goat3d_mesh *mesh);
|
nuclear@15
|
144
|
nuclear@41
|
145 GOAT3DAPI int goat3d_get_mesh_attrib_count(struct goat3d_mesh *mesh, enum goat3d_mesh_attrib attrib);
|
nuclear@41
|
146 GOAT3DAPI int goat3d_get_mesh_face_count(struct goat3d_mesh *mesh);
|
nuclear@15
|
147
|
nuclear@15
|
148 /* sets all the data for a single vertex attribute array in one go.
|
nuclear@15
|
149 * vnum is the number of *vertices* to be set, not the number of floats, ints or whatever
|
nuclear@15
|
150 * data is expected to be something different depending on the attribute:
|
nuclear@15
|
151 * - GOAT3D_MESH_ATTR_VERTEX - 3 floats per vertex
|
nuclear@15
|
152 * - GOAT3D_MESH_ATTR_NORMAL - 3 floats per vertex
|
nuclear@15
|
153 * - GOAT3D_MESH_ATTR_TANGENT - 3 floats per vertex
|
nuclear@15
|
154 * - GOAT3D_MESH_ATTR_TEXCOORD - 2 floats per vertex
|
nuclear@15
|
155 * - GOAT3D_MESH_ATTR_SKIN_WEIGHT - 4 floats per vertex
|
nuclear@15
|
156 * - GOAT3D_MESH_ATTR_SKIN_MATRIX - 4 ints per vertex
|
nuclear@15
|
157 * - GOAT3D_MESH_ATTR_COLOR - 4 floats per vertex
|
nuclear@15
|
158 */
|
nuclear@41
|
159 GOAT3DAPI void goat3d_set_mesh_attribs(struct goat3d_mesh *mesh, enum goat3d_mesh_attrib attrib,
|
nuclear@40
|
160 const void *data, int vnum);
|
nuclear@41
|
161 GOAT3DAPI void goat3d_add_mesh_attrib1f(struct goat3d_mesh *mesh, enum goat3d_mesh_attrib attrib, float val);
|
nuclear@57
|
162 GOAT3DAPI void goat3d_add_mesh_attrib2f(struct goat3d_mesh *mesh, enum goat3d_mesh_attrib attrib,
|
nuclear@57
|
163 float x, float y);
|
nuclear@41
|
164 GOAT3DAPI void goat3d_add_mesh_attrib3f(struct goat3d_mesh *mesh, enum goat3d_mesh_attrib attrib,
|
nuclear@47
|
165 float x, float y, float z);
|
nuclear@41
|
166 GOAT3DAPI void goat3d_add_mesh_attrib4f(struct goat3d_mesh *mesh, enum goat3d_mesh_attrib attrib,
|
nuclear@47
|
167 float x, float y, float z, float w);
|
nuclear@15
|
168 /* returns a pointer to the beginning of the requested mesh attribute array */
|
nuclear@41
|
169 GOAT3DAPI void *goat3d_get_mesh_attribs(struct goat3d_mesh *mesh, enum goat3d_mesh_attrib attrib);
|
nuclear@15
|
170 /* returns a pointer to the requested mesh attribute */
|
nuclear@41
|
171 GOAT3DAPI void *goat3d_get_mesh_attrib(struct goat3d_mesh *mesh, enum goat3d_mesh_attrib attrib, int idx);
|
nuclear@15
|
172
|
nuclear@15
|
173 /* sets all the faces in one go. data is an array of 3 int vertex indices per face */
|
nuclear@41
|
174 GOAT3DAPI void goat3d_set_mesh_faces(struct goat3d_mesh *mesh, const int *data, int fnum);
|
nuclear@41
|
175 GOAT3DAPI void goat3d_add_mesh_face(struct goat3d_mesh *mesh, int a, int b, int c);
|
nuclear@15
|
176 /* returns a pointer to the beginning of the face index array */
|
nuclear@41
|
177 GOAT3DAPI int *goat3d_get_mesh_faces(struct goat3d_mesh *mesh);
|
nuclear@15
|
178 /* returns a pointer to a face index */
|
nuclear@41
|
179 GOAT3DAPI int *goat3d_get_mesh_face(struct goat3d_mesh *mesh, int idx);
|
nuclear@15
|
180
|
nuclear@15
|
181 /* immediate mode OpenGL-like interface for setting mesh data
|
nuclear@15
|
182 * NOTE: using this interface will result in no vertex sharing between faces
|
nuclear@15
|
183 * NOTE2: the immedate mode interface is not thread-safe, either use locks, or don't
|
nuclear@15
|
184 * use it at all in multithreaded situations.
|
nuclear@15
|
185 */
|
nuclear@41
|
186 GOAT3DAPI void goat3d_begin(struct goat3d_mesh *mesh, enum goat3d_im_primitive prim);
|
nuclear@41
|
187 GOAT3DAPI void goat3d_end(void);
|
nuclear@41
|
188 GOAT3DAPI void goat3d_vertex3f(float x, float y, float z);
|
nuclear@41
|
189 GOAT3DAPI void goat3d_normal3f(float x, float y, float z);
|
nuclear@41
|
190 GOAT3DAPI void goat3d_tangent3f(float x, float y, float z);
|
nuclear@41
|
191 GOAT3DAPI void goat3d_texcoord2f(float x, float y);
|
nuclear@41
|
192 GOAT3DAPI void goat3d_skin_weight4f(float x, float y, float z, float w);
|
nuclear@41
|
193 GOAT3DAPI void goat3d_skin_matrix4i(int x, int y, int z, int w);
|
nuclear@41
|
194 GOAT3DAPI void goat3d_color3f(float x, float y, float z);
|
nuclear@41
|
195 GOAT3DAPI void goat3d_color4f(float x, float y, float z, float w);
|
nuclear@15
|
196
|
nuclear@27
|
197 /* lights */
|
nuclear@41
|
198 GOAT3DAPI void goat3d_add_light(struct goat3d *g, struct goat3d_light *lt);
|
nuclear@41
|
199 GOAT3DAPI int goat3d_get_light_count(struct goat3d *g);
|
nuclear@41
|
200 GOAT3DAPI struct goat3d_light *goat3d_get_light(struct goat3d *g, int idx);
|
nuclear@41
|
201 GOAT3DAPI struct goat3d_light *goat3d_get_light_by_name(struct goat3d *g, const char *name);
|
nuclear@0
|
202
|
nuclear@41
|
203 GOAT3DAPI struct goat3d_light *goat3d_create_light(void);
|
nuclear@41
|
204 GOAT3DAPI void goat3d_destroy_light(struct goat3d_light *lt);
|
nuclear@27
|
205
|
nuclear@27
|
206 /* cameras */
|
nuclear@41
|
207 GOAT3DAPI void goat3d_add_camera(struct goat3d *g, struct goat3d_camera *cam);
|
nuclear@41
|
208 GOAT3DAPI int goat3d_get_camera_count(struct goat3d *g);
|
nuclear@41
|
209 GOAT3DAPI struct goat3d_camera *goat3d_get_camera(struct goat3d *g, int idx);
|
nuclear@41
|
210 GOAT3DAPI struct goat3d_camera *goat3d_get_camera_by_name(struct goat3d *g, const char *name);
|
nuclear@27
|
211
|
nuclear@41
|
212 GOAT3DAPI struct goat3d_camera *goat3d_create_camera(void);
|
nuclear@41
|
213 GOAT3DAPI void goat3d_destroy_camera(struct goat3d_camera *cam);
|
nuclear@19
|
214
|
nuclear@25
|
215 /* nodes */
|
nuclear@41
|
216 GOAT3DAPI void goat3d_add_node(struct goat3d *g, struct goat3d_node *node);
|
nuclear@41
|
217 GOAT3DAPI int goat3d_get_node_count(struct goat3d *g);
|
nuclear@41
|
218 GOAT3DAPI struct goat3d_node *goat3d_get_node(struct goat3d *g, int idx);
|
nuclear@41
|
219 GOAT3DAPI struct goat3d_node *goat3d_get_node_by_name(struct goat3d *g, const char *name);
|
nuclear@27
|
220
|
nuclear@41
|
221 GOAT3DAPI struct goat3d_node *goat3d_create_node(void);
|
nuclear@41
|
222 GOAT3DAPI void goat3d_destroy_node(struct goat3d_node *node);
|
nuclear@25
|
223
|
nuclear@41
|
224 GOAT3DAPI void goat3d_set_node_name(struct goat3d_node *node, const char *name);
|
nuclear@41
|
225 GOAT3DAPI const char *goat3d_get_node_name(const struct goat3d_node *node);
|
nuclear@25
|
226
|
nuclear@41
|
227 GOAT3DAPI void goat3d_set_node_object(struct goat3d_node *node, enum goat3d_node_type type, void *obj);
|
nuclear@41
|
228 GOAT3DAPI void *goat3d_get_node_object(const struct goat3d_node *node);
|
nuclear@41
|
229 GOAT3DAPI enum goat3d_node_type goat3d_get_node_type(const struct goat3d_node *node);
|
nuclear@25
|
230
|
nuclear@41
|
231 GOAT3DAPI void goat3d_add_node_child(struct goat3d_node *node, struct goat3d_node *child);
|
nuclear@41
|
232 GOAT3DAPI int goat3d_get_node_child_count(const struct goat3d_node *node);
|
nuclear@41
|
233 GOAT3DAPI struct goat3d_node *goat3d_get_node_child(const struct goat3d_node *node, int idx);
|
nuclear@47
|
234 GOAT3DAPI struct goat3d_node *goat3d_get_node_parent(const struct goat3d_node *node);
|
nuclear@47
|
235
|
nuclear@47
|
236 GOAT3DAPI void goat3d_use_anim(struct goat3d_node *node, int idx);
|
nuclear@47
|
237 GOAT3DAPI void goat3d_use_anims(struct goat3d_node *node, int aidx, int bidx, float t);
|
nuclear@47
|
238 GOAT3DAPI void goat3d_use_anim_by_name(struct goat3d_node *node, const char *name);
|
nuclear@47
|
239 GOAT3DAPI void goat3d_use_anims_by_name(struct goat3d_node *node, const char *aname, const char *bname, float t);
|
nuclear@47
|
240
|
nuclear@47
|
241 GOAT3DAPI int goat3d_get_active_anim(struct goat3d_node *node, int which);
|
nuclear@47
|
242 GOAT3DAPI float goat3d_get_active_anim_mix(struct goat3d_node *node);
|
nuclear@47
|
243
|
nuclear@47
|
244 GOAT3DAPI int goat3d_get_anim_count(struct goat3d_node *node);
|
nuclear@47
|
245 GOAT3DAPI void goat3d_add_anim(struct goat3d_node *root);
|
nuclear@47
|
246
|
nuclear@47
|
247 GOAT3DAPI void goat3d_set_anim_name(struct goat3d_node *root, const char *name);
|
nuclear@47
|
248 GOAT3DAPI const char *goat3d_get_anim_name(struct goat3d_node *node);
|
nuclear@25
|
249
|
nuclear@41
|
250 GOAT3DAPI void goat3d_set_node_position(struct goat3d_node *node, float x, float y, float z, long tmsec);
|
nuclear@41
|
251 GOAT3DAPI void goat3d_set_node_rotation(struct goat3d_node *node, float qx, float qy, float qz, float qw, long tmsec);
|
nuclear@41
|
252 GOAT3DAPI void goat3d_set_node_scaling(struct goat3d_node *node, float sx, float sy, float sz, long tmsec);
|
nuclear@41
|
253 GOAT3DAPI void goat3d_set_node_pivot(struct goat3d_node *node, float px, float py, float pz);
|
nuclear@25
|
254
|
nuclear@41
|
255 GOAT3DAPI void goat3d_get_node_position(const struct goat3d_node *node, float *xptr, float *yptr, float *zptr, long tmsec);
|
nuclear@41
|
256 GOAT3DAPI void goat3d_get_node_rotation(const struct goat3d_node *node, float *xptr, float *yptr, float *zptr, float *wptr, long tmsec);
|
nuclear@41
|
257 GOAT3DAPI void goat3d_get_node_scaling(const struct goat3d_node *node, float *xptr, float *yptr, float *zptr, long tmsec);
|
nuclear@41
|
258 GOAT3DAPI void goat3d_get_node_pivot(const struct goat3d_node *node, float *xptr, float *yptr, float *zptr);
|
nuclear@25
|
259
|
nuclear@41
|
260 GOAT3DAPI void goat3d_get_node_matrix(const struct goat3d_node *node, float *matrix, long tmsec);
|
nuclear@25
|
261
|
nuclear@0
|
262 #ifdef __cplusplus
|
nuclear@0
|
263 }
|
nuclear@0
|
264 #endif
|
nuclear@0
|
265
|
nuclear@0
|
266 #endif /* GOAT3D_H_ */
|