AutoDistribute adalah macro VBA untuk CorelDRAW yang dirancang untuk mengatur dan mendistribusikan objek Design dan Cut Line secara otomatis ke page dan layer yang sesuai.
Macro ini dibuat untuk mengurangi pekerjaan manual saat menyiapkan file produksi cutting, terutama ketika banyak objek harus dipindahkan, dipasangkan, diposisikan, atau disusun ke beberapa page dengan aturan yang konsisten.
AutoDistribute menyediakan model Kiss A, Die A, dan Free, serta pengaturan Sequentially, rotasi objek, page size, dan pengelolaan layer sensor.
Objek yang akan diproses terlebih dahulu dimasukkan ke dalam antrean sebagai:
DesignCut Line
Setiap objek disimpan berdasarkan StaticID, sehingga macro dapat mencari kembali objek yang sama ketika proses dijalankan.
Antrean ditampilkan melalui lbxObjects dengan format seperti:
Design | Obj. ID: /12345
atau:
Cut Line | Obj. ID: /12346
Objek dalam group maupun Master Page tetap dapat ditemukan selama StaticID masih tersedia.
Antrean hanya dapat berisi objek dari satu dokumen dan akan dikosongkan ketika UserForm ditutup.
Mode Kiss A digunakan ketika Design dan Cut Line perlu ditempatkan sebagai pasangan pada page yang sama.
Secara umum:
- Design ditempatkan pada
Layer 1. - Cut Line ditempatkan pada
Layer 2. - Posisi awal Design dan Cut Line berada di tengah page; keduanya digeser bersama bila perlu menghindari mark.
- Cut Line diberi outline CMYK 0, 100, 100, 0.
- Cut Line tetap aktif untuk print/export.
- Design pada page yang memiliki Cut Line dinonaktifkan dari print/export.
Tanpa Sequentially, jumlah Design dan Cut Line harus sama.
Contoh antrean:
Design 1, Design 2, Cut Line 1, Cut Line 2
akan diproses sebagai:
Page 1 → Design 1 + Cut Line 1
Page 2 → Design 2 + Cut Line 2
Urutan kategori di dalam antrean tidak digunakan sebagai pasangan langsung. Macro mengumpulkan Design dan Cut Line, kemudian memasangkannya berdasarkan urutan masing-masing.
Ketika Sequentially aktif, urutan antrean menjadi bagian dari aturan pemrosesan.
Contoh:
D1, D2, C1, D3, D4, D5, C2
akan menghasilkan:
Page 1 → D1 + C1
Page 2 → D2
Page 3 → D3 + C2
Page 4 → D4
Page 5 → D5
Cut Line dipasangkan dengan Design pertama sejak awal antrean atau sejak Cut Line sebelumnya.
Design yang tidak memiliki pasangan Cut Line tetap diproses dan tetap aktif untuk print/export.
Cut Line yang tidak memiliki Design sebelumnya pada segment yang sama akan dianggap sebagai antrean yang tidak valid.
Mode Die A menempatkan setiap objek pada page terpisah.
Tanpa Sequentially, Design dan Cut Line dipasangkan berdasarkan urutan masing-masing, tetapi setiap objek tetap mendapat page sendiri.
Contoh:
Design 1, Design 2, Cut Line 1, Cut Line 2
diproses menjadi:
Page 1 → Design 1
Page 2 → Cut Line 1
Page 3 → Design 2
Page 4 → Cut Line 2
Cut Line pada mode Die A diberi outline RGB 255, 0, 255 (#FF00FF).
Objek ditempatkan pada Layer 1 dan tetap aktif untuk print/export.
Setelah proses selesai, macro memeriksa layer lokal bernama Layer 2, Layer 3, dan seterusnya. Layer tersebut hanya akan dihapus apabila kosong. Layer yang masih memiliki objek akan dipertahankan dan dilaporkan kepada user.
Ketika Sequentially digunakan pada Die A, macro mengikuti urutan lbxObjects secara langsung.
Setiap entry memperoleh satu page sendiri sesuai posisi entry tersebut di dalam antrean.
Mode ini berguna ketika urutan Design dan Cut Line sudah ditentukan langsung oleh user dan tidak perlu dipasangkan kembali oleh macro.
Kiss A dan Die A menggunakan area 320 × 470 mm yang berpusat pada page. Ukuran Design dan Cut Line setelah rotasi sama-sama harus muat. Untuk pasangan, kontur Cut Line menjadi acuan pemeriksaan mark; Design tanpa pasangan diperiksa memakai geometrinya sendiri. Bitmap standalone memakai bounds persegi bitmap, termasuk bagian transparan di dalam bounds.
| Model | Zona mark | Pusat pada sheet acuan 325 × 485 mm, dari kiri bawah |
|---|---|---|
| Kiss A | Empat persegi 10 × 10 mm | (6; 10), (6; 475), (319; 10), (319; 475) |
| Kiss A | Satu persegi 12 × 12 mm | (162,5; 11,5) |
| Die A | Empat ellipse 11 × 11 mm | (11; 11), (11; 474), (314; 11), (314; 474) |
Sheet acuan mark berpusat pada page dan tidak diskalakan mengikuti ukuran page. Pemeriksaan tidak membuat sensor atau mark fisik.
Jika posisi tengah mengenai mark, macro mencari pergeseran X/Y aman pada kandidat berjarak 0,2 mm dan posisi batas ruang gerak, dengan maksimal 50.000 probe per pencarian. Pasangan selalu memakai pergeseran yang sama, termasuk pada page terpisah Die A. Untuk Die A Sequentially, pasangan pergeseran mengikuti urutan masing-masing role; entri yang tidak berpasangan diperiksa sendiri, dan urutan page tetap mengikuti daftar.
Kiss A mengutamakan mark nominal penuh: pencarian di dalam area dahulu, lalu pergeseran hingga 0,6 mm melewati setiap sisi area. Ukuran kelompok sendiri tetap harus muat dalam 320 × 470 mm. Jika belum aman, Kiss A mencoba toleransi penetrasi mark 0,2 mm di dalam area nominal. Die A memakai toleransi mark 0,2 mm tanpa allowance area.
Seluruh antrean diperiksa sebelum page diubah atau objek dipindahkan. Jika pencarian tidak menemukan posisi aman, Process menampilkan MsgBox dan form tetap terbuka. Pilih Free untuk mencoba distribusi tanpa batas area dan mark. Penolakan posisi juga mempertahankan action Process yang sedang menunggu di MacroRunner.
Free (optFree) memakai aturan distribusi Kiss A, termasuk pasangan pada page yang sama, Layer 1/Layer 2, print/export, warna Cut Line, dan perilaku Sequentially. Objek dipusatkan setelah rotasi tanpa pemeriksaan batas area 320 × 470 mm atau forbidden mark.
Free dapat menempatkan objek melampaui tepi page. Ukuran page untuk Process Free mengikuti Kiss A, yaitu 335 × 487 mm.
AutoDistribute menyediakan dua pilihan rotasi:
- CW -90° — memutar objek 90° searah jarum jam.
- CCW +90° — memutar objek 90° berlawanan arah jarum jam.
Kedua pilihan bersifat saling eksklusif.
Jika tidak ada pilihan yang aktif, objek tidak akan diputar.
Setelah rotasi dilakukan, posisi awal objek berada di tengah page tujuan. Kiss A dan Die A menyesuaikan posisi pasangan untuk menghindari mark; Free mempertahankan posisi tengah.
AutoDistribute menyediakan beberapa pengaturan page yang dapat digunakan langsung dari Main UserForm.
Mengatur Master Page dan seluruh page dokumen menjadi:
325 × 485 mm
Mengatur Master Page dan seluruh page dokumen menjadi:
335 × 487 mm
Process Kiss A dan Free mengatur page menjadi 335 × 487 mm, sedangkan Die A memakai 325 × 485 mm. Jika distribusi memerlukan page tambahan, ukurannya mengikuti lebar dan tinggi Page 1 setelah pengaturan tersebut.
MasterPage mengatur page menjadi 325 × 485 mm dan memindahkan layer sensor lokal dari Active Page menjadi Master Layer.
Layer sensor yang diproses adalah:
scpro2_printmarginscpro2_regmarksscpro2_printonly
Urutan layer dijaga dari atas ke bawah sebagai:
scpro2_printmargin
scpro2_regmarks
scpro2_printonly
Setelah page setup selesai, Layer 1 pada page lokal diaktifkan untuk print/export, sedangkan Layer 2 dinonaktifkan.
PerPage mengembalikan layer sensor dari status Master menjadi layer lokal pada Active Page.
Ukuran page juga diatur menjadi:
325 × 485 mm
Urutan ketiga layer sensor tetap dipertahankan dengan aturan yang sama seperti pada MasterPage.
Setelah proses selesai, Layer 1 pada page lokal diaktifkan untuk print/export dan Layer 2 dinonaktifkan.
- Buka dokumen CorelDRAW yang ingin diproses.
- Jalankan AutoDistribute.
- Seleksi satu atau beberapa objek Design.
- Tekan Set Design.
- Seleksi satu atau beberapa objek Cut Line.
- Tekan Set Cut Line.
- Periksa urutan objek pada
lbxObjects. - Pilih Kiss A, Die A, atau Free.
- Aktifkan
Sequentiallyjika urutan antrean ingin digunakan sebagai aturan pemrosesan. - Pilih rotasi jika diperlukan.
- Gunakan pengaturan page atau sensor layer jika diperlukan.
- Tekan Process.
AutoDistribute akan memvalidasi antrean dan dokumen sebelum memindahkan objek.
AutoDistribute menggunakan StaticID untuk menyimpan referensi objek, bukan teks yang tampil pada ListBox.
Karena itu, lbxObjects hanya berfungsi sebagai representasi visual dari antrean.
Beberapa aturan penting:
- Objek yang sama tidak ditambahkan dua kali ke antrean.
- Antrean hanya dapat menggunakan satu dokumen sumber.
- Dokumen sumber harus aktif ketika
Processdijalankan. - Objek yang tidak lagi dapat ditemukan melalui
StaticIDakan membatalkan proses. - Pencarian mencakup page biasa, Master Page, dan objek di dalam group.
- Remove menghapus entry terpilih dari antrean tanpa menghapus objek CorelDRAW.
- Clear mengosongkan seluruh antrean tanpa menghapus objek CorelDRAW.
- Menutup UserForm juga mengosongkan antrean.
Sebelum memodifikasi dokumen, AutoDistribute menyelesaikan referensi seluruh objek, membangun execution plan, lalu memeriksa seluruh posisi hasil termasuk rotasi, batas area, dan mark untuk Kiss A/Die A.
Perubahan dokumen dijalankan di dalam CorelDRAW CommandGroup agar operasi lebih terkontrol dan dapat ditangani sebagai satu kelompok perubahan.
Page setup dan distribusi Process berada dalam satu CommandGroup. Grup ditutup sebelum pesan hasil dan juga pada jalur error. CommandGroup mengelompokkan Undo; error saat perubahan dokumen berjalan dapat menyisakan hasil sebagian yang perlu dibatalkan dengan Undo.
Process yang berhasil mempertahankan unit automasi serta penggaris horizontal/vertikal dalam milimeter dan mengaktifkan kembali page awal. Penolakan posisi pada tahap pemeriksaan memulihkan unit automasi sementara tanpa mengubah page, layer, atau objek.
Untuk operasi page setup, macro juga memeriksa keberadaan layer tujuan dan jumlah objek setelah perpindahan layer sensor.
Jika kondisi yang tidak aman ditemukan, proses dihentikan dan informasi operasi yang gagal ditampilkan kepada user.
Code-behind untuk Main UserForm.
Mengatur interaksi UI seperti:
- pemilihan Kiss A / Die A / Free;
- CW / CCW rotation;
- Sequentially;
- Set Design / Set Cut Line;
- Remove / Clear;
- Default Size / Extended Size;
- MasterPage / PerPage;
- Process.
Core engine AutoDistribute.
Modul ini menangani:
- penyimpanan Object Container;
- pencarian objek berdasarkan
StaticID; - execution planning;
- distribusi page dan layer;
- Kiss A / Die A / Free;
- Sequentially;
- rotation dan centering;
- Cut Line outline;
- page setup;
- sensor layer conversion;
- cleanup layer;
- validation dan error handling.
ADMarkPlanner merencanakan pergeseran setiap pasangan atau entri standalone. ADMarkGeometry menyimpan salinan kurva untuk pemeriksaan mark tanpa mengubah geometri sumber. Aturan preset dan pencarian mengacu pada implementasi AA; kedua class ini dipasang lokal pada GMS AutoDistributeUF.
Entry point AutoDistributeMenu di src/wizard/ membuka UserForm AutoDistributeMenu secara vbModeless.
Mencatat penambahan fitur, perubahan behavior, perbaikan, dan perkembangan AutoDistribute.
AutoDistribute dibuat untuk workflow produksi tertentu di CorelDRAW. Beberapa behavior—terutama nama layer, ukuran page, warna Cut Line, dan aturan Kiss A / Die A—bersifat spesifik terhadap workflow tersebut.
Macro tidak dimaksudkan sebagai generic page distribution engine untuk seluruh kemungkinan struktur dokumen CorelDRAW.
Perubahan pada nama layer atau struktur dokumen dapat memerlukan penyesuaian pada source code.
Pada UserForm AutoDistributeMenu, siapkan OptionButton optFree bersama optKissA dan optDieA. Ketiganya saling eksklusif. Pasang code-behind src/forms/AutoDistributeMenu.vba pada form tersebut.
Tambahkan Class Module headerless bernama ADMarkPlanner dan ADMarkGeometry, lalu isi dengan source dari src/classes/. Perbarui Standard Module AutoDistributeObjectStore dan Class Module ADBehaviorContract pada GMS yang sama. Kontrak MacroBehavior menerima optFree=True, False, Default, dan instruksi skip sebagaimana pilihan model lain.
AutoDistribute saat ini mencakup:
- Object Container berbasis
StaticID; - Design dan Cut Line roles;
- Kiss A;
- Die A;
- Free tanpa batas area atau mark;
- Sequential processing;
- CW / CCW rotation;
- automatic centering dan pergeseran aman terhadap mark;
- automatic page distribution;
- automatic page creation;
- Default dan Extended page size;
- MasterPage / PerPage sensor management;
- Master Page dan nested group object lookup;
- Cut Line color assignment;
- layer print/export handling;
- empty Die layer cleanup;
- validation dan operation-specific error reporting.
Pengembangan berikutnya dapat memperluas workflow ini tanpa mengubah fungsi utama AutoDistribute sebagai alat untuk mengurangi pekerjaan distribusi objek secara manual di CorelDRAW.
Source boleh dipelajari dan dikembangkan, dan issue/feedback tentang bug, edge case, CorelDRAW API, architecture, atau improvement sangat dihargai.