summaryrefslogtreecommitdiffstats
path: root/libdimension-python/dimension.pxd
blob: 55c2ab86fc964096c2137e850418078d416c4889 (plain)
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
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
#########################################################################
# Copyright (C) 2011-2014 Tavian Barnes <tavianator@tavianator.com>     #
#                                                                       #
# This file is part of The Dimension Python Module.                     #
#                                                                       #
# The Dimension Python Module is free software; you can redistribute it #
# and/or modify it under the terms of the GNU Lesser General Public     #
# License as published by the Free Software Foundation; either version  #
# 3 of the License, or (at your option) any later version.              #
#                                                                       #
# The Dimension Python Module is distributed in the hope that it will   #
# be useful, but WITHOUT ANY WARRANTY; without even the implied         #
# warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See #
# the GNU Lesser General Public License for more details.               #
#                                                                       #
# You should have received a copy of the GNU Lesser General Public      #
# License along with this program.  If not, see                         #
# <http://www.gnu.org/licenses/>.                                       #
#########################################################################

from cpython cimport bool
from libc.math cimport *
from libc.stdio cimport *

cdef extern from "errno.h":
  int errno

cdef extern from "../libdimension/dimension.h":

  ###########
  # Globals #
  ###########

  ctypedef void dmnsn_callback_fn(void *ptr)

  void DMNSN_INCREF(void *)

  void dmnsn_die_on_warnings(bint always_die)

  double dmnsn_epsilon

  #########
  # Pools #
  #########

  ctypedef struct dmnsn_pool

  dmnsn_pool *dmnsn_new_pool()
  void *dmnsn_palloc(dmnsn_pool *pool, size_t size, dmnsn_callback_fn *callback)
  void dmnsn_delete_pool(dmnsn_pool *pool)

  ##########
  # Arrays #
  ##########

  ctypedef struct dmnsn_array

  dmnsn_array *dmnsn_new_array(size_t objsize)
  void dmnsn_delete_array(dmnsn_array *array)

  size_t dmnsn_array_size(dmnsn_array *array)
  void dmnsn_array_resize(dmnsn_array *array, size_t length)
  dmnsn_array *dmnsn_array_copy(dmnsn_array *array)
  dmnsn_array *dmnsn_array_split(dmnsn_array *array)
  void dmnsn_array_get(dmnsn_array *array, size_t i, void *obj)
  void dmnsn_array_set(dmnsn_array *array, size_t i, void *obj)
  void *dmnsn_array_first(dmnsn_array *array)
  void *dmnsn_array_last(dmnsn_array *array)
  void *dmnsn_array_at(dmnsn_array *array, size_t i)
  void dmnsn_array_push(dmnsn_array *array, void *obj)
  void dmnsn_array_pop(dmnsn_array *array, void *obj)
  void dmnsn_array_insert(dmnsn_array *array, size_t i, void *obj)
  void dmnsn_array_remove(dmnsn_array *array, size_t i)
  void dmnsn_array_apply(dmnsn_array *array, dmnsn_callback_fn *callback)

  ###########
  # Futures #
  ###########

  ctypedef struct dmnsn_future

  int dmnsn_future_join(dmnsn_future *future) nogil
  void dmnsn_future_cancel(dmnsn_future *future)
  double dmnsn_future_progress(dmnsn_future *future)
  bint dmnsn_future_is_done(dmnsn_future *future)
  void dmnsn_future_wait(dmnsn_future *future, double progress) nogil
  void dmnsn_future_pause(dmnsn_future *future) nogil
  void dmnsn_future_resume(dmnsn_future *future)

  ##########
  # Timers #
  ##########

  ctypedef struct dmnsn_timer:
    double real
    double user
    double system

  void dmnsn_timer_start(dmnsn_timer *timer)
  void dmnsn_timer_stop(dmnsn_timer *timer)

  ############
  # Geometry #
  ############

  double dmnsn_radians(double degrees)
  double dmnsn_degrees(double radians)

  ctypedef struct dmnsn_vector:
    double x
    double y
    double z

  dmnsn_vector dmnsn_new_vector(double x, double y, double z)

  dmnsn_vector dmnsn_vector_negate(dmnsn_vector rhs)

  dmnsn_vector dmnsn_vector_add(dmnsn_vector lhs, dmnsn_vector rhs)
  dmnsn_vector dmnsn_vector_sub(dmnsn_vector lhs, dmnsn_vector rhs)
  dmnsn_vector dmnsn_vector_mul(double lhs, dmnsn_vector rhs)
  dmnsn_vector dmnsn_vector_div(dmnsn_vector lhs, double rhs)

  dmnsn_vector dmnsn_vector_cross(dmnsn_vector lhs, dmnsn_vector rhs)
  double dmnsn_vector_dot(dmnsn_vector lhs, dmnsn_vector rhs)
  dmnsn_vector dmnsn_vector_proj(dmnsn_vector u, dmnsn_vector d)

  double dmnsn_vector_norm(dmnsn_vector v)
  dmnsn_vector dmnsn_vector_normalized(dmnsn_vector v)

  dmnsn_vector dmnsn_zero
  dmnsn_vector dmnsn_x
  dmnsn_vector dmnsn_y
  dmnsn_vector dmnsn_z

  ctypedef struct dmnsn_matrix:
    double n[3][4]

  dmnsn_matrix dmnsn_new_matrix(double a1, double a2, double a3, double a4,
                                double b1, double b2, double b3, double b4,
                                double c1, double c2, double c3, double c4)

  dmnsn_matrix dmnsn_matrix_inverse(dmnsn_matrix m)

  dmnsn_matrix dmnsn_matrix_mul(dmnsn_matrix lhs, dmnsn_matrix rhs)
  dmnsn_vector dmnsn_transform_point(dmnsn_matrix lhs, dmnsn_vector rhs)
  dmnsn_vector dmnsn_transform_direction(dmnsn_matrix lhs, dmnsn_vector rhs)
  dmnsn_vector dmnsn_transform_normal(dmnsn_matrix lhs, dmnsn_vector rhs)

  dmnsn_matrix dmnsn_scale_matrix(dmnsn_vector s)
  dmnsn_matrix dmnsn_translation_matrix(dmnsn_vector d)
  dmnsn_matrix dmnsn_rotation_matrix(dmnsn_vector theta)
  dmnsn_matrix dmnsn_alignment_matrix(dmnsn_vector frm, dmnsn_vector to,
                                      dmnsn_vector axis1, dmnsn_vector axis2)

  ##########
  # Colors #
  ##########

  ctypedef struct dmnsn_color:
    double R
    double G
    double B

  dmnsn_color dmnsn_new_color(double R, double G, double B)

  double dmnsn_sRGB_gamma(double Clinear)
  dmnsn_color dmnsn_color_to_sRGB(dmnsn_color color)
  double dmnsn_sRGB_inverse_gamma(double CsRGB)
  dmnsn_color dmnsn_color_from_sRGB(dmnsn_color color)

  double dmnsn_color_intensity(dmnsn_color color)
  dmnsn_color dmnsn_color_add(dmnsn_color color1, dmnsn_color color2)
  dmnsn_color dmnsn_color_sub(dmnsn_color color1, dmnsn_color color2)
  dmnsn_color dmnsn_color_mul(double n, dmnsn_color color)

  dmnsn_color dmnsn_black
  dmnsn_color dmnsn_white
  dmnsn_color dmnsn_red
  dmnsn_color dmnsn_green
  dmnsn_color dmnsn_blue
  dmnsn_color dmnsn_magenta
  dmnsn_color dmnsn_orange
  dmnsn_color dmnsn_yellow
  dmnsn_color dmnsn_cyan

  ctypedef struct dmnsn_tcolor:
    dmnsn_color c
    double T
    double F

  dmnsn_tcolor dmnsn_new_tcolor(dmnsn_color c, double T, double F)
  dmnsn_tcolor DMNSN_TCOLOR(dmnsn_color c)
  dmnsn_tcolor dmnsn_new_tcolor5(double R, double G, double B,
                                 double T, double F)

  dmnsn_tcolor dmnsn_clear

  ############
  # Canvases #
  ############

  ctypedef struct dmnsn_canvas:
    size_t width
    size_t height

  dmnsn_canvas *dmnsn_new_canvas(dmnsn_pool *pool, size_t width, size_t height)

  dmnsn_tcolor dmnsn_canvas_get_pixel(dmnsn_canvas *canvas, size_t x, size_t y)
  void dmnsn_canvas_set_pixel(dmnsn_canvas *canvas, size_t x, size_t y,
                              dmnsn_tcolor tcolor)

  void dmnsn_canvas_clear(dmnsn_canvas *canvas, dmnsn_tcolor tcolor)

  int dmnsn_png_optimize_canvas(dmnsn_canvas *canvas)
  int dmnsn_png_write_canvas(dmnsn_canvas *canvas, FILE *file)
  dmnsn_future *dmnsn_png_write_canvas_async(dmnsn_canvas *canvas, FILE *file)
  dmnsn_canvas *dmnsn_png_read_canvas(dmnsn_pool *pool, FILE *file)
  dmnsn_future *dmnsn_png_read_canvas_async(dmnsn_canvas **canvas, dmnsn_pool *pool, FILE *file)

  int dmnsn_gl_optimize_canvas(dmnsn_canvas *canvas)
  int dmnsn_gl_write_canvas(dmnsn_canvas *canvas)

  ############
  # Patterns #
  ############

  ctypedef struct dmnsn_pattern:
    pass

  void dmnsn_delete_pattern(dmnsn_pattern *pattern)

  dmnsn_pattern *dmnsn_new_checker_pattern()
  dmnsn_pattern *dmnsn_new_gradient_pattern(dmnsn_vector orientation)
  dmnsn_pattern *dmnsn_new_leopard_pattern()

  ########
  # Maps #
  ########

  ctypedef struct dmnsn_map:
    pass

  void dmnsn_delete_map(dmnsn_map *map)

  void dmnsn_map_add_entry(dmnsn_map *map, double n, void *obj)
  size_t dmnsn_map_size(dmnsn_map *map)

  dmnsn_map *dmnsn_new_pigment_map()

  ############
  # Pigments #
  ############

  ctypedef struct dmnsn_pigment:
    dmnsn_matrix trans
    dmnsn_tcolor quick_color

  ctypedef enum dmnsn_pigment_map_flags:
    DMNSN_PIGMENT_MAP_REGULAR
    DMNSN_PIGMENT_MAP_SRGB

  void dmnsn_delete_pigment(dmnsn_pigment *pigment)

  dmnsn_pigment *dmnsn_new_solid_pigment(dmnsn_tcolor tcolor)
  dmnsn_pigment *dmnsn_new_canvas_pigment(dmnsn_canvas *canvas)
  dmnsn_pigment *dmnsn_new_pigment_map_pigment(dmnsn_pattern *pattern,
                                               dmnsn_map *map,
                                               dmnsn_pigment_map_flags flags)

  ############
  # Finishes #
  ############

  ctypedef struct dmnsn_ambient
  ctypedef struct dmnsn_diffuse
  ctypedef struct dmnsn_specular
  ctypedef struct dmnsn_reflection

  ctypedef struct dmnsn_finish:
    dmnsn_ambient    *ambient
    dmnsn_diffuse    *diffuse
    dmnsn_specular   *specular
    dmnsn_reflection *reflection

  dmnsn_finish dmnsn_new_finish()
  void dmnsn_delete_finish(dmnsn_finish finish)

  void dmnsn_finish_incref(dmnsn_finish *finish)

  void dmnsn_finish_cascade(dmnsn_finish *default_finish, dmnsn_finish *finish)

  dmnsn_ambient *dmnsn_new_ambient(dmnsn_color ambient)
  dmnsn_diffuse *dmnsn_new_lambertian(double diffuse)
  dmnsn_specular *dmnsn_new_phong(double specular, double exp)
  dmnsn_reflection *dmnsn_new_basic_reflection(dmnsn_color min, dmnsn_color max,
                                               double falloff)

  ############
  # Textures #
  ############

  ctypedef struct dmnsn_texture:
    dmnsn_pigment *pigment
    dmnsn_finish finish
    dmnsn_matrix trans

  dmnsn_texture *dmnsn_new_texture()
  void dmnsn_delete_texture(dmnsn_texture *texture)

  void dmnsn_texture_cascade(dmnsn_texture *default_texture,
                             dmnsn_texture **texture)

  #############
  # Interiors #
  #############

  ctypedef struct dmnsn_interior:
    double ior

  dmnsn_interior *dmnsn_new_interior()
  void dmnsn_delete_interior(dmnsn_interior *interior)

  ###########
  # Objects #
  ###########

  ctypedef struct dmnsn_object:
    dmnsn_texture *texture
    dmnsn_interior *interior
    dmnsn_matrix trans
    dmnsn_matrix intrinsic_trans

  dmnsn_object *dmnsn_new_object()
  void dmnsn_delete_object(dmnsn_object *object)

  dmnsn_object *dmnsn_new_flat_triangle(dmnsn_vector a,
                                        dmnsn_vector b,
                                        dmnsn_vector c)
  dmnsn_object *dmnsn_new_triangle(dmnsn_vector a,
                                   dmnsn_vector b,
                                   dmnsn_vector c,
                                   dmnsn_vector na,
                                   dmnsn_vector nb,
                                   dmnsn_vector nc)
  dmnsn_object *dmnsn_new_plane(dmnsn_vector normal)
  dmnsn_object *dmnsn_new_sphere()
  dmnsn_object *dmnsn_new_cube()
  dmnsn_object *dmnsn_new_cone(double r1, double r2, bint open)
  dmnsn_object *dmnsn_new_torus(double major, double minor)

  dmnsn_object *dmnsn_new_csg_union(dmnsn_array *objects)
  dmnsn_object *dmnsn_new_csg_intersection(dmnsn_object *A, dmnsn_object *B)
  dmnsn_object *dmnsn_new_csg_difference(dmnsn_object *A, dmnsn_object *B)
  dmnsn_object *dmnsn_new_csg_merge(dmnsn_object *A, dmnsn_object *B)

  ##########
  # Lights #
  ##########

  ctypedef struct dmnsn_light:
    dmnsn_vector x0

  dmnsn_light *dmnsn_new_light()
  void dmnsn_delete_light(dmnsn_light *light)

  dmnsn_light *dmnsn_new_point_light(dmnsn_vector x0, dmnsn_color color)

  ###########
  # Cameras #
  ###########

  ctypedef struct dmnsn_camera:
    dmnsn_matrix trans

  dmnsn_camera *dmnsn_new_camera(dmnsn_pool *pool)

  dmnsn_camera *dmnsn_new_perspective_camera(dmnsn_pool *pool)

  ##########
  # Scenes #
  ##########

  ctypedef enum dmnsn_quality:
    DMNSN_RENDER_NONE
    DMNSN_RENDER_PIGMENT
    DMNSN_RENDER_LIGHTS
    DMNSN_RENDER_FINISH
    DMNSN_RENDER_TRANSPARENCY
    DMNSN_RENDER_REFLECTION
    DMNSN_RENDER_FULL

  ctypedef struct dmnsn_scene:
    dmnsn_pigment *background
    dmnsn_texture *default_texture
    dmnsn_interior *default_interior

    dmnsn_canvas *canvas
    size_t region_x
    size_t region_y
    size_t outer_width
    size_t outer_height

    dmnsn_array *objects
    dmnsn_array *lights
    dmnsn_camera *camera

    dmnsn_quality quality
    unsigned int reclimit
    double adc_bailout
    unsigned int nthreads

    dmnsn_timer bounding_timer
    dmnsn_timer render_timer

  dmnsn_scene *dmnsn_new_scene(dmnsn_pool *pool)
  void dmnsn_delete_scene(dmnsn_scene *scene)

  void dmnsn_ray_trace(dmnsn_scene *scene)
  dmnsn_future *dmnsn_ray_trace_async(dmnsn_scene *scene)

cdef extern from "platform.h":
  unsigned int dmnsn_terminal_width()