Texture png batch convert

Libraries/PyKotor/CLI_COMMANDS_REFERENCE.md

@@ -1016,13 +1016,32 @@ Based on the comprehensive analysis above, PyKotorCLI should support:
 - `assemble` - Assemble NSS to NCS (built-in)
 - `nwnnsscomp` / `script-compile` - Unified nwnnsscomp.exe-compatible CLI: accepts all variant argument styles (V1, TSLPatcher, KOTOR Tool, KOTOR Scripting Tool); uses built-in compiler/decompiler or optional external exe with correct argv. Implementation and external invocation both rely on [compilers.py](Libraries/PyKotor/src/pykotor/resource/formats/ncs/compilers.py) (`KnownExternalCompilers`, `NwnnsscompConfig`).
 
-### Resource Tools (To Add)
+### Resource Tools
 
-- `texture-convert` - Convert textures (TPC↔TGA, etc.)
+- `texture-convert` - Convert textures (`.tpc`, `.tga`, `.png`) one file at a time or in batches.
 - `sound-convert` - Convert sounds (SSF↔WAV, etc.)
 - `model-convert` - Convert models (MDL↔ASCII)
 - `walkmesh-rebuild` / `wok-rebuild` - Rebuild BWM derived data (AABB, adjacency, perimeter edges) from geometry
 
+```bash
+# Convert edited PNGs back to TGAs for Override. PNG support requires pykotor[textures].
+uvx --refresh --with "pykotor[textures]" pykotor texture-convert ./edited_pngs --from-format png --to tga --output ./Override --recursive
+
+# Convert source TGAs to PNGs for AI/image-editor work.
+uvx --refresh --with "pykotor[textures]" pykotor texture-convert ./source_tgas --from-format tga --to png --output ./png_work --recursive
+
+# Convert explicit files in place. Defaults: TPC->TGA, TGA->TPC, PNG->TGA.
+pykotor texture-convert texture_a.png texture_b.png --overwrite
+```
+
+Useful options:
+
+- `--to {tpc,tga,png}` - Force one output format.
+- `--from-format {tpc,tga,png}` - Filter directory inputs; repeat for multiple source formats.
+- `--output PATH` - Output file for one input, or output directory for multiple inputs.
+- `--recursive` - Recurse into input directories and preserve relative paths under the output directory.
+- `--overwrite` - Replace existing outputs; otherwise existing batch outputs are skipped.
+
 ### Utility Commands (Implemented)
 
 - `diff` - Compare resources

Libraries/PyKotor/CLI_QUICKSTART.md

@@ -89,6 +89,22 @@ uvx --refresh pykotor diff --path1 "C:\Games\KOTOR" --path2 "C:\Games\KOTOR_Modd
 uvx --refresh pykotor diff --path1 "C:\Games\KOTOR" --path2 "C:\Games\KOTOR_Modded" --tslpatchdata .\tslpatchdata --incremental
 ```
 
+### 8. Batch texture conversion for AI edit workflows
+
+`texture-convert` accepts one or more files or directories and supports `.tpc`, `.tga`, and `.png`.
+PNG support uses Pillow; install the `textures` extra when running from PyPI.
+
+```bash
+# Convert final edited PNGs back to TGAs for Override
+uvx --refresh --with "pykotor[textures]" pykotor texture-convert ./edited_pngs --from-format png --to tga --output ./Override --recursive
+
+# Convert exported TGAs to PNGs before editing
+uvx --refresh --with "pykotor[textures]" pykotor texture-convert ./exported_tgas --from-format tga --to png --output ./png_work --recursive
+
+# Convert a few files in place, using defaults: TPC->TGA, TGA->TPC, PNG->TGA
+uvx --refresh --with "pykotor[textures]" pykotor texture-convert texture_a.png texture_b.png --overwrite
+```
+
 GUI (omit paths or pass `--gui`):
 
 ```bash

Libraries/PyKotor/CLI_README.md

@@ -19,6 +19,7 @@ PyKotorCLI is a command-line tool for converting KOTOR modules, ERFs, and haks b
 - **Pure Python** - No external tool dependencies required (nwnnsscomp optional)
 - **Holocron kit generator** - Generate Holocron-compatible kits via `kit-generate` in headless mode or by launching the Tkinter GUI when no CLI args are provided
 - **GUI converter** - Resize KotOR `.gui` layouts to common resolutions (`gui-convert` headless, GUI when arguments are omitted)
