การหมุนภาพโดยโปรแกรมเป็นความต้องการที่พบบ่อยเมื่อสร้างตัวสร้างตัวอย่างภาพ, โปรแกรมแก้ไขรูปภาพ, หรือกระบวนการทำงานของเอกสาร. Conholdate.Total for Java มี SDK ที่แข็งแกร่งซึ่งทำให้การจัดการภาพเป็นเรื่องง่ายในแอปพลิเคชัน Java. ในคู่มือนี้คุณจะได้เรียนรู้วิธีการหมุนไฟล์ PNG และ JPG, ตั้งค่าพารามิเตอร์การหมุน, และรักษา metadata ไว้ขณะยังคงคุณภาพภาพสูง.

การเตรียมสภาพแวดล้อม - ข้อกำหนดเบื้องต้นและการตั้งค่า

ก่อนที่คุณจะเริ่มต้น โปรดตรวจสอบว่าคุณมีสิ่งต่อไปนี้:

  • ติดตั้ง Java 17 หรือใหม่กว่า.
  • IDE เช่น IntelliJ IDEA หรือ Eclipse.
  • Maven สำหรับการจัดการ dependencies.

เพิ่มที่เก็บ Maven ของ Conholdate และการอ้างอิง SDK ลงใน pom.xml ของคุณ:

<repositories>
    <repository>
        <id>conholdate-repo</id>
        <name>Conholdate Maven Repository</name>
        <url>https://repository.conholdate.com/repo/</url>
    </repository>
</repositories>

<dependency>
    <groupId>com.conholdate</groupId>
    <artifactId>conholdate-total</artifactId>
    <version>24.9</version>
    <type>pom</type>
</dependency>

ดาวน์โหลดไบนารี SDK ล่าสุดจากหน้าดาวน์โหลดอย่างเป็นทางการ: Conholdate.Total for Java Download. เมื่อการพึ่งพาถูกแก้ไขแล้ว คุณพร้อมที่จะเขียนโค้ดที่หมุนภาพ.

หมุนภาพใน Java: คู่มือแบบทีละขั้นตอน

ขั้นตอนที่ 1: โหลดแหล่งที่มและเส้นทางปลายทาง

กำหนดตำแหน่งไฟล์อินพุตและเอาต์พุต SDK รองรับทั้งรูปแบบ PNG และ JPG.

String inputPath = "input.jpg";
String outputPath = "output_rotated.jpg";

ขั้นตอนที่ 2: เริ่มต้นตัวจัดการการแปลงและตัวเลือก

สร้างอ็อบเจ็กต์หลักที่ขับเคลื่อนกระบวนการแปลง

ConversionHandler handler = new ConversionHandler();
ImageConvertOptions options = new ImageConvertOptions();

ขั้นตอนที่ 3: ตั้งค่ามุมการหมุนและสีพื้นหลัง

ระบุจำนวนองศาที่ต้องการหมุนภาพและสีเติมสำหรับมุมที่ว่างเปล่า

options.setRotateAngle(90);               // Rotate 90 degrees clockwise
options.setBackgroundColor(Color.WHITE);  // Fill empty space with white

ขั้นตอนที่ 4: กำหนดค่าพารามิเตอร์เพิ่มเติม

รักษาเมตาดาต้าต้นฉบับและกำหนดคุณภาพของ JPEG เมื่อผลลัพธ์เป็น JPG.

options.setPreserveMetadata(true);
options.setQuality(90); // JPEG quality (0‑100)

ขั้นตอนที่ 5: ดำเนินการหมุน

เรียกเมธอด convert เพื่อใช้การหมุนและเขียนผลลัพธ์.

handler.convert(inputPath, outputPath, options);
System.out.println("Image rotated successfully: " + outputPath);

สำหรับรายละเอียดเพิ่มเติมเกี่ยวกับคลาส ConversionHandler ให้ดูที่ เอกสารอ้างอิง API อย่างเป็นทางการ.

ตัวอย่างโค้ดเต็ม: การหมุนภาพใน Java โดยใช้ Conholdate.Total

ตัวอย่างต่อไปนี้แสดงขั้นตอนการทำงานทั้งหมดสำหรับการหมุนไฟล์รูปภาพ

ตัวอย่างนี้แสดงวิธีการหมุนภาพ JPG ไป 90 องศาและบันทึกผลลัพธ์.

import com.groupdocs.conversion.ConversionHandler;
import com.groupdocs.conversion.options.convert.ImageConvertOptions;
import java.awt.Color;

public class RotateImageExample {
    public static void main(String[] args) {
        String inputPath = "input.jpg";
        String outputPath = "output_rotated.jpg";

try (ConversionHandler handler = new ConversionHandler()) {
            ImageConvertOptions options = new ImageConvertOptions();
            // Rotation angle in degrees (positive = clockwise)
            options.setRotateAngle(90);
            // Background color for empty areas after rotation
            options.setBackgroundColor(Color.WHITE);
            // Preserve original metadata (EXIF, DPI, etc.)
            options.setPreserveMetadata(true);
            // Optional: for large images you can limit memory usage
            options.setQuality(90); // JPEG quality (0-100)

handler.convert(inputPath, outputPath, options);
            System.out.println("Image rotated successfully: " + outputPath);
        } catch (Exception e) {
            System.err.println("Error during image rotation:");
            e.printStackTrace();
        }
    }
}

