Functions/GenXdev.AI.ComfyUI/ConvertComfyImageFormat.ps1
|
<##############################################################################
Part of PowerShell module : GenXdev.AI.ComfyUI Original cmdlet filename : ConvertComfyImageFormat.ps1 Original author : René Vaessen / GenXdev Version : 1.272.2025 ################################################################################ MIT License Copyright 2021-2025 GenXdev 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. ################################################################################> ################################################################################ ############################################################################### <# .SYNOPSIS Converts image file format while preserving maximum quality. .DESCRIPTION Loads an image file using System.Drawing and saves it in a different format with optimized quality settings. The function supports all major image formats including JPEG, PNG, BMP, TIFF, and GIF with special handling for JPEG quality optimization to maintain visual fidelity during conversion. The function automatically determines the target format from the provided format parameter and applies appropriate encoding settings. For JPEG output, it uses 95% quality to balance file size with visual quality. For other formats, it uses lossless conversion where possible. This function is particularly useful in ComfyUI workflows where generated images need to be converted to specific formats based on user requirements or compatibility needs. .PARAMETER ImagePath Path to the input image file to convert. Must be a valid image file that System.Drawing can load (JPEG, PNG, BMP, TIFF, GIF, etc.). The file will be validated for existence and readability. .PARAMETER OutputPath Path where the converted image should be saved. The directory will be created if it doesn't exist. If the file already exists, it will be overwritten. .PARAMETER Format Target image format as a string (e.g., "Jpeg", "Png", "Bmp", "Tiff", "Gif"). Case-insensitive. For JPEG format, high-quality encoding parameters are automatically applied. .EXAMPLE $convertedPath = ConvertComfyImageFormat -ImagePath "input.png" ` -OutputPath "output.jpg" -Format "Jpeg" Converts a PNG image to high-quality JPEG format. .EXAMPLE ConvertComfyImageFormat "image.bmp" "image.png" "Png" Convert BMP to PNG using positional parameters. .EXAMPLE $result = ConvertComfyImageFormat -ImagePath "source.tiff" ` -OutputPath "result.gif" -Format "Gif" Convert TIFF to GIF format with quality preservation. .NOTES This function requires System.Drawing to be available in the PowerShell session. The function handles resource disposal properly to prevent memory leaks and provides detailed progress feedback during conversion operations. For JPEG output, the function uses 95% quality encoding to maintain visual fidelity while achieving reasonable file sizes. Other formats use their default quality settings optimized for the format characteristics. #> function ConvertComfyImageFormat { [CmdletBinding()] param( ############################################################################### [Parameter( Mandatory = $true, Position = 0, HelpMessage = "Path to the input image file to convert" )] [string]$ImagePath, ############################################################################### [Parameter( Mandatory = $true, Position = 1, HelpMessage = "Path where the converted image should be saved" )] [string]$OutputPath, ############################################################################### [Parameter( Mandatory = $true, Position = 2, HelpMessage = "Target image format (Jpeg, Png, Bmp, Tiff, etc.)" )] [ValidateSet("Jpeg", "Jpg", "Png", "Bmp", "Tiff", "Gif")] [string]$Format ) begin { # display progress for image format conversion operation Microsoft.PowerShell.Utility\Write-Progress ` -Activity "ComfyUI Generation" ` -Status "Converting image format to ${Format}" # initialize image object variable for proper resource disposal $image = $null } process { try { # load image using system.drawing for high-quality format conversion $image = [System.Drawing.Image]::FromFile($ImagePath) # determine target image format based on format parameter $imageFormat = switch ($Format.ToLower()) { "jpeg" { [System.Drawing.Imaging.ImageFormat]::Jpeg } "jpg" { [System.Drawing.Imaging.ImageFormat]::Jpeg } "png" { [System.Drawing.Imaging.ImageFormat]::Png } "bmp" { [System.Drawing.Imaging.ImageFormat]::Bmp } "tiff" { [System.Drawing.Imaging.ImageFormat]::Tiff } "gif" { [System.Drawing.Imaging.ImageFormat]::Gif } default { [System.Drawing.Imaging.ImageFormat]::Jpeg } } # apply format-specific encoding with quality optimization if ($imageFormat -eq [System.Drawing.Imaging.ImageFormat]::Jpeg) { # configure jpeg encoder parameters for high-quality output $encoder = [System.Drawing.Imaging.Encoder]::Quality # create encoder parameters object with single quality parameter $encoderParameters = Microsoft.PowerShell.Utility\New-Object ` System.Drawing.Imaging.EncoderParameters(1) # set quality parameter to 95% for high-quality jpeg output $encoderParameters.Param[0] = Microsoft.PowerShell.Utility\New-Object ` System.Drawing.Imaging.EncoderParameter($encoder, 95L) # get jpeg codec information for encoding $jpegCodec = [System.Drawing.Imaging.ImageCodecInfo]::GetImageEncoders() | Microsoft.PowerShell.Core\Where-Object { $_.FormatID -eq [System.Drawing.Imaging.ImageFormat]::Jpeg.Guid } # save image with high-quality jpeg encoding settings $image.Save($OutputPath, $jpegCodec, $encoderParameters) } else { # save in other formats with their optimal default quality settings $image.Save($OutputPath, $imageFormat) } # clean up image object to free memory resources immediately $image.Dispose() # get file information for size reporting and validation $fileInfo = Microsoft.PowerShell.Management\Get-Item -LiteralPath $OutputPath # calculate file size in megabytes for user-friendly feedback $fileSizeMB = [Math]::Round($fileInfo.Length / 1MB, 2) Microsoft.PowerShell.Utility\Write-Verbose ("Converted to ${Format}: " + "${fileSizeMB}MB") # return the output path for pipeline continuation return $OutputPath } catch { # handle conversion errors gracefully with informative warnings Microsoft.PowerShell.Utility\Write-Warning "Failed to convert image format: $_" # ensure image object is disposed even on error to prevent memory leaks if ($image) { $image.Dispose() } # return original path when conversion fails return $ImagePath } } end { } } ################################################################################ |