Cropvideo¶
Auto-generated documentation for musicalgestures._cropvideo module.
- Mgt-python / Modules / Musicalgestures / Cropvideo
async_subprocess¶
cropping_window¶
find_motion_box_ffmpeg¶
Helper function to find the area of motion in a video, using ffmpeg.
Arguments¶
filename
str - Path to the video file.motion_box_thresh
float, optional - Pixel threshold to apply to the video before assessing the area of motion. Defaults to 0.1.motion_box_margin
int, optional - Margin (in pixels) to add to the detected motion box. Defaults to 12.
Raises¶
KeyboardInterrupt
- In case we stop the process manually.
Returns¶
int
- The width of the motion box.int
- The height of the motion box.int
- The X coordinate of the top left corner of the motion box.int
- The Y coordinate of the top left corner of the motion box.
manual_text_input¶
Helper function for mg_crop_video_ffmpeg when its crop_movement is 'manual', but the environment is in Colab. In this case we can't display the windowed cropping UI, so we ask for the values as a text input.
Returns¶
list
- x, y, w, h for crop_ffmpeg.
mg_cropvideo_ffmpeg¶
def mg_cropvideo_ffmpeg(
filename,
crop_movement='Auto',
motion_box_thresh=0.1,
motion_box_margin=12,
target_name=None,
overwrite=False,
):
Crops the video using ffmpeg.
Arguments¶
filename
str - Path to the video file.crop_movement
str, optional - 'Auto' finds the bounding box that contains the total motion in the video. Motion threshold is given by motion_box_thresh. 'Manual' opens up a simple GUI that is used to crop the video manually by looking at the first frame. Defaults to 'Auto'.motion_box_thresh
float, optional - Only meaningful ifcrop_movement='Auto'
. Takes floats between 0 and 1, where 0 includes all the motion and 1 includes none. Defaults to 0.1.motion_box_margin
int, optional - Only meaningful ifcrop_movement='Auto'
. Adds margin to the bounding box. Defaults to 12.target_name
str, optional - The name of the output video. Defaults to None (which assumes that the input filename with the suffix "_crop" should be used).overwrite
bool, optional - Whether to allow overwriting existing files or to automatically increment target filenames to avoid overwriting. Defaults to False.
Returns¶
str
- Path to the cropped video.