Video

supervisely_lib.video.video.is_valid_ext(ext: str) → bool

Checks if given extension is supported.

Parameters

ext (str) – Video file extension.

Returns

bool

Return type

bool

Usage example

sly.video.is_valid_ext(".mp4")  # True
sly.video.is_valid_ext(".jpeg") # False

supervisely_lib.video.video.has_valid_ext(path: str) → bool

Checks if Video file from given path has supported extension.

Parameters

path (str) – Path to Video file.

Returns

bool

Return type

bool

Usage example

video_path = "/home/admin/work//videos/Cars/ds0/video/6x.mp4"
sly.video.has_valid_ext(video_path) # True

supervisely_lib.video.video.validate_ext(ext: str) → None

Raises error if given extension is not supported.

Parameters

ext (str) – Extension.

Raises

UnsupportedVideoFormat if given extension is not supported.

Returns

None

Return type

NoneType

Usage example

sly.video.validate_ext(".jpeg")
# Unsupported video extension: .jpeg.
# Only the following extensions are supported: ['.avi', '.mp4', '.3gp', '.flv', '.webm', '.wmv', '.mov', '.mkv'].

supervisely_lib.video.video.get_image_size_and_frames_count(path: str) → Tuple[Tuple[int, int], int]

Gets image size and number of frames from Video file.

Parameters

path (str) – Path to Video file.

Returns

Image size and number of Video frames.

Return type

Tuple[Tuple[int, int], int]

Usage example

video_path = "/home/admin/work/videos/Cars/ds0/video/6x.mp4"
video_info = sly.video.get_image_size_and_frames_count(video_path)
print(video_info)
# Output: ((720, 1280), 152)

supervisely_lib.video.video.validate_format(path: str) → None

Raise error if Video file from given path couldn’t be read or file extension is not supported.

Parameters

path (str) – Path to Video file.

Raises

VideoReadException if Video file from given path couldn’t be read or file extension is not supported

Returns

None

Return type

NoneType

Usage example

video_path = "/home/paul/work/sphinx-docs/supervisely_py/docs/source/debug/video/Prius_360/ds0/video/video.jpg"
sly.video.validate_format(video_path)
# Unsupported video extension: .jpg. Only the following extensions are supported: ['.avi', '.mp4', '.3gp', '.flv', '.webm', '.wmv', '.mov', '.mkv'].

supervisely_lib.video.video.count_video_streams(all_streams: List[dict]) → int

Count number of video streams in video.

Parameters

all_streams (List[dict]) – List of Video file audio and video streams.

Returns

Number of video streams in Video file

Return type

int

supervisely_lib.video.video.get_video_streams(all_streams: List[dict]) → list

Get list of video streams from given list of all streams.

Parameters

all_streams (List[dict]) – List of Video file audio and video streams.

Returns

List of video streams in Video file.

Return type

list

supervisely_lib.video.video.warn_video_requires_processing(file_name: str, logger=None) → None

Create logger if it was not there and displays message about the need for transcoding.

Parameters

• file_name (str) – Video file name.

• logger (logger) – Logger object.

Returns

None

Return type

NoneType

supervisely_lib.video.video.gen_video_stream_name(file_name: str, stream_index: int) → str

Create name to video stream from given filename and index of stream.

Parameters

• file_name (str) – Video file name.

• stream_index (int) – Stream index.

Returns

str

Return type

str

Usage example

stream_name = gen_video_stream_name('my_video.mp4', 2)
print(stream_name)
# Output: my_video_stream_2_CULxO.mp4