# pyd2v
[](https://github.com/rlaphoenix/pyd2v/blob/master/LICENSE)
[](https://github.com/rlaphoenix/pyd2v/actions/workflows/ci.yml)
[](https://pypi.python.org/pypi/pyd2v)
[](https://pypi.python.org/pypi/pyd2v)
[](https://github.com/rlaphoenix/pyd2v/graphs/contributors)
[](https://deepsource.io/gh/rlaphoenix/pyd2v)
A Python Parser for DGMPGDec's D2V Project Files.
## Installation
pip install --user pyd2v
## Building
### Dependencies
- [Python](https://python.org/downloads) (v3.7 or newer)
- [Poetry](https://python-poetry.org/docs) (latest recommended)
### Steps
1. `git clone https://github.com/rlaphoenix/pyd2v`
2. `cd pyd2v`
3. `poetry config virtualenvs.in-project true` (optional, but recommended)
4. `poetry install`
5. `d2v --help`
For further information on using the Poetry virtual environment, see
[Using your virtual environment](https://python-poetry.org/docs/basic-usage/#using-your-virtual-environment).
## Usage
This project can be used in Python Scripts by importing `pyd2v`, or in your terminal by calling `d2v`.
### Scripting
```py
from pyd2v import D2V
# ...
d2v = D2V(filename="C:/Users/phoenix/Videos/1998_home_video.d2v")
print(d2v) # d2v object basic information, e.g. version and settings
print(d2v.videos) # input video files
print(d2v.settings["Frame_Rate"]) # frame rate
print(d2v.data[0]) # print first frame data
```
### Executable
For help information run `d2v --help`. Here's some examples of using the d2v executable:
#### Getting a Setting like the Video Resolution:
```shell
$ d2v "D:\...\The.IT.Crowd.S01E01.Yesterdays.Jam.PAL.DVD.DD.2.0.MPEG-2.REMUX.d2v" settings.Picture_Size
[720, 576]
```
#### Parse the entire D2V to a JSON Pickle:
```shell
$ d2v "D:\...\The.IT.Crowd.S01E01.Yesterdays.Jam.PAL.DVD.DD.2.0.MPEG-2.REMUX.d2v" --json
{"py/object": "pyd2v.d2v.D2V", "path": {"py/reduce": [{"py/type": "pathlib.WindowsPath"}, {"py/tuple": ["D:\\", "...",
"The.IT.Crowd.S01E01.Yesterdays.Jam.PAL.DVD.DD.2.0.MPEG-2.REMUX.d2v"]}]}, "version": 16, "videos": [
"D:\\...\\The.IT.Crowd.S01E01.Yesterdays.Jam.PAL.DVD.DD.2.0.MPEG-2.REMUX.mpeg"], "settings": {"Stream_Type": 0,
"MPEG_Type": 2, "iDCT_Algorithm": 5, "YUVRGB_Scale": 1, "Luminance_Filter": {"Gamma": 0, "Offset": 0}, "Clipping":
[0, 0, 0, 0], "Aspect_Ratio": "16:9", "Picture_Size": [720, 576], "Field_Operation": 2, ... ...
```
#### Parse only the D2V Headers:
```shell
$ d2v "D:\...\The.IT.Crowd.S01E01.Yesterdays.Jam.PAL.DVD.DD.2.0.MPEG-2.REMUX.d2v" --pretty
<D2V path=WindowsPath('D:/.../The.IT.Crowd.S01E01.Yesterdays.Jam.PAL.DVD.DD.2.0.MPEG-2.REMUX.d2v') version=16,
data_type='100.00% VIDEO\n', settings={'Stream_Type': 0, 'MPEG_Type': 2, 'iDCT_Algorithm': 5, 'YUVRGB_Scale': 1,
'Luminance_Filter': {'Gamma': 0, 'Offset': 0}, 'Clipping': [0, 0, 0, 0], 'Aspect_Ratio': '16:9', 'Picture_Size':
[720, 576], 'Field_Operation': 2, 'Frame_Rate': ['25000', [25, 1]], 'Location': {'StartFile': '0', 'StartOffset': '0',
'EndFile': '0', 'EndOffset': '67d1f'}}>
```
### D2V Properties
D2V objects contain the following properties:
- version: D2V version, `16` is currently the latest for the original DGIndex which was last updated in 2010.
- videos: List of the video file paths that were indexed by DGIndex. It will be just a filename if "Use Full Paths" was
disabled in DGIndex.
- settings: Will return various user-provided and auto-evaluated settings based on input data. More information on
Settings below.
- data: Indexing data of the MPEG video stream, Each entry is of an I frame which will describe the following non-I
frames up to the next I frame.
- data_type: What type of video is most previlent, e.g. `88.4% FILM`, `PAL`, `99.9% NTSC`.
### Settings
| Auto-evaluated Settings | Possible Values | Description |
| ----------------------- | -------------------------------------- | ---------------------------------------------------------------------------------- |
| Stream_Type | 0=Elementary Stream | Defines the type of MPEG stream. |
| | 1=Program Stream | |
| | 2=Transport Stream | |
| | 3=PVA Stream | |
| Transport_Packet_Size | [188, 204] | Specifies the size in bytes of the transport packets. Used only for Stream_Type=2. |
| MPEG_Type | 1=MPEG-1, 2=MPEG-2 | Defines the type of MPEG stream. |
| Aspect_Ratio | MPEG-2: "1:1", "4:3", "16:9", "2.21:1" | Defines the Aspect Ratio of the video specified in the MPEG stream. |
| | MPEG-1: "1:1", 0.6735, ["16:9", 625], | |
| | 0.7615, 0.8055, ["16:9", 525], 0.8935, | |
| | ["4:3", 625], 0.9815, 1.0255, 1.0695, | |
| | ["4:3", 525], 1.575, 1.2015 | |
| Picture_Size | [width, height] | Defines the size of the video _after_ clipping has been applied. |
| Frame_Rate | rate [num, den] | 'rate' defines output framerate \* 1000. |
| User-specified Settings | Possible Values | Description |
| ----------------------- | ----------------------------------------- | ------------------------------------------------------------------------ |
| MPEG2_Transport_PID | {Video, Audio, RCR} | Selects the video/audio PIDs to be decoded. Used only for Stream_Type=2. |
| iDCT_Algorithm | 1=32-bit MMX | Defines the iDCT DGDecode will use to decode this video |
| | 2=32-bit SSEMMX | |
| | 3=32-bit SSE2MMX | |
| | 4=64-bit Floating Point | |
| | 5=64-bit IEEE-1180 Reference | |
| | 6=32-bit SSEMMX (Skal) | |
| | 7=32-bit Simple MMX (XviD) | |
| YUVRGB_Scale | 0=TV Scale | Defines the range DGDecode will use if RGB conversion is requested. |
| | 1=PC Scale | |
| Luminance_Filter | {Gamma, Offset} (range of +/- 256) | Defines values for DGIndex's Luminance_Filter. |
| Clipping | [ClipLeft,ClipRight,ClipTop,ClipBottom] | Defines values for Cropping lines of video. |
| Field_Operation | 0=Honor Pulldown Flags | Defines values for Field Operation. |
| | 1=Force Film | |
| | 2=Ignore Pulldown Flags | |
| Location | {StartFile,StartOffset,EndFile,EndOffset} | Defines start and end points for the video selection range. |
## License
[MIT License](LICENSE)
Raw data
{
"_id": null,
"home_page": "https://github.com/rlaphoenix/pyd2v",
"name": "pyd2v",
"maintainer": "PHOENiX",
"docs_url": null,
"requires_python": ">=3.7,<4.0",
"maintainer_email": "rlaphoenix@pm.me",
"keywords": "python,d2v,dgindex,dgmpgdec,mpeg",
"author": "PHOENiX",
"author_email": "rlaphoenix@pm.me",
"download_url": "https://files.pythonhosted.org/packages/9b/9a/fe246a0d50d95f9ff2e9ca5d8ccf7b1f182dce781289eaa36b0c741d3f5e/pyd2v-1.4.0.tar.gz",
"platform": null,
"description": "# pyd2v\n\n[](https://github.com/rlaphoenix/pyd2v/blob/master/LICENSE)\n[](https://github.com/rlaphoenix/pyd2v/actions/workflows/ci.yml)\n[](https://pypi.python.org/pypi/pyd2v)\n[](https://pypi.python.org/pypi/pyd2v)\n[](https://github.com/rlaphoenix/pyd2v/graphs/contributors)\n[](https://deepsource.io/gh/rlaphoenix/pyd2v)\n\nA Python Parser for DGMPGDec's D2V Project Files.\n\n## Installation\n\n pip install --user pyd2v\n\n## Building\n\n### Dependencies\n\n- [Python](https://python.org/downloads) (v3.7 or newer)\n- [Poetry](https://python-poetry.org/docs) (latest recommended)\n\n### Steps\n\n1. `git clone https://github.com/rlaphoenix/pyd2v`\n2. `cd pyd2v`\n3. `poetry config virtualenvs.in-project true` (optional, but recommended)\n4. `poetry install`\n5. `d2v --help`\n\nFor further information on using the Poetry virtual environment, see\n[Using your virtual environment](https://python-poetry.org/docs/basic-usage/#using-your-virtual-environment).\n\n## Usage\n\nThis project can be used in Python Scripts by importing `pyd2v`, or in your terminal by calling `d2v`.\n\n### Scripting\n\n```py\nfrom pyd2v import D2V\n\n# ...\n\nd2v = D2V(filename=\"C:/Users/phoenix/Videos/1998_home_video.d2v\")\nprint(d2v) # d2v object basic information, e.g. version and settings\nprint(d2v.videos) # input video files\nprint(d2v.settings[\"Frame_Rate\"]) # frame rate\nprint(d2v.data[0]) # print first frame data\n```\n\n### Executable\n\nFor help information run `d2v --help`. Here's some examples of using the d2v executable:\n\n#### Getting a Setting like the Video Resolution:\n\n```shell\n$ d2v \"D:\\...\\The.IT.Crowd.S01E01.Yesterdays.Jam.PAL.DVD.DD.2.0.MPEG-2.REMUX.d2v\" settings.Picture_Size\n[720, 576]\n```\n\n#### Parse the entire D2V to a JSON Pickle:\n\n```shell\n$ d2v \"D:\\...\\The.IT.Crowd.S01E01.Yesterdays.Jam.PAL.DVD.DD.2.0.MPEG-2.REMUX.d2v\" --json\n{\"py/object\": \"pyd2v.d2v.D2V\", \"path\": {\"py/reduce\": [{\"py/type\": \"pathlib.WindowsPath\"}, {\"py/tuple\": [\"D:\\\\\", \"...\",\n\"The.IT.Crowd.S01E01.Yesterdays.Jam.PAL.DVD.DD.2.0.MPEG-2.REMUX.d2v\"]}]}, \"version\": 16, \"videos\": [\n\"D:\\\\...\\\\The.IT.Crowd.S01E01.Yesterdays.Jam.PAL.DVD.DD.2.0.MPEG-2.REMUX.mpeg\"], \"settings\": {\"Stream_Type\": 0,\n\"MPEG_Type\": 2, \"iDCT_Algorithm\": 5, \"YUVRGB_Scale\": 1, \"Luminance_Filter\": {\"Gamma\": 0, \"Offset\": 0}, \"Clipping\":\n[0, 0, 0, 0], \"Aspect_Ratio\": \"16:9\", \"Picture_Size\": [720, 576], \"Field_Operation\": 2, ... ...\n```\n\n#### Parse only the D2V Headers:\n\n```shell\n$ d2v \"D:\\...\\The.IT.Crowd.S01E01.Yesterdays.Jam.PAL.DVD.DD.2.0.MPEG-2.REMUX.d2v\" --pretty\n<D2V path=WindowsPath('D:/.../The.IT.Crowd.S01E01.Yesterdays.Jam.PAL.DVD.DD.2.0.MPEG-2.REMUX.d2v') version=16,\ndata_type='100.00% VIDEO\\n', settings={'Stream_Type': 0, 'MPEG_Type': 2, 'iDCT_Algorithm': 5, 'YUVRGB_Scale': 1,\n'Luminance_Filter': {'Gamma': 0, 'Offset': 0}, 'Clipping': [0, 0, 0, 0], 'Aspect_Ratio': '16:9', 'Picture_Size':\n[720, 576], 'Field_Operation': 2, 'Frame_Rate': ['25000', [25, 1]], 'Location': {'StartFile': '0', 'StartOffset': '0',\n'EndFile': '0', 'EndOffset': '67d1f'}}>\n```\n\n### D2V Properties\n\nD2V objects contain the following properties:\n\n- version: D2V version, `16` is currently the latest for the original DGIndex which was last updated in 2010.\n- videos: List of the video file paths that were indexed by DGIndex. It will be just a filename if \"Use Full Paths\" was\n disabled in DGIndex.\n- settings: Will return various user-provided and auto-evaluated settings based on input data. More information on\n Settings below.\n- data: Indexing data of the MPEG video stream, Each entry is of an I frame which will describe the following non-I\n frames up to the next I frame.\n- data_type: What type of video is most previlent, e.g. `88.4% FILM`, `PAL`, `99.9% NTSC`.\n\n### Settings\n\n| Auto-evaluated Settings | Possible Values | Description |\n| ----------------------- | -------------------------------------- | ---------------------------------------------------------------------------------- |\n| Stream_Type | 0=Elementary Stream | Defines the type of MPEG stream. |\n| | 1=Program Stream | |\n| | 2=Transport Stream | |\n| | 3=PVA Stream | |\n| Transport_Packet_Size | [188, 204] | Specifies the size in bytes of the transport packets. Used only for Stream_Type=2. |\n| MPEG_Type | 1=MPEG-1, 2=MPEG-2 | Defines the type of MPEG stream. |\n| Aspect_Ratio | MPEG-2: \"1:1\", \"4:3\", \"16:9\", \"2.21:1\" | Defines the Aspect Ratio of the video specified in the MPEG stream. |\n| | MPEG-1: \"1:1\", 0.6735, [\"16:9\", 625], | |\n| | 0.7615, 0.8055, [\"16:9\", 525], 0.8935, | |\n| | [\"4:3\", 625], 0.9815, 1.0255, 1.0695, | |\n| | [\"4:3\", 525], 1.575, 1.2015 | |\n| Picture_Size | [width, height] | Defines the size of the video _after_ clipping has been applied. |\n| Frame_Rate | rate [num, den] | 'rate' defines output framerate \\* 1000. |\n\n| User-specified Settings | Possible Values | Description |\n| ----------------------- | ----------------------------------------- | ------------------------------------------------------------------------ |\n| MPEG2_Transport_PID | {Video, Audio, RCR} | Selects the video/audio PIDs to be decoded. Used only for Stream_Type=2. |\n| iDCT_Algorithm | 1=32-bit MMX | Defines the iDCT DGDecode will use to decode this video |\n| | 2=32-bit SSEMMX | |\n| | 3=32-bit SSE2MMX | |\n| | 4=64-bit Floating Point | |\n| | 5=64-bit IEEE-1180 Reference | |\n| | 6=32-bit SSEMMX (Skal) | |\n| | 7=32-bit Simple MMX (XviD) | |\n| YUVRGB_Scale | 0=TV Scale | Defines the range DGDecode will use if RGB conversion is requested. |\n| | 1=PC Scale | |\n| Luminance_Filter | {Gamma, Offset} (range of +/- 256) | Defines values for DGIndex's Luminance_Filter. |\n| Clipping | [ClipLeft,ClipRight,ClipTop,ClipBottom] | Defines values for Cropping lines of video. |\n| Field_Operation | 0=Honor Pulldown Flags | Defines values for Field Operation. |\n| | 1=Force Film | |\n| | 2=Ignore Pulldown Flags | |\n| Location | {StartFile,StartOffset,EndFile,EndOffset} | Defines start and end points for the video selection range. |\n\n## License\n\n[MIT License](LICENSE)\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A Python Parser for DGMPGDec's D2V Project Files.",
"version": "1.4.0",
"project_urls": {
"Homepage": "https://github.com/rlaphoenix/pyd2v",
"Repository": "https://github.com/rlaphoenix/pyd2v"
},
"split_keywords": [
"python",
"d2v",
"dgindex",
"dgmpgdec",
"mpeg"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "2236692d45f2acf1899dde7d25f37e8ed272a373073ebd8bebb1db0f0a561fae",
"md5": "6bbf97f435b19696b184a23dfe1098c7",
"sha256": "69f9ba34018ad73c889517edf2da3db517b76b03fed73b7c8f4f473a7778ede0"
},
"downloads": -1,
"filename": "pyd2v-1.4.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "6bbf97f435b19696b184a23dfe1098c7",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7,<4.0",
"size": 9563,
"upload_time": "2023-10-08T19:14:16",
"upload_time_iso_8601": "2023-10-08T19:14:16.486974Z",
"url": "https://files.pythonhosted.org/packages/22/36/692d45f2acf1899dde7d25f37e8ed272a373073ebd8bebb1db0f0a561fae/pyd2v-1.4.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "9b9afe246a0d50d95f9ff2e9ca5d8ccf7b1f182dce781289eaa36b0c741d3f5e",
"md5": "8570cf9ab5b258fd3b6092025a5ab29b",
"sha256": "df1ef6abf7853a251ca7ec7280832fb09fae26e836c0f7911fba9a763149bdba"
},
"downloads": -1,
"filename": "pyd2v-1.4.0.tar.gz",
"has_sig": false,
"md5_digest": "8570cf9ab5b258fd3b6092025a5ab29b",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7,<4.0",
"size": 8374,
"upload_time": "2023-10-08T19:14:17",
"upload_time_iso_8601": "2023-10-08T19:14:17.784306Z",
"url": "https://files.pythonhosted.org/packages/9b/9a/fe246a0d50d95f9ff2e9ca5d8ccf7b1f182dce781289eaa36b0c741d3f5e/pyd2v-1.4.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-10-08 19:14:17",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "rlaphoenix",
"github_project": "pyd2v",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "pyd2v"
}
JSON
