IN NAM DU TOOLS 3.9.0 - PLUGIN NATIVE CHO CORELDRAW
=================================================

PHẠM VI TƯƠNG THÍCH
- CorelDRAW X7 đến CorelDRAW 2026, bản 64-bit.
- Không hỗ trợ CorelDRAW 12, X3, X4, X5, X6 trong gói plugin này.
- Windows phải có .NET Framework 4.x (thông thường đã có sẵn).

CÀI ĐẶT
1. Giải nén toàn bộ file ZIP ra một thư mục.
2. Đóng tất cả cửa sổ CorelDRAW.
3. Bấm đúp Setup-InNamDu-Plugin.hta.
4. Chọn CÀI PLUGIN và đồng ý quyền Administrator.
5. Mở CorelDRAW, vào Window > Dockers > IN NAM DU Tools.

Nếu cài đặt báo lỗi, gửi file InNamDu-Plugin-Install.log nằm trên Desktop
để kiểm tra chính xác thành phần Corel hoặc .NET còn thiếu.

Nếu tên docker chưa hiện sau lần cài đầu:
- Sao lưu workspace tùy chỉnh nếu đang dùng.
- Khởi động CorelDRAW trong khi giữ F8 và xác nhận đặt lại workspace.
- Lưu ý: F8 sẽ xóa các tùy chỉnh workspace hiện tại, chỉ dùng khi thật cần.

CHỨC NĂNG 3.8
- XẾP FILE: xếp một mẫu hoặc nhiều đối tượng khác kích thước trên cùng khổ;
  tự xoay 90 độ, lấp khoảng trống; thêm xếp thẳng hàng cho các đối tượng cùng kích thước.
- DẤU CẮT: tạo dấu tại từng đường chia nhưng chỉ ở chu vi ngoài của cả cụm;
  có thể lùi riêng trái/phải/trên/dưới cho đối tượng. Ví dụ 50×50 mm lùi mỗi
  phía 1 mm cho vùng dấu 48×48 mm. Dấu khổ giấy luôn nằm trong trang.
- KÍCH THƯỚC: vẽ đường dóng, đường kích thước, vạch đầu và số đo ở bốn phía;
  cho phép chọn màu riêng cho toàn bộ thước.
- NHẢY DỮ LIỆU: đọc CSV/TXT UTF-8, gắn trường chữ, nhảy số tự động,
  thay hình theo cột dữ liệu hoặc theo thư mục; danh sách tên trường lấy trực tiếp
  từ dòng tiêu đề CSV/TXT; hỗ trợ lưới cố định và sáu hướng chạy dữ liệu.
  Thư mục ảnh hiển thị danh sách đánh số, cho phép đưa ảnh lên/xuống. Khi chọn
  trường HINH, ảnh thứ 1 gắn dòng dữ liệu 1, ảnh thứ 2 gắn dòng 2 và tiếp tục.
- CHỈNH ẢNH: xoay/lật, xem BCI tức thì khi kéo, vector hóa PowerTRACE,
  tạo đường cắt sticker theo phần ảnh PNG nhìn thấy, chỉnh DPI và chuyển CMYK/RGB.
- Đã bỏ phần đổi kích thước ảnh theo yêu cầu.
- MÃ VẠCH DỮ LIỆU: Code 128, EAN-13, EAN-8, UPC-A, Code 39, ITF-14
  và Interleaved 2 of 5; mã được dựng bằng đối tượng vector trực tiếp trong CorelDRAW.
- ĐĂNG NHẬP: khung đăng nhập gọn nằm phía trên giao diện; chỉ tài khoản có
  bản quyền corel-tool còn hạn mới mở và sử dụng được các tab công cụ.

CÁCH DÙNG TAB NHẢY DỮ LIỆU
1. Tệp CSV có dòng đầu là tên cột, ví dụ: TEN,SDT,HINH.
2. Chọn một đối tượng chữ, nhập tên cột (ví dụ TEN), bấm GẮN VÀO CHỮ.
3. Nếu nhảy số: nhập tên trường MA, khoảng số và bấm GẮN TRƯỜNG SỐ VÀO CHỮ.
4. Nếu nhảy ảnh: chọn hình chữ nhật làm khung, chọn nguồn ảnh rồi bấm GẮN KHUNG ẢNH.
5. Chọn toàn bộ mẫu gồm chữ, khung ảnh và nền; bấm TẠO BẢN DỮ LIỆU.

