b2dIsMoviePaused

Returns 1 if movie is paused (frozen on current frame), 0 otherwise (checks movie->paused flag). Takes handle (movie handle from b2dLoadMovie, integer). Returns 1 if movie paused (b2dPauseMovie called, frame frozen), returns 0 if not paused (actively playing, stopped, or finished). Reads movie->paused flag (set by b2dPauseMovie, cleared by b2dResumeMovie or b2dStopMovie). Use to distinguish paused from playing (both return 1 from b2dMoviePlaying, this distinguishes them), query pause state (check if movie frozen), or conditional logic (different UI for paused vs playing). Return values: 1 if paused (movie frozen on current frame, b2dPauseMovie called, waiting for b2dResumeMovie), 0 if actively playing (movie->playing==true, frames advancing normally), 0 if stopped (b2dStopMovie called or never started, no active playback), 0 if invalid handle (handle not found or <=0). Use cases: (1) Toggle pause (If b2dIsMoviePaused(movie) Then b2dResumeMovie(movie) Else b2dPauseMovie(movie)), (2) UI indicator (If b2dIsMoviePaused(movie) Then Print "PAUSED" show pause indicator), (3) Distinguish states (If b2dMoviePlaying(movie) Then If b2dIsMoviePaused(movie) Then paused Else playing), (4) Conditional resume (If b2dIsMoviePaused(movie) And userAction Then b2dResumeMovie(movie)). Common patterns: check paused = If b2dIsMoviePaused(movie) Then frozen; toggle = If paused Then resume Else pause; not paused = If Not b2dIsMoviePaused(movie) Then playing or stopped. Paused vs Playing vs Stopped: paused (b2dIsMoviePaused=1, b2dMoviePlaying=1, frame frozen but active), playing (b2dIsMoviePaused=0, b2dMoviePlaying=1, frames advancing), stopped (b2dIsMoviePaused=0, b2dMoviePlaying=0, no active playback). State transitions: b2dPauseMovie sets paused=true (this function returns 1), b2dResumeMovie clears paused=false (this function returns 0, movie playing again), b2dStopMovie clears paused=false (this function returns 0, movie stopped), b2dPlayMovie clears paused=false (this function returns 0, movie playing from beginning). 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: b2dMoviePlaying queries playing state (returns 1 for both playing and paused, use this function to distinguish), b2dPauseMovie pauses playback (causes this function to return 1), b2dResumeMovie resumes playback (causes this function to return 0), b2dStopMovie stops playback (causes this function to return 0), b2dPlayMovie starts playback (causes this function to return 0).