Fix T64842: crash rendering files with bevel curves
[blender.git] / source / blender / blenkernel / BKE_sound.h
1 /*
2  * This program is free software; you can redistribute it and/or
3  * modify it under the terms of the GNU General Public License
4  * as published by the Free Software Foundation; either version 2
5  * of the License, or (at your option) any later version.
6  *
7  * This program is distributed in the hope that it will be useful,
8  * but WITHOUT ANY WARRANTY; without even the implied warranty of
9  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
10  * GNU General Public License for more details.
11  *
12  * You should have received a copy of the GNU General Public License
13  * along with this program; if not, write to the Free Software Foundation,
14  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
15  *
16  * The Original Code is Copyright (C) 2001-2002 by NaN Holding BV.
17  * All rights reserved.
18  */
19 #ifndef __BKE_SOUND_H__
20 #define __BKE_SOUND_H__
21
22 /** \file
23  * \ingroup bke
24  */
25
26 #define SOUND_WAVE_SAMPLES_PER_SECOND 250
27
28 #if defined(WITH_AUDASPACE)
29 #  include <AUD_Device.h>
30 #endif
31
32 struct Main;
33 struct Sequence;
34 struct bSound;
35
36 typedef struct SoundWaveform {
37   int length;
38   float *data;
39 } SoundWaveform;
40
41 void BKE_sound_init_once(void);
42 void BKE_sound_exit_once(void);
43
44 void *BKE_sound_get_device(void);
45
46 void BKE_sound_init(struct Main *main);
47
48 void BKE_sound_init_main(struct Main *bmain);
49
50 void BKE_sound_exit(void);
51
52 void BKE_sound_force_device(const char *device);
53
54 struct bSound *BKE_sound_new_file(struct Main *main, const char *filepath);
55 struct bSound *BKE_sound_new_file_exists_ex(struct Main *bmain,
56                                             const char *filepath,
57                                             bool *r_exists);
58 struct bSound *BKE_sound_new_file_exists(struct Main *bmain, const char *filepath);
59
60 // XXX unused currently
61 #if 0
62 struct bSound *BKE_sound_new_buffer(struct Main *bmain, struct bSound *source);
63
64 struct bSound *BKE_sound_new_limiter(struct Main *bmain,
65                                      struct bSound *source,
66                                      float start,
67                                      float end);
68 #endif
69
70 void BKE_sound_cache(struct bSound *sound);
71
72 void BKE_sound_delete_cache(struct bSound *sound);
73
74 void BKE_sound_load(struct Main *main, struct bSound *sound);
75
76 void BKE_sound_free(struct bSound *sound);
77
78 void BKE_sound_copy_data(struct Main *bmain,
79                          struct bSound *sound_dst,
80                          const struct bSound *sound_src,
81                          const int flag);
82
83 void BKE_sound_make_local(struct Main *bmain, struct bSound *sound, const bool lib_local);
84
85 #if defined(WITH_AUDASPACE)
86 AUD_Device *BKE_sound_mixdown(struct Scene *scene, AUD_DeviceSpecs specs, int start, float volume);
87 #endif
88
89 void BKE_sound_create_scene(struct Scene *scene);
90
91 void BKE_sound_destroy_scene(struct Scene *scene);
92
93 void BKE_sound_reset_scene_specs(struct Scene *scene);
94
95 void BKE_sound_mute_scene(struct Scene *scene, int muted);
96
97 void BKE_sound_update_fps(struct Scene *scene);
98
99 void BKE_sound_update_scene_listener(struct Scene *scene);
100
101 void *BKE_sound_scene_add_scene_sound(
102     struct Scene *scene, struct Sequence *sequence, int startframe, int endframe, int frameskip);
103 void *BKE_sound_scene_add_scene_sound_defaults(struct Scene *scene, struct Sequence *sequence);
104
105 void *BKE_sound_add_scene_sound(
106     struct Scene *scene, struct Sequence *sequence, int startframe, int endframe, int frameskip);
107 void *BKE_sound_add_scene_sound_defaults(struct Scene *scene, struct Sequence *sequence);
108
109 void BKE_sound_remove_scene_sound(struct Scene *scene, void *handle);
110
111 void BKE_sound_mute_scene_sound(void *handle, char mute);
112
113 void BKE_sound_move_scene_sound(
114     struct Scene *scene, void *handle, int startframe, int endframe, int frameskip);
115 void BKE_sound_move_scene_sound_defaults(struct Scene *scene, struct Sequence *sequence);
116
117 void BKE_sound_update_scene_sound(void *handle, struct bSound *sound);
118
119 void BKE_sound_set_cfra(int cfra);
120
121 void BKE_sound_set_scene_volume(struct Scene *scene, float volume);
122
123 void BKE_sound_set_scene_sound_volume(void *handle, float volume, char animated);
124
125 void BKE_sound_set_scene_sound_pitch(void *handle, float pitch, char animated);
126
127 void BKE_sound_set_scene_sound_pan(void *handle, float pan, char animated);
128
129 void BKE_sound_update_sequencer(struct Main *main, struct bSound *sound);
130
131 void BKE_sound_play_scene(struct Scene *scene);
132
133 void BKE_sound_stop_scene(struct Scene *scene);
134
135 void BKE_sound_seek_scene(struct Main *bmain, struct Scene *scene);
136
137 float BKE_sound_sync_scene(struct Scene *scene);
138
139 int BKE_sound_scene_playing(struct Scene *scene);
140
141 void BKE_sound_free_waveform(struct bSound *sound);
142
143 void BKE_sound_read_waveform(struct bSound *sound, short *stop);
144
145 void BKE_sound_update_scene(struct Main *bmain, struct Scene *scene);
146
147 void *BKE_sound_get_factory(void *sound);
148
149 float BKE_sound_get_length(struct bSound *sound);
150
151 char **BKE_sound_get_device_names(void);
152
153 #endif /* __BKE_SOUND_H__ */