mirror of
https://github.com/snapotter-hq/SnapOtter.git
synced 2026-08-03 07:46:42 +02:00
SnapOtterandGitHub
4963ab3bbd
All 181 docs markdown files translated into 20 languages (apps/docs/<locale>/**). Companion to the i18n code PR; admin-merged because the file count exceeds GitHub's per-PR CI trigger limit. Validated by pnpm i18n:check (all surfaces, 0 stale/missing) and a clean all-locale docs build.
212 lines
15 KiB
Markdown
212 lines
15 KiB
Markdown
---
|
|
description: "เอกสารอ้างอิงการทำงานของเอนจินภาพ การประมวลผลภาพที่อิง Sharp ทั้งหมดและพารามิเตอร์ของแต่ละอย่าง"
|
|
i18n_source_hash: 42febdf85fa8
|
|
i18n_provenance: human
|
|
i18n_output_hash: e7056568e7b1
|
|
---
|
|
|
|
# เอนจินภาพ {#image-engine}
|
|
|
|
แพ็กเกจ `@snapotter/image-engine` จัดการการทำงานกับภาพที่ไม่ใช่ AI ทั้งหมด มันห่อหุ้ม [Sharp](https://sharp.pixelplumbing.com/) และทำงานทั้งหมดในกระบวนการโดยไม่มี dependency ภายนอก
|
|
|
|
## การทำงาน {#operations}
|
|
|
|
### resize {#resize}
|
|
|
|
ปรับขนาดภาพให้เป็นมิติที่กำหนดหรือเป็นเปอร์เซ็นต์
|
|
|
|
| พารามิเตอร์ | ชนิด | คำอธิบาย |
|
|
|---|---|---|
|
|
| `width` | number | ความกว้างเป้าหมายเป็นพิกเซล |
|
|
| `height` | number | ความสูงเป้าหมายเป็นพิกเซล |
|
|
| `fit` | string | `cover`, `contain`, `fill`, `inside` หรือ `outside` |
|
|
| `withoutEnlargement` | boolean | หากเป็น true จะไม่ขยายภาพที่เล็กกว่า |
|
|
| `percentage` | number | ปรับขนาดตามเปอร์เซ็นต์แทนมิติสัมบูรณ์ |
|
|
|
|
คุณสามารถกำหนด `width`, `height` หรือทั้งสองอย่าง หากกำหนดเพียงอย่างเดียว อีกอย่างจะถูกคำนวณเพื่อรักษาอัตราส่วนภาพ
|
|
|
|
### crop {#crop}
|
|
|
|
ตัดบริเวณรูปสี่เหลี่ยมออกจากภาพ
|
|
|
|
| พารามิเตอร์ | ชนิด | คำอธิบาย |
|
|
|---|---|---|
|
|
| `left` | number | ระยะเยื้อง X จากขอบซ้าย |
|
|
| `top` | number | ระยะเยื้อง Y จากขอบบน |
|
|
| `width` | number | ความกว้างของพื้นที่ครอบตัด |
|
|
| `height` | number | ความสูงของพื้นที่ครอบตัด |
|
|
| `unit` | string | `px` (ค่าเริ่มต้น) หรือ `percent` |
|
|
|
|
### rotate {#rotate}
|
|
|
|
หมุนภาพตามมุมที่กำหนด
|
|
|
|
| พารามิเตอร์ | ชนิด | คำอธิบาย |
|
|
|---|---|---|
|
|
| `angle` | number | มุมการหมุนเป็นองศา (0-360) |
|
|
| `background` | string | สีเติมสำหรับพื้นที่ที่เปิดเผย (ค่าเริ่มต้น: `#000000`) ใช้กับมุมที่ไม่ใช่ 90 องศาเท่านั้น |
|
|
|
|
### flip {#flip}
|
|
|
|
สะท้อนภาพในแนวนอน แนวตั้ง หรือทั้งสองอย่าง อย่างน้อยหนึ่งอย่างต้องเป็น true
|
|
|
|
| พารามิเตอร์ | ชนิด | คำอธิบาย |
|
|
|---|---|---|
|
|
| `horizontal` | boolean | สะท้อนจากซ้ายไปขวา |
|
|
| `vertical` | boolean | สะท้อนจากบนลงล่าง |
|
|
|
|
### convert {#convert}
|
|
|
|
เปลี่ยนรูปแบบของภาพ
|
|
|
|
| พารามิเตอร์ | ชนิด | คำอธิบาย |
|
|
|---|---|---|
|
|
| `format` | string | รูปแบบเป้าหมาย: `jpg`, `png`, `webp`, `avif`, `tiff`, `gif`, `jxl`, `heic`, `heif`, `bmp`, `ico`, `jp2`, `qoi` |
|
|
| `quality` | number | คุณภาพการบีบอัด (1-100 ใช้กับรูปแบบที่สูญเสียข้อมูล) |
|
|
|
|
เจ็ดรูปแบบแรก (`jpg` ถึง `jxl`) ถูกเข้ารหัสโดย Sharp ในกระบวนการ รูปแบบที่เหลือใช้ตัวเข้ารหัสภายนอกที่ชั้น API: `heic`/`heif` ผ่าน heif-enc, `bmp`/`ico` ผ่าน ImageMagick, `jp2` ผ่าน opj_compress และ `qoi` ผ่าน codec แบบ TypeScript ในโค้ด
|
|
|
|
### compress {#compress}
|
|
|
|
ลดขนาดไฟล์โดยยังคงรูปแบบเดิม
|
|
|
|
| พารามิเตอร์ | ชนิด | คำอธิบาย |
|
|
|---|---|---|
|
|
| `quality` | number | คุณภาพเป้าหมาย (1-100) |
|
|
| `targetSizeBytes` | number | ขนาดไฟล์เป้าหมายแบบเสริมเป็นไบต์ |
|
|
| `format` | string | การแทนที่รูปแบบแบบเสริม |
|
|
|
|
### strip-metadata {#strip-metadata}
|
|
|
|
ลบเมทาดาทา EXIF, IPTC, XMP และ ICC ออกจากภาพ หากไม่มีพารามิเตอร์ (หรือ `stripAll: true`) จะลบทุกอย่าง ส่งแฟล็กแต่ละตัวเพื่อการลบแบบเลือกได้
|
|
|
|
| พารามิเตอร์ | ชนิด | คำอธิบาย |
|
|
|---|---|---|
|
|
| `stripAll` | boolean | ลบเมทาดาทาทั้งหมด (ค่าเริ่มต้นเมื่อไม่ได้ตั้งแฟล็กใด ๆ) |
|
|
| `stripExif` | boolean | ลบข้อมูล EXIF (รวมถึง GPS หาก `stripGps` ไม่ได้ตั้งแยกต่างหาก) |
|
|
| `stripGps` | boolean | ลบข้อมูลตำแหน่ง GPS |
|
|
| `stripIcc` | boolean | ลบโปรไฟล์สี ICC |
|
|
| `stripXmp` | boolean | ลบเมทาดาทา XMP |
|
|
|
|
### การปรับสี {#color-adjustments}
|
|
|
|
การทำงานเหล่านี้ปรับเปลี่ยนคุณสมบัติสีของภาพ แต่ละอย่างรับค่าตัวเลขเดียว
|
|
|
|
| การทำงาน | พารามิเตอร์ | ช่วง | คำอธิบาย |
|
|
|---|---|---|---|
|
|
| `brightness` | `value` | -100 ถึง 100 | ปรับความสว่าง |
|
|
| `contrast` | `value` | -100 ถึง 100 | ปรับคอนทราสต์ |
|
|
| `saturation` | `value` | -100 ถึง 100 | ปรับความอิ่มตัวของสี |
|
|
|
|
### ฟิลเตอร์สี {#color-filters}
|
|
|
|
ฟิลเตอร์เหล่านี้ใช้การแปลงสีแบบตายตัว ไม่รับพารามิเตอร์
|
|
|
|
| การทำงาน | คำอธิบาย |
|
|
|---|---|
|
|
| `grayscale` | แปลงเป็นโทนสีเทา |
|
|
| `sepia` | ใช้โทนสีซีเปีย |
|
|
| `invert` | กลับสีทั้งหมด |
|
|
|
|
### ช่องสี {#color-channels}
|
|
|
|
ปรับช่องสี RGB แต่ละช่อง ค่าเป็นตัวคูณโดยที่ 100 = ไม่เปลี่ยนแปลง
|
|
|
|
| พารามิเตอร์ | ชนิด | คำอธิบาย |
|
|
|---|---|---|
|
|
| `red` | number | ตัวคูณช่องสีแดง (0 ถึง 200, 100 = ไม่เปลี่ยนแปลง) |
|
|
| `green` | number | ตัวคูณช่องสีเขียว (0 ถึง 200, 100 = ไม่เปลี่ยนแปลง) |
|
|
| `blue` | number | ตัวคูณช่องสีน้ำเงิน (0 ถึง 200, 100 = ไม่เปลี่ยนแปลง) |
|
|
|
|
### sharpen {#sharpen}
|
|
|
|
การเพิ่มความคมชัดอย่างง่ายที่ควบคุมด้วยค่าเดียว
|
|
|
|
| พารามิเตอร์ | ชนิด | คำอธิบาย |
|
|
|---|---|---|
|
|
| `value` | number | ความเข้มของการเพิ่มความคมชัด (0 ถึง 100) แมปไปยังค่า Gaussian sigma ที่ 0.5-10 |
|
|
|
|
### sharpen-advanced {#sharpen-advanced}
|
|
|
|
การเพิ่มความคมชัดขั้นสูงพร้อมสามวิธีที่เลือกได้และการลดสัญญาณรบกวนล่วงหน้าแบบเสริม
|
|
|
|
| พารามิเตอร์ | ชนิด | คำอธิบาย |
|
|
|---|---|---|
|
|
| `method` | string | `adaptive`, `unsharp-mask` หรือ `high-pass` |
|
|
| `sigma` | number | รัศมี Gaussian blur, 0.5-10 (ปรับตัวได้) |
|
|
| `m1` | number | การเพิ่มความคมชัดในพื้นที่เรียบ, 0-10 (ปรับตัวได้) |
|
|
| `m2` | number | การเพิ่มความคมชัดในพื้นที่ที่มีพื้นผิว, 0-20 (ปรับตัวได้) |
|
|
| `x1` | number | เกณฑ์พื้นที่เรียบ/หยัก, 0-10 (ปรับตัวได้) |
|
|
| `y2` | number | การเพิ่มความสว่างสูงสุด (จำกัด halo), 0-50 (ปรับตัวได้) |
|
|
| `y3` | number | การลดความสว่างสูงสุด (จำกัด halo), 0-50 (ปรับตัวได้) |
|
|
| `amount` | number | เปอร์เซ็นต์ความเข้ม, 0-500 (unsharp-mask) |
|
|
| `radius` | number | รัศมีการเบลอ, 0.1-5.0 (unsharp-mask) |
|
|
| `threshold` | number | ความสว่างขอบต่ำสุด, 0-255 (unsharp-mask) |
|
|
| `strength` | number | ความเข้มของการผสม, 0-100 (high-pass) |
|
|
| `kernelSize` | number | `3` หรือ `5` สำหรับ kernel 3x3 / 5x5 (high-pass) |
|
|
| `denoise` | string | การลดสัญญาณรบกวนล่วงหน้า: `off`, `light`, `medium` หรือ `strong` |
|
|
|
|
พารามิเตอร์เป็นแบบเฉพาะวิธี ให้ระบุเฉพาะพารามิเตอร์ที่เกี่ยวข้องกับวิธีที่เลือกเท่านั้น
|
|
|
|
### color-blindness {#color-blindness}
|
|
|
|
จำลองภาวะบกพร่องในการมองเห็นสีโดยใช้เมทริกซ์การรวมสีขนาด 3x3
|
|
|
|
| พารามิเตอร์ | ชนิด | คำอธิบาย |
|
|
|---|---|---|
|
|
| `type` | string | หนึ่งใน: `protanopia`, `deuteranopia`, `tritanopia`, `protanomaly`, `deuteranomaly`, `tritanomaly`, `achromatopsia`, `blueConeMonochromacy` |
|
|
|
|
### edit-metadata {#edit-metadata}
|
|
|
|
เขียนหรือลบฟิลด์เมทาดาทา EXIF/IPTC แต่ละฟิลด์โดยไม่ต้องลบทั้งบล็อก
|
|
|
|
| พารามิเตอร์ | ชนิด | คำอธิบาย |
|
|
|---|---|---|
|
|
| `artist` | string | แท็ก EXIF Artist |
|
|
| `copyright` | string | แท็ก EXIF Copyright |
|
|
| `imageDescription` | string | แท็ก EXIF ImageDescription |
|
|
| `software` | string | แท็ก EXIF Software |
|
|
| `dateTime` | string | แท็ก EXIF DateTime |
|
|
| `dateTimeOriginal` | string | แท็ก EXIF DateTimeOriginal |
|
|
| `clearGps` | boolean | ลบแท็ก GPS ทั้งหมด |
|
|
| `fieldsToRemove` | string[] | รายการชื่อฟิลด์ EXIF ที่จะลบ |
|
|
|
|
พารามิเตอร์ทั้งหมดเป็นแบบเสริม ฟิลด์ที่ระบุใน `fieldsToRemove` จะถูกลบออกจากบล็อก EXIF ที่มีอยู่ ฟิลด์ที่ตั้งค่าผ่านพารามิเตอร์ที่มีชื่อจะถูกเขียน (หรือเขียนทับ) คีย์แบบไบนารี/ไม่ปลอดภัยอย่าง MakerNote จะถูกละเว้นโดยไม่แจ้ง
|
|
|
|
## การตรวจจับรูปแบบ {#format-detection}
|
|
|
|
เอนจินตรวจจับรูปแบบอินพุตโดยอัตโนมัติจากส่วนหัวของไฟล์ ไม่ใช่แค่นามสกุลไฟล์ นี่หมายความว่าไฟล์ `.jpg` ที่จริง ๆ เป็น PNG จะถูกจัดการอย่างถูกต้อง การตรวจจับใช้แนวทางหลายชั้น: magic bytes ก่อน จากนั้นใช้นามสกุลไฟล์เป็น fallback
|
|
|
|
SnapOtter รองรับ **รูปแบบอินพุตกว่า 55 รูปแบบ** และ **รูปแบบผลลัพธ์ 13 รูปแบบ** รวมถึงรูปแบบ RAW จากกล้อง 23 รูปแบบจากกว่า 20 แบรนด์ รูปแบบมืออาชีพ (PSD, EPS, OpenEXR, HDR) codec สมัยใหม่ (JPEG XL, AVIF, HEIC, QOI, JPEG 2000) และรูปแบบทางวิทยาศาสตร์/เกม (FITS, DDS) การถอดรหัสจัดการโดย Sharp โดยตรงเมื่อทำได้ พร้อม fallback อัตโนมัติไปยัง ImageMagick, LibRaw และตัวถอดรหัส CLI เฉพาะทาง
|
|
|
|
ดูหน้า [Supported Formats](/th/guide/supported-formats) สำหรับรายการทั้งหมด
|
|
|
|
## การสกัดเมทาดาทา {#metadata-extraction}
|
|
|
|
เครื่องมือ `info` คืนเมทาดาทาของภาพ ดู [Image Info](/th/tools/image/info) สำหรับเอกสารอ้างอิงฟิลด์ทั้งหมด
|
|
|
|
```json
|
|
{
|
|
"filename": "photo.jpg",
|
|
"fileSize": 2450000,
|
|
"width": 4032,
|
|
"height": 3024,
|
|
"format": "jpeg",
|
|
"channels": 3,
|
|
"hasAlpha": false,
|
|
"colorSpace": "srgb",
|
|
"density": 72,
|
|
"isProgressive": false,
|
|
"hasExif": true,
|
|
"hasIcc": true,
|
|
"hasXmp": false,
|
|
"bitDepth": "8",
|
|
"pages": 1,
|
|
"histogram": [
|
|
{ "channel": "red", "min": 0, "max": 255, "mean": 128.45, "stdev": 52.31 },
|
|
{ "channel": "green", "min": 2, "max": 253, "mean": 115.22, "stdev": 48.76 },
|
|
{ "channel": "blue", "min": 0, "max": 250, "mean": 102.89, "stdev": 55.14 }
|
|
]
|
|
}
|
|
```
|