KeyframeSelection¶
Description
This is a node for keyframe selection from video, which removes too similar or too blurry images.
Note
At the moment, KeyframeSelection can not be used as input for CameraInit. We cannot know in advance how many images will be extracted, but the total number of images is required for render farm submisson. So when adding a video file to Meshroom, the following Message will appear: “You need to manually compute the KeyframeSelection node and then reimport the created images into Meshroom for the reconstruction.”
To automatically add extracted frames to your project you can copy the output folder path of KeyframeExtraction and set it as the Live Reconsturuction Image Folder Path. Then start watching the folder and execute the graph.
https://github.com/alicevision/meshroom/issues/232
Supported file types:
.avi, .mov, .qt, .mkv, .webm, .mp4, .mpg, .mpeg, .m2v, .m4v, .wmv, .ogv, .ogg, .mxf
FFmpeg can be used for video file conversion.
MR version 2020.x
settings
Name |
Description |
---|---|
Media Path |
Media Path |
Media Paths |
Input video files or image sequence directories. |
Brand |
Camera brand. |
Brands |
Camera brands. |
Model |
Camera model. |
Models |
Camera models. |
mmFocal |
Focal in mm (will be use if not 0). (0.0-500) |
mmFocals |
Focals in mm (will be use if not 0). |
pxFocal |
Focal in px (will be use and convert in mm if not 0). (0.0-500) |
pxFocals |
Focals in px (will be use and convert in mm if not 0). |
Frame Offset |
Frame Offset 0-100 |
Frame Offsets |
Frame Offsets |
Sensor Db Path |
Camera sensor width database path. (ALICEVISION_SENSOR_DB) |
Voctree Path |
Vocabulary tree path. (ALICEVISION_VOCTREE) |
Use Sparse Distance Selection |
Use sparseDistance selection in order to avoid similar keyframes. (True) |
Use Sharpness Selection |
Use frame sharpness score for keyframe selection. (True) |
Sparse Distance Max Score |
Maximum number of strong common points between two keyframes. (1-200, 100) |
Sharpness Preset |
Preset for sharpnessSelection : {ultra, high, normal, low, very_low, none} |
Sharp Subset |
sharp part of the image (1 = all, 2 = size/2, …) (1-100, 4) |
Min Frame Step |
minimum number of frames between two keyframes (1-100, 12) |
Max Frame Step |
maximum number of frames after which a keyframe can be taken (2-1000, 36) |
Max Nb Out Frame |
maximum number of output frames (0 = no limit) (0-10000) |
Verbose Level |
[‘fatal’, ‘error’, ‘warning’, ‘info’, ‘debug’, ‘trace’] |
Output Folder |
Output keyframes folder for extracted frames. (internalFolder) |