QUY ƯỚC DỮ LIỆU
- CSV nhận dấu phẩy, dấu chấm phẩy hoặc Tab; giữ nguyên tiếng Việt UTF-8.
- Đường dẫn ảnh tương đối trong CSV được tính từ thư mục chứa tệp CSV.
- Ảnh hỗ trợ: PNG, JPG/JPEG, TIFF, PSD, BMP, GIF và WebP.
- Có thể tự gõ {{TEN}}, {{SDT}}, {{MA}} vào đối tượng chữ thay vì dùng nút gắn.
- Có thể đặt tên khung ảnh là {{IMG:HINH}} trong Object Manager như bản Illustrator cũ.
- Ảnh trong thư mục được sắp xếp tự nhiên: 1, 2, 3 ... 10, 11.
- Mẫu gốc được giữ nguyên; kết quả nằm trên layer NHAY DU LIEU.

LƯU Ý CHỈNH MÀU TỨC THÌ
- Chọn trực tiếp một hoặc nhiều bitmap rồi kéo Sáng / Tương phản / Cường độ.
- Plugin chờ khoảng 0,22 giây sau thao tác kéo để tránh giật.
- Mỗi lần xem trước sẽ thay lần xem trước ngay trước đó, không cộng dồn liên tục.
- Nút ĐẶT LẠI MÀU hoàn tác phần xem trước gần nhất và đưa thanh về 0.

LƯU Ý VECTOR VÀ STICKER
- PowerTRACE cần thành phần vector hóa của CorelDRAW được cài đầy đủ.
- Đường sticker dùng biên ngoài của toàn bộ vùng chọn và đặt trên layer
  DUONG CAT STICKER; màu mặc định là #FF00FF.

GỠ CÀI ĐẶT
- Chạy lại Setup-InNamDu-Plugin.hta và chọn GỠ PLUGIN.
- Khi nâng cấp, phải đóng CorelDRAW; Setup 3.9.0 tự xóa thư mục plugin cũ trước khi cài.

THAY ĐỔI 3.8
- Bản 3.9.0 thống nhất toàn bộ quy trình xếp theo hướng trái sang phải, hết
  hàng mới xuống dưới. Khi Số lần lặp = 0, Tool chỉ ghi nhận một vòng khi đã
  xếp đủ tất cả mẫu, bảo đảm mọi đối tượng được nhân đều trước.
- Nếu tích Lấp kín khoảng trống, sau phần nhân đều Tool mới chọn bất kỳ mẫu
  nào vừa vùng trống còn lại để xếp thêm; mẫu nhỏ không còn chiếm chỗ trước.
- Bản 3.8.9 đổi tên ô thành Số lần lặp và tính theo TỪNG đối tượng: nhập 1
  thì mỗi mẫu một bản, nhập 2 thì mỗi mẫu hai bản. Kết quả xếp liên tiếp từ
  trên xuống dưới, không giãn đều khoảng trống; hết chiều cao mới sang cột.
- Nhập 0 sẽ nhân cân bằng tất cả mẫu đến khi đầy khổ. Tùy chọn lấp kín không
  đều được đổi thành ô tích; khi bật, mẫu vừa khoảng trống có thể được nhân nhiều hơn.
- Bản 3.8.8 sửa Giới hạn tổng số bản: nhập 0 luôn tự nhân đến đầy sức chứa
  của khổ; nhập số lớn hơn 0 sẽ dừng đúng giới hạn hoặc khi hết chỗ.
- Thêm chế độ Nhân đều nhiều đối tượng khác nhau: ưu tiên giữ số lượng mỗi
  mẫu cân bằng, kể cả khi các mẫu có kích thước khác nhau.
- Thêm chế độ Lấp kín khoảng trống, không cần lặp đều: tự chọn mẫu và hướng
  xoay phù hợp nhất cho từng vùng trống để tận dụng khổ in.
- Bản 3.8.7 sửa thời gian dòng thông báo: số giây đặt trên Server là tổng
  thời gian hiển thị. Ví dụ 15 giây thì hết 15 giây thanh sẽ dừng và tự ẩn,
  không chạy lặp vô hạn như trước.
