CHANGELOG.md

日本語 (Japanese)

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[1.8.0] - 2026-08-15

Added

• Unpack Mode: The tool window now has a Pack / Unpack switcher at the top. The new Unpack tab does the reverse of packing: it splits a packed RGBA texture into separate grayscale textures, one asset per channel.
  • Instant Channel Preview: Selecting a source texture immediately shows its R/G/B/A contents as a 2×2 grid of grayscale previews (capped to a small resolution, so it stays fast even for 16K sources).
  • Per-Channel Export Toggles: Each channel has a checkbox controlling whether it is exported as an asset.
  • Unused Channel Detection: Channels whose pixels all share a single value (e.g. an alpha that is uniformly 255) are flagged with a "Uniform" badge and automatically excluded from export. Re-check the box to export them anyway.
  • Smart Naming: The output base name is derived from the source texture name with known packed suffixes stripped (e.g. T_Rock_ORM → T_Rock), and each channel appends a preset-driven suffix — with the ORM preset, T_Rock_AO / T_Rock_Roughness / T_Rock_Metallic. The base name can be edited manually.
  • Preset Integration: Presets (built-in and user-created) now carry per-channel unpack suffixes, selectable from a Preset dropdown in the Unpack tab. Older preset files load with the missing fields defaulting to _R/_G/_B/_A.
  • Extracted assets are single-channel (G8) textures with Grayscale compression and sRGB = false, created at the source resolution.
  • Streaming, allocation-free reads: Both the preview and the extraction read straight out of the locked source mip — no full-resolution copy and no intermediate FColor buffers. The preview walks the source exactly once, box-downsampling all four channels and detecting uniform channels in the same pass, so its allocation is ~256 KB no matter how large the source is (selecting a 16K RGBA32F texture no longer spikes gigabytes). Extraction peaks at one byte per pixel per selected channel, independent of the source format. As a side effect, sources larger than 2 GB (e.g. 16K RGBA32F) can now be unpacked.
  • The Unpack tab reuses the existing UX: overwrite confirmation (listing all affected assets), cancellable progress dialog, toast notifications, memory warning above 8K, and full English/Japanese localization.
  • Note: Grayscale compression is uncompressed PF_G8, so each extracted 8K channel costs roughly 67 MB of video memory plus mips once created.

Changed

• Unreal Engine 5.8: The sample project now targets UE 5.8 (EngineAssociation), and the plugin's EngineVersion was raised to 5.8.0. Supported versions are now 5.5 / 5.6 / 5.7 / 5.8.

[1.7.0] - 2026-06-08

Added

• Live Preview: Added a Preview panel to the tool. Click Update Preview to build a low-resolution composite of the packed RGB result using the current inputs, invert flags, and source-channel selections — without generating an asset. This shortens the generate → inspect → adjust loop.
  • The preview is rendered at a small capped resolution (max 256 px on the longest side) following the target aspect ratio, so it stays fast even for 16K output targets.
  • Alpha is shown as fully opaque so data packed into the Alpha channel does not blend the RGB composite against the panel background.
  • View modes: A View dropdown at the top of the preview switches between the RGB composite and any single channel (R/G/B/A) shown as grayscale, so data packed into Green/Blue/Alpha can be inspected individually. Switching is instant and does not re-read the source textures.
  • The preview is shown linear (sRGB off), matching the color space of the generated asset.

Fixed

• Large Texture Overflow: Source data extraction computed the byte count with 32-bit math (Width * Height * BytesPerPixel), which overflowed for very large inputs (e.g. a 16K RGBA32F texture is 4 GB) and failed with a misleading "invalid total bytes" error. The byte count is now computed in 64-bit, and textures larger than a 32-bit-indexed buffer can hold are rejected with a clear message.

[1.6.0] - 2026-05-07

Added

• Source Channel Selector: Each input slot now has a dropdown to choose which channel (R/G/B/A) of the input texture to read from. Previously the tool always read the Red channel, which made it awkward to source data from color or already-packed textures. Now you can, for example, swap just the G channel (Roughness) of an existing ORM map without first splitting it into individual textures.
  • For single-channel grayscale formats (G8/G16/R16F/R32F) the selection is ignored and the lone luminance value is used.
  • The selection is saved per preset so common channel layouts can be reused (older preset files load with missing fields defaulting to Red).