+- **Batch texture conversion** - Convert `.tpc`, `.tga`, and `.png` files for texture editing workflows (`texture-convert`)
 - **Integrated KotorDiff** - Structured comparisons across files, modules, and installations; stays headless when CLI args are provided and launches the KotorDiff GUI when omitted or `--gui` is passed
 
 ## Installation
@@ -126,7 +127,23 @@ Interactive GUI (omit args):
 uvx --refresh pykotor gui-convert
 ```
 
-### 7. Run KotorDiff comparisons (headless or GUI)
+### 7. Batch texture conversion
+
+Use `texture-convert` for headless TGA/PNG/TPC conversions. PNG support requires Pillow;
+install with `pykotor[textures]` or `pykotor[all]`.
+
+```bash
+# AI edit loop: edited PNGs back to game-ready TGAs
+uvx --refresh --with "pykotor[textures]" pykotor texture-convert ./edited_pngs --from-format png --to tga --output ./Override --recursive
+
+# Export TGAs to PNGs for editing
+uvx --refresh --with "pykotor[textures]" pykotor texture-convert ./exported_tgas --from-format tga --to png --output ./png_work --recursive
+
+# One or more explicit files; defaults are TPC->TGA, TGA->TPC, PNG->TGA
+pykotor texture-convert texture_a.png texture_b.png --overwrite
+```
+
+### 8. Run KotorDiff comparisons (headless or GUI)
 
 Headless CLI (stays in the console when paths are provided):
 

Libraries/PyKotor/pyproject.toml

@@ -61,7 +61,7 @@ readme = "README.md"
 requires-python = ">=3.8"
 
 [project.optional-dependencies]
-all = ["pykotor[encodings,exp,extra,font,gl,updater]"]
+all = ["pykotor[encodings,exp,extra,font,textures,gl,updater]"]
 # Development dependencies
 dev = [
   "astroid>=3.2.0,<3.5.0; python_version<\"3.9\"",
@@ -127,6 +127,10 @@ font = [
   "pillow>=10.0.0,<11; python_version < \"3.10\"",
   "pillow>=12.1.1; python_version >= \"3.10\"",
 ]
+textures = [
+  "pillow>=10.0.0,<11; python_version < \"3.10\"",
+  "pillow>=12.1.1; python_version >= \"3.10\"",
+]
 gl = [
   "PyGLM>=2.0,<2.9",
   "PyOpenGL>=3.1",
@@ -219,6 +223,7 @@ encodings = ["charset-normalizer"]
 exp = ["fusepy", "pywin32"]
 extra = ["PyYAML", "Send2Trash", "colorama", "comtypes", "gputil", "psutil"]
 font = ["pillow"]
+textures = ["pillow"]
 gl = ["PyGLM", "PyOpenGL", "numpy"]
 gl_exp = ["moderngl"]
 updater = ["certifi", "pycryptodome", "requests"]

Libraries/PyKotor/src/pykotor/cli/argparser.py

@@ -930,10 +930,41 @@ def create_parser(prog: str | None = None) -> ArgumentParser:  # noqa: PLR0915
 
     # Resource tools
     texture_parser = subparsers.add_parser(
-        "texture-convert", help="Convert texture files (TPC<->TGA)"
+        "texture-convert", help="Convert texture files (TPC/TGA/PNG)"
+    )
+    texture_parser.add_argument(
+        "input",
+        nargs="+",
+        help="Input texture file(s) or directory/directories (.tpc, .tga, .png)",
+    )
+    texture_parser.add_argument(
+        "--output",
+        "-o",
+        dest="output",
+        help="Output file for one input, or output directory for multiple inputs",
+    )
+    texture_parser.add_argument(
+        "--to",
+        choices=["tpc", "tga", "png"],
+        help="Output format. Defaults: TPC->TGA, TGA->TPC, PNG->TGA",
+    )
+    texture_parser.add_argument(
+        "--from-format",
+        action="append",
+        choices=["tpc", "tga", "png"],
+        help="Only convert inputs with this format. Repeat to include multiple formats.",
+    )
+    texture_parser.add_argument(
+        "--recursive",
+        "-r",
+        action="store_true",
+        help="Recurse into input directories",
+    )
+    texture_parser.add_argument(
+        "--overwrite",
+        action="store_true",
+        help="Replace existing outputs during batch conversion",
     )
-    texture_parser.add_argument("input", help="Input texture file (TPC or TGA)")
-    texture_parser.add_argument("--output", "-o", dest="output", help="Output texture file")
     texture_parser.add_argument("--txi", help="TXI file path (for TPC<->TGA conversion)")
     texture_parser.add_argument("--format", help="TPC format type (for TGA->TPC)")
     texture_parser.add_argument(
@@ -1198,9 +1229,7 @@ def create_parser(prog: str | None = None) -> ArgumentParser:  # noqa: PLR0915
         "check-txi", help="Check if TXI files exist for specific textures"
     )
     check_txi_path_group = check_txi_parser.add_mutually_exclusive_group(required=True)
-    check_txi_path_group.add_argument(
-        "--path", "-p", dest="path", help="Path to a game root"
-    )
+    check_txi_path_group.add_argument("--path", "-p", dest="path", help="Path to a game root")
     check_txi_path_group.add_argument("--installation", "-i", dest="path", help=SUPPRESS)
     check_txi_parser.add_argument(
         "--textures",
@@ -1340,11 +1369,15 @@ def create_parser(prog: str | None = None) -> ArgumentParser:  # noqa: PLR0915
     validate_installation_parser = subparsers.add_parser(
         "validate-game-root", aliases=["validate-installation"], help="Validate a KotOR game root"
     )
-    validate_installation_path_group = validate_installation_parser.add_mutually_exclusive_group(required=True)
+    validate_installation_path_group = validate_installation_parser.add_mutually_exclusive_group(
+        required=True
+    )
     validate_installation_path_group.add_argument(
         "--path", "-p", dest="path", help="Path to a game root"
     )
-    validate_installation_path_group.add_argument("--installation", "-i", dest="path", help=SUPPRESS)
+    validate_installation_path_group.add_argument(
+        "--installation", "-i", dest="path", help=SUPPRESS
+    )
     validate_installation_parser.add_argument(
         "--check-essential",
         action="store_true",
@@ -1358,7 +1391,9 @@ def create_parser(prog: str | None = None) -> ArgumentParser:  # noqa: PLR0915
     investigate_module_parser.add_argument(
         "--module", "-m", required=True, help="Module name to investigate"
     )
-    investigate_module_path_group = investigate_module_parser.add_mutually_exclusive_group(required=True)
+    investigate_module_path_group = investigate_module_parser.add_mutually_exclusive_group(
+        required=True
+    )
     investigate_module_path_group.add_argument(
         "--path", "-p", dest="path", help="Path to a game root"
     )
@@ -1374,11 +1409,15 @@ def create_parser(prog: str | None = None) -> ArgumentParser:  # noqa: PLR0915
     check_missing_resources_parser.add_argument(
         "--module", "-m", required=True, help="Module name to check"
     )
-    check_missing_resources_path_group = check_missing_resources_parser.add_mutually_exclusive_group(required=True)
+    check_missing_resources_path_group = (
+        check_missing_resources_parser.add_mutually_exclusive_group(required=True)
+    )
     check_missing_resources_path_group.add_argument(
         "--path", "-p", dest="path", help="Path to a game root"
     )
-    check_missing_resources_path_group.add_argument("--installation", "-i", dest="path", help=SUPPRESS)
+    check_missing_resources_path_group.add_argument(
+        "--installation", "-i", dest="path", help=SUPPRESS
+    )
     check_missing_resources_parser.add_argument(
         "--textures", "-t", nargs="+", help="Texture names to check"
     )
@@ -1390,7 +1429,9 @@ def create_parser(prog: str | None = None) -> ArgumentParser:  # noqa: PLR0915
         "module-resources", help="Get all resources referenced by a module's models"
     )
     module_resources_parser.add_argument("--module", "-m", required=True, help="Module name")
-    module_resources_path_group = module_resources_parser.add_mutually_exclusive_group(required=True)
+    module_resources_path_group = module_resources_parser.add_mutually_exclusive_group(
+        required=True
+    )
     module_resources_path_group.add_argument(
         "--path", "-p", dest="path", help="Path to a game root"
     )
@@ -1607,7 +1648,9 @@ def create_parser(prog: str | None = None) -> ArgumentParser:  # noqa: PLR0915
     patch_installation_parser = subparsers.add_parser(
         "patch-game-root", aliases=["patch-installation"], help="Patch a KotOR game root"
     )
-    patch_installation_path_group = patch_installation_parser.add_mutually_exclusive_group(required=True)
+    patch_installation_path_group = patch_installation_parser.add_mutually_exclusive_group(
+        required=True
+    )
     patch_installation_path_group.add_argument(
         "--path", "-p", dest="path", help="Path to a game root"
     )