SnapOtter/apps/docs/th/api/image-engine.md

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
เอกสารอ้างอิงการทำงานของเอนจินภาพ การประมวลผลภาพที่อิง Sharp ทั้งหมดและพารามิเตอร์ของแต่ละอย่าง	42febdf85fa8	human	e7056568e7b1

เอนจินภาพ

แพ็กเกจ @snapotter/image-engine จัดการการทำงานกับภาพที่ไม่ใช่ AI ทั้งหมด มันห่อหุ้ม Sharp และทำงานทั้งหมดในกระบวนการโดยไม่มี dependency ภายนอก

การทำงาน

resize

ปรับขนาดภาพให้เป็นมิติที่กำหนดหรือเป็นเปอร์เซ็นต์

พารามิเตอร์	ชนิด	คำอธิบาย
width	number	ความกว้างเป้าหมายเป็นพิกเซล
height	number	ความสูงเป้าหมายเป็นพิกเซล
fit	string	cover, contain, fill, inside หรือ outside
withoutEnlargement	boolean	หากเป็น true จะไม่ขยายภาพที่เล็กกว่า
percentage	number	ปรับขนาดตามเปอร์เซ็นต์แทนมิติสัมบูรณ์

คุณสามารถกำหนด width, height หรือทั้งสองอย่าง หากกำหนดเพียงอย่างเดียว อีกอย่างจะถูกคำนวณเพื่อรักษาอัตราส่วนภาพ

crop

ตัดบริเวณรูปสี่เหลี่ยมออกจากภาพ

พารามิเตอร์	ชนิด	คำอธิบาย
left	number	ระยะเยื้อง X จากขอบซ้าย
top	number	ระยะเยื้อง Y จากขอบบน
width	number	ความกว้างของพื้นที่ครอบตัด
height	number	ความสูงของพื้นที่ครอบตัด
unit	string	px (ค่าเริ่มต้น) หรือ percent

rotate

หมุนภาพตามมุมที่กำหนด

พารามิเตอร์	ชนิด	คำอธิบาย
angle	number	มุมการหมุนเป็นองศา (0-360)
background	string	สีเติมสำหรับพื้นที่ที่เปิดเผย (ค่าเริ่มต้น: #000000) ใช้กับมุมที่ไม่ใช่ 90 องศาเท่านั้น

flip

สะท้อนภาพในแนวนอน แนวตั้ง หรือทั้งสองอย่าง อย่างน้อยหนึ่งอย่างต้องเป็น true

พารามิเตอร์	ชนิด	คำอธิบาย
horizontal	boolean	สะท้อนจากซ้ายไปขวา
vertical	boolean	สะท้อนจากบนลงล่าง

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

ลดขนาดไฟล์โดยยังคงรูปแบบเดิม

พารามิเตอร์	ชนิด	คำอธิบาย
quality	number	คุณภาพเป้าหมาย (1-100)
targetSizeBytes	number	ขนาดไฟล์เป้าหมายแบบเสริมเป็นไบต์
format	string	การแทนที่รูปแบบแบบเสริม

strip-metadata

ลบเมทาดาทา EXIF, IPTC, XMP และ ICC ออกจากภาพ หากไม่มีพารามิเตอร์ (หรือ stripAll: true) จะลบทุกอย่าง ส่งแฟล็กแต่ละตัวเพื่อการลบแบบเลือกได้

พารามิเตอร์	ชนิด	คำอธิบาย
stripAll	boolean	ลบเมทาดาทาทั้งหมด (ค่าเริ่มต้นเมื่อไม่ได้ตั้งแฟล็กใด ๆ)
stripExif	boolean	ลบข้อมูล EXIF (รวมถึง GPS หาก stripGps ไม่ได้ตั้งแยกต่างหาก)
stripGps	boolean	ลบข้อมูลตำแหน่ง GPS
stripIcc	boolean	ลบโปรไฟล์สี ICC
stripXmp	boolean	ลบเมทาดาทา XMP

การปรับสี

การทำงานเหล่านี้ปรับเปลี่ยนคุณสมบัติสีของภาพ แต่ละอย่างรับค่าตัวเลขเดียว

การทำงาน	พารามิเตอร์	ช่วง	คำอธิบาย
brightness	value	-100 ถึง 100	ปรับความสว่าง
contrast	value	-100 ถึง 100	ปรับคอนทราสต์
saturation	value	-100 ถึง 100	ปรับความอิ่มตัวของสี

ฟิลเตอร์สี

ฟิลเตอร์เหล่านี้ใช้การแปลงสีแบบตายตัว ไม่รับพารามิเตอร์

การทำงาน	คำอธิบาย
grayscale	แปลงเป็นโทนสีเทา
sepia	ใช้โทนสีซีเปีย
invert	กลับสีทั้งหมด

ช่องสี

ปรับช่องสี RGB แต่ละช่อง ค่าเป็นตัวคูณโดยที่ 100 = ไม่เปลี่ยนแปลง

พารามิเตอร์	ชนิด	คำอธิบาย
red	number	ตัวคูณช่องสีแดง (0 ถึง 200, 100 = ไม่เปลี่ยนแปลง)
green	number	ตัวคูณช่องสีเขียว (0 ถึง 200, 100 = ไม่เปลี่ยนแปลง)
blue	number	ตัวคูณช่องสีน้ำเงิน (0 ถึง 200, 100 = ไม่เปลี่ยนแปลง)

sharpen

การเพิ่มความคมชัดอย่างง่ายที่ควบคุมด้วยค่าเดียว

พารามิเตอร์	ชนิด	คำอธิบาย
value	number	ความเข้มของการเพิ่มความคมชัด (0 ถึง 100) แมปไปยังค่า Gaussian sigma ที่ 0.5-10

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

จำลองภาวะบกพร่องในการมองเห็นสีโดยใช้เมทริกซ์การรวมสีขนาด 3x3

พารามิเตอร์	ชนิด	คำอธิบาย
type	string	หนึ่งใน: protanopia, deuteranopia, tritanopia, protanomaly, deuteranomaly, tritanomaly, achromatopsia, blueConeMonochromacy

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 จะถูกละเว้นโดยไม่แจ้ง

การตรวจจับรูปแบบ

เอนจินตรวจจับรูปแบบอินพุตโดยอัตโนมัติจากส่วนหัวของไฟล์ ไม่ใช่แค่นามสกุลไฟล์ นี่หมายความว่าไฟล์ .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 สำหรับรายการทั้งหมด

การสกัดเมทาดาทา

เครื่องมือ info คืนเมทาดาทาของภาพ ดู Image Info สำหรับเอกสารอ้างอิงฟิลด์ทั้งหมด

{
  "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 }
  ]
}