b2dMovieHeight

Returns movie height in pixels (from BBVHeader, original video resolution). Takes handle (movie handle from b2dLoadMovie, integer). Returns height in pixels (positive integer from movie->height, loaded from BBV header), returns 0 if invalid handle (handle not found or <=0). Reads movie->height (set during b2dLoadMovie from BBVHeader.height, original frame height). Use to query video dimensions (calculate scaling, positioning, aspect ratio), allocate buffers (if processing frames), or center video (calculate y position based on screen height). Height from header: stored in BBVHeader during video creation (original frame height from encoding tool), loaded during b2dLoadMovie (read from header.bin in ZIP), immutable (never changes after load, reflects source video resolution). Use cases: (1) Center video (y = (screenHeight - b2dMovieHeight(movie)) / 2 center vertically), (2) Aspect ratio (aspect = b2dMovieWidth(movie) / b2dMovieHeight(movie) calculate ratio), (3) Scale to fit (scaleY = targetHeight / b2dMovieHeight(movie) fit to target size), (4) Validate dimensions (If b2dMovieHeight(movie) > 1080 Then Print "Full HD or higher"). Common patterns: query = height = b2dMovieHeight(movie) get height; center = y = (screenH - movieH) / 2; aspect = w / h calculate ratio. Performance: cost zero (simple struct member read, trivial operation), safe to call frequently (can query 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 positive height from header). Related: b2dMovieWidth queries width (paired with height for aspect ratio calculations), b2dDrawMovieScaled draws scaled (can scale to arbitrary width/height), b2dDrawScaledMovie draws with scale factors (scaleY applied to height), b2dLoadMovie loads movie (reads height from BBVHeader).