หมายเหตุ: ตัวอย่างโค้ดนี้แสดงการทำงานหลัก ก่อนนำไปใช้ในโครงการของคุณ โปรดตรวจสอบให้แน่ใจว่าได้อัปเดตเส้นทางไฟล์และค่าการกำหนดค่าต่าง ๆ ให้ตรงกับสภาพแวดล้อมจริงของคุณ ตรวจสอบว่าการติดตั้ง dependencies ที่จำเป็นทั้งหมดเสร็จสมบูรณ์แล้ว และทำการทดสอบอย่างละเอียดในสภาพแวดล้อมการพัฒนา หากคุณพบปัญหาใด ๆ โปรดดูที่ เอกสารอย่างเป็นทางการ หรือ ติดต่อทีมสนับสนุนที่ ทีมสนับสนุน เพื่อขอความช่วยเหลือ.

พารามิเตอร์การหมุน: ตัวเลือกและการตั้งค่า

SDK มีตัวเลือกหลายอย่างเพื่อปรับแต่งกระบวนการหมุนอย่างละเอียด

  • Rotate Angle - กำหนดจำนวนองศาที่ภาพจะถูกหมุน ค่าเป็นบวกจะหมุนตามเข็มนาฬิกา.
options.setRotateAngle(90);

  • สีพื้นหลัง - กำหนดสีเติมสำหรับมุมว่างที่ปรากฏหลังจากการหมุน ใช้ค่า java.awt.Color ใดก็ได้

  • รักษาเมตาดาต้า - เมื่อเปิดใช้งาน, ข้อมูล EXIF , DPI และเมตาดาต้าอื่น ๆ จะถูกเก็บไว้ในไฟล์ผลลัพธ์ ดู ImageConvertOptions API สำหรับรายละเอียดเพิ่มเติม.

  • Quality - ควบคุมคุณภาพการบีบอัด JPEG (0‑100). ค่าที่สูงกว่าจะรักษารายละเอียดได้มากขึ้นแต่ขนาดไฟล์จะเพิ่มขึ้น.

ปรับการตั้งค่าเหล่านี้ให้ตรงกับความต้องการของแอปพลิเคชันของคุณ ไม่ว่าจะต้องการผลลัพธ์ PNG แบบไม่สูญเสียคุณภาพหรือ JPG คุณภาพสูง

สรุป

การหมุนภาพใน Java ง่ายเมื่อคุณใช้ Conholdate.Total for Java. คู่มือนี้จะพาคุณผ่านการตั้งค่าที่จำเป็น การดำเนินการแบบขั้นตอนโดยละเอียด และตัวเลือกการกำหนดค่าหลักที่ให้คุณควบคุมมุม, พื้นหลัง, การรักษาเมตาดาต้า, และคุณภาพของผลลัพธ์. อย่าลืมรับใบอนุญาตที่เหมาะสมสำหรับการใช้งานในสภาพแวดล้อมการผลิต; คุณสามารถสำรวจตัวเลือกการกำหนดราคาได้ที่ https://purchase.conholdate.com/pricing/total/family/ หรือรับใบอนุญาตชั่วคราวสำหรับการทดสอบที่ https://purchase.conholdate.com/temporary-license/. เมื่อรวม SDK แล้ว คุณสามารถเพิ่มการหมุนภาพที่เชื่อถือได้ในกระบวนการทำงานใด ๆ ที่ใช้ Java.

คำถามที่พบบ่อย

  • ฉันจะหมุนไฟล์รูปภาพใน Java โดยใช้ Conholdate.Total ได้อย่างไร?
    ใช้คลาส ImageConvertOptions เพื่อตั้งค่ามุมการหมุนที่ต้องการและจากนั้นเรียก handler.convert(inputPath, outputPath, options) ตามที่แสดงในตัวอย่างข้างต้น.

  • ฉันสามารถหมุนภาพ PNG และ JPG ด้วยโค้ดเดียวกันได้หรือไม่?
    ใช่, SDK จะตรวจจับรูปแบบของไฟล์โดยอัตโนมัติ ให้ระบุนามสกุลไฟล์ที่ถูกต้องในเส้นทางอินพุตและโค้ดเดียวกันจะทำงานได้กับ PNG และ JPG.

  • ตัวเลือกใดบ้างที่มีให้ปรับแต่งกระบวนการหมุน?
    คุณสามารถปรับมุมการหมุน, สีพื้นหลัง, คุณภาพของผลลัพธ์, และเลือกว่าจะเก็บเมตาดาต้าหรือไม่. ดูที่ ImageConvertOptions API เพื่อดูรายการทั้งหมด.

  • ฉันต้องการใบอนุญาตเพื่อใช้ฟีเจอร์นี้ในสภาพแวดล้อมการผลิตหรือไม่?
    จำเป็นต้องมีใบอนุญาตที่ถูกต้องสำหรับการใช้งานในสภาพแวดล้อมการผลิต รับใบอนุญาตชั่วคราวเพื่อการประเมินที่ https://purchase.conholdate.com/temporary-license/ หรือดูรายละเอียดการกำหนดราคาครบถ้วนที่ https://purchase.conholdate.com/pricing/total/family/.

อ่านเพิ่มเติม