Loading...
Searching...
No Matches
Music.h
Go to the documentation of this file.
1
2//
3// SFML - Simple and Fast Multimedia Library
4// Copyright (C) 2007-2024 Laurent Gomila (laurent@sfml-dev.org)
5//
6// This software is provided 'as-is', without any express or implied warranty.
7// In no event will the authors be held liable for any damages arising from the use of this software.
8//
9// Permission is granted to anyone to use this software for any purpose,
10// including commercial applications, and to alter it and redistribute it freely,
11// subject to the following restrictions:
12//
13// 1. The origin of this software must not be misrepresented;
14// you must not claim that you wrote the original software.
15// If you use this software in a product, an acknowledgment
16// in the product documentation would be appreciated but is not required.
17//
18// 2. Altered source versions must be plainly marked as such,
19// and must not be misrepresented as being the original software.
20//
21// 3. This notice may not be removed or altered from any source distribution.
22//
24
25#ifndef SFML_MUSIC_H
26#define SFML_MUSIC_H
27
29// Headers
31#include <SFML/Audio/Export.h>
33#include <SFML/Audio/Types.h>
35#include <SFML/System/Time.h>
36#include <SFML/System/Vector3.h>
37#include <stddef.h>
38
39
44typedef struct
45{
49
50
66
82CSFML_AUDIO_API sfMusic* sfMusic_createFromMemory(const void* data, size_t sizeInBytes);
83
99
107
121
131
141
158
180
194
205
217
229
242
252
262
276CSFML_AUDIO_API void sfMusic_setPitch(sfMusic* music, float pitch);
277
288CSFML_AUDIO_API void sfMusic_setVolume(sfMusic* music, float volume);
289
302
317
332CSFML_AUDIO_API void sfMusic_setMinDistance(sfMusic* music, float distance);
333
350CSFML_AUDIO_API void sfMusic_setAttenuation(sfMusic* music, float attenuation);
351
363
373
383
393
404
414
424
425
426#endif // SFML_MUSIC_H
#define CSFML_AUDIO_API
struct sfMusic sfMusic
Definition Audio/Types.h:29
int sfBool
Definition Config.h:153
sfSoundStatus sfMusic_getStatus(const sfMusic *music)
Get the current status of a music (stopped, paused, playing)
sfTime sfMusic_getPlayingOffset(const sfMusic *music)
Get the current playing position of a music.
sfMusic * sfMusic_createFromStream(sfInputStream *stream)
Create a new music and load it from a custom stream.
sfVector3f sfMusic_getPosition(const sfMusic *music)
Get the 3D position of a music in the audio scene.
void sfMusic_setPlayingOffset(sfMusic *music, sfTime timeOffset)
Change the current playing position of a music.
float sfMusic_getVolume(const sfMusic *music)
Get the volume of a music.
unsigned int sfMusic_getChannelCount(const sfMusic *music)
Return the number of channels of a music.
void sfMusic_setRelativeToListener(sfMusic *music, sfBool relative)
Make a musics's position relative to the listener or absolute.
sfMusic * sfMusic_createFromMemory(const void *data, size_t sizeInBytes)
Create a new music and load it from a file in memory.
sfBool sfMusic_isRelativeToListener(const sfMusic *music)
Tell whether a music's position is relative to the listener or is absolute.
void sfMusic_setAttenuation(sfMusic *music, float attenuation)
Set the attenuation factor of a music.
void sfMusic_setLoopPoints(sfMusic *music, sfTimeSpan timePoints)
Sets the beginning and end of the sound's looping sequence using sf::Time.
void sfMusic_setLoop(sfMusic *music, sfBool loop)
Set whether or not a music should loop after reaching the end.
sfBool sfMusic_getLoop(const sfMusic *music)
Tell whether or not a music is in loop mode.
float sfMusic_getAttenuation(const sfMusic *music)
Get the attenuation factor of a music.
sfMusic * sfMusic_createFromFile(const char *filename)
Create a new music and load it from a file.
void sfMusic_setPosition(sfMusic *music, sfVector3f position)
Set the 3D position of a music in the audio scene.
sfTimeSpan sfMusic_getLoopPoints(const sfMusic *music)
Get the positions of the of the sound's looping sequence.
void sfMusic_setMinDistance(sfMusic *music, float distance)
Set the minimum distance of a music.
sfTime sfMusic_getDuration(const sfMusic *music)
Get the total duration of a music.
void sfMusic_pause(sfMusic *music)
Pause a music.
void sfMusic_stop(sfMusic *music)
Stop playing a music.
unsigned int sfMusic_getSampleRate(const sfMusic *music)
Get the sample rate of a music.
float sfMusic_getPitch(const sfMusic *music)
Get the pitch of a music.
void sfMusic_play(sfMusic *music)
Start or resume playing a music.
void sfMusic_setVolume(sfMusic *music, float volume)
Set the volume of a music.
float sfMusic_getMinDistance(const sfMusic *music)
Get the minimum distance of a music.
void sfMusic_destroy(sfMusic *music)
Destroy a music.
void sfMusic_setPitch(sfMusic *music, float pitch)
Set the pitch of a music.
sfSoundStatus
Enumeration of statuses for sounds and musics.
Definition SoundStatus.h:39
Set of callbacks that allow users to define custom file streams.
Definition InputStream.h:45
Structure defining a time range.
Definition Music.h:45
sfTime offset
The beginning offset of the time range.
Definition Music.h:46
sfTime length
The length of the time range.
Definition Music.h:47
Represents a time value.
Definition Time.h:39
3-component vector of floats
Definition Vector3.h:39