WOLFRAM

Wolfram Language & System Documentation Center

VideoIntervals[video,crit]

returns time intervals of video for which the criterion crit is satisfied.

VideoIntervals[video,crit,n]

evaluates criterion crit on partitions of n video frames.

VideoIntervals[video,crit,n,d]

evaluates crit on partitions with offset d.

VideoIntervals[{video1,video2,…},crit,…]

applies crit to a list of inputs extracted from each videoi.

Details and Options
Details and Options Details and Options
Examples  
Basic Examples  
Scope  
Options  
MaxItems  
VideoPadding  
Applications  
See Also
Related Guides
History
Cite this Page

VideoIntervals

VideoIntervals[video,crit]

returns time intervals of video for which the criterion crit is satisfied.

VideoIntervals[video,crit,n]

evaluates criterion crit on partitions of n video frames.

VideoIntervals[video,crit,n,d]

evaluates crit on partitions with offset d.

VideoIntervals[{video1,video2,…},crit,…]

applies crit to a list of inputs extracted from each videoi.

Details and Options

  • VideoIntervals can be used to detect time intervals of interest in a video, such as constant frame, silent audio intervals, intervals containing a specific object, etc.
  • A criterion crit of a single argument gets applied to image frames or a list of image frames.
  • A pure function crit can access video and audio data as well as time using the following arguments:
  • #Imagevideo frames as Image objects
    #Audioa chunk of the audio as an Audio object
    #Timetime from the beginning of the video
    #TimeIntervalbeginning and end time stamps for the current partition
    #FrameIndexindex of the current output frame
    #InputFrameIndexindex of the current input frame
  • In VideoIntervals[{video1,video2,…},crit,…], data provided to each of the arguments is a list where the i^(th) element corresponds to the data extracted from videoi.
  • By default, partitions are offset by one frame.
  • VideoIntervals supports video containers and codecs specified by $VideoDecoders.
  • The following options can be given:
  • MaxItems Infinitymaximum number of intervals to return
    VideoPadding Automaticpadding to use for frames beyond last frame

Examples

open all close all

Basic Examples  (2)

Find video intervals with constant frames:

