rescale ¶
Classes:
-
Rescale
–Rescale wrapper supporting everything you need for (fractional) descaling,
-
RescaleBase
–Base class for Rescale wrapper
Rescale ¶
Rescale(
clip: VideoNode,
/,
height: int | float,
kernel: KernelLike,
upscaler: ScalerLike = ArtCNN,
downscaler: ScalerLike = Hermite(linear=True),
width: int | float | None = None,
base_height: int | None = None,
base_width: int | None = None,
crop: tuple[LeftCrop, RightCrop, TopCrop, BottomCrop] = CropRel(),
shift: tuple[TopShift, LeftShift] = (0, 0),
field_based: FieldBasedT | bool | None = None,
border_handling: int | BorderHandling = MIRROR,
**kwargs: Any,
)
Bases: RescaleBase
Rescale wrapper supporting everything you need for (fractional) descaling, re-upscaling and masking-out details.
Examples usage:
-
Basic 720p rescale:
from vsscale import Rescale from vskernels import Bilinear rs = Rescale(clip, 720, Bilinear) final = rs.upscale
-
Adding aa and dehalo on doubled clip:
from vsaa import based_aa from vsdehalo import fine_dehalo aa = based_aa(rs.doubled, supersampler=False) dehalo = fine_dehalo(aa, ...) rs.doubled = dehalo
-
Loading line_mask and credit_mask:
from vsmasktools import diff_creditless_oped from vsexprtools import ExprOp rs.default_line_mask() oped_credit_mask = diff_creditless_oped(...) credit_mask = rs.default_credit_mask(thr=0.209, ranges=(200, 300), postfilter=4) rs.credit_mask = ExprOp.ADD.combine(oped_credit_mask, credit_mask)
-
Fractional rescale:
from vsscale import Rescale from vskernels import Bilinear # Forcing the height to a float will ensure a fractional descale rs = Rescale(clip, 800.0, Bilinear) >>> rs.descale_args ScalingArgs( width=1424, height=800, src_width=1422.2222222222222, src_height=800.0, src_top=0.0, src_left=0.8888888888889142, mode='hw' ) # while doing this will not rs = Rescale(clip, 800, Bilinear) >>> rs.descale_args ScalingArgs(width=1422, height=800, src_width=1422, src_height=800, src_top=0, src_left=0, mode='hw')
-
Cropping is also supported:
from vsscale import Rescale from vskernels import Bilinear # Descaling while cropping the letterboxes at the top and bottom rs = Rescale(clip, 874, Bilinear, crop=(0, 0, 202, 202)) >>> rs.descale_args ScalingArgs( width=1554, height=548, src_width=1554.0, src_height=547.0592592592592, src_top=0.4703703703703752, src_left=0.0, mode='hw' ) # Same thing but ensuring the width is fractional descaled rs = Rescale(clip, 874.0, Bilinear, crop=(0, 0, 202, 202)) >>> rs.descale_args ScalingArgs( width=1554, height=548, src_width=1553.7777777777778, src_height=547.0592592592592, src_top=0.4703703703703752, src_left=0.11111111111108585, mode='hw' )
Initialize the rescaling process.
Parameters:
-
clip
¶VideoNode
) –Clip to be rescaled.
-
height
¶int | float
) –Height to be descaled to. If passed as a float, a fractional descale is performed.
-
kernel
¶KernelLike
) –Kernel used for descaling.
-
upscaler
¶ScalerLike
, default:ArtCNN
) –Scaler that supports doubling. Defaults to
ArtCNN
. -
downscaler
¶ScalerLike
, default:Hermite(linear=True)
) –Scaler used to downscale the upscaled clip back to input resolution. Defaults to
Hermite(linear=True)
. -
width
¶int | float | None
, default:None
) –Width to be descaled to. If
None
, it is automatically calculated from the height. -
base_height
¶int | None
, default:None
) –Integer height to contain the clip within. If
None
, it is automatically calculated from the height. -
base_width
¶int | None
, default:None
) –Integer width to contain the clip within. If
None
, it is automatically calculated from the width. -
crop
¶tuple[LeftCrop, RightCrop, TopCrop, BottomCrop]
, default:CropRel()
) –Cropping values to apply before descale. The ratio
descale_height / source_height
is preserved even after descale. The cropped area is restored when calling theupscale
property. -
shift
¶tuple[TopShift, LeftShift]
, default:(0, 0)
) –Pixel shifts to apply during descale and upscale. Defaults to
(0, 0)
. -
field_based
¶FieldBasedT | bool | None
, default:None
) –Whether the input is cross-converted or interlaced content.
-
border_handling
¶int | BorderHandling
, default:MIRROR
) –Adjusts how the clip is padded internally during the scaling process. Accepted values are:
0
(MIRROR): Assume the image was resized with mirror padding.1
(ZERO): Assume the image was resized with zero padding.2
(EXTEND): Assume the image was resized with extend padding, where the outermost row was extended infinitely far.
Defaults to
0
.
Methods:
-
default_credit_mask
–Load a credit mask by making a difference mask between src and rescaled clips
-
default_line_mask
–Load a default Kirsch line mask in the class instance. Additionally, it is returned.
Attributes:
-
credit_mask
(ConstantFormatVideoNode
) –Gets the credit mask to be applied on the upscaled clip.
-
descale
(ConstantFormatVideoNode
) –Gets the descaled clip.
-
descale_args
– -
doubled
(ConstantFormatVideoNode
) –Gets the doubled clip.
-
ignore_mask
(ConstantFormatVideoNode
) –Gets the ignore mask to be applied on the descaled clip.
-
line_mask
(ConstantFormatVideoNode
) –Gets the lineart mask to be applied on the upscaled clip.
-
rescale
(ConstantFormatVideoNode
) –Gets the rescaled clip.
-
upscale
(ConstantFormatVideoNode
) –Returns the upscaled clip
Source code
292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 |
|
credit_mask deletable
property
writable
¶
credit_mask: ConstantFormatVideoNode
Gets the credit mask to be applied on the upscaled clip.
descale_args instance-attribute
¶
descale_args = from_args(
clip,
height,
width,
base_height,
base_width,
shift[0],
shift[1],
crop,
mode="hw",
)
ignore_mask deletable
property
writable
¶
ignore_mask: ConstantFormatVideoNode
Gets the ignore mask to be applied on the descaled clip.
line_mask deletable
property
writable
¶
line_mask: ConstantFormatVideoNode
Gets the lineart mask to be applied on the upscaled clip.
default_credit_mask ¶
default_credit_mask(
rescale: VideoNode | None = None,
src: VideoNode | None = None,
thr: float = 0.216,
expand: int = 4,
ranges: FrameRangeN | FrameRangesN | None = None,
stabilize: bool | tuple[Sequence[float], float] = False,
**kwargs: Any
) -> ConstantFormatVideoNode
Load a credit mask by making a difference mask between src and rescaled clips
Parameters:
-
rescale
¶VideoNode | None
, default:None
) –Rescaled clip, defaults to rescaled instance clip.
-
src
¶VideoNode | None
, default:None
) –Source clip, defaults to source instance clip.
-
thr
¶float
, default:0.216
) –Threshold of the amplification expr, defaults to 0.216.
-
expand
¶int
, default:4
) –Additional expand radius applied to the mask, defaults to 4.
-
ranges
¶FrameRangeN | FrameRangesN | None
, default:None
) –If specified, ranges to apply the credit clip to.
-
stabilize
¶bool | tuple[Sequence[float], float]
, default:False
) –Try to stabilize the mask by applying a temporal convolution and then binarized by a threshold. Only works when there are ranges specified.
Returns:
-
ConstantFormatVideoNode
–Generated mask.
Source code
518 519 520 521 522 523 524 525 526 527 528 529 530 531 532 533 534 535 536 537 538 539 540 541 542 543 544 545 546 547 548 549 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 565 566 567 568 569 570 571 572 573 574 575 576 577 578 579 580 581 582 583 584 585 586 587 |
|
default_line_mask ¶
default_line_mask(
clip: VideoNode | None = None, scaler: ScalerLike = Bilinear, **kwargs: Any
) -> ConstantFormatVideoNode
Load a default Kirsch line mask in the class instance. Additionally, it is returned.
Parameters:
-
clip
¶VideoNode | None
, default:None
) –Reference clip, defaults to doubled clip if None.
-
scaler
¶ScalerLike
, default:Bilinear
) –Scaled used for matching the source clip format, defaults to Bilinear.
Returns:
-
ConstantFormatVideoNode
–Generated mask.
Source code
491 492 493 494 495 496 497 498 499 500 501 502 503 504 505 506 507 508 509 510 511 512 513 514 515 516 |
|
RescaleBase ¶
RescaleBase(
clip: VideoNode,
/,
kernel: KernelLike,
upscaler: ScalerLike = ArtCNN,
downscaler: ScalerLike = Hermite(linear=True),
field_based: FieldBasedT | bool | None = None,
border_handling: int | BorderHandling = MIRROR,
**kwargs: Any,
)
Bases: vs_object
Base class for Rescale wrapper
Attributes:
-
descale
(ConstantFormatVideoNode
) –Gets the descaled clip.
-
descale_args
(ScalingArgs
) –Descale arguments. See ScalingArgs
-
doubled
(ConstantFormatVideoNode
) –Gets the doubled clip.
-
rescale
(ConstantFormatVideoNode
) –Gets the rescaled clip.
-
upscale
(ConstantFormatVideoNode
) –Returns the upscaled clip
Source code
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 |
|