b2dMoviePlaying

Returns 1 if movie is playing or paused (not stopped), 0 otherwise (checks movie->playing OR movie->paused). Takes handle (movie handle from b2dLoadMovie, integer). Returns 1 if movie actively playing or paused (playback in progress, frame visible), returns 0 if movie stopped or finished (playback not active, no frame). Checks combined state (returns (movie->playing || movie->paused) ? 1 : 0), considers paused as "playing" (movie still considered active when paused, frame remains visible). Use to query playback state (check if movie needs drawing, loop control), wait for completion (While b2dMoviePlaying(movie): render loop), or conditional logic (different behavior based on playback state). Return values: 1 if actively playing (movie->playing==true, frames advancing normally), 1 if paused (movie->paused==true, frozen on current frame but still "active"), 0 if stopped (b2dStopMovie called, reset to beginning), 0 if finished (movie reached end without looping, not currently playing), 0 if invalid handle (handle not found or <=0). Use cases: (1) Render loop (While b2dMoviePlaying(cutscene): b2dDrawMovie(cutscene,x,y): b3dRenderWorld() draw until complete), (2) Conditional rendering (If b2dMoviePlaying(movie) Then b2dDrawMovie(movie,x,y) only draw if playing), (3) Wait for completion (Repeat: b2dDrawMovie(movie,x,y): b3dRenderWorld(): Until Not b2dMoviePlaying(movie)), (4) State check (If b2dMoviePlaying(movie) Then Print "Movie active" Else Print "Movie stopped"). Common patterns: check = If b2dMoviePlaying(movie) Then active; wait loop = While b2dMoviePlaying(movie): draw; not playing = If Not b2dMoviePlaying(movie) Then stopped or finished. Playing vs Paused distinction: use b2dIsMoviePaused to distinguish (b2dMoviePlaying returns 1 for both playing and paused), paused means frozen frame (frame not advancing, but texture valid and drawable), playing means active advancement (frames changing based on elapsed time), stopped means inactive (b2dMoviePlaying returns 0, no active playback). Finished state: movie->finished set when reaching end without looping (stops automatically, b2dMoviePlaying returns 0), b2dPlayMovie clears finished flag (allows replay from beginning), b2dStopMovie also clears finished flag (explicit reset for replay). Performance: cost zero (simple flag check, trivial operation), safe to call frequently (can check every frame without overhead), lightweight (returns immediately, no state changes). Validation: returns 0 if handle<=0 or not found (negative, zero, or invalid handle), always returns valid integer (0 or 1, never error code). Related: b2dIsMoviePaused queries paused state (distinguishes paused from actively playing, both return 1 from b2dMoviePlaying), b2dPlayMovie starts playback (causes this function to return 1), b2dStopMovie stops playback (causes this function to return 0), b2dPauseMovie pauses playback (this function still returns 1 when paused), b2dDrawMovie renders frame (typically called when this function returns 1).