bittor7x0/vapoursynth-arearesize

Area Average Downscale Resizer Plugin for VapourSynth

VapourSynth-AreaResize

Description

AreaResize is an area average downscale resizer plugin for VapourSynth. Support 8-16 bit and 32 bit sample type. Support Gray, YUV and RGB color family.

Downscaling in 8-16 bit RGB has additional gamma corrected.

Ported from AviSynth plugins https://github.com/chikuzen/AreaResize and https://github.com/Aktanusa/AreaResize.

Usage

core.area.AreaResize(clip clip, int width, int height[, float gamma=2.2])

• clip
  • Required parameter.
  • Clip to process.
  • Integer sample type of 8-16 bit depth and float sample type of 32 bit depth are supported.
  • Gray, YUV and RGB color family are supported.
• width
  • Required parameter.
  • The width of output.
  • Must be smaller than the width of input.
• height
  • Required parameter.
  • The height of output.
  • Must be smaller than the height of input.
• gamma
  • Optional parameter. Default: 2.2
  • Gamma corrected. Only valid for 8-16 bit RGB.
  • For 32 bit RGB, the accuracy is high enough, no gamma correction is needed.

Features

• Add parameter for gamma corrected.

TODO List

• Fix bug for special target size
  • For Gray or YUV 8-16 bit, if the target width can't be divisible by 32, output is abnormal
    • I haven't found the reason, so add an exception handling
  • For RGB 8bit, 1920x1080 -> 1200x700, crash

Compilation

VapourSynth.h and VSHelper.h need be in the same folder. You can get them from here or your VapourSynth installation directory (VapourSynth/sdk/include/vapoursynth).

Make sure the header files used during compilation are the same as those of your VapourSynth installation directory.

Windows

x86_64-w64-mingw32-g++ -shared -o AreaResize.dll -O2 -static AreaResize.cpp

Linux

g++ -shared -fPIC -O2 AreaResize.cpp -o AreaResize.so

Windows and Linux using Github Actions

1.Fork this repository.

2.Enable Github Actions on your fork: Settings tab -> Actions -> General -> Allow all actions and reusable workflows -> Save button.

3.Edit (if necessary) the file .github/workflows/CI.yml on your fork modifying the environment variable VapourSynth version:

env:
  VAPOURSYNTH_VERSION: <SET_YOUR_VERSION>

4.Go to the GitHub Actions tab on your fork, select CI workflow and press the Run workflow button (if you modified the .github/workflows/CI.yml file, a workflow will be already running and no need to run a new one).

When the workflow is completed you will be able to download the artifacts generated (Windows and Linux versions) from the run.

Download Nightly Builds

GitHub Actions Artifacts ONLY can be downloaded by GitHub logged users.

Nightly builds are built automatically by GitHub Actions (GitHub's integrated CI/CD tool) every time a new commit is pushed to the master branch or a pull request is created.

To download the latest nightly build, go to the GitHub Actions tab, enter the last run of workflow CI, and download the artifacts generated (Windows and Linux versions) from the run.