class SFML::Music

# File lib/sfml/audio/music.rb, line 22
def self.from_memory(bytes, **opts)
  raise ArgumentError, "expected a String, got #{bytes.class}" unless bytes.is_a?(String)

  buf = FFI::MemoryPointer.new(:uint8, bytes.bytesize)
  buf.write_bytes(bytes)
  ptr = C::Audio.sfMusic_createFromMemory(buf, bytes.bytesize)
  raise LoadError, "sfMusic_createFromMemory returned NULL — unsupported format?" if ptr.null?

  m = _wrap(ptr, opts)
  m.instance_variable_set(:@_memory_pin, buf)   # keep buffer alive
  m
end

# File lib/sfml/audio/music.rb, line 38
def self.from_stream(io, **opts)
  stream = SFML::InputStream.new(io)
  ptr = C::Audio.sfMusic_createFromStream(stream.to_ptr)
  raise LoadError, "sfMusic_createFromStream returned NULL — unsupported format?" if ptr.null?

  m = _wrap(ptr, opts)
  m.instance_variable_set(:@_stream_pin, stream)
  m.instance_variable_set(:@_io_pin, io)
  m
end

# File lib/sfml/audio/music.rb, line 11
def self.load(path, **opts)
  ptr = C::Audio.sfMusic_createFromFile(path.to_s)
  raise LoadError, "Could not load music from #{path.inspect}" if ptr.null?

  _wrap(ptr, opts)
end

# File lib/sfml/audio/music.rb, line 300
def _take_ownership(ptr)
  @handle = FFI::AutoPointer.new(ptr, C::Audio.method(:sfMusic_destroy))
end

# File lib/sfml/audio/music.rb, line 194
def attenuation = C::Audio.sfMusic_getAttenuation(@handle)

# Set the attenuation.
def attenuation=(value)
  C::Audio.sfMusic_setAttenuation(@handle, value.to_f)
end

# Distance below which volume is not attenuated.
def min_distance = C::Audio.sfMusic_getMinDistance(@handle)

# Set the min-distance.
def min_distance=(value)
  C::Audio.sfMusic_setMinDistance(@handle, value.to_f)
end

# `true` if `#position` is interpreted relative to the listener.
def relative_to_listener? = C::Audio.sfMusic_isRelativeToListener(@handle)

# Toggle listener-relative positioning.
def relative_to_listener=(value)
  C::Audio.sfMusic_setRelativeToListener(@handle, value ? true : false)
end

# ---- Stream introspection ----

# Number of audio channels (1 = mono, 2 = stereo, ...).
def channel_count = C::Audio.sfMusic_getChannelCount(@handle)
# Sample rate in Hz (e.g. 44_100 for CD-quality).
def sample_rate   = C::Audio.sfMusic_getSampleRate(@handle)

# The portion of the track that loops when `looping = true`.
# Returns `[offset, length]` of `SFML::Time`s; defaults to the
# whole track. Set with `loop_points = [Time, Time]`.
def loop_points
  span = C::Audio.sfMusic_getLoopPoints(@handle)
  [Time.from_native(span[:offset]), Time.from_native(span[:length])]
end

# Set the looping window. Accepts `[offset, length]` of either
# `SFML::Time` or numeric seconds.
def loop_points=(value)
  offset_t, length_t = value
  raise ArgumentError, "expected [offset_time, length_time]" unless offset_t && length_t

  span = C::Audio::TimeSpan.new
  span[:offset][:microseconds] = offset_t.is_a?(Time) ? offset_t.microseconds : Time.seconds(offset_t.to_f).microseconds
  span[:length][:microseconds] = length_t.is_a?(Time) ? length_t.microseconds : Time.seconds(length_t.to_f).microseconds
  C::Audio.sfMusic_setLoopPoints(@handle, span)
end

# ---- 3D-audio extras (mirror of Sound's) ----

# Stereo pan in [-1.0, 1.0] — see `Sound#pan`.
def pan = C::Audio.sfMusic_getPan(@handle)

# Set the stereo pan.
def pan=(v)
  C::Audio.sfMusic_setPan(@handle, v.to_f)
end

# Lower gain bound — see `Sound#min_gain`.
def min_gain = C::Audio.sfMusic_getMinGain(@handle)

# Set the min-gain floor.
def min_gain=(v)
  C::Audio.sfMusic_setMinGain(@handle, v.to_f)
end

# Upper gain bound — see `Sound#max_gain`.
def max_gain = C::Audio.sfMusic_getMaxGain(@handle)

# Set the max-gain cap.
def max_gain=(v)
  C::Audio.sfMusic_setMaxGain(@handle, v.to_f)
end

# Distance beyond which the source is fully attenuated.
def max_distance = C::Audio.sfMusic_getMaxDistance(@handle)

# Set the max-distance.
def max_distance=(v)
  C::Audio.sfMusic_setMaxDistance(@handle, v.to_f)
end

# `true` if 3D positional / Doppler / cone math is applied at
# mix time.
def spatialization_enabled? = C::Audio.sfMusic_isSpatializationEnabled(@handle)

# Toggle 3D spatialisation.
def spatialization_enabled=(v)
  C::Audio.sfMusic_setSpatializationEnabled(@handle, v ? true : false)
end

# Multiplier on the Listener's directional attenuation cone —
# see `Sound#directional_attenuation_factor`.
def directional_attenuation_factor
  C::Audio.sfMusic_getDirectionalAttenuationFactor(@handle)
end

# Set the directional-attenuation factor.
def directional_attenuation_factor=(v)
  C::Audio.sfMusic_setDirectionalAttenuationFactor(@handle, v.to_f)
end

private

