1 /*************************************************************************/
2 /*  audio_stream_preview.h                                               */
3 /*************************************************************************/
4 /*                       This file is part of:                           */
5 /*                           GODOT ENGINE                                */
6 /*                      https://godotengine.org                          */
7 /*************************************************************************/
8 /* Copyright (c) 2007-2020 Juan Linietsky, Ariel Manzur.                 */
9 /* Copyright (c) 2014-2020 Godot Engine contributors (cf. AUTHORS.md).   */
10 /*                                                                       */
11 /* Permission is hereby granted, free of charge, to any person obtaining */
12 /* a copy of this software and associated documentation files (the       */
13 /* "Software"), to deal in the Software without restriction, including   */
14 /* without limitation the rights to use, copy, modify, merge, publish,   */
15 /* distribute, sublicense, and/or sell copies of the Software, and to    */
16 /* permit persons to whom the Software is furnished to do so, subject to */
17 /* the following conditions:                                             */
18 /*                                                                       */
19 /* The above copyright notice and this permission notice shall be        */
20 /* included in all copies or substantial portions of the Software.       */
21 /*                                                                       */
22 /* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,       */
23 /* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF    */
24 /* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.*/
25 /* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY  */
26 /* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,  */
27 /* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE     */
28 /* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.                */
29 /*************************************************************************/
30 
31 #ifndef AUDIO_STREAM_PREVIEW_H
32 #define AUDIO_STREAM_PREVIEW_H
33 
34 #include "core/os/thread.h"
35 #include "scene/main/node.h"
36 #include "servers/audio/audio_stream.h"
37 
38 class AudioStreamPreview : public Reference {
39 	GDCLASS(AudioStreamPreview, Reference);
40 	friend class AudioStream;
41 	Vector<uint8_t> preview;
42 	float length;
43 
44 	friend class AudioStreamPreviewGenerator;
45 
46 public:
47 	float get_length() const;
48 	float get_max(float p_time, float p_time_next) const;
49 	float get_min(float p_time, float p_time_next) const;
50 
51 	AudioStreamPreview();
52 };
53 
54 class AudioStreamPreviewGenerator : public Node {
55 	GDCLASS(AudioStreamPreviewGenerator, Node);
56 
57 	static AudioStreamPreviewGenerator *singleton;
58 
59 	struct Preview {
60 		Ref<AudioStreamPreview> preview;
61 		Ref<AudioStream> base_stream;
62 		Ref<AudioStreamPlayback> playback;
63 		volatile bool generating;
64 		ObjectID id;
65 		Thread *thread;
66 	};
67 
68 	Map<ObjectID, Preview> previews;
69 
70 	static void _preview_thread(void *p_preview);
71 
72 	void _update_emit(ObjectID p_id);
73 
74 protected:
75 	void _notification(int p_what);
76 	static void _bind_methods();
77 
78 public:
get_singleton()79 	static AudioStreamPreviewGenerator *get_singleton() { return singleton; }
80 
81 	Ref<AudioStreamPreview> generate_preview(const Ref<AudioStream> &p_stream);
82 
83 	AudioStreamPreviewGenerator();
84 };
85 
86 #endif // AUDIO_STREAM_PREVIEW_H
87