Skip to content

Latest commit

 

History

History
184 lines (139 loc) · 5.27 KB

README.md

File metadata and controls

184 lines (139 loc) · 5.27 KB
Raw

D2VSource

This is a project (previously named as MPEG2DecPlus) to modify DGDecode.dll for AviSynth+.

Requirements:

  • AviSynth 2.60 / AviSynth+ 3.4 or later

  • Microsoft VisualC++ Redistributable Package 2022 (can be downloaded from here)

Usage:

D2VSource(string "d2v", int "idct", bool "showQ", int "info", int "upConv", bool "i420", bool "iCC", bool "nocrop", int "rff")

Parameters:

  • d2v
    The path of the dv2 file.

  • idct
    The iDCT algorithm to use.
    0: Follow the d2v specification.
    1,2,3,6,7: AP922 integer (same as SSE2/MMX).
    4: SSE2/AVX2 LLM (single precision floating point, SSE2/AVX2 determination is automatic).
    5: IEEE 1180 reference (double precision floating point).
    Default: -1.

  • showQ
    It displays macroblock quantizers..
    Default: False.

  • info
    It prints debug information.
    0: Do not display.
    1: Overlay on video frame.
    2: Output with OutputDebugString(). (The contents are confirmed by DebugView.exe).
    3: Embed hints in 64 bytes of the frame upper left corner.
    Default: 0.

  • upConv
    The output format.
    0: No conversion. YUV420 output is YV12, YUV422 output is YV16.
    1: Output YV16.
    2: Output YV24.
    Default: 0.

  • i420
    It determinates what is the output of YUV420.
    True: The output is i410.
    False: The output is YV12.
    Default: False.

  • iCC
    It determinates how YUV420 is upscaled when upConv=true.
    True: Force field-based upsampling.
    False: Forse progressive upsampling.
    Default: Auto determination based on the frame flag.

  • nocrop
    Use direct-rendered buffer, which may need cropping.
    It could provide a speedup when you know you need to crop your image anyway, by avoiding extra memcpy calls.
    Default: False.

  • rff
    Changes Field_Operation without the need of editing d2v or rescanning with different Field Operation.
    0: Honor Pulldowns Flags.
    1: Forced Film.
    2: Ignored Pulldowns Flags.
    Default: -1 - read the value from d2v.

Exported variables:

FFSAR_NUM, FFSAR_DEN, FFSAR (these indicate Generic PAR).

Frame properties

_AbsoluteTime [float]
The frame’s absolute timestamp in seconds.

_AspectRatio [int]
An array giving the display aspect ratio.

_ChromaLocation [int]
Chroma sample position in YUV formats: 0=left, 1=center, 2=topleft, 3=top, 4=bottomleft, 5=bottom.

_DurationNum [int], _DurationDen [int]
The frame’s duration in seconds as a rational number.

_EncodedFrameTop [int], _EncodedFrameBottom [int]
Frame number (before pulldown) used to generate this frame's top/bottom field.

_FieldBased [int]
Describes the composition of the frame:
0=frame based (progressive), 1=bottom field first, 2=top field first.
Note that the GOP progressive flag is used to determine whether the frame is progressive.

_FieldOperation [int]
Describes the field operation option in effect:
0=honor pulldown, 1=force film, 2=ignore pulldown.

_FieldOrder [int]
Display field order of the frame:
0=bottom field first, 1=top field first.

_Film [int]
Set if the frame is part of a 3:2 soft pulldown section.
Note that this uses the RFF history of several preceding
frames, and so is valid only when doing linear access.

_GOPClosed [int]
Set if the current GOP is closed.

_GOPNumber [int]
The 0-based GOP number that contains the frame. Note that
if this is set as the value x, then propShow displays it as
[x, y] where y is the 0-based frame number of the first frame
in the GOP.

_GOPPosition [int]
The GOP position field from the D2V file for the GOP containing
the frame.

_Matrix [int]
The matrix number field from the D2V file for the GOP containing
the frame.

_PictType [data]
A single character describing the frame type. It uses the common
IPB characters but others may also be used for formats with
additional frame types.

_ProgressiveFrame [int]
Set if the progress_frame flag is set for this frame.

_QuantsAverage [int]
The average quantizer value for the frame.

_QuantsMax [int]
The maximum quantizer value for the frame.

_QuantsMin [int]
The minimum quantizer value for the frame.

_RFF [int]
If _FieldOperation is 2 (ignore pulldown) then _RFF describes whether the stream specifies that a repeat field operation is to be performed on this frame. If _FieldOperation is 0 (honor pulldown) or 1 (force film) then _RFF describes whether the frame was composed with field repetition.

_SARDen [int] The denominator of the "pixel size" (MPEG-4 PAR), also called the
Sample Aspect Ratio (SAR).

_SARNum [int] The numerator of the "pixel size" (MPEG-4 PAR), also called the
Sample Aspect Ratio (SAR).

_TFF [int]
If _FieldOperation is 2 (ignore pulldown) and _RFF is set, then _TFF
describes whether the stream specifies that the top field is to be repeated, otherwise the bottom field is to be repeated. If _FieldOperation is 0 (honor pulldown) or 1 (force film) then _TFF is inapplicable and is set to -1.

Building:

  • Windows
    Use solution files.

  • Linux

    Requirements:
    - Git
    - C++17 compiler
    - CMake >= 3.16

    git clone https://github.com/Asd-g/MPEG2DecPlus && \
cd MPEG2DecPlus && \
mkdir build && \
cd build && \

cmake ..
make -j$(nproc)
sudo make install