b2dGetMovieVolume

Returns current movie volume level (0-100 range, default 100, currently stored but not used for audio). Takes handle (movie handle from b2dLoadMovie, integer). Returns volume level (integer 0-100, from movie->volume), returns 0 if invalid handle (handle not found or <=0). Reads movie->volume (set by b2dSetMovieVolume or initialized to 100 by b2dLoadMovie). Use to query current volume (check volume setting, display in UI), save volume setting (store volume preference before freeing movie), or validate volume range (verify volume within expected range). Volume range: 0 (silent/muted, set by b2dSetMovieVolume(movie,0)), 1-99 (partial volume, various levels set by user), 100 (full volume, default value when movie loaded, maximum level), always valid (constrained by b2dSetMovieVolume clamping, never outside 0-100). Use cases: (1) Display volume (Print "Volume: "+b2dGetMovieVolume(movie)+"%" show current setting), (2) Save preference (savedVolume=b2dGetMovieVolume(movie): store before freeing), (3) Restore volume (b2dSetMovieVolume(newMovie,savedVolume) apply to new movie), (4) UI slider (sliderValue=b2dGetMovieVolume(movie) sync UI with current volume). Common patterns: query = vol=b2dGetMovieVolume(movie) get current; check muted = If b2dGetMovieVolume(movie)=0 Then muted; check full = If b2dGetMovieVolume(movie)=100 Then maximum. Current implementation: stored but unused (movie->volume field exists, but no audio playback in current BBV format), default value (movies loaded with volume=100 initially), persists across playback (volume setting maintained through play/stop/pause cycles), future audio support (when audio added to BBV, this will reflect actual playback volume). Default behavior: new movies (b2dLoadMovie initializes volume=100, full volume by default), after b2dSetMovieVolume (returns value set by last b2dSetMovieVolume call, clamped to 0-100), invalid handle (returns 0, same as silent/muted volume, indistinguishable from actual volume=0). Performance: cost zero (simple struct member read, trivial operation ~0.0001ms), safe to call frequently (can query every frame without overhead, no state changes), lightweight (returns immediately, no processing). Validation: returns 0 if handle<=0 or not found (negative, zero, or invalid handle, same value as muted), always returns valid integer (0-100 range guaranteed by b2dSetMovieVolume clamping). Related: b2dSetMovieVolume sets volume (changes value returned by this function), b2dLoadMovie creates movie (initializes volume to 100, value returned by this function), b2dPlayMovie starts playback (when audio added, uses volume from this function).