WeddingPlatform.Services.SystemDrawingImageOptimizationService 클래스 참조

더 자세히 ...

WeddingPlatform.Services.SystemDrawingImageOptimizationService에 대한 상속 다이어그램 :

WeddingPlatform.Services.SystemDrawingImageOptimizationService에 대한 협력 다이어그램:

Public 멤버 함수
bool	CanEncode (string outputFormat)
Task< ImageOptimizationResult >	OptimizeAsync (string sourcePath, string destinationPath, EffectiveMediaPolicy policy, CancellationToken ct=default)

정적 Private 멤버 함수
static Bitmap	CreateResizedBitmap (Image source, int maxLongSide)
static void	SaveJpeg (Image image, string path, int quality)
static string	NormalizeFormat (string? outputFormat)

상세한 설명

System.Drawing 기반 이미지 최적화 서비스입니다. WebP는 기본 Windows/.NET 인코더에 없으므로 호출부에서 지원 가능한 형식으로 fallback합니다.

SystemDrawingImageOptimizationService.cs 파일의 17 번째 라인에서 정의되었습니다.

멤버 함수 문서화

CanEncode()

bool WeddingPlatform.Services.SystemDrawingImageOptimizationService.CanEncode ( string outputFormat )

inline

Can Encode 조건을 확인합니다.

매개변수

outputFormat

output Format에 사용할 string 값입니다.

반환값

Can Encode 조건이 충족되면 true이고, 그렇지 않으면 false입니다.

WeddingPlatform.Services.IImageOptimizationService를 구현.

SystemDrawingImageOptimizationService.cs 파일의 43 번째 라인에서 정의되었습니다.

    {
        var format = NormalizeFormat(outputFormat);
        return format is "jpg" or "jpeg" or "png";
    }

다음을 참조함 : NormalizeFormat().

다음에 의해서 참조됨 : OptimizeAsync().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

이 함수를 호출하는 함수들에 대한 그래프입니다.:

CreateResizedBitmap()

Bitmap WeddingPlatform.Services.SystemDrawingImageOptimizationService.CreateResizedBitmap ( Image source, int maxLongSide )

inlinestaticprivate

Resized Bitmap 값을 생성합니다.

매개변수

source	source에 사용할 Image 값입니다.
maxLongSide	max Long Side에 사용할 int 값입니다.

반환값

Create Resized Bitmap 작업에서 생성한 Bitmap 결과입니다.

SystemDrawingImageOptimizationService.cs 파일의 169 번째 라인에서 정의되었습니다.

    {
        var boundedLongSide = maxLongSide <= 0 ? 1920 : maxLongSide;
        var scale = Math.Min(1d, boundedLongSide / (double)Math.Max(source.Width, source.Height));
        var width = Math.Max(1, (int)Math.Round(source.Width * scale));
        var height = Math.Max(1, (int)Math.Round(source.Height * scale));
 
        var bitmap = new Bitmap(width, height);
        bitmap.SetResolution(source.HorizontalResolution, source.VerticalResolution);
        using var graphics = Graphics.FromImage(bitmap);
        graphics.CompositingQuality = CompositingQuality.HighQuality;
        graphics.InterpolationMode = InterpolationMode.HighQualityBicubic;
        graphics.SmoothingMode = SmoothingMode.HighQuality;
        graphics.PixelOffsetMode = PixelOffsetMode.HighQuality;
        graphics.Clear(Color.White);
        graphics.DrawImage(source, 0, 0, width, height);
        return bitmap;
    }

다음에 의해서 참조됨 : OptimizeAsync().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

NormalizeFormat()

string WeddingPlatform.Services.SystemDrawingImageOptimizationService.NormalizeFormat ( string? outputFormat )

inlinestaticprivate

Normalize Format 작업을 수행합니다.

매개변수

outputFormat

output Format에 사용할 string? 값입니다.

반환값

Normalize Format 작업에서 생성한 string 결과입니다.