- Bản 3.8.6 thêm chữ gợi ý Tài khoản/Email và Mật khẩu ngay trong các ô
  đăng nhập, đăng ký; chữ tự ẩn khi nhập và hiện lại khi xóa nội dung.
- Khi đã đăng nhập, nút QUẢN LÝ TÀI KHOẢN nằm ở góc phải cùng hàng tên Tool.
- Bản 3.8.5 đổi khung tài khoản theo hai chế độ Đăng nhập/Đăng ký. Khi đăng
  nhập thành công, toàn bộ biểu mẫu được ẩn và chỉ còn nút QUẢN LÝ TÀI KHOẢN.
- Dòng thông báo tuân theo trạng thái Bật/Tắt riêng của corel-tool và tốc độ
  số giây đặt trên Server; bản ghi riêng đang Tắt không còn rơi về dòng chung.
- Bản 3.8.4 thêm nút mắt cho mật khẩu đăng nhập/đăng ký, ghi nhớ email và
  token; khi mở lại Corel sẽ tự xác thực phiên và không yêu cầu đăng nhập lại.
- Bản 3.8.3 hiển thị dòng thông báo chạy ngang phía trên, lấy trực tiếp từ
  /api/ticker của License Server theo mã sản phẩm corel-tool.
- Bản 3.8.2 tách Quản lý tài khoản thành màn hình riêng, không chiếm vùng tab
  chức năng; thêm Quên mật khẩu và tự ẩn đăng ký sau khi đăng nhập thành công.
- Bản 3.8.1 bổ sung đăng ký tài khoản, quản lý gói, hiển thị giá, hạn dùng,
  Serial Key, kích hoạt key và nút mua gói trong khung thu gọn phía trên.
- Bỏ tab Tài khoản riêng và bỏ chức năng Cắt sát ảnh trong suốt.
- Ảnh dữ liệu fit đủ chiều ngang khung và giữ đúng tỷ lệ ảnh.
- Nhóm mã vạch vector có kích thước ngoài đúng bằng khung chữ nhật đã gắn.
- Khóa toàn bộ công cụ trước khi đăng nhập; đăng xuất sẽ khóa lại ngay.
- Đưa Xếp thẳng hàng lên đầu và đặt làm chế độ mặc định; giới hạn số bản bằng 0
  nghĩa là tự xếp đầy khổ giấy.
- Sửa thuật toán để giá trị 0 thực sự nhân lặp đến toàn bộ sức chứa của khổ,
  thay vì chỉ xếp một lần số đối tượng gốc.

SỬA LỖI 3.7
- Bản 3.7.1 sửa cấu trúc GroupBox của tab Tài khoản gây lỗi MC3089 khi biên dịch bộ cài.
- Nhập ảnh dữ liệu không truyền tham số bộ lọc COM, tránh lỗi "Could not convert argument 0 for call to Import".
- Cắt sát alpha xuất chính đối tượng đang chọn qua Document.ExportBitmap rồi mới cắt PNG,
  tránh lỗi HRESULT E_FAIL của Bitmap.SaveAs trên một số phiên bản CorelDRAW.
- Thêm tài khoản và thanh toán trực tiếp qua API, gắn bản quyền theo mã máy và sản phẩm corel-tool.
- Thêm trường mã vạch dữ liệu và sinh mã vạch vector theo từng dòng CSV/TXT.

SỬA LỖI 3.6
- Chế độ thư mục không còn tự đổi trường ảnh sang mã nội bộ __FOLDER_IMAGE__.
- Khung ảnh giữ đúng tên trường đã chọn và nhận ảnh theo thứ tự danh sách.
- Danh sách ảnh dùng sắp xếp tên tự nhiên: 1, 2, 3 ... 10, 11; có thể đổi tay.

XỬ LÝ LỖI
- "Không tìm thấy CorelDRAW": chỉ nhận bản 64-bit X7–2026 cài trong Program Files.
- "Thiếu Corel.Interop.VGCore.dll": chạy Repair CorelDRAW hoặc cài đủ thành phần SDK/VSTA.
- Lỗi biên dịch: bật/cài .NET Framework 4.x trong Windows Features rồi chạy Setup lại.
- Khi thao tác ảnh, phải chọn trực tiếp bitmap; group/vector không được coi là bitmap.
