lvsfunc.util
Helper functions for module functions and wrapper. Some of these may also be useful for regular scripting or other modules.
|
Return a list of BlankClips with unique colors in sequential or random order. |
|
Display frames since last bookmark to create easily reusable scenefiltering. |
|
Load VSEdit bookmarks. |
|
Truncate a string if it surpasses a certain length. |
- lvsfunc.util.check_has_nvidia()
Check if the user has an Nvidia GPU.
- Return type
bool
- lvsfunc.util.colored_clips(amount, max_hue=300, rand=True, seed=None, **kwargs)
Return a list of BlankClips with unique colors in sequential or random order.
The colors will be evenly spaced by hue in the HSL colorspace.
Useful maybe for comparison functions or just for getting multiple uniquely colored BlankClips for testing purposes.
Will always return a pure red clip in the list as this is the RGB equivalent of the lowest HSL hue possible (0).
Written by Dave.
- Parameters
amount (
int
) – Number of VideoNodes to return.max_hue (
int
) – Maximum hue (0 < hue <= 360) in degrees to generate colors from (uses the HSL color model). Setting this higher than315
will result in the clip colors looping back towards red and is not recommended for visually distinct colors. If the amount of clips is higher than the max_hue expect there to be identical or visually similar colored clips returned (Default: 300)rand (
bool
) – Randomizes order of the returned list (Default: True).seed (
Union
[bytearray
,bytes
,float
,str
,None
]) – Bytes-like object passed torandom.seed
which allows for consistent randomized order. of the resulting clips (Default: None)kwargs (
Any
) – Arguments passed tovapoursynth.core.std.BlankClip()
(Default: keep=1).
- Return type
list
[VideoNode
]- Returns
List of uniquely colored clips in sequential or random order.
- Raises
ValueError –
amount
is less than 2.ValueError –
max_hue
is not between 0–360.
- lvsfunc.util.frames_since_bookmark(clip, bookmarks)
Display frames since last bookmark to create easily reusable scenefiltering.
Can be used in tandem with
lvsfunc.misc.load_bookmarks()
to import VSEdit bookmarks.- Parameters
clip (
VideoNode
) – Clip to process.bookmarks (
list
[int
]) – A list of bookmarks.
- Return type
VideoNode
- Returns
Clip with bookmarked frames.
- lvsfunc.util.load_bookmarks(bookmark_path)
Load VSEdit bookmarks.
load_bookmarks(os.path.basename(__file__)+”.bookmarks”) will load the VSEdit bookmarks for the current Vapoursynth script.
- Parameters
bookmark_path (
str
) – Path to bookmarks file.- Return type
list
[int
]- Returns
A list of bookmarked frames.
- lvsfunc.util.match_clip(clip, ref, dimensions=True, vformat=True, matrices=True, length=False, kernel=vskernels.Catrom)
Try matching the given clip’s format with the reference clip’s.
- Parameters
clip (
VideoNode
) – Clip to process.ref (
VideoNode
) – Reference clip.dimensions (
bool
) – Match video dimensions (Default: True).vformat (
bool
) – Match video formats (Default: True).matrices (
bool
) – Match matrix/transfer/primaries (Default: True).length (
bool
) – Match clip length (Default: False).kernel (
KernelT
) – py:class:vskernels.Kernel object used for the format conversion. This can also be the string name of the kernel (Default: py:class:vskernels.Catrom).
- Return type
VideoNode
- Returns
Clip that matches the ref clip in format.
- lvsfunc.util.truncate_string(str_in, max_length, suffix='...')
Truncate a string if it surpasses a certain length.
- Return type
str