SystemDrawingImageOptimizationService.cs 파일의 259 번째 라인에서 정의되었습니다.

    {
        var normalized = outputFormat?.Trim().TrimStart('.').ToLowerInvariant();
        return string.IsNullOrWhiteSpace(normalized) ? "" : normalized;
    }

다음에 의해서 참조됨 : CanEncode(), OptimizeAsync().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

OptimizeAsync()

Task< ImageOptimizationResult > WeddingPlatform.Services.SystemDrawingImageOptimizationService.OptimizeAsync ( string sourcePath, string destinationPath, EffectiveMediaPolicy policy, CancellationToken ct = default )

inline

Optimize Async 작업을 수행합니다.

매개변수

sourcePath	source Path에 사용할 string 값입니다.
destinationPath	destination Path에 사용할 string 값입니다.
policy	policy에 사용할 EffectiveMediaPolicy 값입니다.
ct	취소 요청을 감시하는 토큰입니다.

반환값

Optimize Async 작업에서 생성한 Task<ImageOptimizationResult> 결과입니다.

WeddingPlatform.Services.IImageOptimizationService를 구현.

SystemDrawingImageOptimizationService.cs 파일의 97 번째 라인에서 정의되었습니다.

    {
        ct.ThrowIfCancellationRequested();
 
        var format = NormalizeFormat(Path.GetExtension(destinationPath));
        if (string.IsNullOrWhiteSpace(format))
        {
            format = NormalizeFormat(policy.ImageOutputFormat);
        }
 
        if (!CanEncode(format))
        {
            return Task.FromResult(new ImageOptimizationResult
            {
                Skipped = true,
                Message = $"{format} 인코더를 사용할 수 없어 원본 표시 파일을 유지했습니다."
            });
        }
 
        using var source = Image.FromFile(sourcePath);
        using var output = CreateResizedBitmap(source, policy.ImageMaxLongSidePx);
 
        Directory.CreateDirectory(Path.GetDirectoryName(destinationPath)!);
        if (format is "jpg" or "jpeg")
        {
            SaveJpeg(output, destinationPath, policy.ImageQuality);
        }
        else
        {
            output.Save(destinationPath, ImageFormat.Png);
        }
 
        return Task.FromResult(new ImageOptimizationResult
        {
            Succeeded = File.Exists(destinationPath) && new FileInfo(destinationPath).Length > 0,
            FileName = Path.GetFileName(destinationPath),
            Message = "이미지 최적화 완료"
        });
    }

다음을 참조함 : CanEncode(), CreateResizedBitmap(), WeddingPlatform.Models.EffectiveMediaPolicy.ImageMaxLongSidePx, WeddingPlatform.Models.EffectiveMediaPolicy.ImageOutputFormat, WeddingPlatform.Models.EffectiveMediaPolicy.ImageQuality, NormalizeFormat(), SaveJpeg(), WeddingPlatform.Models.Skipped.

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

SaveJpeg()

void WeddingPlatform.Services.SystemDrawingImageOptimizationService.SaveJpeg ( Image image, string path, int quality )

inlinestaticprivate

Jpeg 데이터를 저장합니다.

매개변수

image	image에 사용할 Image 값입니다.
path	path에 사용할 string 값입니다.
quality	quality에 사용할 int 값입니다.

SystemDrawingImageOptimizationService.cs 파일의 220 번째 라인에서 정의되었습니다.

    {
        var codec = ImageCodecInfo.GetImageEncoders()
            .FirstOrDefault(x => x.FormatID == ImageFormat.Jpeg.Guid);
        if (codec is null)
        {
            image.Save(path, ImageFormat.Jpeg);
            return;
        }
 
        using var parameters = new EncoderParameters(1);
        parameters.Param[0] = new EncoderParameter(Encoder.Quality, Math.Clamp(quality, 1, 100));
        image.Save(path, codec, parameters);
    }

다음에 의해서 참조됨 : OptimizeAsync().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

---

이 클래스에 대한 문서화 페이지는 다음의 파일로부터 생성되었습니다.:

• SystemDrawingImageOptimizationService.cs