various ¶
Classes:
-
ClampScaler
–Clamp a reference Scaler.
-
DPID
–Rapid, Detail-Preserving Image Downscaler for VapourSynth
-
SSIM
–SSIM downsampler is an image downscaling technique that aims to optimize
ClampScaler ¶
ClampScaler(
base_scaler: ScalerT,
reference: ScalerT | VideoNode,
strength: int = 80,
overshoot: float | None = None,
undershoot: float | None = None,
limit: RepairMode | bool = True,
operator: Literal[MAX, MIN] | None = MIN,
masked: bool = True,
*,
kernel: KernelT = Catrom,
scaler: ScalerT | None = None,
shifter: KernelT | None = None,
**kwargs: Any
)
Bases: GenericScaler
Clamp a reference Scaler.
Parameters:
-
base_scaler
¶ScalerT
) –Scaler to clamp.
-
reference
¶ScalerT | VideoNode
) –Reference Scaler used to clamp base_scaler
-
strength
¶int
, default:80
) –Strength of clamping. Default to 80. Must be between 0 and 100 (exclusive)
-
overshoot
¶float | None
, default:None
) –Overshoot threshold within the 0.0 - 1.0 range.
-
undershoot
¶float | None
, default:None
) –Undershoot threshold within the 0.0 - 1.0 range.
-
limit
¶RepairMode | bool
, default:True
) –Whether to use under/overshoot limit (True) or a reference repaired clip for limiting.
-
operator
¶Literal[MAX, MIN] | None
, default:MIN
) –Whether to take the brightest or darkest pixels in the merge. Defaults to ExprOp.MIN.
-
masked
¶bool
, default:True
) –Whether to mask with a ringing mask or not. Defaults to True
-
kernel
¶KernelT
, default:Catrom
) –Base kernel to be used for certain scaling/shifting/resampling operations. Defaults to Catrom.
-
scaler
¶ScalerT | None
, default:None
) –Scaler used for scaling operations. Defaults to kernel.
-
shifter
¶KernelT | None
, default:None
) –Kernel used for shifting operations. Defaults to kernel.
Methods:
-
ensure_obj
– -
from_param
– -
get_clean_kwargs
– -
get_implemented_funcs
– -
get_scale_args
– -
kernel_radius
– -
multi
– -
pretty_string
– -
scale
– -
supersample
–
Attributes:
-
base_scaler
– -
func
– -
kernel
– -
kwargs
(KwargsT
) –Arguments passed to the internal scale function
-
limit
– -
masked
– -
operator
– -
overshoot
– -
reference
(Scaler | VideoNode
) – -
scale_function
(Callable[..., VideoNode]
) –Scale function called internally when scaling
-
scaler
– -
shifter
– -
strength
– -
undershoot
–
Source code
27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 |
|
kwargs instance-attribute
¶
kwargs: KwargsT = kwargs
Arguments passed to the internal scale function
scale_function instance-attribute
¶
scale_function: Callable[..., VideoNode]
Scale function called internally when scaling
ensure_obj classmethod
¶
ensure_obj(
scaler: str | type[BaseScalerT] | BaseScalerT | None = None,
/,
func_except: FuncExceptT | None = None,
) -> BaseScalerT
Source code
201 202 203 204 205 206 207 208 |
|
from_param classmethod
¶
from_param(
scaler: str | type[BaseScalerT] | BaseScalerT | None = None,
/,
func_except: FuncExceptT | None = None,
) -> type[BaseScalerT]
Source code
192 193 194 195 196 197 198 199 |
|
get_clean_kwargs ¶
Source code
216 217 |
|
get_implemented_funcs ¶
Source code
299 300 |
|
get_scale_args ¶
get_scale_args(
clip: VideoNode,
shift: tuple[TopShift, LeftShift] = (0, 0),
width: int | None = None,
height: int | None = None,
*funcs: Callable[..., Any],
**kwargs: Any
) -> KwargsT
Source code
283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 |
|
kernel_radius ¶
kernel_radius() -> int
Source code
148 149 150 151 152 |
|
multi ¶
multi(
clip: VideoNode,
multi: float = 2.0,
shift: tuple[TopShift, LeftShift] = (0, 0),
**kwargs: Any
) -> VideoNode
Source code
272 273 274 275 276 277 278 279 280 281 |
|
pretty_string ¶
pretty_string() -> str
Source code
225 226 227 |
|
scale ¶
scale(
clip: VideoNode,
width: int | None = None,
height: int | None = None,
shift: tuple[float, float] = (0, 0),
**kwargs: Any
) -> ConstantFormatVideoNode
Source code
87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 |
|
supersample ¶
supersample(
clip: VideoNode,
rfactor: float = 2.0,
shift: tuple[TopShift, LeftShift] = (0, 0),
**kwargs: Any
) -> VideoNode
Source code
257 258 259 260 261 262 263 264 265 266 267 268 269 270 |
|
DPID ¶
DPID(
sigma: float = 0.1,
ref: VideoNode | ScalerT = Catrom,
planes: PlanesT = None,
**kwargs: Any
)
Bases: BaseGenericScaler
Rapid, Detail-Preserving Image Downscaler for VapourSynth
Parameters:
-
sigma
¶float
, default:0.1
) –The power factor of range kernel. It can be used to tune the amplification of the weights of pixels that represent detail—from a box filter over an emphasis of distinct pixels towards a selection of only the most distinct pixels.
-
ref
¶VideoNode | ScalerT
, default:Catrom
) –VideoNode or Scaler to obtain the downscaled reference for DPID.
-
planes
¶PlanesT
, default:None
) –Sets which planes will be processed. Any unprocessed planes will be simply copied from ref.
Methods:
-
ensure_obj
– -
from_param
– -
get_clean_kwargs
– -
get_implemented_funcs
– -
get_scale_args
– -
kernel_radius
– -
multi
– -
pretty_string
– -
scale
– -
supersample
–
Attributes:
-
kernel
– -
kwargs
(KwargsT
) –Arguments passed to the internal scale function
-
planes
– -
ref
– -
scale_function
(Callable[..., VideoNode]
) –Scale function called internally when scaling
-
scaler
– -
shifter
– -
sigma
–
Source code
158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 |
|
kwargs instance-attribute
¶
kwargs: KwargsT = kwargs
Arguments passed to the internal scale function
scale_function instance-attribute
¶
scale_function: Callable[..., VideoNode]
Scale function called internally when scaling
ensure_obj classmethod
¶
ensure_obj(
scaler: str | type[BaseScalerT] | BaseScalerT | None = None,
/,
func_except: FuncExceptT | None = None,
) -> BaseScalerT
Source code
201 202 203 204 205 206 207 208 |
|
from_param classmethod
¶
from_param(
scaler: str | type[BaseScalerT] | BaseScalerT | None = None,
/,
func_except: FuncExceptT | None = None,
) -> type[BaseScalerT]
Source code
192 193 194 195 196 197 198 199 |
|
get_clean_kwargs ¶
Source code
216 217 |
|
get_implemented_funcs ¶
Source code
299 300 |
|
get_scale_args ¶
get_scale_args(
clip: VideoNode,
shift: tuple[TopShift, LeftShift] = (0, 0),
width: int | None = None,
height: int | None = None,
*funcs: Callable[..., Any],
**kwargs: Any
) -> KwargsT
Source code
283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 |
|
kernel_radius ¶
kernel_radius() -> int
Source code
216 217 218 |
|
multi ¶
multi(
clip: VideoNode,
multi: float = 2.0,
shift: tuple[TopShift, LeftShift] = (0, 0),
**kwargs: Any
) -> VideoNode
Source code
272 273 274 275 276 277 278 279 280 281 |
|
pretty_string ¶
pretty_string() -> str
Source code
225 226 227 |
|
scale ¶
scale(
clip: VideoNode,
width: int | None = None,
height: int | None = None,
shift: tuple[float, float] = (0, 0),
**kwargs: Any
) -> ConstantFormatVideoNode
Source code
183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 |
|
supersample ¶
supersample(
clip: VideoNode,
rfactor: float = 2.0,
shift: tuple[TopShift, LeftShift] = (0, 0),
**kwargs: Any
) -> VideoNode
Source code
257 258 259 260 261 262 263 264 265 266 267 268 269 270 |
|
SSIM ¶
SSIM(
scaler: ScalerT = Hermite,
smooth: (
int
| float
| VSFunctionNoArgs[VideoNode, ConstantFormatVideoNode]
| None
) = None,
**kwargs: Any
)
Bases: LinearScaler
SSIM downsampler is an image downscaling technique that aims to optimize for the perceptual quality of the downscaled results.
Image downscaling is considered as an optimization problem where the difference between the input and output images is measured using famous Structural SIMilarity (SSIM) index.
The solution is derived in closed-form, which leads to the simple, efficient implementation. The downscaled images retain perceptually important features and details, resulting in an accurate and spatio-temporally consistent representation of the high resolution input.
Parameters:
-
scaler
¶ScalerT
, default:Hermite
) –Scaler to be used for downscaling, defaults to Hermite.
-
smooth
¶int | float | VSFunctionNoArgs[VideoNode, ConstantFormatVideoNode] | None
, default:None
) –Image smoothening method. If you pass an int, it specifies the "radius" of the internally-used boxfilter, i.e. the window has a size of (2smooth+1)x(2smooth+1). If you pass a float, it specifies the "sigma" of gauss_blur, i.e. the standard deviation of gaussian blur. If you pass a function, it acts as a general smoother. Default uses a gaussian blur based on the scaler's kernel radius.
Methods:
-
ensure_obj
– -
from_param
– -
get_clean_kwargs
– -
get_implemented_funcs
– -
get_scale_args
– -
kernel_radius
– -
multi
– -
pretty_string
– -
scale
– -
supersample
–
Attributes:
-
filter_func
– -
kwargs
(KwargsT
) –Arguments passed to the internal scale function
-
scale_function
(Callable[..., VideoNode]
) –Scale function called internally when scaling
-
scaler
–
Source code
235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 |
|
kwargs instance-attribute
¶
kwargs: KwargsT = kwargs
Arguments passed to the internal scale function
scale_function instance-attribute
¶
scale_function: Callable[..., VideoNode]
Scale function called internally when scaling
ensure_obj classmethod
¶
ensure_obj(
scaler: str | type[BaseScalerT] | BaseScalerT | None = None,
/,
func_except: FuncExceptT | None = None,
) -> BaseScalerT
Source code
201 202 203 204 205 206 207 208 |
|
from_param classmethod
¶
from_param(
scaler: str | type[BaseScalerT] | BaseScalerT | None = None,
/,
func_except: FuncExceptT | None = None,
) -> type[BaseScalerT]
Source code
192 193 194 195 196 197 198 199 |
|
get_clean_kwargs ¶
Source code
216 217 |
|
get_implemented_funcs ¶
Source code
299 300 |
|
get_scale_args ¶
get_scale_args(
clip: VideoNode,
shift: tuple[TopShift, LeftShift] = (0, 0),
width: int | None = None,
height: int | None = None,
*funcs: Callable[..., Any],
**kwargs: Any
) -> KwargsT
Source code
283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 |
|
kernel_radius ¶
kernel_radius() -> int
Source code
289 290 291 |
|
multi ¶
multi(
clip: VideoNode,
multi: float = 2.0,
shift: tuple[TopShift, LeftShift] = (0, 0),
**kwargs: Any
) -> VideoNode
Source code
272 273 274 275 276 277 278 279 280 281 |
|
pretty_string ¶
pretty_string() -> str
Source code
225 226 227 |
|
scale ¶
scale(
clip: VideoNode,
width: int | None = None,
height: int | None = None,
shift: tuple[TopShift, LeftShift] = (0, 0),
*,
linear: bool = False,
sigmoid: bool | tuple[Slope, Center] = False,
**kwargs: Any
) -> VideoNode
Source code
83 84 85 86 87 88 89 90 91 92 |
|
supersample ¶
supersample(
clip: VideoNode,
rfactor: float = 2.0,
shift: tuple[TopShift, LeftShift] = (0, 0),
**kwargs: Any
) -> VideoNode
Source code
257 258 259 260 261 262 263 264 265 266 267 268 269 270 |
|