Wolfram Language code: v = Video["ExampleData/Caminandes.mp4"];
Wolfram Language code: VideoIntervals[v, Max[#Image] - Min[#Image] < .01&]

Find video intervals with loud audio:

Wolfram Language code: v = Video["ExampleData/bullfinch.mkv"];
Wolfram Language code: VideoIntervals[v, First@Mean[Abs@#Audio] > .1&]

Scope  (6)

Specify the criterion as a pure function:

Wolfram Language code: v = VideoTrim[Video["ExampleData/bullfinch.mkv"], {1, 2}];
Wolfram Language code: VideoIntervals[v, ImageMeasurements[#Image, "MeanIntensity"] < .47&]

Specify the criterion as a normal function:

Wolfram Language code: crit[assoc_] := ImageMeasurements[assoc["Image"], "MeanIntensity"] < .47
Wolfram Language code: VideoIntervals[v, crit]

The input to the criterion function is an association with keys "Time", "TimeInterval", "Image", "FrameIndex", "InputFrameIndex" and "Audio" (if present):

Wolfram Language code: v = VideoTrim[Video["ExampleData/bullfinch.mkv"], {1, 2}];
Wolfram Language code: inputs = {}; VideoIntervals[v, (AppendTo[inputs, #];False)&]; inputs[[1]]

Evaluate the criterion on a buffer of five frames:

Wolfram Language code: v = VideoTrim[Video["ExampleData/bullfinch.mkv"], {1, 2}];
Wolfram Language code: VideoIntervals[v, ImageMeasurements[Mean@#Image, "MeanIntensity"] < .47&, 5]

If the partition size is not Automatic, the value for "Image" will be a list of images:

Wolfram Language code: inputs = {}; VideoIntervals[v, (AppendTo[inputs, #];False)&, 5];
Wolfram Language code: inputs[[1, "Image"]]

The value for "Audio" is always a single Audio object of the appropriate duration:

Wolfram Language code: Duration@inputs[[1, "Audio"]]

Evaluate the criterion on non-overlapping partitions of five frames:

Wolfram Language code: v = Video["ExampleData/bullfinch.mkv"];VideoIntervals[v, ImageMeasurements[Mean@#Image, "MeanIntensity"] < .47&, 5, 5]

Specify partition size and offset using time quantities:

Wolfram Language code: v = Video["ExampleData/bullfinch.mkv"];VideoIntervals[v, ImageMeasurements[Mean@#Image, "MeanIntensity"] < .47&, Quantity[1, "Seconds"], Quantity[0.5, "Seconds"]]

Compute intervals from multiple videos:

Wolfram Language code: videos = {Video["ExampleData/bullfinch.mkv"], Video["ExampleData/fish.mp4"]};VideoIntervals[videos, ImageMeasurements[#Image[[1]], "MeanIntensity"] > ImageMeasurements[#Image[[2]], "MeanIntensity"]&]

Options  (2)

MaxItems  (1)

By default, using MaxItems∞, the whole input is evaluated for possible intervals of interest:

Wolfram Language code: v = Video["ExampleData/bullfinch.mkv"];
Wolfram Language code: Options[VideoIntervals]
Wolfram Language code: VideoIntervals[v, ImageMeasurements[#Image, "MeanIntensity"] < .47&]

Stop the computation once n complete intervals have been detected:

Wolfram Language code: VideoIntervals[v, ImageMeasurements[#Image, "MeanIntensity"] < .47&, MaxItems -> 2]

VideoPadding  (1)

When a video track is shorter than other tracks, black frames are used beyond its duration:

Wolfram Language code: v1 = FrameListVideo[ConstantImage @* Hue /@ Most[Subdivide[10]], FrameRate -> 2]; v2 = VideoCombine[{v1, AudioGenerator["Sin", 10]}]
Wolfram Language code: VideoIntervals[v2, ImageMeasurements[#Image, "MeanIntensity"] < .3&]

Use VideoPadding to specify a different color padding:

Wolfram Language code: VideoIntervals[v2, ImageMeasurements[#Image, "MeanIntensity"] < .3&, VideoPadding -> White]

Applications  (2)

Find the intervals that contain the most motion in a video:

Wolfram Language code: v = Video["ExampleData/bullfinch.mkv"];VideoIntervals[v, ImageMeasurements[ImageDifference@@#Image, "MeanIntensity"] > .025&, 2]

Extract the corresponding frames:

Wolfram Language code: VideoExtractFrames[v, Interval@@%]//ImageCollage

Find the intervals that contain constant frames:

Wolfram Language code: v = Video["ExampleData/Caminandes.mp4"];
Wolfram Language code: int = VideoIntervals[v, Max[#Image] - Min[#Image] < .1&]

Delete such intervals from the video:

Wolfram Language code: VideoDelete[v, int]

Compare the duration of the original and resulting videos:

Wolfram Language code: Duration /@ {v, %}
Wolfram Research (2020), VideoIntervals, Wolfram Language function, https://reference.wolfram.com/language/ref/VideoIntervals.html.

Text

Wolfram Research (2020), VideoIntervals, Wolfram Language function, https://reference.wolfram.com/language/ref/VideoIntervals.html.

CMS

Wolfram Language. 2020. "VideoIntervals." Wolfram Language & System Documentation Center. Wolfram Research. https://reference.wolfram.com/language/ref/VideoIntervals.html.

APA

Wolfram Language. (2020). VideoIntervals. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/VideoIntervals.html

BibTeX

@misc{reference.wolfram_2026_videointervals, author="Wolfram Research", title="{VideoIntervals}", year="2020", howpublished="\url{https://reference.wolfram.com/language/ref/VideoIntervals.html}", note=[Accessed: 16-June-2026]}

BibLaTeX

@online{reference.wolfram_2026_videointervals, organization={Wolfram Research}, title={VideoIntervals}, year={2020}, url={https://reference.wolfram.com/language/ref/VideoIntervals.html}, note=[Accessed: 16-June-2026]}