• Preserve All RGBA32F Channels: 32-bit float color inputs now preserve all four channels instead of only Red, allowing the new channel selector to operate on G/B/A as well.

[1.5.0] - 2026-04-05

Added

• Preset Management: Added a preset dropdown at the top of the tool UI that allows users to save, load, and delete channel packing configurations. Includes built-in presets for common workflows:
  • ORM (default): R=Ambient Occlusion, G=Roughness, B=Metallic — suffix _ORM
  • MRA: R=Metallic, G=Roughness, B=Ambient Occlusion — suffix _MRA
  • Custom: Automatically selected when the user manually changes settings.
• Preset Persistence: User-created presets are saved as individual JSON files in Saved/TextureChannelPacker/Presets/, enabling easy sharing of configurations across team members.
• Dynamic Channel Labels: Channel input labels now update automatically when switching presets, reflecting the expected texture type for each slot (e.g., "Red Channel Input (e.g. Metallic)" for MRA).
• Preset-Aware Filename Suffix: The auto-generated output filename now uses the active preset's suffix (e.g., _ORM, _MRA, _Packed) instead of the hardcoded _ORM.

Changed

• Scrollable UI with Pinned Generate Button: The tool window content is now wrapped in a scroll view, and the "Generate Texture" button is pinned to the bottom of the window. This ensures the button is always visible regardless of window size.

[1.4.0] - 2026-03-01

Added

• 16K Resolution Support: The maximum output resolution has been increased from 8192 to 16384 to accommodate limitations of DirectX 11 and OpenGL 4.1 and later.
• Memory Warning Dialog: Added a warning dialog asking for user confirmation when attempting to process textures with a resolution exceeding 8192, as it may consume a very large amount of memory.

[1.3.0] - 2026-02-23

Added

• Invert Toggle: Added a per-channel Invert checkbox next to each input slot label. When enabled, the channel values are flipped (255 - Value), useful for conversions like Roughness to Smoothness.
• Non-Square Output: Width and Height can now be specified independently, replacing the single Resolution field. This enables non-square packed textures for use cases like UI atlases.
• Overwrite Confirmation: A confirmation dialog now appears when the output asset already exists, preventing accidental data loss.

Changed

• Compression Settings Refactor: Migrated internal compression option handling from string-based comparison to an enum/struct-based architecture (FCompressionOption), improving maintainability and localization safety.

[1.2.0] - 2026-01-25

Fixed

• Memory Leak: Addressed an issue where UPackage objects were not properly garbage collected when texture generation was cancelled or failed. Implemented RAII using TStrongObjectPtr and proper cleanup logic.

[1.1.0] - 2026-01-16

Added

• Parallel Processing: Implemented multi-threaded processing for texture channel resizing and conversion using ParallelFor, improving generation speed.
• Cancellable Progress: Added a progress dialog with a cancel button, allowing users to abort the texture generation process.
• Extended Format Support: Added support for TSF_RGBA32F (Linear Color) input textures.

[1.0.1] - 2025-12-09

Fixed

• Smart Naming: Fixed an issue where auto-generation would overwrite manually edited filenames. It now respects user input.
• Color Space: Forced SRGB = false on generated textures to ensure correct linear values for packed channels.
• Packaging: Added PlatformAllowList to .uplugin to prevent packaging errors on mobile platforms.

Changed

• Fab Preparation: Updated .uplugin metadata (EngineVersion, Installed) for Fab store submission.
• License: Updated Copyright year to 2026.

[1.0.0] - 2025-12-08

Added

• Core Features
  • RGBA Channel Packing (Supports Red, Green, Blue, and optional Alpha inputs).
  • Auto-Resizing of input textures to match target resolution using high-quality bilinear interpolation.
  • Smart File Naming: Automatically generates output filenames based on input texture names.
• UI & UX
  • Path Picker button for easy output directory selection.
  • Compression Settings dropdown (Masks, Grayscale, Default).
  • Toast Notifications for success/error feedback.
  • Drag & Drop support for texture slots.
  • Full UI Localization (English/Japanese) based on Editor language.
• Technical Improvements
  • Extended Format Support: Handles 8-bit, 16-bit Grayscale, and 16/32-bit Float (SDF) textures.
  • Memory Optimization: Reduced peak memory usage during packing of large (e.g., 8K) textures.
  • Performance: Implemented lazy allocation for pixel data processing.
  • Validation: Enforced resolution limits (1-8192) and input checks.