def _take_ownership(ptr)
  @handle = FFI::AutoPointer.new(ptr, C

# File lib/sfml/audio/music.rb, line 197
def attenuation=(value)
  C::Audio.sfMusic_setAttenuation(@handle, value.to_f)
end

# File lib/sfml/audio/music.rb, line 220
def channel_count = C::Audio.sfMusic_getChannelCount(@handle)
# Sample rate in Hz (e.g. 44_100 for CD-quality).
def sample_rate   = C::Audio.sfMusic_getSampleRate(@handle)

# The portion of the track that loops when `looping = true`.
# Returns `[offset, length]` of `SFML::Time`s; defaults to the
# whole track. Set with `loop_points = [Time, Time]`.
def loop_points
  span = C::Audio.sfMusic_getLoopPoints(@handle)
  [Time.from_native(span[:offset]), Time.from_native(span[:length])]
end

# Set the looping window. Accepts `[offset, length]` of either
# `SFML::Time` or numeric seconds.
def loop_points=(value)
  offset_t, length_t = value
  raise ArgumentError, "expected [offset_time, length_time]" unless offset_t && length_t

  span = C::Audio::TimeSpan.new
  span[:offset][:microseconds] = offset_t.is_a?(Time) ? offset_t.microseconds : Time.seconds(offset_t.to_f).microseconds
  span[:length][:microseconds] = length_t.is_a?(Time) ? length_t.microseconds : Time.seconds(length_t.to_f).microseconds
  C::Audio.sfMusic_setLoopPoints(@handle, span)
end

# ---- 3D-audio extras (mirror of Sound's) ----

# Stereo pan in [-1.0, 1.0] — see `Sound#pan`.
def pan = C::Audio.sfMusic_getPan(@handle)

# Set the stereo pan.
def pan=(v)
  C::Audio.sfMusic_setPan(@handle, v.to_f)
end

# Lower gain bound — see `Sound#min_gain`.
def min_gain = C::Audio.sfMusic_getMinGain(@handle)

# Set the min-gain floor.
def min_gain=(v)
  C::Audio.sfMusic_setMinGain(@handle, v.to_f)
end

# Upper gain bound — see `Sound#max_gain`.
def max_gain = C::Audio.sfMusic_getMaxGain(@handle)

# Set the max-gain cap.
def max_gain=(v)
  C::Audio.sfMusic_setMaxGain(@handle, v.to_f)
end

# Distance beyond which the source is fully attenuated.
def max_distance = C::Audio.sfMusic_getMaxDistance(@handle)

# Set the max-distance.
def max_distance=(v)
  C::Audio.sfMusic_setMaxDistance(@handle, v.to_f)
end

# `true` if 3D positional / Doppler / cone math is applied at
# mix time.
def spatialization_enabled? = C::Audio.sfMusic_isSpatializationEnabled(@handle)

# Toggle 3D spatialisation.
def spatialization_enabled=(v)
  C::Audio.sfMusic_setSpatializationEnabled(@handle, v ? true : false)
end

# Multiplier on the Listener's directional attenuation cone —
# see `Sound#directional_attenuation_factor`.
def directional_attenuation_factor
  C::Audio.sfMusic_getDirectionalAttenuationFactor(@handle)
end

# Set the directional-attenuation factor.
def directional_attenuation_factor=(v)
  C::Audio.sfMusic_setDirectionalAttenuationFactor(@handle, v.to_f)
end

private

def _take_ownership(ptr)
  @handle = FFI::AutoPointer.new(ptr, C::Audio.method(:sfMusic_destroy

# File lib/sfml/audio/music.rb, line 130
def cone
  SoundCone.from_native(C::Audio.sfMusic_getCone(@handle))
end

# File lib/sfml/audio/music.rb, line 136
def cone=(value)
  cone =
    case value
    when SoundCone then value
    when Hash      then SoundCone.new(**value)
    else
      raise ArgumentError, "Music#cone= expects SoundCone or Hash; got #{value.class}"
    end
  C::Audio.sfMusic_setCone(@handle, cone.to_native)
end

# File lib/sfml/audio/music.rb, line 116
def direction
  v = C::Audio.sfMusic_getDirection(@handle)
  Vector3.new(v[:x], v[:y], v[:z])
end

# File lib/sfml/audio/music.rb, line 122
def direction=(value)
  vec = value.is_a?(Vector3) ? value : Vector3.new(*value)
  packed = C::System::Vector3f.new
  packed[:x] = vec.x.to_f; packed[:y] = vec.y.to_f; packed[:z] = vec.z.to_f
  C::Audio.sfMusic_setDirection(@handle, packed)
end

# File lib/sfml/audio/music.rb, line 289
def directional_attenuation_factor
  C::Audio.sfMusic_getDirectionalAttenuationFactor(@handle)
end

# File lib/sfml/audio/music.rb, line 294
def directional_attenuation_factor=(v)
  C::Audio.sfMusic_setDirectionalAttenuationFactor(@handle, v.to_f)
end

# File lib/sfml/audio/music.rb, line 111
def doppler_factor    = C::Audio.sfMusic_getDopplerFactor(@handle)
# Set the per-source Doppler scale.
def doppler_factor=(v) C::Audio.sfMusic_setDopplerFactor(@handle, v.to_f); end

# The direction the music's cone points.
def direction
  v = C::Audio.sfMusic_getDirection(@handle)
  Vector3.new(v[:x], v[:y], v[:z])
end

# Set the direction vector — accepts Vector3 or `[x, y, z]`.
def direction=(value)
  vec = value.is_a?(Vector3) ? value : Vector3.new(*value)
  packed = C::System::Vector3f.new
  packed[:x] = vec.x.to_f; packed[:y] = vec.y.to_f; packed[:z] = vec.z.to_f
  C::Audio.sfMusic_setDirection(@handle, packed)
end

# Directional-attenuation cone — see SFML::SoundCone.
def cone
  SoundCone.from_native(C::Audio.sfMusic_getCone(@handle))
end

# Set the cone. Accepts a `SoundCone` or a Hash with
# `inner_angle`, `outer_angle`, `outer_gain`.
def cone=(value)
  cone =
    case value
    when SoundCone then value
    when Hash      then SoundCone.new(**value)
    else
      raise ArgumentError, "Music#cone= expects SoundCone or Hash; got #{value.class}"
    end
  C::Audio.sfMusic_setCone(@handle, cone.to_native)
end

# See Sound#effect_processor= — same audio-thread DSP callback.
def effect_processor=(callable)
  @effect_cb = callable.nil? ? nil : Audio._build_effect_processor(callable)
  C::Audio.sfMusic_setEffectProcessor(@handle, @effect_cb, nil)
end

# `true` if the track restarts after reaching the end (or its
# `loop_points` length).
# Cached on the Ruby side; see Sound#looping? for the why.
def looping?
  @looping
end

# Toggle looping playback.
def looping=(value)
  @looping = value ? true : false
  C::Audio.sfMusic_setLooping(@handle, @looping)
end

# Playback volume in [0, 100] — 100 = unattenuated.
def volume = C::Audio.sfMusic_getVolume(@handle)

# Set the playback volume in [0, 100].
def volume=(value)
  C::Audio.sfMusic_setVolume(@handle, value.to_f)
end

# Pitch multiplier. 1.0 = normal, 2.0 = octave up, 0.5 = octave down.
def pitch = C::Audio.sfMusic_getPitch(@handle)

# Set the pitch multiplier.
def pitch=(value)
  C::Audio.sfMusic_setPitch(@handle, value.to_f)
end

# 3D positional audio — see SFML::Sound for the why.
def position
  Vector3.from_native(C::Audio.sfMusic_getPosition(@handle))
end

# Set the 3D position — accepts Vector3 or `[x, y, z]`.
def position=(value)
  vec = value.is_a?(Vector3) ? value : Vector3.new(*value)
  C::Audio.sfMusic_setPosition(@handle, vec.to_native_f)
end

# Falloff sharpness with distance — see `Sound#attenuation`.
def attenuation = C::Audio.sfMusic_getAttenuation(@handle)

# Set the attenuation.
def attenuation=(value)
  C::Audio.sfMusic_setAttenuation(@handle, value.to_f)
end

# Distance below which volume is not attenuated.
def min_distance = C::Audio.sfMusic_getMinDistance(@handle)

# Set the min-distance.
def min_distance=(value)
  C::Audio.sfMusic_setMinDistance(@handle, value.to_f)
end

# `true` if `#position` is interpreted relative to the listener.
def relative_to_listener? = C::Audio.sfMusic_isRelativeToListener(@handle)

# Toggle listener-relative positioning.
def relative_to_listener=(value)
  C::Audio.sfMusic_setRelativeToListener(@handle, value ? true : false)
end

# ---- Stream introspection ----

# Number of audio channels (1 = mono, 2 = stereo, ...).
def channel_count = C::Audio.sfMusic_getChannelCount(@handle)
# Sample rate in Hz (e.g. 44_100 for CD-quality).
def sample_rate   = C::Audio.sfMusic_getSampleRate(@handle)

# The portion of the track that loops when `looping = true`.
# Returns `[offset, length]` of `SFML::Time`s; defaults to the
# whole track. Set with `loop_points = [Time, Time]`.
def loop_points
  span = C::Audio.sfMusic_getLoopPoints(@handle)
  [Time.from_native(span[:offset]), Time.from_native(span[:length])]
end

# Set the looping window. Accepts `[offset, length]` of either
# `SFML::Time` or numeric seconds.
def loop_points=(value)
  offset_t, length_t = value
  raise ArgumentError, "expected [offset_time, length_time]" unless offset_t && length_t

  span = C::Audio::TimeSpan.new
  span[:offset][:microseconds] = offset_t.is_a?(Time) ? offset_t.microseconds : Time.seconds(offset_t.to_f).microseconds
  span[:length][:microseconds] = length_t.is_a?(Time) ? length_t.microseconds : Time.seconds(length_t.to_f).microseconds
  C::Audio.sfMusic_setLoopPoints(@handle, span)
end

# ---- 3D-audio extras (mirror of Sound's) ----

# Stereo pan in [-1.0, 1.0] — see `Sound#pan`.
def pan = C::Audio.sfMusic_getPan(@handle)

# Set the stereo pan.
def pan=(v)
  C::Audio.sfMusic_setPan(@handle, v.to_f)
end

# Lower gain bound — see `Sound#min_gain`.
def min_gain = C::Audio.sfMusic_getMinGain(@handle)

# Set the min-gain floor.
def min_gain=(v)
  C::Audio.sfMusic_setMinGain(@handle, v.to_f)
end

# Upper gain bound — see `Sound#max_gain`.
def max_gain = C::Audio.sfMusic_getMaxGain(@handle)

# Set the max-gain cap.
def max_gain=(v)
  C::Audio.sfMusic_setMaxGain(@handle, v.to_f)
end

# Distance beyond which the source is fully attenuated.
def max_distance = C::Audio.sfMusic_getMaxDistance(@handle)

# Set the max-distance.
def max_distance=(v)
  C::Audio.sfMusic_setMaxDistance(@handle, v.to_f)
end

# `true` if 3D positional / Doppler / cone math is applied at
# mix time.
def spatialization_enabled? = C::Audio.sfMusic_isSpatializationEnabled(@handle)

# Toggle 3D spatialisation.
def spatialization_enabled=(v)
  C::Audio.sfMusic_setSpatializationEnabled(@handle, v ? true : false)
end

# Multiplier on the Listener's directional attenuation cone —
# see `Sound#directional_attenuation_factor`.
def directional_attenuation_factor
  C::Audio.sfMusic_getDirectionalAttenuationFactor(@handle)
end

# Set the directional-attenuation factor.
def directional_attenuation_factor=(v)
  C::Audio.sfMusic_setDirectionalAttenuationFactor(@handle, v.to_f)
end

private

def _take_ownership(ptr)
  @handle = FFI::AutoPointer.

# File lib/sfml/audio/music.rb, line 113
def doppler_factor=(v) C::Audio.sfMusic_setDopplerFactor(@handle, v.to_f); end

# File lib/sfml/audio/music.rb, line 79
def duration = Time.from_native(C::Audio.sfMusic_getDuration(@handle))

# Current playback head as a SFML::Time. Reads from the underlying
# OpenAL source — only meaningful while the music is playing or
# paused (not after #stop).
def playing_offset
  Time.from_native(C::Audio.sfMusic_getPlayingOffset(@handle))
end

# Seek to `value` (a SFML::Time, or seconds as a Numeric). Works
# while the music is playing, paused, or stopped.
def playing_offset=(value)
  t = value.is_a?(Time) ? value : Time.seconds(value.to_f)
  C::Audio.sfMusic_setPlayingOffset(@handle, t.to_native)
end

# 3D velocity, Doppler factor, direction, cone — see Sound for
# the same methods on the simpler buffered source.
def velocity
  v = C::Audio.sfMusic_getVelocity(@handle)
  Vector3.new(v[:x], v[:y], v[:z])
end

# Set the 3D velocity — accepts Vector3 or `[x, y, z]`.
def velocity=(value)
  vec = value.is_a?(Vector3) ? value : Vector3.new(*value)
  packed = C::System::Vector3f.new
  packed[:x] = vec.x.to_f; packed[:y] = vec.y.to_f; packed[:z] = vec.z.to_f
  C::Audio.sfMusic_setVelocity(@handle, packed)
end

# Per-source Doppler scale. 1.0 realistic, 0 disables.
def doppler_factor    = C::Audio.sfMusic_getDopplerFactor(@handle)
# Set the per-source Doppler scale.
def doppler_factor=(v) C::Audio.sfMusic_setDopplerFactor(@handle, v.to_f); end

# The direction the music's cone points.
def direction
  v = C::Audio.sfMusic_getDirection(@handle)
  Vector3.new(v[:x], v[:y], v[:z])
end

# Set the direction vector — accepts Vector3 or `[x, y, z]`.
def direction=(value)
  vec = value.is_a?(Vector3) ? value : Vector3.new(*value)
  packed = C::System::Vector3f.new
  packed[:x] = vec.x.to_f; packed[:y] = vec.y.to_f; packed[:z] = vec.z.to_f
  C::Audio.sfMusic_setDirection(@handle, packed)
end

# Directional-attenuation cone — see SFML::SoundCone.
def cone
  SoundCone.from_native(C::Audio.sfMusic_getCone(@handle))
end

# Set the cone. Accepts a `SoundCone` or a Hash with
# `inner_angle`, `outer_angle`, `outer_gain`.
def cone=(value)
  cone =
    case value
    when SoundCone then value
    when Hash      then SoundCone.new(**value)
    else
      raise ArgumentError, "Music#cone= expects SoundCone or Hash; got #{value.class}"
    end
  C::Audio.sfMusic_setCone(@handle, cone.to_native)
end

# See Sound#effect_processor= — same audio-thread DSP callback.
def effect_processor=(callable)
  @effect_cb = callable.nil? ? nil : Audio._build_effect_processor(callable)
  C::Audio.sfMusic_setEffectProcessor(@handle, @effect_cb, nil)
end

# `true` if the track restarts after reaching the end (or its
# `loop_points` length).
# Cached on the Ruby side; see Sound#looping? for the why.
def looping?
  @looping
end

# Toggle looping playback.
def looping=(value)
  @looping = value ? true : false
  C::Audio.sfMusic_setLooping(@handle, @looping)
end

# Playback volume in [0, 100] — 100 = unattenuated.
def volume = C::Audio.sfMusic_getVolume(@handle)

# Set the playback volume in [0, 100].
def volume=(value)
  C::Audio.sfMusic_setVolume(@handle, value.to_f)
end

# Pitch multiplier. 1.0 = normal, 2.0 = octave up, 0.5 = octave down.
def pitch = C::Audio.sfMusic_getPitch(@handle)

# Set the pitch multiplier.
def pitch=(value)
  C::Audio.sfMusic_setPitch(@handle, value.to_f)
end

# 3D positional audio — see SFML::Sound for the why.
def position
  Vector3.from_native(C::Audio.sfMusic_getPosition(@handle))
end

# Set the 3D position — accepts Vector3 or `[x, y, z]`.
def position=(value)
  vec = value.is_a?(Vector3) ? value : Vector3.new(*value)
  C::Audio.sfMusic_setPosition(@handle, vec.to_native_f)
end

# Falloff sharpness with distance — see `Sound#attenuation`.
def attenuation = C::Audio.sfMusic_getAttenuation(@handle)

# Set the attenuation.
def attenuation=(value)
  C::Audio.sfMusic_setAttenuation(@handle, value.to_f)
end

# Distance below which volume is not attenuated.
def min_distance = C::Audio.sfMusic_getMinDistance(@handle)

# Set the min-distance.
def min_distance=(value)
  C::Audio.sfMusic_setMinDistance(@handle, value.to_f)
end

# `true` if `#position` is interpreted relative to the listener.
def relative_to_listener? = C::Audio.sfMusic_isRelativeToListener(@handle)

# Toggle listener-relative positioning.
def relative_to_listener=(value)
  C::Audio.sfMusic_setRelativeToListener(@handle, value ? true : false)
end

# ---- Stream introspection ----

# Number of audio channels (1 = mono, 2 = stereo, ...).
def channel_count = C::Audio.sfMusic_getChannelCount(@handle)
# Sample rate in Hz (e.g. 44_100 for CD-quality).
def sample_rate   = C::Audio.sfMusic_getSampleRate(@handle)

# The portion of the track that loops when `looping = true`.
# Returns `[offset, length]` of `SFML::Time`s; defaults to the
# whole track. Set with `loop_points = [Time, Time]`.
def loop_points
  span = C::Audio.sfMusic_getLoopPoints(@handle)
  [Time.from_native(span[:offset]), Time.from_native(span[:length])]
end

# Set the looping window. Accepts `[offset, length]` of either
# `SFML::Time` or numeric seconds.
def loop_points=(value)
  offset_t, length_t = value
  raise ArgumentError, "expected [offset_time, length_time]" unless offset_t && length_t

  span = C::Audio::TimeSpan.new
  span[:offset][:microseconds] = offset_t.is_a?(Time) ? offset_t.microseconds : Time.seconds(offset_t.to_f).microseconds
  span[:length][:microseconds] = length_t.is_a?(Time) ? length_t.microseconds : Time.seconds(length_t.to_f).microseconds
  C::Audio.sfMusic_setLoopPoints(@handle, span)
end

# ---- 3D-audio extras (mirror of Sound's) ----

# Stereo pan in [-1.0, 1.0] — see `Sound#pan`.
def pan = C::Audio.sfMusic_getPan(@handle)

# Set the stereo pan.
def pan=(v)
  C::Audio.sfMusic_setPan(@handle, v.to_f)
end

# Lower gain bound — see `Sound#min_gain`.
def min_gain = C::Audio.sfMusic_getMinGain(@handle)

# Set the min-gain floor.
def min_gain=(v)
  C::Audio.sfMusic_setMinGain(@handle, v.to_f)
end

# Upper gain bound — see `Sound#max_gain`.
def max_gain = C::Audio.sfMusic_getMaxGain(@handle)

# Set the max-gain cap.
def max_gain=(v)
  C::Audio.sfMusic_setMaxGain(@handle, v.to_f)
end

# Distance beyond which the source is fully attenuated.
def max_distance = C::Audio.sfMusic_getMaxDistance(@handle)

# Set the max-distance.
def max_distance=(v)
  C::Audio.sfMusic_setMaxDistance(@handle, v.to_f)
end

# `true` if 3D positional / Doppler / cone math is applied at
# mix time.
def spatialization_enabled? = C::Audio.sfMusic_isSpatializationEnabled(@handle)

# Toggle 3D spatialisation.
def spatialization_enabled=(v)
  C::Audio.sfMusic_setSpatializationEnabled(@handle, v ? true : false)
end

# Multiplier on the Listener's directional attenuation cone —
# see `Sound#directional_attenuation_factor`.
def directional_attenuation_factor
  C::Audio.sfMusic_getDirectionalAttenuationFactor(@handle)
end

# Set the directional-attenuation factor.
def directional_attenuation_factor=(v)
  C::Audio.sfMusic_setDirectionalAttenuationFactor(@handle, v.to_f)
end

private

def _take_ownership(ptr)
  @handle = FFI::

# File lib/sfml/audio/music.rb, line 148
def effect_processor=(callable)
  @effect_cb = callable.nil? ? nil : Audio._build_effect_processor(callable)
  C::Audio.sfMusic_setEffectProcessor(@handle, @effect_cb, nil)
end

# File lib/sfml/audio/music.rb, line 227
def loop_points
  span = C::Audio.sfMusic_getLoopPoints(@handle)
  [Time.from_native(span[:offset]), Time.from_native(span[:length])]
end

# File lib/sfml/audio/music.rb, line 234
def loop_points=(value)
  offset_t, length_t = value
  raise ArgumentError, "expected [offset_time, length_time]" unless offset_t && length_t

  span = C::Audio::TimeSpan.new
  span[:offset][:microseconds] = offset_t.is_a?(Time) ? offset_t.microseconds : Time.seconds(offset_t.to_f).microseconds
  span[:length][:microseconds] = length_t.is_a?(Time) ? length_t.microseconds : Time.seconds(length_t.to_f).microseconds
  C::Audio.sfMusic_setLoopPoints(@handle, span)
end

# File lib/sfml/audio/music.rb, line 161
def looping=(value)
  @looping = value ? true : false
  C::Audio.sfMusic_setLooping(@handle, @looping)
end

# File lib/sfml/audio/music.rb, line 156
def looping?
  @looping
end

# File lib/sfml/audio/music.rb, line 271
    def max_distance = C::Audio.sfMusic_getMaxDistance(@handle)

    # Set the max-distance.
    def max_distance=(v)
      C::Audio.sfMusic_setMaxDistance(@handle, v.to_f)
    end

    # `true` if 3D positional / Doppler / cone math is applied at
    # mix time.
    def spatialization_enabled? = C::Audio.sfMusic_isSpatializationEnabled(@handle)

    # Toggle 3D spatialisation.
    def spatialization_enabled=(v)
      C::Audio.sfMusic_setSpatializationEnabled(@handle, v ? true : false)
    end

    # Multiplier on the Listener's directional attenuation cone —
    # see `Sound#directional_attenuation_factor`.
    def directional_attenuation_factor
      C::Audio.sfMusic_getDirectionalAttenuationFactor(@handle)
    end

    # Set the directional-attenuation factor.
    def directional_attenuation_factor=(v)
      C::Audio.sfMusic_setDirectionalAttenuationFactor(@handle, v.to_f)
    end

    private

    def _take_ownership(ptr)
      @handle = FFI::AutoPointer.new(ptr, C::Audio.method(:sfMusic_destroy))
    end
  end
end

# File lib/sfml/audio/music.rb, line 274
def max_distance=(v)
  C::Audio.sfMusic_setMaxDistance(@handle, v.to_f)
end

# File lib/sfml/audio/music.rb, line 263
  def max_gain = C::Audio.sfMusic_getMaxGain(@handle)

  # Set the max-gain cap.
  def max_gain=(v)
    C::Audio.sfMusic_setMaxGain(@handle, v.to_f)
  end

  # Distance beyond which the source is fully attenuated.
  def max_distance = C::Audio.sfMusic_getMaxDistance(@handle)

  # Set the max-distance.
  def max_distance=(v)
    C::Audio.sfMusic_setMaxDistance(@handle, v.to_f)
  end

  # `true` if 3D positional / Doppler / cone math is applied at
  # mix time.
  def spatialization_enabled? = C::Audio.sfMusic_isSpatializationEnabled(@handle)

  # Toggle 3D spatialisation.
  def spatialization_enabled=(v)
    C::Audio.sfMusic_setSpatializationEnabled(@handle, v ? true : false)
  end

  # Multiplier on the Listener's directional attenuation cone —
  # see `Sound#directional_attenuation_factor`.
  def directional_attenuation_factor
    C::Audio.sfMusic_getDirectionalAttenuationFactor(@handle)
  end

  # Set the directional-attenuation factor.
  def directional_attenuation_factor=(v)
    C::Audio.sfMusic_setDirectionalAttenuationFactor(@handle, v.to_f)
  end

  private

  def _take_ownership(ptr)
    @handle = FFI::AutoPointer.new(ptr, C::Audio.method(:sfMusic_destroy))
  end
end

# File lib/sfml/audio/music.rb, line 266
def max_gain=(v)
  C::Audio.sfMusic_setMaxGain(@handle, v.to_f)
end

# File lib/sfml/audio/music.rb, line 202
def min_distance = C::Audio.sfMusic_getMinDistance(@handle)

# Set the min-distance.
def min_distance=(value)
  C::Audio.sfMusic_setMinDistance(@handle, value.to_f)
end

# `true` if `#position` is interpreted relative to the listener.
def relative_to_listener? = C::Audio.sfMusic_isRelativeToListener(@handle)

# Toggle listener-relative positioning.
def relative_to_listener=(value)
  C::Audio.sfMusic_setRelativeToListener(@handle, value ? true : false)
end

# ---- Stream introspection ----

# Number of audio channels (1 = mono, 2 = stereo, ...).
def channel_count = C::Audio.sfMusic_getChannelCount(@handle)
# Sample rate in Hz (e.g. 44_100 for CD-quality).
def sample_rate   = C::Audio.sfMusic_getSampleRate(@handle)

# The portion of the track that loops when `looping = true`.
# Returns `[offset, length]` of `SFML::Time`s; defaults to the
# whole track. Set with `loop_points = [Time, Time]`.
def loop_points
  span = C::Audio.sfMusic_getLoopPoints(@handle)
  [Time.from_native(span[:offset]), Time.from_native(span[:length])]
end

# Set the looping window. Accepts `[offset, length]` of either
# `SFML::Time` or numeric seconds.
def loop_points=(value)
  offset_t, length_t = value
  raise ArgumentError, "expected [offset_time, length_time]" unless offset_t && length_t

  span = C::Audio::TimeSpan.new
  span[:offset][:microseconds] = offset_t.is_a?(Time) ? offset_t.microseconds : Time.seconds(offset_t.to_f).microseconds
  span[:length][:microseconds] = length_t.is_a?(Time) ? length_t.microseconds : Time.seconds(length_t.to_f).microseconds
  C::Audio.sfMusic_setLoopPoints(@handle, span)
end

# ---- 3D-audio extras (mirror of Sound's) ----

# Stereo pan in [-1.0, 1.0] — see `Sound#pan`.
def pan = C::Audio.sfMusic_getPan(@handle)

# Set the stereo pan.
def pan=(v)
  C::Audio.sfMusic_setPan(@handle, v.to_f)
end

# Lower gain bound — see `Sound#min_gain`.
def min_gain = C::Audio.sfMusic_getMinGain(@handle)

# Set the min-gain floor.
def min_gain=(v)
  C::Audio.sfMusic_setMinGain(@handle, v.to_f)
end

# Upper gain bound — see `Sound#max_gain`.
def max_gain = C::Audio.sfMusic_getMaxGain(@handle)

# Set the max-gain cap.
def max_gain=(v)
  C::Audio.sfMusic_setMaxGain(@handle, v.to_f)
end

# Distance beyond which the source is fully attenuated.
def max_distance = C::Audio.sfMusic_getMaxDistance(@handle)

# Set the max-distance.
def max_distance=(v)
  C::Audio.sfMusic_setMaxDistance(@handle, v.to_f)
end

# `true` if 3D positional / Doppler / cone math is applied at
# mix time.
def spatialization_enabled? = C::Audio.sfMusic_isSpatializationEnabled(@handle)

# Toggle 3D spatialisation.
def spatialization_enabled=(v)
  C::Audio.sfMusic_setSpatializationEnabled(@handle, v ? true : false)
end

# Multiplier on the Listener's directional attenuation cone —
# see `Sound#directional_attenuation_factor`.
def directional_attenuation_factor
  C::Audio.sfMusic_getDirectionalAttenuationFactor(@handle)
end

# Set the directional-attenuation factor.
def directional_attenuation_factor=(v)
  C::Audio.sfMusic_setDirectionalAttenuationFactor(@handle, v.to_f)
end

private

def _take_ownership(ptr)
  @handle = FFI::AutoPointer.new(ptr, C::Audio

# File lib/sfml/audio/music.rb, line 205
def min_distance=(value)
  C::Audio.sfMusic_setMinDistance(@handle, value.to_f)
end

# File lib/sfml/audio/music.rb, line 255
def min_gain = C::Audio.sfMusic_getMinGain(@handle)

# Set the min-gain floor.
def min_gain=(v)
  C::Audio.sfMusic_setMinGain(@handle, v.to_f)
end

# Upper gain bound — see `Sound#max_gain`.
def max_gain = C::Audio.sfMusic_getMaxGain(@handle)

# Set the max-gain cap.
def max_gain=(v)
  C::Audio.sfMusic_setMaxGain(@handle, v.to_f)
end

# Distance beyond which the source is fully attenuated.
def max_distance = C::Audio.sfMusic_getMaxDistance(@handle)

# Set the max-distance.
def max_distance=(v)
  C::Audio.sfMusic_setMaxDistance(@handle, v.to_f)
end

# `true` if 3D positional / Doppler / cone math is applied at
# mix time.
def spatialization_enabled? = C::Audio.sfMusic_isSpatializationEnabled(@handle)

# Toggle 3D spatialisation.
def spatialization_enabled=(v)
  C::Audio.sfMusic_setSpatializationEnabled(@handle, v ? true : false)
end

# Multiplier on the Listener's directional attenuation cone —
# see `Sound#directional_attenuation_factor`.
def directional_attenuation_factor
  C::Audio.sfMusic_getDirectionalAttenuationFactor(@handle)
end

# Set the directional-attenuation factor.
def directional_attenuation_factor=(v)
  C::Audio.sfMusic_setDirectionalAttenuationFactor(@handle, v.to_f)
end

private

def _take_ownership(ptr)
  @handle = FFI::AutoPointer.new(ptr, C::Audio.method(:sfMusic_destroy))
end

# File lib/sfml/audio/music.rb, line 258
def min_gain=(v)
  C::Audio.sfMusic_setMinGain(@handle, v.to_f)
end

# File lib/sfml/audio/music.rb, line 247
def pan = C::Audio.sfMusic_getPan(@handle)

# Set the stereo pan.
def pan=(v)
  C::Audio.sfMusic_setPan(@handle, v.to_f)
end

# Lower gain bound — see `Sound#min_gain`.
def min_gain = C::Audio.sfMusic_getMinGain(@handle)

# Set the min-gain floor.
def min_gain=(v)
  C::Audio.sfMusic_setMinGain(@handle, v.to_f)
end

# Upper gain bound — see `Sound#max_gain`.
def max_gain = C::Audio.sfMusic_getMaxGain(@handle)

# Set the max-gain cap.
def max_gain=(v)
  C::Audio.sfMusic_setMaxGain(@handle, v.to_f)
end

# Distance beyond which the source is fully attenuated.
def max_distance = C::Audio.sfMusic_getMaxDistance(@handle)

# Set the max-distance.
def max_distance=(v)
  C::Audio.sfMusic_setMaxDistance(@handle, v.to_f)
end

# `true` if 3D positional / Doppler / cone math is applied at
# mix time.
def spatialization_enabled? = C::Audio.sfMusic_isSpatializationEnabled(@handle)

# Toggle 3D spatialisation.
def spatialization_enabled=(v)
  C::Audio.sfMusic_setSpatializationEnabled(@handle, v ? true : false)
end

# Multiplier on the Listener's directional attenuation cone —
# see `Sound#directional_attenuation_factor`.
def directional_attenuation_factor
  C::Audio.sfMusic_getDirectionalAttenuationFactor(@handle)
end

# Set the directional-attenuation factor.
def directional_attenuation_factor=(v)
  C::Audio.sfMusic_setDirectionalAttenuationFactor(@handle, v.to_f)
end

private

def _take_ownership(ptr)
  @handle = FFI::AutoPointer.new(ptr, C::Audio.method(:sfMusic_destroy))

# File lib/sfml/audio/music.rb, line 250
def pan=(v)
  C::Audio.sfMusic_setPan(@handle, v.to_f)
end

# File lib/sfml/audio/music.rb, line 65
def pause  = C::Audio.sfMusic_pause(@handle)
# Stop playback and rewind to the start.
def stop   = C::Audio.sfMusic_stop(@handle)

# Playback state — one of `:stopped`, `:paused`, `:playing`.
def status   = C::Audio::STATUSES[C::Audio.sfMusic_getStatus(@handle)]
# Convenience for `status == :playing`.
def playing? = status == :playing
# Convenience for `status == :paused`.
def paused?  = status == :paused
# Convenience for `status == :stopped`.
def stopped? = status == :stopped

# Total length of the track as a `SFML::Time`.
def duration = Time.from_native(C::Audio.sfMusic_getDuration(@handle))

# Current playback head as a SFML::Time. Reads from the underlying
# OpenAL source — only meaningful while the music is playing or
# paused (not after #stop).
def playing_offset
  Time.from_native(C::Audio.sfMusic_getPlayingOffset(@handle))
end

# Seek to `value` (a SFML::Time, or seconds as a Numeric). Works
# while the music is playing, paused, or stopped.
def playing_offset=(value)
  t = value.is_a?(Time) ? value : Time.seconds(value.to_f)
  C::Audio.sfMusic_setPlayingOffset(@handle, t.to_native)
end

# 3D velocity, Doppler factor, direction, cone — see Sound for
# the same methods on the simpler buffered source.
def velocity
  v = C::Audio.sfMusic_getVelocity(@handle)
  Vector3.new(v[:x], v[:y], v[:z])
end

# Set the 3D velocity — accepts Vector3 or `[x, y, z]`.
def velocity=(value)
  vec = value.is_a?(Vector3) ? value : Vector3.new(*value)
  packed = C::System::Vector3f.new
  packed[:x] = vec.x.to_f; packed[:y] = vec.y.to_f; packed[:z] = vec.z.to_f
  C::Audio.sfMusic_setVelocity(@handle, packed)
end

# Per-source Doppler scale. 1.0 realistic, 0 disables.
def doppler_factor    = C::Audio.sfMusic_getDopplerFactor(@handle)
# Set the per-source Doppler scale.
def doppler_factor=(v) C::Audio.sfMusic_setDopplerFactor(@handle, v.to_f); end

# The direction the music's cone points.
def direction
  v = C::Audio.sfMusic_getDirection(@handle)
  Vector3.new(v[:x], v[:y], v[:z])
end

# Set the direction vector — accepts Vector3 or `[x, y, z]`.
def direction=(value)
  vec = value.is_a?(Vector3) ? value : Vector3.new(*value)
  packed = C::System::Vector3f.new
  packed[:x] = vec.x.to_f; packed[:y] = vec.y.to_f; packed[:z] = vec.z.to_f
  C::Audio.sfMusic_setDirection(@handle, packed)
end

# Directional-attenuation cone — see SFML::SoundCone.
def cone
  SoundCone.from_native(C::Audio.sfMusic_getCone(@handle))
end

# Set the cone. Accepts a `SoundCone` or a Hash with
# `inner_angle`, `outer_angle`, `outer_gain`.
def cone=(value)
  cone =
    case value
    when SoundCone then value
    when Hash      then SoundCone.new(**value)
    else
      raise ArgumentError, "Music#cone= expects SoundCone or Hash; got #{value.class}"
    end
  C::Audio.sfMusic_setCone(@handle, cone.to_native)
end

# See Sound#effect_processor= — same audio-thread DSP callback.
def effect_processor=(callable)
  @effect_cb = callable.nil? ? nil : Audio._build_effect_processor(callable)
  C::Audio.sfMusic_setEffectProcessor(@handle, @effect_cb, nil)
end

# `true` if the track restarts after reaching the end (or its
# `loop_points` length).
# Cached on the Ruby side; see Sound#looping? for the why.
def looping?
  @looping
end

# Toggle looping playback.
def looping=(value)
  @looping = value ? true : false
  C::Audio.sfMusic_setLooping(@handle, @looping)
end

# Playback volume in [0, 100] — 100 = unattenuated.
def volume = C::Audio.sfMusic_getVolume(@handle)

# Set the playback volume in [0, 100].
def volume=(value)
  C::Audio.sfMusic_setVolume(@handle, value.to_f)
end

# Pitch multiplier. 1.0 = normal, 2.0 = octave up, 0.5 = octave down.
def pitch = C::Audio.sfMusic_getPitch(@handle)

# Set the pitch multiplier.
def pitch=(value)
  C::Audio.sfMusic_setPitch(@handle, value.to_f)
end

# 3D positional audio — see SFML::Sound for the why.
def position
  Vector3.from_native(C::Audio.sfMusic_getPosition(@handle))
end

# Set the 3D position — accepts Vector3 or `[x, y, z]`.
def position=(value)
  vec = value.is_a?(Vector3) ? value : Vector3.new(*value)
  C::Audio.sfMusic_setPosition(@handle, vec.to_native_f)
end

# Falloff sharpness with distance — see `Sound#attenuation`.
def attenuation = C::Audio.sfMusic_getAttenuation(@handle)

# Set the attenuation.
def attenuation=(value)
  C::Audio.sfMusic_setAttenuation(@handle, value.to_f)
end

# Distance below which volume is not attenuated.
def min_distance = C::Audio.sfMusic_getMinDistance(@handle)

# Set the min-distance.
def min_distance=(value)
  C::Audio.sfMusic_setMinDistance(@handle, value.to_f)
end

# `true` if `#position` is interpreted relative to the listener.
def relative_to_listener? = C::Audio.sfMusic_isRelativeToListener(@handle)

# Toggle listener-relative positioning.
def relative_to_listener=(value)
  C::Audio.sfMusic_setRelativeToListener(@handle, value ? true : false)
end

# ---- Stream introspection ----

# Number of audio channels (1 = mono, 2 = stereo, ...).
def channel_count = C::Audio.sfMusic_getChannelCount(@handle)
# Sample rate in Hz (e.g. 44_100 for CD-quality).
def sample_rate   = C::Audio.sfMusic_getSampleRate(@handle)

# The portion of the track that loops when `looping = true`.
# Returns `[offset, length]` of `SFML::Time`s; defaults to the
# whole track. Set with `loop_points = [Time, Time]`.
def loop_points
  span = C::Audio.sfMusic_getLoopPoints(@handle)
  [Time.from_native(span[:offset]), Time.from_native(span[:length])]
end

# Set the looping window. Accepts `[offset, length]` of either
# `SFML::Time` or numeric seconds.
def loop_points=(value)
  offset_t, length_t = value
  raise ArgumentError, "expected [offset_time, length_time]" unless offset_t && length_t

  span = C::Audio::TimeSpan.new
  span[:offset][:microseconds] = offset_t.is_a?(Time) ? offset_t.microseconds : Time.seconds(offset_t.to_f).microseconds
  span[:length][:microseconds] = length_t.is_a?(Time) ? length_t.microseconds : Time.seconds(length_t.to_f).microseconds
  C::Audio.sfMusic_setLoopPoints(@handle, span)
end

# ---- 3D-audio extras (mirror of Sound's) ----

# Stereo pan in [-1.0, 1.0] — see `Sound#pan`.
def pan = C::Audio.sfMusic_getPan(@handle)

# Set the stereo pan.
def pan=(v)
  C::Audio.sfMusic_setPan(@handle, v.to_f)
end

# Lower gain bound — see `Sound#min_gain`.
def min_gain = C::Audio.sfMusic_getMinGain(@handle)

# Set the min-gain floor.
def min_gain=(v)
  C::Audio.sfMusic_setMinGain(@handle, v.to_f)
end

# Upper gain bound — see `Sound#max_gain`.
def max_gain = C::Audio.sfMusic_getMaxGain(@handle)

# Set the max-gain cap.
def max_gain=(v)
  C::Audio.sfMusic_setMaxGain(@handle, v.to_f)
end

# Distance beyond which the source is fully attenuated.
def max_distance = C::Audio.sfMusic_getMaxDistance(@handle)

# Set the max-distance.
def max_distance=(v)
  C::Audio.sfMusic_setMaxDistance(@handle, v.to_f)
end

# `true` if 3D positional / Doppler / cone math is applied at
# mix time.
def spatialization_enabled? = C::Audio.sfMusic_isSpatializationEnabled(@handle)

# Toggle 3D spatialisation.
def spatialization_enabled=(v)
  C::Audio.sfMusic_setSpatializationEnabled(@handle, v ? true : false)
end

# Multiplier on the Listener's directional attenuation cone —
# see `Sound#directional_attenuation_factor`.
def directional_attenuation_factor
  C::Audio.sfMusic_getDirectionalAttenuationFactor(@handle)
end

# Set the directional-attenuation factor.
def directional_attenuation_factor=(v)
  C::Audio.sfMusic_setDirectionalAttenuationFactor(@handle, v.to_f)
end

private

def 

# File lib/sfml/audio/music.rb, line 74
def paused?  = status == :paused
# Convenience for `status == :stopped`.
def stopped? = status == :stopped

# Total length of the track as a `SFML::Time`.
def duration = Time.from_native(C::Audio.sfMusic_getDuration(@handle))

# Current playback head as a SFML::Time. Reads from the underlying
# OpenAL source — only meaningful while the music is playing or
# paused (not after #stop).
def playing_offset
  Time.from_native(C::Audio.sfMusic_getPlayingOffset(@handle))
end

# Seek to `value` (a SFML::Time, or seconds as a Numeric). Works
# while the music is playing, paused, or stopped.
def playing_offset=(value)
  t = value.is_a?(Time) ? value : Time.seconds(value.to_f)
  C::Audio.sfMusic_setPlayingOffset(@handle, t.to_native)
end

# 3D velocity, Doppler factor, direction, cone — see Sound for
# the same methods on the simpler buffered source.
def velocity
  v = C::Audio.sfMusic_getVelocity(@handle)
  Vector3.new(v[:x], v[:y], v[:z])
end

# Set the 3D velocity — accepts Vector3 or `[x, y, z]`.
def velocity=(value)
  vec = value.is_a?(Vector3) ? value : Vector3.new(*value)
  packed = C::System::Vector3f.new
  packed[:x] = vec.x.to_f; packed[:y] = vec.y.to_f; packed[:z] = vec.z.to_f
  C::Audio.sfMusic_setVelocity(@handle, packed)
end

# Per-source Doppler scale. 1.0 realistic, 0 disables.
def doppler_factor    = C::Audio.sfMusic_getDopplerFactor(@handle)
# Set the per-source Doppler scale.
def doppler_factor=(v) C::Audio.sfMusic_setDopplerFactor(@handle, v.to_f); end

# The direction the music's cone points.
def direction
  v = C::Audio.sfMusic_getDirection(@handle)
  Vector3.new(v[:x], v[:y], v[:z])
end

# Set the direction vector — accepts Vector3 or `[x, y, z]`.
def direction=(value)
  vec = value.is_a?(Vector3) ? value : Vector3.new(*value)
  packed = C::System::Vector3f.new
  packed[:x] = vec.x.to_f; packed[:y] = vec.y.to_f; packed[:z] = vec.z.to_f
  C::Audio.sfMusic_setDirection(@handle, packed)
end

# Directional-attenuation cone — see SFML::SoundCone.
def cone
  SoundCone.from_native(C::Audio.sfMusic_getCone(@handle))
end

# Set the cone. Accepts a `SoundCone` or a Hash with
# `inner_angle`, `outer_angle`, `outer_gain`.
def cone=(value)
  cone =
    case value
    when SoundCone then value
    when Hash      then SoundCone.new(**value)
    else
      raise ArgumentError, "Music#cone= expects SoundCone or Hash; got #{value.class}"
    end
  C::Audio.sfMusic_setCone(@handle, cone.to_native)
end

# See Sound#effect_processor= — same audio-thread DSP callback.
def effect_processor=(callable)
  @effect_cb = callable.nil? ? nil : Audio._build_effect_processor(callable)
  C::Audio.sfMusic_setEffectProcessor(@handle, @effect_cb, nil)
end

# `true` if the track restarts after reaching the end (or its
# `loop_points` length).
# Cached on the Ruby side; see Sound#looping? for the why.
def looping?
  @looping
end

# Toggle looping playback.
def looping=(value)
  @looping = value ? true : false
  C::Audio.sfMusic_setLooping(@handle, @looping)
end

# Playback volume in [0, 100] — 100 = unattenuated.
def volume = C::Audio.sfMusic_getVolume(@handle)

# Set the playback volume in [0, 100].
def volume=(value)
  C::Audio.sfMusic_setVolume(@handle, value.to_f)
end

# Pitch multiplier. 1.0 = normal, 2.0 = octave up, 0.5 = octave down.
def pitch = C::Audio.sfMusic_getPitch(@handle)

# Set the pitch multiplier.
def pitch=(value)
  C::Audio.sfMusic_setPitch(@handle, value.to_f)
end

# 3D positional audio — see SFML::Sound for the why.
def position
  Vector3.from_native(C::Audio.sfMusic_getPosition(@handle))
end

# Set the 3D position — accepts Vector3 or `[x, y, z]`.
def position=(value)
  vec = value.is_a?(Vector3) ? value : Vector3.new(*value)
  C::Audio.sfMusic_setPosition(@handle, vec.to_native_f)
end

# Falloff sharpness with distance — see `Sound#attenuation`.
def attenuation = C::Audio.sfMusic_getAttenuation(@handle)

# Set the attenuation.
def attenuation=(value)
  C::Audio.sfMusic_setAttenuation(@handle, value.to_f)
end

# Distance below which volume is not attenuated.
def min_distance = C::Audio.sfMusic_getMinDistance(@handle)

# Set the min-distance.
def min_distance=(value)
  C::Audio.sfMusic_setMinDistance(@handle, value.to_f)
end

# `true` if `#position` is interpreted relative to the listener.
def relative_to_listener? = C::Audio.sfMusic_isRelativeToListener(@handle)

# Toggle listener-relative positioning.
def relative_to_listener=(value)
  C::Audio.sfMusic_setRelativeToListener(@handle, value ? true : false)
end

# ---- Stream introspection ----

# Number of audio channels (1 = mono, 2 = stereo, ...).
def channel_count = C::Audio.sfMusic_getChannelCount(@handle)
# Sample rate in Hz (e.g. 44_100 for CD-quality).
def sample_rate   = C::Audio.sfMusic_getSampleRate(@handle)

# The portion of the track that loops when `looping = true`.
# Returns `[offset, length]` of `SFML::Time`s; defaults to the
# whole track. Set with `loop_points = [Time, Time]`.
def loop_points
  span = C::Audio.sfMusic_getLoopPoints(@handle)
  [Time.from_native(span[:offset]), Time.from_native(span[:length])]
end

# Set the looping window. Accepts `[offset, length]` of either
# `SFML::Time` or numeric seconds.
def loop_points=(value)
  offset_t, length_t = value
  raise ArgumentError, "expected [offset_time, length_time]" unless offset_t && length_t

  span = C::Audio::TimeSpan.new
  span[:offset][:microseconds] = offset_t.is_a?(Time) ? offset_t.microseconds : Time.seconds(offset_t.to_f).microseconds
  span[:length][:microseconds] = length_t.is_a?(Time) ? length_t.microseconds : Time.seconds(length_t.to_f).microseconds
  C::Audio.sfMusic_setLoopPoints(@handle, span)
end

# ---- 3D-audio extras (mirror of Sound's) ----

# Stereo pan in [-1.0, 1.0] — see `Sound#pan`.
def pan = C::Audio.sfMusic_getPan(@handle)

# Set the stereo pan.
def pan=(v)
  C::Audio.sfMusic_setPan(@handle, v.to_f)
end

# Lower gain bound — see `Sound#min_gain`.
def min_gain = C::Audio.sfMusic_getMinGain(@handle)

# Set the min-gain floor.
def min_gain=(v)
  C::Audio.sfMusic_setMinGain(@handle, v.to_f)
end

# Upper gain bound — see `Sound#max_gain`.
def max_gain = C::Audio.sfMusic_getMaxGain(@handle)

# Set the max-gain cap.
def max_gain=(v)
  C::Audio.sfMusic_setMaxGain(@handle, v.to_f)
end

# Distance beyond which the source is fully attenuated.
def max_distance = C::Audio.sfMusic_getMaxDistance(@handle)

# Set the max-distance.
def max_distance=(v)
  C::Audio.sfMusic_setMaxDistance(@handle, v.to_f)
end

# `true` if 3D positional / Doppler / cone math is applied at
# mix time.
def spatialization_enabled? = C::Audio.sfMusic_isSpatializationEnabled(@handle)

# Toggle 3D spatialisation.
def spatialization_enabled=(v)
  C::Audio.sfMusic_setSpatializationEnabled(@handle, v ? true : false)
end

# Multiplier on the Listener's directional attenuation cone —
# see `Sound#directional_attenuation_factor`.
def directional_attenuation_factor
  C::Audio.sfMusic_getDirectionalAttenuationFactor(@handle)
end

# Set the directional-attenuation factor.
def directional_attenuation_factor=(v)
  C::Audio.sfMusic_setDirectionalAttenuationFactor(@handle, v.to_f)
end

private

def _take_ownership(ptr)
  @handle 

# File lib/sfml/audio/music.rb, line 175
def pitch = C::Audio.sfMusic_getPitch(@handle)

# Set the pitch multiplier.
def pitch=(value)
  C::Audio.sfMusic_setPitch(@handle, value.to_f)
end

# 3D positional audio — see SFML::Sound for the why.
def position
  Vector3.from_native(C::Audio.sfMusic_getPosition(@handle))
end

# Set the 3D position — accepts Vector3 or `[x, y, z]`.
def position=(value)
  vec = value.is_a?(Vector3) ? value : Vector3.new(*value)
  C::Audio.sfMusic_setPosition(@handle, vec.to_native_f)
end

# Falloff sharpness with distance — see `Sound#attenuation`.
def attenuation = C::Audio.sfMusic_getAttenuation(@handle)

# Set the attenuation.
def attenuation=(value)
  C::Audio.sfMusic_setAttenuation(@handle, value.to_f)
end

# Distance below which volume is not attenuated.
def min_distance = C::Audio.sfMusic_getMinDistance(@handle)

# Set the min-distance.
def min_distance=(value)
  C::Audio.sfMusic_setMinDistance(@handle, value.to_f)
end

# `true` if `#position` is interpreted relative to the listener.
def relative_to_listener? = C::Audio.sfMusic_isRelativeToListener(@handle)

# Toggle listener-relative positioning.
def relative_to_listener=(value)
  C::Audio.sfMusic_setRelativeToListener(@handle, value ? true : false)
end

# ---- Stream introspection ----

# Number of audio channels (1 = mono, 2 = stereo, ...).
def channel_count = C::Audio.sfMusic_getChannelCount(@handle)
# Sample rate in Hz (e.g. 44_100 for CD-quality).
def sample_rate   = C::Audio.sfMusic_getSampleRate(@handle)

# The portion of the track that loops when `looping = true`.
# Returns `[offset, length]` of `SFML::Time`s; defaults to the
# whole track. Set with `loop_points = [Time, Time]`.
def loop_points
  span = C::Audio.sfMusic_getLoopPoints(@handle)
  [Time.from_native(span[:offset]), Time.from_native(span[:length])]
end

# Set the looping window. Accepts `[offset, length]` of either
# `SFML::Time` or numeric seconds.
def loop_points=(value)
  offset_t, length_t = value
  raise ArgumentError, "expected [offset_time, length_time]" unless offset_t && length_t

  span = C::Audio::TimeSpan.new
  span[:offset][:microseconds] = offset_t.is_a?(Time) ? offset_t.microseconds : Time.seconds(offset_t.to_f).microseconds
  span[:length][:microseconds] = length_t.is_a?(Time) ? length_t.microseconds : Time.seconds(length_t.to_f).microseconds
  C::Audio.sfMusic_setLoopPoints(@handle, span)
end

# ---- 3D-audio extras (mirror of Sound's) ----

# Stereo pan in [-1.0, 1.0] — see `Sound#pan`.
def pan = C::Audio.sfMusic_getPan(@handle)

# Set the stereo pan.
def pan=(v)
  C::Audio.sfMusic_setPan(@handle, v.to_f)
end

# Lower gain bound — see `Sound#min_gain`.
def min_gain = C::Audio.sfMusic_getMinGain(@handle)

# Set the min-gain floor.
def min_gain=(v)
  C::Audio.sfMusic_setMinGain(@handle, v.to_f)
end

# Upper gain bound — see `Sound#max_gain`.
def max_gain = C::Audio.sfMusic_getMaxGain(@handle)

# Set the max-gain cap.
def max_gain=(v)
  C::Audio.sfMusic_setMaxGain(@handle, v.to_f)
end

# Distance beyond which the source is fully attenuated.
def max_distance = C::Audio.sfMusic_getMaxDistance(@handle)

# Set the max-distance.
def max_distance=(v)
  C::Audio.sfMusic_setMaxDistance(@handle, v.to_f)
end

# `true` if 3D positional / Doppler / cone math is applied at
# mix time.
def spatialization_enabled? = C::Audio.sfMusic_isSpatializationEnabled(@handle)

# Toggle 3D spatialisation.
def spatialization_enabled=(v)
  C::Audio.sfMusic_setSpatializationEnabled(@handle, v ? true : false)
end

# Multiplier on the Listener's directional attenuation cone —
# see `Sound#directional_attenuation_factor`.
def directional_attenuation_factor
  C::Audio.sfMusic_getDirectionalAttenuationFactor(@handle)
end

# Set the directional-attenuation factor.
def directional_attenuation_factor=(v)
  C::Audio.sfMusic_setDirectionalAttenuationFactor(@handle, v.to_f)
end

private

def _take_ownership(ptr)
  @handle = FFI::AutoPointer.new(ptr,

# File lib/sfml/audio/music.rb, line 178
def pitch=(value)
  C::Audio.sfMusic_setPitch(@handle, value.to_f)
end

# File lib/sfml/audio/music.rb, line 63
def play   = C::Audio.sfMusic_play(@handle)
# Pause playback — `#play` resumes from here.
def pause  = C::Audio.sfMusic_pause(@handle)
# Stop playback and rewind to the start.
def stop   = C::Audio.sfMusic_stop(@handle)

# Playback state — one of `:stopped`, `:paused`, `:playing`.
def status   = C::Audio::STATUSES[C::Audio.sfMusic_getStatus(@handle)]
# Convenience for `status == :playing`.
def playing? = status == :playing
# Convenience for `status == :paused`.
def paused?  = status == :paused
# Convenience for `status == :stopped`.
def stopped? = status == :stopped

# Total length of the track as a `SFML::Time`.
def duration = Time.from_native(C::Audio.sfMusic_getDuration(@handle))

# Current playback head as a SFML::Time. Reads from the underlying
# OpenAL source — only meaningful while the music is playing or
# paused (not after #stop).
def playing_offset
  Time.from_native(C::Audio.sfMusic_getPlayingOffset(@handle))
end

# Seek to `value` (a SFML::Time, or seconds as a Numeric). Works
# while the music is playing, paused, or stopped.
def playing_offset=(value)
  t = value.is_a?(Time) ? value : Time.seconds(value.to_f)
  C::Audio.sfMusic_setPlayingOffset(@handle, t.to_native)
end

# 3D velocity, Doppler factor, direction, cone — see Sound for
# the same methods on the simpler buffered source.
def velocity
  v = C::Audio.sfMusic_getVelocity(@handle)
  Vector3.new(v[:x], v[:y], v[:z])
end

# Set the 3D velocity — accepts Vector3 or `[x, y, z]`.
def velocity=(value)
  vec = value.is_a?(Vector3) ? value : Vector3.new(*value)
  packed = C::System::Vector3f.new
  packed[:x] = vec.x.to_f; packed[:y] = vec.y.to_f; packed[:z] = vec.z.to_f
  C::Audio.sfMusic_setVelocity(@handle, packed)
end

# Per-source Doppler scale. 1.0 realistic, 0 disables.
def doppler_factor    = C::Audio.sfMusic_getDopplerFactor(@handle)
# Set the per-source Doppler scale.
def doppler_factor=(v) C::Audio.sfMusic_setDopplerFactor(@handle, v.to_f); end

# The direction the music's cone points.
def direction
  v = C::Audio.sfMusic_getDirection(@handle)
  Vector3.new(v[:x], v[:y], v[:z])
end

# Set the direction vector — accepts Vector3 or `[x, y, z]`.
def direction=(value)
  vec = value.is_a?(Vector3) ? value : Vector3.new(*value)
  packed = C::System::Vector3f.new
  packed[:x] = vec.x.to_f; packed[:y] = vec.y.to_f; packed[:z] = vec.z.to_f
  C::Audio.sfMusic_setDirection(@handle, packed)
end

# Directional-attenuation cone — see SFML::SoundCone.
def cone
  SoundCone.from_native(C::Audio.sfMusic_getCone(@handle))
end

# Set the cone. Accepts a `SoundCone` or a Hash with
# `inner_angle`, `outer_angle`, `outer_gain`.
def cone=(value)
  cone =
    case value
    when SoundCone then value
    when Hash      then SoundCone.new(**value)
    else
      raise ArgumentError, "Music#cone= expects SoundCone or Hash; got #{value.class}"
    end
  C::Audio.sfMusic_setCone(@handle, cone.to_native)
end

# See Sound#effect_processor= — same audio-thread DSP callback.
def effect_processor=(callable)
  @effect_cb = callable.nil? ? nil : Audio._build_effect_processor(callable)
  C::Audio.sfMusic_setEffectProcessor(@handle, @effect_cb, nil)
end

# `true` if the track restarts after reaching the end (or its
# `loop_points` length).
# Cached on the Ruby side; see Sound#looping? for the why.
def looping?
  @looping
end

# Toggle looping playback.
def looping=(value)
  @looping = value ? true : false
  C::Audio.sfMusic_setLooping(@handle, @looping)
end

# Playback volume in [0, 100] — 100 = unattenuated.
def volume = C::Audio.sfMusic_getVolume(@handle)

# Set the playback volume in [0, 100].
def volume=(value)
  C::Audio.sfMusic_setVolume(@handle, value.to_f)
end

# Pitch multiplier. 1.0 = normal, 2.0 = octave up, 0.5 = octave down.
def pitch = C::Audio.sfMusic_getPitch(@handle)

# Set the pitch multiplier.
def pitch=(value)
  C::Audio.sfMusic_setPitch(@handle, value.to_f)
end

# 3D positional audio — see SFML::Sound for the why.
def position
  Vector3.from_native(C::Audio.sfMusic_getPosition(@handle))
end

# Set the 3D position — accepts Vector3 or `[x, y, z]`.
def position=(value)
  vec = value.is_a?(Vector3) ? value : Vector3.new(*value)
  C::Audio.sfMusic_setPosition(@handle, vec.to_native_f)
end

# Falloff sharpness with distance — see `Sound#attenuation`.
def attenuation = C::Audio.sfMusic_getAttenuation(@handle)

# Set the attenuation.
def attenuation=(value)
  C::Audio.sfMusic_setAttenuation(@handle, value.to_f)
end

# Distance below which volume is not attenuated.
def min_distance = C::Audio.sfMusic_getMinDistance(@handle)

# Set the min-distance.
def min_distance=(value)
  C::Audio.sfMusic_setMinDistance(@handle, value.to_f)
end

# `true` if `#position` is interpreted relative to the listener.
def relative_to_listener? = C::Audio.sfMusic_isRelativeToListener(@handle)

# Toggle listener-relative positioning.
def relative_to_listener=(value)
  C::Audio.sfMusic_setRelativeToListener(@handle, value ? true : false)
end

# ---- Stream introspection ----

# Number of audio channels (1 = mono, 2 = stereo, ...).
def channel_count = C::Audio.sfMusic_getChannelCount(@handle)
# Sample rate in Hz (e.g. 44_100 for CD-quality).
def sample_rate   = C::Audio.sfMusic_getSampleRate(@handle)

# The portion of the track that loops when `looping = true`.
# Returns `[offset, length]` of `SFML::Time`s; defaults to the
# whole track. Set with `loop_points = [Time, Time]`.
def loop_points
  span = C::Audio.sfMusic_getLoopPoints(@handle)
  [Time.from_native(span[:offset]), Time.from_native(span[:length])]
end

# Set the looping window. Accepts `[offset, length]` of either
# `SFML::Time` or numeric seconds.
def loop_points=(value)
  offset_t, length_t = value
  raise ArgumentError, "expected [offset_time, length_time]" unless offset_t && length_t

  span = C::Audio::TimeSpan.new
  span[:offset][:microseconds] = offset_t.is_a?(Time) ? offset_t.microseconds : Time.seconds(offset_t.to_f).microseconds
  span[:length][:microseconds] = length_t.is_a?(Time) ? length_t.microseconds : Time.seconds(length_t.to_f).microseconds
  C::Audio.sfMusic_setLoopPoints(@handle, span)
end

# ---- 3D-audio extras (mirror of Sound's) ----

# Stereo pan in [-1.0, 1.0] — see `Sound#pan`.
def pan = C::Audio.sfMusic_getPan(@handle)

# Set the stereo pan.
def pan=(v)
  C::Audio.sfMusic_setPan(@handle, v.to_f)
end

# Lower gain bound — see `Sound#min_gain`.
def min_gain = C::Audio.sfMusic_getMinGain(@handle)

# Set the min-gain floor.
def min_gain=(v)
  C::Audio.sfMusic_setMinGain(@handle, v.to_f)
end

# Upper gain bound — see `Sound#max_gain`.
def max_gain = C::Audio.sfMusic_getMaxGain(@handle)

# Set the max-gain cap.
def max_gain=(v)
  C::Audio.sfMusic_setMaxGain(@handle, v.to_f)
end

# Distance beyond which the source is fully attenuated.
def max_distance = C::Audio.sfMusic_getMaxDistance(@handle)

# Set the max-distance.
def max_distance=(v)
  C::Audio.sfMusic_setMaxDistance(@handle, v.to_f)
end

# `true` if 3D positional / Doppler / cone math is applied at
# mix time.
def spatialization_enabled? = C::Audio.sfMusic_isSpatializationEnabled(@handle)

# Toggle 3D spatialisation.
def spatialization_enabled=(v)
  C::Audio.sfMusic_setSpatializationEnabled(@handle, v ? true : false)
end

# Multiplier on the Listener's directional attenuation cone —
# see `Sound#directional_attenuation_factor`.
def directional_attenuation_factor
  C::Audio.sfMusic_getDirectionalAttenuationFactor(@handle)
end

# Set the directional-attenuation factor.
def directional_attenuation_factor=(v)
  C::Audio.sfMusic_setDirectionalAttenuationFactor(@handle, v.to_f)
end

private

# File lib/sfml/audio/music.rb, line 72
def playing? = status == :playing
# Convenience for `status == :paused`.
def paused?  = status == :paused
# Convenience for `status == :stopped`.
def stopped? = status == :stopped

# Total length of the track as a `SFML::Time`.
def duration = Time.from_native(C::Audio.sfMusic_getDuration(@handle))

# Current playback head as a SFML::Time. Reads from the underlying
# OpenAL source — only meaningful while the music is playing or
# paused (not after #stop).
def playing_offset
  Time.from_native(C::Audio.sfMusic_getPlayingOffset(@handle))
end

# Seek to `value` (a SFML::Time, or seconds as a Numeric). Works
# while the music is playing, paused, or stopped.
def playing_offset=(value)
  t = value.is_a?(Time) ? value : Time.seconds(value.to_f)
  C::Audio.sfMusic_setPlayingOffset(@handle, t.to_native)
end

# 3D velocity, Doppler factor, direction, cone — see Sound for
# the same methods on the simpler buffered source.
def velocity
  v = C::Audio.sfMusic_getVelocity(@handle)
  Vector3.new(v[:x], v[:y], v[:z])
end

# Set the 3D velocity — accepts Vector3 or `[x, y, z]`.
def velocity=(value)
  vec = value.is_a?(Vector3) ? value : Vector3.new(*value)
  packed = C::System::Vector3f.new
  packed[:x] = vec.x.to_f; packed[:y] = vec.y.to_f; packed[:z] = vec.z.to_f
  C::Audio.sfMusic_setVelocity(@handle, packed)
end

# Per-source Doppler scale. 1.0 realistic, 0 disables.
def doppler_factor    = C::Audio.sfMusic_getDopplerFactor(@handle)
# Set the per-source Doppler scale.
def doppler_factor=(v) C::Audio.sfMusic_setDopplerFactor(@handle, v.to_f); end

# The direction the music's cone points.
def direction
  v = C::Audio.sfMusic_getDirection(@handle)
  Vector3.new(v[:x], v[:y], v[:z])
end

# Set the direction vector — accepts Vector3 or `[x, y, z]`.
def direction=(value)
  vec = value.is_a?(Vector3) ? value : Vector3.new(*value)
  packed = C::System::Vector3f.new
  packed[:x] = vec.x.to_f; packed[:y] = vec.y.to_f; packed[:z] = vec.z.to_f
  C::Audio.sfMusic_setDirection(@handle, packed)
end

# Directional-attenuation cone — see SFML::SoundCone.
def cone
  SoundCone.from_native(C::Audio.sfMusic_getCone(@handle))
end

# Set the cone. Accepts a `SoundCone` or a Hash with
# `inner_angle`, `outer_angle`, `outer_gain`.
def cone=(value)
  cone =
    case value
    when SoundCone then value
    when Hash      then SoundCone.new(**value)
    else
      raise ArgumentError, "Music#cone= expects SoundCone or Hash; got #{value.class}"
    end
  C::Audio.sfMusic_setCone(@handle, cone.to_native)
end

# See Sound#effect_processor= — same audio-thread DSP callback.
def effect_processor=(callable)
  @effect_cb = callable.nil? ? nil : Audio._build_effect_processor(callable)
  C::Audio.sfMusic_setEffectProcessor(@handle, @effect_cb, nil)
end

# `true` if the track restarts after reaching the end (or its
# `loop_points` length).
# Cached on the Ruby side; see Sound#looping? for the why.
def looping?
  @looping
end

# Toggle looping playback.
def looping=(value)
  @looping = value ? true : false
  C::Audio.sfMusic_setLooping(@handle, @looping)
end

# Playback volume in [0, 100] — 100 = unattenuated.
def volume = C::Audio.sfMusic_getVolume(@handle)

# Set the playback volume in [0, 100].
def volume=(value)
  C::Audio.sfMusic_setVolume(@handle, value.to_f)
end

# Pitch multiplier. 1.0 = normal, 2.0 = octave up, 0.5 = octave down.
def pitch = C::Audio.sfMusic_getPitch(@handle)

# Set the pitch multiplier.
def pitch=(value)
  C::Audio.sfMusic_setPitch(@handle, value.to_f)
end

# 3D positional audio — see SFML::Sound for the why.
def position
  Vector3.from_native(C::Audio.sfMusic_getPosition(@handle))
end

# Set the 3D position — accepts Vector3 or `[x, y, z]`.
def position=(value)
  vec = value.is_a?(Vector3) ? value : Vector3.new(*value)
  C::Audio.sfMusic_setPosition(@handle, vec.to_native_f)
end

# Falloff sharpness with distance — see `Sound#attenuation`.
def attenuation = C::Audio.sfMusic_getAttenuation(@handle)

# Set the attenuation.
def attenuation=(value)
  C::Audio.sfMusic_setAttenuation(@handle, value.to_f)
end

# Distance below which volume is not attenuated.
def min_distance = C::Audio.sfMusic_getMinDistance(@handle)

# Set the min-distance.
def min_distance=(value)
  C::Audio.sfMusic_setMinDistance(@handle, value.to_f)
end

# `true` if `#position` is interpreted relative to the listener.
def relative_to_listener? = C::Audio.sfMusic_isRelativeToListener(@handle)

# Toggle listener-relative positioning.
def relative_to_listener=(value)
  C::Audio.sfMusic_setRelativeToListener(@handle, value ? true : false)
end

# ---- Stream introspection ----

# Number of audio channels (1 = mono, 2 = stereo, ...).
def channel_count = C::Audio.sfMusic_getChannelCount(@handle)
# Sample rate in Hz (e.g. 44_100 for CD-quality).
def sample_rate   = C::Audio.sfMusic_getSampleRate(@handle)

# The portion of the track that loops when `looping = true`.
# Returns `[offset, length]` of `SFML::Time`s; defaults to the
# whole track. Set with `loop_points = [Time, Time]`.
def loop_points
  span = C::Audio.sfMusic_getLoopPoints(@handle)
  [Time.from_native(span[:offset]), Time.from_native(span[:length])]
end

# Set the looping window. Accepts `[offset, length]` of either
# `SFML::Time` or numeric seconds.
def loop_points=(value)
  offset_t, length_t = value
  raise ArgumentError, "expected [offset_time, length_time]" unless offset_t && length_t

  span = C::Audio::TimeSpan.new
  span[:offset][:microseconds] = offset_t.is_a?(Time) ? offset_t.microseconds : Time.seconds(offset_t.to_f).microseconds
  span[:length][:microseconds] = length_t.is_a?(Time) ? length_t.microseconds : Time.seconds(length_t.to_f).microseconds
  C::Audio.sfMusic_setLoopPoints(@handle, span)
end

# ---- 3D-audio extras (mirror of Sound's) ----

# Stereo pan in [-1.0, 1.0] — see `Sound#pan`.
def pan = C::Audio.sfMusic_getPan(@handle)

# Set the stereo pan.
def pan=(v)
  C::Audio.sfMusic_setPan(@handle, v.to_f)
end

# Lower gain bound — see `Sound#min_gain`.
def min_gain = C::Audio.sfMusic_getMinGain(@handle)

# Set the min-gain floor.
def min_gain=(v)
  C::Audio.sfMusic_setMinGain(@handle, v.to_f)
end

# Upper gain bound — see `Sound#max_gain`.
def max_gain = C::Audio.sfMusic_getMaxGain(@handle)

# Set the max-gain cap.
def max_gain=(v)
  C::Audio.sfMusic_setMaxGain(@handle, v.to_f)
end

# Distance beyond which the source is fully attenuated.
def max_distance = C::Audio.sfMusic_getMaxDistance(@handle)

# Set the max-distance.
def max_distance=(v)
  C::Audio.sfMusic_setMaxDistance(@handle, v.to_f)
end

# `true` if 3D positional / Doppler / cone math is applied at
# mix time.
def spatialization_enabled? = C::Audio.sfMusic_isSpatializationEnabled(@handle)

# Toggle 3D spatialisation.
def spatialization_enabled=(v)
  C::Audio.sfMusic_setSpatializationEnabled(@handle, v ? true : false)
end

# Multiplier on the Listener's directional attenuation cone —
# see `Sound#directional_attenuation_factor`.
def directional_attenuation_factor
  C::Audio.sfMusic_getDirectionalAttenuationFactor(@handle)
end

# Set the directional-attenuation factor.
def directional_attenuation_factor=(v)
  C::Audio.sfMusic_setDirectionalAttenuationFactor(@handle, v.to_f)
end

private

def _take_ownership(ptr)
  

# File lib/sfml/audio/music.rb, line 84
def playing_offset
  Time.from_native(C::Audio.sfMusic_getPlayingOffset(@handle))
end

# File lib/sfml/audio/music.rb, line 90
def playing_offset=(value)
  t = value.is_a?(Time) ? value : Time.seconds(value.to_f)
  C::Audio.sfMusic_setPlayingOffset(@handle, t.to_native)
end

# File lib/sfml/audio/music.rb, line 183
def position
  Vector3.from_native(C::Audio.sfMusic_getPosition(@handle))
end

# File lib/sfml/audio/music.rb, line 188
def position=(value)
  vec = value.is_a?(Vector3) ? value : Vector3.new(*value)
  C::Audio.sfMusic_setPosition(@handle, vec.to_native_f)
end

# File lib/sfml/audio/music.rb, line 213
def relative_to_listener=(value)
  C::Audio.sfMusic_setRelativeToListener(@handle, value ? true : false)
end

# File lib/sfml/audio/music.rb, line 210
def relative_to_listener? = C::Audio.sfMusic_isRelativeToListener(@handle)

# Toggle listener-relative positioning.
def relative_to_listener=(value)
  C::Audio.sfMusic_setRelativeToListener(@handle, value ? true : false)
end

# ---- Stream introspection ----

# Number of audio channels (1 = mono, 2 = stereo, ...).
def channel_count = C::Audio.sfMusic_getChannelCount(@handle)
# Sample rate in Hz (e.g. 44_100 for CD-quality).
def sample_rate   = C::Audio.sfMusic_getSampleRate(@handle)

# The portion of the track that loops when `looping = true`.
# Returns `[offset, length]` of `SFML::Time`s; defaults to the
# whole track. Set with `loop_points = [Time, Time]`.
def loop_points
  span = C::Audio.sfMusic_getLoopPoints(@handle)
  [Time.from_native(span[:offset]), Time.from_native(span[:length])]
end

# Set the looping window. Accepts `[offset, length]` of either
# `SFML::Time` or numeric seconds.
def loop_points=(value)
  offset_t, length_t = value
  raise ArgumentError, "expected [offset_time, length_time]" unless offset_t && length_t

  span = C::Audio::TimeSpan.new
  span[:offset][:microseconds] = offset_t.is_a?(Time) ? offset_t.microseconds : Time.seconds(offset_t.to_f).microseconds
  span[:length][:microseconds] = length_t.is_a?(Time) ? length_t.microseconds : Time.seconds(length_t.to_f).microseconds
  C::Audio.sfMusic_setLoopPoints(@handle, span)
end

# ---- 3D-audio extras (mirror of Sound's) ----

# Stereo pan in [-1.0, 1.0] — see `Sound#pan`.
def pan = C::Audio.sfMusic_getPan(@handle)

# Set the stereo pan.
def pan=(v)
  C::Audio.sfMusic_setPan(@handle, v.to_f)
end

# Lower gain bound — see `Sound#min_gain`.
def min_gain = C::Audio.sfMusic_getMinGain(@handle)

# Set the min-gain floor.
def min_gain=(v)
  C::Audio.sfMusic_setMinGain(@handle, v.to_f)
end

# Upper gain bound — see `Sound#max_gain`.
def max_gain = C::Audio.sfMusic_getMaxGain(@handle)

# Set the max-gain cap.
def max_gain=(v)
  C::Audio.sfMusic_setMaxGain(@handle, v.to_f)
end

# Distance beyond which the source is fully attenuated.
def max_distance = C::Audio.sfMusic_getMaxDistance(@handle)

# Set the max-distance.
def max_distance=(v)
  C::Audio.sfMusic_setMaxDistance(@handle, v.to_f)
end

# `true` if 3D positional / Doppler / cone math is applied at
# mix time.
def spatialization_enabled? = C::Audio.sfMusic_isSpatializationEnabled(@handle)

# Toggle 3D spatialisation.
def spatialization_enabled=(v)
  C::Audio.sfMusic_setSpatializationEnabled(@handle, v ? true : false)
end

# Multiplier on the Listener's directional attenuation cone —
# see `Sound#directional_attenuation_factor`.
def directional_attenuation_factor
  C::Audio.sfMusic_getDirectionalAttenuationFactor(@handle)
end

# Set the directional-attenuation factor.
def directional_attenuation_factor=(v)
  C::Audio.sfMusic_setDirectionalAttenuationFactor(@handle, v.to_f)
end

private

def _take_ownership(ptr)
  @handle = FFI::AutoPointer.new(ptr, C::Audio.method

# File lib/sfml/audio/music.rb, line 222
def sample_rate   = C::Audio.sfMusic_getSampleRate(@handle)

# The portion of the track that loops when `looping = true`.
# Returns `[offset, length]` of `SFML::Time`s; defaults to the
# whole track. Set with `loop_points = [Time, Time]`.
def loop_points
  span = C::Audio.sfMusic_getLoopPoints(@handle)
  [Time.from_native(span[:offset]), Time.from_native(span[:length])]
end

# Set the looping window. Accepts `[offset, length]` of either
# `SFML::Time` or numeric seconds.
def loop_points=(value)
  offset_t, length_t = value
  raise ArgumentError, "expected [offset_time, length_time]" unless offset_t && length_t

  span = C::Audio::TimeSpan.new
  span[:offset][:microseconds] = offset_t.is_a?(Time) ? offset_t.microseconds : Time.seconds(offset_t.to_f).microseconds
  span[:length][:microseconds] = length_t.is_a?(Time) ? length_t.microseconds : Time.seconds(length_t.to_f).microseconds
  C::Audio.sfMusic_setLoopPoints(@handle, span)
end

# ---- 3D-audio extras (mirror of Sound's) ----

# Stereo pan in [-1.0, 1.0] — see `Sound#pan`.
def pan = C::Audio.sfMusic_getPan(@handle)

# Set the stereo pan.
def pan=(v)
  C::Audio.sfMusic_setPan(@handle, v.to_f)
end

# Lower gain bound — see `Sound#min_gain`.
def min_gain = C::Audio.sfMusic_getMinGain(@handle)

# Set the min-gain floor.
def min_gain=(v)
  C::Audio.sfMusic_setMinGain(@handle, v.to_f)
end

# Upper gain bound — see `Sound#max_gain`.
def max_gain = C::Audio.sfMusic_getMaxGain(@handle)

# Set the max-gain cap.
def max_gain=(v)
  C::Audio.sfMusic_setMaxGain(@handle, v.to_f)
end

# Distance beyond which the source is fully attenuated.
def max_distance = C::Audio.sfMusic_getMaxDistance(@handle)

# Set the max-distance.
def max_distance=(v)
  C::Audio.sfMusic_setMaxDistance(@handle, v.to_f)
end

# `true` if 3D positional / Doppler / cone math is applied at
# mix time.
def spatialization_enabled? = C::Audio.sfMusic_isSpatializationEnabled(@handle)

# Toggle 3D spatialisation.
def spatialization_enabled=(v)
  C::Audio.sfMusic_setSpatializationEnabled(@handle, v ? true : false)
end

# Multiplier on the Listener's directional attenuation cone —
# see `Sound#directional_attenuation_factor`.
def directional_attenuation_factor
  C::Audio.sfMusic_getDirectionalAttenuationFactor(@handle)
end

# Set the directional-attenuation factor.
def directional_attenuation_factor=(v)
  C::Audio.sfMusic_setDirectionalAttenuationFactor(@handle, v.to_f)
end

private

def _take_ownership(ptr)
  @handle = FFI::AutoPointer.new(ptr, C::Audio.method(:sfMusic_destroy))

# File lib/sfml/audio/music.rb, line 283
def spatialization_enabled=(v)
  C::Audio.sfMusic_setSpatializationEnabled(@handle, v ? true : false)
end

# File lib/sfml/audio/music.rb, line 280
  def spatialization_enabled? = C::Audio.sfMusic_isSpatializationEnabled(@handle)

  # Toggle 3D spatialisation.
  def spatialization_enabled=(v)
    C::Audio.sfMusic_setSpatializationEnabled(@handle, v ? true : false)
  end

  # Multiplier on the Listener's directional attenuation cone —
  # see `Sound#directional_attenuation_factor`.
  def directional_attenuation_factor
    C::Audio.sfMusic_getDirectionalAttenuationFactor(@handle)
  end

  # Set the directional-attenuation factor.
  def directional_attenuation_factor=(v)
    C::Audio.sfMusic_setDirectionalAttenuationFactor(@handle, v.to_f)
  end

  private

  def _take_ownership(ptr)
    @handle = FFI::AutoPointer.new(ptr, C::Audio.method(:sfMusic_destroy))
  end
end

# File lib/sfml/audio/music.rb, line 70
def status   = C::Audio::STATUSES[C::Audio.sfMusic_getStatus(@handle)]
# Convenience for `status == :playing`.
def playing? = status == :playing
# Convenience for `status == :paused`.
def paused?  = status == :paused
# Convenience for `status == :stopped`.
def stopped? = status == :stopped

# Total length of the track as a `SFML::Time`.
def duration = Time.from_native(C::Audio.sfMusic_getDuration(@handle))

# Current playback head as a SFML::Time. Reads from the underlying
# OpenAL source — only meaningful while the music is playing or
# paused (not after #stop).
def playing_offset
  Time.from_native(C::Audio.sfMusic_getPlayingOffset(@handle))
end

# Seek to `value` (a SFML::Time, or seconds as a Numeric). Works
# while the music is playing, paused, or stopped.
def playing_offset=(value)
  t = value.is_a?(Time) ? value : Time.seconds(value.to_f)
  C::Audio.sfMusic_setPlayingOffset(@handle, t.to_native)
end

# 3D velocity, Doppler factor, direction, cone — see Sound for
# the same methods on the simpler buffered source.
def velocity
  v = C::Audio.sfMusic_getVelocity(@handle)
  Vector3.new(v[:x], v[:y], v[:z])
end

# Set the 3D velocity — accepts Vector3 or `[x, y, z]`.
def velocity=(value)
  vec = value.is_a?(Vector3) ? value : Vector3.new(*value)
  packed = C::System::Vector3f.new
  packed[:x] = vec.x.to_f; packed[:y] = vec.y.to_f; packed[:z] = vec.z.to_f
  C::Audio.sfMusic_setVelocity(@handle, packed)
end

# Per-source Doppler scale. 1.0 realistic, 0 disables.
def doppler_factor    = C::Audio.sfMusic_getDopplerFactor(@handle)
# Set the per-source Doppler scale.
def doppler_factor=(v) C::Audio.sfMusic_setDopplerFactor(@handle, v.to_f); end

# The direction the music's cone points.
def direction
  v = C::Audio.sfMusic_getDirection(@handle)
  Vector3.new(v[:x], v[:y], v[:z])
end

# Set the direction vector — accepts Vector3 or `[x, y, z]`.
def direction=(value)
  vec = value.is_a?(Vector3) ? value : Vector3.new(*value)
  packed = C::System::Vector3f.new
  packed[:x] = vec.x.to_f; packed[:y] = vec.y.to_f; packed[:z] = vec.z.to_f
  C::Audio.sfMusic_setDirection(@handle, packed)
end

# Directional-attenuation cone — see SFML::SoundCone.
def cone
  SoundCone.from_native(C::Audio.sfMusic_getCone(@handle))
end

# Set the cone. Accepts a `SoundCone` or a Hash with
# `inner_angle`, `outer_angle`, `outer_gain`.
def cone=(value)
  cone =
    case value
    when SoundCone then value
    when Hash      then SoundCone.new(**value)
    else
      raise ArgumentError, "Music#cone= expects SoundCone or Hash; got #{value.class}"
    end
  C::Audio.sfMusic_setCone(@handle, cone.to_native)
end

# See Sound#effect_processor= — same audio-thread DSP callback.
def effect_processor=(callable)
  @effect_cb = callable.nil? ? nil : Audio._build_effect_processor(callable)
  C::Audio.sfMusic_setEffectProcessor(@handle, @effect_cb, nil)
end

# `true` if the track restarts after reaching the end (or its
# `loop_points` length).
# Cached on the Ruby side; see Sound#looping? for the why.
def looping?
  @looping
end

# Toggle looping playback.
def looping=(value)
  @looping = value ? true : false
  C::Audio.sfMusic_setLooping(@handle, @looping)
end

# Playback volume in [0, 100] — 100 = unattenuated.
def volume = C::Audio.sfMusic_getVolume(@handle)

# Set the playback volume in [0, 100].
def volume=(value)
  C::Audio.sfMusic_setVolume(@handle, value.to_f)
end

# Pitch multiplier. 1.0 = normal, 2.0 = octave up, 0.5 = octave down.
def pitch = C::Audio.sfMusic_getPitch(@handle)

# Set the pitch multiplier.
def pitch=(value)
  C::Audio.sfMusic_setPitch(@handle, value.to_f)
end

# 3D positional audio — see SFML::Sound for the why.
def position
  Vector3.from_native(C::Audio.sfMusic_getPosition(@handle))
end

# Set the 3D position — accepts Vector3 or `[x, y, z]`.
def position=(value)
  vec = value.is_a?(Vector3) ? value : Vector3.new(*value)
  C::Audio.sfMusic_setPosition(@handle, vec.to_native_f)
end

# Falloff sharpness with distance — see `Sound#attenuation`.
def attenuation = C::Audio.sfMusic_getAttenuation(@handle)

# Set the attenuation.
def attenuation=(value)
  C::Audio.sfMusic_setAttenuation(@handle, value.to_f)
end

# Distance below which volume is not attenuated.
def min_distance = C::Audio.sfMusic_getMinDistance(@handle)

# Set the min-distance.
def min_distance=(value)
  C::Audio.sfMusic_setMinDistance(@handle, value.to_f)
end

# `true` if `#position` is interpreted relative to the listener.
def relative_to_listener? = C::Audio.sfMusic_isRelativeToListener(@handle)

# Toggle listener-relative positioning.
def relative_to_listener=(value)
  C::Audio.sfMusic_setRelativeToListener(@handle, value ? true : false)
end

# ---- Stream introspection ----

# Number of audio channels (1 = mono, 2 = stereo, ...).
def channel_count = C::Audio.sfMusic_getChannelCount(@handle)
# Sample rate in Hz (e.g. 44_100 for CD-quality).
def sample_rate   = C::Audio.sfMusic_getSampleRate(@handle)

# The portion of the track that loops when `looping = true`.
# Returns `[offset, length]` of `SFML::Time`s; defaults to the
# whole track. Set with `loop_points = [Time, Time]`.
def loop_points
  span = C::Audio.sfMusic_getLoopPoints(@handle)
  [Time.from_native(span[:offset]), Time.from_native(span[:length])]
end

# Set the looping window. Accepts `[offset, length]` of either
# `SFML::Time` or numeric seconds.
def loop_points=(value)
  offset_t, length_t = value
  raise ArgumentError, "expected [offset_time, length_time]" unless offset_t && length_t

  span = C::Audio::TimeSpan.new
  span[:offset][:microseconds] = offset_t.is_a?(Time) ? offset_t.microseconds : Time.seconds(offset_t.to_f).microseconds
  span[:length][:microseconds] = length_t.is_a?(Time) ? length_t.microseconds : Time.seconds(length_t.to_f).microseconds
  C::Audio.sfMusic_setLoopPoints(@handle, span)
end

# ---- 3D-audio extras (mirror of Sound's) ----

# Stereo pan in [-1.0, 1.0] — see `Sound#pan`.
def pan = C::Audio.sfMusic_getPan(@handle)

# Set the stereo pan.
def pan=(v)
  C::Audio.sfMusic_setPan(@handle, v.to_f)
end

# Lower gain bound — see `Sound#min_gain`.
def min_gain = C::Audio.sfMusic_getMinGain(@handle)

# Set the min-gain floor.
def min_gain=(v)
  C::Audio.sfMusic_setMinGain(@handle, v.to_f)
end

# Upper gain bound — see `Sound#max_gain`.
def max_gain = C::Audio.sfMusic_getMaxGain(@handle)

# Set the max-gain cap.
def max_gain=(v)
  C::Audio.sfMusic_setMaxGain(@handle, v.to_f)
end

# Distance beyond which the source is fully attenuated.
def max_distance = C::Audio.sfMusic_getMaxDistance(@handle)

# Set the max-distance.
def max_distance=(v)
  C::Audio.sfMusic_setMaxDistance(@handle, v.to_f)
end

# `true` if 3D positional / Doppler / cone math is applied at
# mix time.
def spatialization_enabled? = C::Audio.sfMusic_isSpatializationEnabled(@handle)

# Toggle 3D spatialisation.
def spatialization_enabled=(v)
  C::Audio.sfMusic_setSpatializationEnabled(@handle, v ? true : false)
end

# Multiplier on the Listener's directional attenuation cone —
# see `Sound#directional_attenuation_factor`.
def directional_attenuation_factor
  C::Audio.sfMusic_getDirectionalAttenuationFactor(@handle)
end

# Set the directional-attenuation factor.
def directional_attenuation_factor=(v)
  C::Audio.sfMusic_setDirectionalAttenuationFactor(@handle, v.to_f)
end

private

def _take_ownership(ptr)

# File lib/sfml/audio/music.rb, line 67
def stop   = C::Audio.sfMusic_stop(@handle)

# Playback state — one of `:stopped`, `:paused`, `:playing`.
def status   = C::Audio::STATUSES[C::Audio.sfMusic_getStatus(@handle)]
# Convenience for `status == :playing`.
def playing? = status == :playing
# Convenience for `status == :paused`.
def paused?  = status == :paused
# Convenience for `status == :stopped`.
def stopped? = status == :stopped

# Total length of the track as a `SFML::Time`.
def duration = Time.from_native(C::Audio.sfMusic_getDuration(@handle))

# Current playback head as a SFML::Time. Reads from the underlying
# OpenAL source — only meaningful while the music is playing or
# paused (not after #stop).
def playing_offset
  Time.from_native(C::Audio.sfMusic_getPlayingOffset(@handle))
end

# Seek to `value` (a SFML::Time, or seconds as a Numeric). Works
# while the music is playing, paused, or stopped.
def playing_offset=(value)
  t = value.is_a?(Time) ? value : Time.seconds(value.to_f)
  C::Audio.sfMusic_setPlayingOffset(@handle, t.to_native)
end

# 3D velocity, Doppler factor, direction, cone — see Sound for
# the same methods on the simpler buffered source.
def velocity
  v = C::Audio.sfMusic_getVelocity(@handle)
  Vector3.new(v[:x], v[:y], v[:z])
end

# Set the 3D velocity — accepts Vector3 or `[x, y, z]`.
def velocity=(value)
  vec = value.is_a?(Vector3) ? value : Vector3.new(*value)
  packed = C::System::Vector3f.new
  packed[:x] = vec.x.to_f; packed[:y] = vec.y.to_f; packed[:z] = vec.z.to_f
  C::Audio.sfMusic_setVelocity(@handle, packed)
end

# Per-source Doppler scale. 1.0 realistic, 0 disables.
def doppler_factor    = C::Audio.sfMusic_getDopplerFactor(@handle)
# Set the per-source Doppler scale.
def doppler_factor=(v) C::Audio.sfMusic_setDopplerFactor(@handle, v.to_f); end

# The direction the music's cone points.
def direction
  v = C::Audio.sfMusic_getDirection(@handle)
  Vector3.new(v[:x], v[:y], v[:z])
end

# Set the direction vector — accepts Vector3 or `[x, y, z]`.
def direction=(value)
  vec = value.is_a?(Vector3) ? value : Vector3.new(*value)
  packed = C::System::Vector3f.new
  packed[:x] = vec.x.to_f; packed[:y] = vec.y.to_f; packed[:z] = vec.z.to_f
  C::Audio.sfMusic_setDirection(@handle, packed)
end

# Directional-attenuation cone — see SFML::SoundCone.
def cone
  SoundCone.from_native(C::Audio.sfMusic_getCone(@handle))
end

# Set the cone. Accepts a `SoundCone` or a Hash with
# `inner_angle`, `outer_angle`, `outer_gain`.
def cone=(value)
  cone =
    case value
    when SoundCone then value
    when Hash      then SoundCone.new(**value)
    else
      raise ArgumentError, "Music#cone= expects SoundCone or Hash; got #{value.class}"
    end
  C::Audio.sfMusic_setCone(@handle, cone.to_native)
end

# See Sound#effect_processor= — same audio-thread DSP callback.
def effect_processor=(callable)
  @effect_cb = callable.nil? ? nil : Audio._build_effect_processor(callable)
  C::Audio.sfMusic_setEffectProcessor(@handle, @effect_cb, nil)
end

# `true` if the track restarts after reaching the end (or its
# `loop_points` length).
# Cached on the Ruby side; see Sound#looping? for the why.
def looping?
  @looping
end

# Toggle looping playback.
def looping=(value)
  @looping = value ? true : false
  C::Audio.sfMusic_setLooping(@handle, @looping)
end

# Playback volume in [0, 100] — 100 = unattenuated.
def volume = C::Audio.sfMusic_getVolume(@handle)

# Set the playback volume in [0, 100].
def volume=(value)
  C::Audio.sfMusic_setVolume(@handle, value.to_f)
end

# Pitch multiplier. 1.0 = normal, 2.0 = octave up, 0.5 = octave down.
def pitch = C::Audio.sfMusic_getPitch(@handle)

# Set the pitch multiplier.
def pitch=(value)
  C::Audio.sfMusic_setPitch(@handle, value.to_f)
end

# 3D positional audio — see SFML::Sound for the why.
def position
  Vector3.from_native(C::Audio.sfMusic_getPosition(@handle))
end

# Set the 3D position — accepts Vector3 or `[x, y, z]`.
def position=(value)
  vec = value.is_a?(Vector3) ? value : Vector3.new(*value)
  C::Audio.sfMusic_setPosition(@handle, vec.to_native_f)
end

# Falloff sharpness with distance — see `Sound#attenuation`.
def attenuation = C::Audio.sfMusic_getAttenuation(@handle)

# Set the attenuation.
def attenuation=(value)
  C::Audio.sfMusic_setAttenuation(@handle, value.to_f)
end

# Distance below which volume is not attenuated.
def min_distance = C::Audio.sfMusic_getMinDistance(@handle)

# Set the min-distance.
def min_distance=(value)
  C::Audio.sfMusic_setMinDistance(@handle, value.to_f)
end

# `true` if `#position` is interpreted relative to the listener.
def relative_to_listener? = C::Audio.sfMusic_isRelativeToListener(@handle)

# Toggle listener-relative positioning.
def relative_to_listener=(value)
  C::Audio.sfMusic_setRelativeToListener(@handle, value ? true : false)
end

# ---- Stream introspection ----

# Number of audio channels (1 = mono, 2 = stereo, ...).
def channel_count = C::Audio.sfMusic_getChannelCount(@handle)
# Sample rate in Hz (e.g. 44_100 for CD-quality).
def sample_rate   = C::Audio.sfMusic_getSampleRate(@handle)

# The portion of the track that loops when `looping = true`.
# Returns `[offset, length]` of `SFML::Time`s; defaults to the
# whole track. Set with `loop_points = [Time, Time]`.
def loop_points
  span = C::Audio.sfMusic_getLoopPoints(@handle)
  [Time.from_native(span[:offset]), Time.from_native(span[:length])]
end

# Set the looping window. Accepts `[offset, length]` of either
# `SFML::Time` or numeric seconds.
def loop_points=(value)
  offset_t, length_t = value
  raise ArgumentError, "expected [offset_time, length_time]" unless offset_t && length_t

  span = C::Audio::TimeSpan.new
  span[:offset][:microseconds] = offset_t.is_a?(Time) ? offset_t.microseconds : Time.seconds(offset_t.to_f).microseconds
  span[:length][:microseconds] = length_t.is_a?(Time) ? length_t.microseconds : Time.seconds(length_t.to_f).microseconds
  C::Audio.sfMusic_setLoopPoints(@handle, span)
end

# ---- 3D-audio extras (mirror of Sound's) ----

# Stereo pan in [-1.0, 1.0] — see `Sound#pan`.
def pan = C::Audio.sfMusic_getPan(@handle)

# Set the stereo pan.
def pan=(v)
  C::Audio.sfMusic_setPan(@handle, v.to_f)
end

# Lower gain bound — see `Sound#min_gain`.
def min_gain = C::Audio.sfMusic_getMinGain(@handle)

# Set the min-gain floor.
def min_gain=(v)
  C::Audio.sfMusic_setMinGain(@handle, v.to_f)
end

# Upper gain bound — see `Sound#max_gain`.
def max_gain = C::Audio.sfMusic_getMaxGain(@handle)

# Set the max-gain cap.
def max_gain=(v)
  C::Audio.sfMusic_setMaxGain(@handle, v.to_f)
end

# Distance beyond which the source is fully attenuated.
def max_distance = C::Audio.sfMusic_getMaxDistance(@handle)

# Set the max-distance.
def max_distance=(v)
  C::Audio.sfMusic_setMaxDistance(@handle, v.to_f)
end

# `true` if 3D positional / Doppler / cone math is applied at
# mix time.
def spatialization_enabled? = C::Audio.sfMusic_isSpatializationEnabled(@handle)

# Toggle 3D spatialisation.
def spatialization_enabled=(v)
  C::Audio.sfMusic_setSpatializationEnabled(@handle, v ? true : false)
end

# Multiplier on the Listener's directional attenuation cone —
# see `Sound#directional_attenuation_factor`.
def directional_attenuation_factor
  C::Audio.sfMusic_getDirectionalAttenuationFactor(@handle)
end

# Set the directional-attenuation factor.
def directional_attenuation_factor=(v)
  C::Audio.sfMusic_setDirectionalAttenuationFactor(@handle, v.to_f)
end

private

def _take_ownership(