metafile-render 0.1.0__tar.gz

metafile_render-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Xiaomeng Zhao (myhloli)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

metafile_render-0.1.0/MANIFEST.in

@@ -0,0 +1 @@
+include tests/*.py

metafile_render-0.1.0/PKG-INFO

@@ -0,0 +1,166 @@
+Metadata-Version: 2.4
+Name: metafile-render
+Version: 0.1.0
+Summary: Render WMF and EMF files to SVG, PNG, JPEG, and WebP
+Author: Xiaomeng Zhao (myhloli)
+License-Expression: MIT
+Project-URL: Repository, https://github.com/myhloli/metafile-render
+Project-URL: Issues, https://github.com/myhloli/metafile-render/issues
+Keywords: wmf,emf,metafile,svg,png,jpeg,webp,rendering
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Multimedia :: Graphics :: Graphics Conversion
+Classifier: Typing :: Typed
+Requires-Python: <3.15,>=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pillow>=11.0.0; python_version < "3.14"
+Requires-Dist: pillow>=12.0.0; python_version >= "3.14"
+Requires-Dist: pyclipper<2,>=1.3.0; python_version < "3.14"
+Requires-Dist: pyclipper<2,>=1.4.0; python_version >= "3.14"
+Provides-Extra: test
+Requires-Dist: pytest>=8; extra == "test"
+Requires-Dist: pypptx-with-oxml<2,>=1.0.3; extra == "test"
+Provides-Extra: dev
+Requires-Dist: metafile-render[test]; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Dynamic: license-file
+
+# Metafile Render
+
+Render Windows Metafile (WMF) and Enhanced Metafile (EMF) images to SVG, PNG,
+JPEG, and WebP on Linux, macOS, and Windows.
+
+Requires Python 3.10–3.14. Runtime dependencies are Pillow and pyclipper;
+no Office installation, external conversion executable, or Windows GDI is required.
+
+## Installation
+
+```bash
+pip install metafile-render
+```
+
+Python 3.10–3.13 requires Pillow >=11.0.0 and pyclipper >=1.3.0,<2.
+Python 3.14 requires Pillow >=12.0.0 and pyclipper >=1.4.0,<2.
+Existing compatible dependencies can be retained; these ranges do not pin a fresh installation to older releases.
+
+## Python API
+
+```python
+from pathlib import Path
+from metafile_render import MetafileError, render_metafile
+
+try:
+    result = render_metafile(
+        Path("input.emf").read_bytes(),
+        output_format="svg",
+        dpi=144,
+        size_hint=None,
+    )
+except MetafileError as error:
+    print(error.code, str(error))
+else:
+    Path("output.svg").write_bytes(result.data)
+    print(result.width, result.height, result.media_type, result.partial)
+    for diagnostic in result.diagnostics:
+        print(diagnostic.code, diagnostic.message)
+```
+
+`render_metafile(data: bytes, *, output_format="png", dpi=144, size_hint=None)`
+returns a `MetafileRenderResult`. `dpi` must be an integer from 1 through 1200;
+`size_hint`, when supplied, is a pair of positive integer pixel dimensions, useful
+for standard WMF images without physical dimensions. Resource limits may reduce
+the actual canvas size.
+
+The result contains `data`, `output_format`, `media_type`, `width`, `height`,
+`source_format`, `emfplus_mode`, `partial`, and a tuple of `diagnostics`.
+Each diagnostic contains a code, level, message, and optional record location.
+
+Supported output format strings are `svg`, `png`, `jpeg`, and `webp`.
+PNG preserves transparency; JPEG uses a white background at quality 90.
+WebP preserves transparency and uses lossy quality 90, method 4.
+SVG is self-contained, with embedded images and a PNG fallback in metadata.
+Some raster operations require a raster image wrapped in SVG.
+
+Public exports are `render_metafile`, `MetafileOutputFormat`,
+`MetafileRenderResult`, `MetafileDiagnostic`, `MetafileError`,
+`MetafileMalformedError`, `MetafileResourceLimitError`, and `MetafileUnsupportedError`.
+The parser, drawing models, and renderer internals are not a stable public API.
+Invalid API arguments raise `TypeError` or `ValueError`; malformed, unsupported,
+and over-budget images raise the corresponding `MetafileError` subclass.
+
+## Command line
+
+```bash
+metafile-render input.emf -o output.svg
+metafile-render input.wmf -o output.png --dpi 144 --size 800 600
+metafile-render input.emf -o output.webp
+python -m metafile_render input.emf -o output.jpg --force
+metafile-render --version
+```
+
+The output extension selects the format: `.svg`, `.png`, `.jpg`, `.jpeg`, or `.webp`
+(case-insensitive). The output directory must exist. Existing output files are
+preserved unless `--force` is supplied; input and output must be different files.
+Completed outputs are published atomically. Input reads are bounded.
+
+Exit codes: `0` for a completed conversion (including partial rendering), `1` for
+conversion or filesystem errors, and `2` for invalid arguments. Diagnostics go to
+stderr. Partial rendering is explicitly reported. Use the Python API to inspect
+individual diagnostic fields.
+
+## Rendering and fonts
+
+Placeable and standard WMF, common EMF drawing records, text, DIB images, paths,
+transforms, clipping, and common raster operations are supported. EMF+ Dual uses
+the EMF fallback; EMF+ Only is unsupported. Unhandled records may produce partial
+results with diagnostics. This is not a complete implementation of every GDI record.
+
+Font lookup uses installed system fonts and common aliases, then Pillow's default
+font. Install the fonts used by the source document for closer text fidelity;
+glyph coverage and measurements can vary across systems. Font files are not bundled.
+WebP output requires a Pillow build with WebP encoding support, as provided by its
+standard wheels; an unavailable encoder raises `MetafileUnsupportedError`.
+
+SVG uses `data-metafile-render="wmf-emf"`, PNG metadata ID
+`metafile-render-raster-fallback`, and local clip IDs `metafile-render-clip-N`.
+The generated-image marker is not authentication of an arbitrary SVG. Consumers
+accepting externally supplied SVG should validate its structure independently.
+
+Fixed budgets bound input bytes, record and object counts, nesting, geometry,
+embedded images, and rendering work. Input is limited to 128 MiB; generated SVG
+is limited to 64 MiB; the canvas is limited to 8192 per side and 16 million pixels.
+
+## Development
+
+```bash
+uv venv .venv
+uv pip install --python .venv/bin/python -e ".[dev]"
+.venv/bin/python -m pytest
+.venv/bin/python -m ruff check .
+.venv/bin/python -m ruff format --check .
+.venv/bin/python -m build
+.venv/bin/python -m twine check dist/*
+```
+
+On Windows, the virtual environment interpreter is `.venv\Scripts\python.exe`.
+CI tests Python 3.10–3.14 on Linux, macOS, and Windows, plus minimum dependency combinations.
+Real EMF test images are read from a test-only presentation package dependency.
+
+## Publishing
+
+Releases use PyPI Trusted Publishing. Configure the PyPI pending publisher with
+project `metafile-render`, owner `myhloli`, repository `metafile-render`, workflow
+`publish.yml`, and environment `pypi`. Publishing a GitHub Release such as `v0.1.0`
+runs tests, verifies that the tag matches the package version, builds the wheel
+and source distribution, and uploads them through OIDC.
+
+## License
+
+MIT. Copyright (c) 2026 Xiaomeng Zhao (myhloli).

metafile_render-0.1.0/README.md

@@ -0,0 +1,132 @@
+# Metafile Render
+
+Render Windows Metafile (WMF) and Enhanced Metafile (EMF) images to SVG, PNG,
+JPEG, and WebP on Linux, macOS, and Windows.
+
+Requires Python 3.10–3.14. Runtime dependencies are Pillow and pyclipper;
+no Office installation, external conversion executable, or Windows GDI is required.
+
+## Installation
+
+```bash
+pip install metafile-render
+```
+
+Python 3.10–3.13 requires Pillow >=11.0.0 and pyclipper >=1.3.0,<2.
+Python 3.14 requires Pillow >=12.0.0 and pyclipper >=1.4.0,<2.
+Existing compatible dependencies can be retained; these ranges do not pin a fresh installation to older releases.
+
+## Python API
+
+```python
+from pathlib import Path
+from metafile_render import MetafileError, render_metafile
+
+try:
+    result = render_metafile(
+        Path("input.emf").read_bytes(),
+        output_format="svg",
+        dpi=144,
+        size_hint=None,
+    )
+except MetafileError as error:
+    print(error.code, str(error))
+else:
+    Path("output.svg").write_bytes(result.data)
+    print(result.width, result.height, result.media_type, result.partial)
+    for diagnostic in result.diagnostics:
+        print(diagnostic.code, diagnostic.message)
+```
+
+`render_metafile(data: bytes, *, output_format="png", dpi=144, size_hint=None)`
+returns a `MetafileRenderResult`. `dpi` must be an integer from 1 through 1200;
+`size_hint`, when supplied, is a pair of positive integer pixel dimensions, useful
+for standard WMF images without physical dimensions. Resource limits may reduce
+the actual canvas size.
+
+The result contains `data`, `output_format`, `media_type`, `width`, `height`,
+`source_format`, `emfplus_mode`, `partial`, and a tuple of `diagnostics`.
+Each diagnostic contains a code, level, message, and optional record location.
+
+Supported output format strings are `svg`, `png`, `jpeg`, and `webp`.
+PNG preserves transparency; JPEG uses a white background at quality 90.
+WebP preserves transparency and uses lossy quality 90, method 4.
+SVG is self-contained, with embedded images and a PNG fallback in metadata.
+Some raster operations require a raster image wrapped in SVG.
+
+Public exports are `render_metafile`, `MetafileOutputFormat`,
+`MetafileRenderResult`, `MetafileDiagnostic`, `MetafileError`,
+`MetafileMalformedError`, `MetafileResourceLimitError`, and `MetafileUnsupportedError`.
+The parser, drawing models, and renderer internals are not a stable public API.
+Invalid API arguments raise `TypeError` or `ValueError`; malformed, unsupported,
+and over-budget images raise the corresponding `MetafileError` subclass.
+
+## Command line
+
+```bash
+metafile-render input.emf -o output.svg
+metafile-render input.wmf -o output.png --dpi 144 --size 800 600
+metafile-render input.emf -o output.webp
+python -m metafile_render input.emf -o output.jpg --force
+metafile-render --version
+```
+
+The output extension selects the format: `.svg`, `.png`, `.jpg`, `.jpeg`, or `.webp`
+(case-insensitive). The output directory must exist. Existing output files are
+preserved unless `--force` is supplied; input and output must be different files.
+Completed outputs are published atomically. Input reads are bounded.
+
+Exit codes: `0` for a completed conversion (including partial rendering), `1` for
+conversion or filesystem errors, and `2` for invalid arguments. Diagnostics go to
+stderr. Partial rendering is explicitly reported. Use the Python API to inspect
+individual diagnostic fields.
+
+## Rendering and fonts
+
+Placeable and standard WMF, common EMF drawing records, text, DIB images, paths,
+transforms, clipping, and common raster operations are supported. EMF+ Dual uses
+the EMF fallback; EMF+ Only is unsupported. Unhandled records may produce partial
+results with diagnostics. This is not a complete implementation of every GDI record.
+
+Font lookup uses installed system fonts and common aliases, then Pillow's default
+font. Install the fonts used by the source document for closer text fidelity;
+glyph coverage and measurements can vary across systems. Font files are not bundled.
+WebP output requires a Pillow build with WebP encoding support, as provided by its
+standard wheels; an unavailable encoder raises `MetafileUnsupportedError`.
+
+SVG uses `data-metafile-render="wmf-emf"`, PNG metadata ID
+`metafile-render-raster-fallback`, and local clip IDs `metafile-render-clip-N`.
+The generated-image marker is not authentication of an arbitrary SVG. Consumers
+accepting externally supplied SVG should validate its structure independently.
+
+Fixed budgets bound input bytes, record and object counts, nesting, geometry,
+embedded images, and rendering work. Input is limited to 128 MiB; generated SVG
+is limited to 64 MiB; the canvas is limited to 8192 per side and 16 million pixels.
+
+## Development
+
+```bash
+uv venv .venv
+uv pip install --python .venv/bin/python -e ".[dev]"
+.venv/bin/python -m pytest
+.venv/bin/python -m ruff check .
+.venv/bin/python -m ruff format --check .
+.venv/bin/python -m build
+.venv/bin/python -m twine check dist/*
+```
+
+On Windows, the virtual environment interpreter is `.venv\Scripts\python.exe`.
+CI tests Python 3.10–3.14 on Linux, macOS, and Windows, plus minimum dependency combinations.
+Real EMF test images are read from a test-only presentation package dependency.
+
+## Publishing
+
+Releases use PyPI Trusted Publishing. Configure the PyPI pending publisher with
+project `metafile-render`, owner `myhloli`, repository `metafile-render`, workflow
+`publish.yml`, and environment `pypi`. Publishing a GitHub Release such as `v0.1.0`
+runs tests, verifies that the tag matches the package version, builds the wheel
+and source distribution, and uploads them through OIDC.
+
+## License
+
+MIT. Copyright (c) 2026 Xiaomeng Zhao (myhloli).

metafile_render-0.1.0/pyproject.toml

@@ -0,0 +1,59 @@
+[build-system]
+requires = ["setuptools>=77.0.3", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "metafile-render"
+version = "0.1.0"
+description = "Render WMF and EMF files to SVG, PNG, JPEG, and WebP"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{name = "Xiaomeng Zhao (myhloli)"}]
+requires-python = ">=3.10,<3.15"
+keywords = ["wmf", "emf", "metafile", "svg", "png", "jpeg", "webp", "rendering"]
+classifiers = [
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Operating System :: OS Independent",
+    "Topic :: Multimedia :: Graphics :: Graphics Conversion",
+    "Typing :: Typed",
+]
+dependencies = [
+    "pillow>=11.0.0; python_version < '3.14'",
+    "pillow>=12.0.0; python_version >= '3.14'",
+    "pyclipper>=1.3.0,<2; python_version < '3.14'",
+    "pyclipper>=1.4.0,<2; python_version >= '3.14'",
+]
+
+[project.optional-dependencies]
+test = ["pytest>=8", "pypptx-with-oxml>=1.0.3,<2"]
+dev = ["metafile-render[test]", "ruff", "build", "twine"]
+
+[project.urls]
+Repository = "https://github.com/myhloli/metafile-render"
+Issues = "https://github.com/myhloli/metafile-render/issues"
+
+[project.scripts]
+metafile-render = "metafile_render.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+namespaces = false
+
+[tool.setuptools.package-data]
+metafile_render = ["py.typed"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
+[tool.ruff]
+line-length = 128
+target-version = "py310"
+
+[tool.ruff.lint]
+select = ["C", "E", "F", "W", "ANN"]
+ignore = ["C901", "ANN204", "ANN401"]

metafile_render-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

metafile_render-0.1.0/src/metafile_render/__init__.py

@@ -0,0 +1,25 @@
+# Copyright (c) 2026 Xiaomeng Zhao (myhloli)
+# SPDX-License-Identifier: MIT
+"""WMF/EMF 的跨平台渲染 API。"""
+
+from .api import render_metafile
+from .models import (
+    MetafileDiagnostic,
+    MetafileError,
+    MetafileMalformedError,
+    MetafileOutputFormat,
+    MetafileRenderResult,
+    MetafileResourceLimitError,
+    MetafileUnsupportedError,
+)
+
+__all__ = [
+    "MetafileDiagnostic",
+    "MetafileError",
+    "MetafileMalformedError",
+    "MetafileOutputFormat",
+    "MetafileRenderResult",
+    "MetafileResourceLimitError",
+    "MetafileUnsupportedError",
+    "render_metafile",
+]

metafile_render-0.1.0/src/metafile_render/__main__.py

@@ -0,0 +1,10 @@
+# Copyright (c) 2026 Xiaomeng Zhao (myhloli)
+# SPDX-License-Identifier: MIT
+"""支持 python -m metafile_render。"""
+
+from .cli import main
+
+__all__: list[str] = []
+
+if __name__ == "__main__":
+    raise SystemExit(main())

metafile_render-0.1.0/src/metafile_render/api.py

@@ -0,0 +1,37 @@
+# Copyright (c) 2026 Xiaomeng Zhao (myhloli)
+# SPDX-License-Identifier: MIT
+"""WMF/EMF 公共渲染入口。"""
+
+from __future__ import annotations
+
+from .models import MetafileOutputFormat, MetafileRenderResult
+from .parser import parse_metafile
+from .render import encode_document
+
+
+def render_metafile(
+    data: bytes,
+    *,
+    output_format: MetafileOutputFormat = "png",
+    dpi: int = 144,
+    size_hint: tuple[int, int] | None = None,
+) -> MetafileRenderResult:
+    """把 WMF/EMF 字节渲染为 PNG、JPEG、WebP 或安全 SVG。"""
+    if output_format not in {"png", "jpeg", "svg", "webp"}:
+        raise ValueError(f"unsupported metafile output format: {output_format}")
+    document = parse_metafile(data, dpi=dpi, size_hint=size_hint)
+    output, media_type = encode_document(document, output_format)
+    return MetafileRenderResult(
+        data=output,
+        output_format=output_format,
+        media_type=media_type,
+        width=document.width,
+        height=document.height,
+        source_format=document.source_format,
+        emfplus_mode=document.emfplus_mode,
+        partial=document.partial,
+        diagnostics=document.diagnostics,
+    )
+
+
+__all__ = ["render_metafile"]

metafile_render-0.1.0/src/metafile_render/binary.py

@@ -0,0 +1,77 @@
+# Copyright (c) 2026 Xiaomeng Zhao (myhloli)
+# SPDX-License-Identifier: MIT
+"""WMF/EMF 使用的严格有界二进制读取器。"""
+
+from __future__ import annotations
+
+import struct
+
+from .models import MetafileMalformedError
+
+
+class BoundedReader:
+    """在固定 memoryview 边界内读取小端标量和切片。"""
+
+    def __init__(self, data: bytes | memoryview, *, base_offset: int = 0) -> None:
+        """保存输入视图与用于诊断的绝对起始偏移。"""
+        self.data = memoryview(data)
+        self.base_offset = base_offset
+
+    def _require(self, offset: int, size: int) -> None:
+        """验证读取范围，不允许负数或越过当前视图。"""
+        if offset < 0 or size < 0 or offset > len(self.data) - size:
+            raise MetafileMalformedError(
+                f"metafile field exceeds record boundary: offset={self.base_offset + offset}, size={size}"
+            )
+
+    def u8(self, offset: int) -> int:
+        """读取小端无符号 8 位整数。"""
+        self._require(offset, 1)
+        return int(self.data[offset])
+
+    def i16(self, offset: int) -> int:
+        """读取小端有符号 16 位整数。"""
+        self._require(offset, 2)
+        return int(struct.unpack_from("<h", self.data, offset)[0])
+
+    def u16(self, offset: int) -> int:
+        """读取小端无符号 16 位整数。"""
+        self._require(offset, 2)
+        return int(struct.unpack_from("<H", self.data, offset)[0])
+
+    def i32(self, offset: int) -> int:
+        """读取小端有符号 32 位整数。"""
+        self._require(offset, 4)
+        return int(struct.unpack_from("<i", self.data, offset)[0])
+
+    def u32(self, offset: int) -> int:
+        """读取小端无符号 32 位整数。"""
+        self._require(offset, 4)
+        return int(struct.unpack_from("<I", self.data, offset)[0])
+
+    def f32(self, offset: int) -> float:
+        """读取小端 IEEE-754 单精度浮点数。"""
+        self._require(offset, 4)
+        return float(struct.unpack_from("<f", self.data, offset)[0])
+
+    def bytes(self, offset: int, size: int) -> bytes:
+        """返回经过边界校验的不可变字节切片。"""
+        self._require(offset, size)
+        return self.data[offset : offset + size].tobytes()
+
+    def subreader(self, offset: int, size: int) -> BoundedReader:
+        """返回继承绝对偏移信息的有界子读取器。"""
+        self._require(offset, size)
+        return BoundedReader(self.data[offset : offset + size], base_offset=self.base_offset + offset)
+
+    def remaining(self, offset: int) -> int:
+        """返回从指定位置到当前视图末尾的剩余字节数。"""
+        self._require(offset, 0)
+        return len(self.data) - offset
+
+    def __len__(self) -> int:
+        """返回当前视图的总字节数。"""
+        return len(self.data)
+
+
+__all__ = ["BoundedReader"]

metafile_render-0.1.0/src/metafile_render/cli.py

@@ -0,0 +1,97 @@
+# Copyright (c) 2026 Xiaomeng Zhao (myhloli)
+# SPDX-License-Identifier: MIT
+"""单文件 WMF/EMF 转换命令行。"""
+
+from __future__ import annotations
+
+import argparse
+import os
+import sys
+import tempfile
+from importlib.metadata import version
+from pathlib import Path
+from typing import Sequence
+
+from .api import render_metafile
+from .limits import MAX_METAFILE_BYTES
+from .models import MetafileError, MetafileOutputFormat, MetafileResourceLimitError
+
+_OUTPUT_FORMATS: dict[str, MetafileOutputFormat] = {
+    ".png": "png",
+    ".jpg": "jpeg",
+    ".jpeg": "jpeg",
+    ".svg": "svg",
+    ".webp": "webp",
+}
+
+
+def _positive_integer(value: str) -> int:
+    """将命令行尺寸解析为正整数，错误交由 argparse 报告。"""
+    try:
+        number = int(value)
+    except ValueError as exc:
+        raise argparse.ArgumentTypeError("must be a positive integer") from exc
+    if number <= 0:
+        raise argparse.ArgumentTypeError("must be a positive integer")
+    return number
+
+
+def _read_input(path: Path) -> bytes:
+    """最多读取输入预算加一字节，避免完整载入超大文件。"""
+    with path.open("rb") as stream:
+        data = stream.read(MAX_METAFILE_BYTES + 1)
+    if len(data) > MAX_METAFILE_BYTES:
+        raise MetafileResourceLimitError(f"metafile exceeds max_metafile_bytes={MAX_METAFILE_BYTES}")
+    return data
+
+
+def _write_output(path: Path, data: bytes, *, overwrite: bool) -> None:
+    """在目标目录原子发布完整文件，并保证默认模式不会覆盖并发创建的文件。"""
+    descriptor, filename = tempfile.mkstemp(prefix=f".{path.name}.", suffix=".tmp", dir=path.parent)
+    temporary = Path(filename)
+    try:
+        with os.fdopen(descriptor, "wb") as stream:
+            stream.write(data)
+        if overwrite:
+            os.replace(temporary, path)
+        else:
+            os.link(temporary, path)
+    finally:
+        temporary.unlink(missing_ok=True)
+
+
+def main(argv: Sequence[str] | None = None) -> int:
+    """解析转换参数并返回稳定退出码，所有运行诊断写入 stderr。"""
+    parser = argparse.ArgumentParser(prog="metafile-render", description="Render WMF/EMF to SVG, PNG, JPEG or WebP.")
+    parser.add_argument("input", type=Path, help="input WMF or EMF file")
+    parser.add_argument("-o", "--output", type=Path, required=True, help="output .svg, .png, .jpg, .jpeg or .webp file")
+    parser.add_argument("--dpi", type=_positive_integer, default=144, help="render DPI, 1–1200 (default: 144)")
+    parser.add_argument("--size", type=_positive_integer, nargs=2, metavar=("WIDTH", "HEIGHT"), help="pixel size hint")
+    parser.add_argument("--force", action="store_true", help="replace an existing output file")
+    parser.add_argument("--version", action="version", version=f"%(prog)s {version('metafile-render')}")
+    arguments = parser.parse_args(argv)
+    output_format = _OUTPUT_FORMATS.get(arguments.output.suffix.lower())
+    if output_format is None:
+        parser.error("output extension must be .svg, .png, .jpg, .jpeg or .webp")
+    if arguments.dpi > 1200:
+        parser.error("--dpi must be between 1 and 1200")
+    try:
+        source, destination = arguments.input, arguments.output
+        if source.resolve() == destination.resolve() or destination.exists() and source.samefile(destination):
+            parser.error("input and output must refer to different files")
+        if (destination.exists() or destination.is_symlink()) and not arguments.force:
+            raise FileExistsError(f"output already exists: {destination}; use --force to replace it")
+        size_hint = (arguments.size[0], arguments.size[1]) if arguments.size else None
+        result = render_metafile(_read_input(source), output_format=output_format, dpi=arguments.dpi, size_hint=size_hint)
+        _write_output(destination, result.data, overwrite=arguments.force)
+    except (MetafileError, OSError) as exc:
+        print(f"metafile-render: {exc}", file=sys.stderr)
+        return 1
+    if result.partial:
+        print("metafile-render: partial rendering", file=sys.stderr)
+    for diagnostic in result.diagnostics:
+        print(f"metafile-render: {diagnostic.level} [{diagnostic.code}] {diagnostic.message}", file=sys.stderr)
+    return 0
+
+
+__all__ = ["main"]