b2dSetMovieVolume

Sets movie volume level (0-100 range, clamped automatically, currently stored but not used for audio playback). Takes handle (movie handle from b2dLoadMovie, integer), volume (volume level 0=silent to 100=full, integer, clamped to 0-100 range). Returns nothing. Clamps volume to valid range (if volume<0 then volume=0, if volume>100 then volume=100), stores in movie->volume (movie->volume = clamped value, default is 100), currently not used for audio (BBV format is video-only, no audio track, volume stored for future extension). Use to set playback volume (when audio support added), prepare for audio-enabled BBV files (set volume before audio implementation), or store volume preference (save/restore volume settings per movie). Volume range: 0 (silent, muted, no audio output), 1-99 (partial volume, proportional audio level), 100 (full volume, maximum audio level, default value), automatic clamping (values outside 0-100 range clamped to nearest valid value). Use cases: (1) Set volume (b2dSetMovieVolume(movie,50) half volume for background video), (2) Mute movie (b2dSetMovieVolume(movie,0) silent playback), (3) Full volume (b2dSetMovieVolume(movie,100) maximum level), (4) Dynamic volume (b2dSetMovieVolume(movie,volumeSlider) user-controlled volume). Common patterns: set volume = b2dSetMovieVolume(movie,level) 0-100 range; mute = b2dSetMovieVolume(movie,0) silent; full = b2dSetMovieVolume(movie,100) maximum; fade = gradually change volume over time. Current implementation: stored but unused (movie->volume field exists, but no audio playback in current BBV format), future extension (when audio added to BBV format, volume will control playback level), video-only format (BBV currently contains only video frames, no audio track), default value 100 (movies created with full volume by default). Audio implementation notes: BBV format extensible (can add audio track to ZIP archive in future, audio.wav or per-frame audio), volume would control mixer level (when audio added, volume maps to audio mixer gain 0-100%), cross-fade support (volume useful for smooth transitions between videos with audio). Performance: cost zero (simple integer assignment with two comparisons for clamping ~0.0001ms), immediate (takes effect immediately, no delay or processing), lightweight (safe to call frequently, could animate volume changes every frame). Validation: silently ignores if handle<=0 or not found (negative, zero, or invalid handle), clamps out-of-range values (no error, automatically constrains to 0-100 range). Related: b2dGetMovieVolume queries volume (reads current volume level 0-100), b2dLoadMovie creates movie (initializes volume to 100 by default), b2dPlayMovie starts playback (when audio added, respects volume setting).