Scripting & Core API

Μπορείτε να διαχειριστείτε τις δυνατότητες του 3DСoat με τη βοήθεια του σεναρίου.
Εκτελέστε ή δημιουργήστε νέες εντολές χρησιμοποιώντας δέσμες ενεργειών ή μεταγλωττίζοντάς τες με πρόσβαση στο Core API.

Η αρχή είναι αρκετά εύκολη. Απλώς χρησιμοποιήστε το Μενού Σεναρίων → Δημιουργήστε το σενάριο σας ή Δημιουργήστε ένα νέο σενάριο Core API .

Μενού σεναρίων

– Η Scripting είναι μια σειρά από εντολές που μπορούν να εκτελεστούν χωρίς μεταγλώττιση.
Όταν επιλέγουμε ένα εργαλείο ή εκτελούμε μια συνάρτηση, εκτελούμε μια εντολή που περιλαμβάνεται ήδη στο πρόγραμμα. Η δημιουργία ενός σεναρίου μας επιτρέπει να συνδυάσουμε αυτές τις εντολές για να εκτελέσουμε αυτόματα μια σειρά βημάτων που επιταχύνουν την εργασία μας.

– Το Core API (Application Programming Interface) δεν είναι μόνο το σενάριο. ο κώδικας που γράφετε εκτελείται με την πλήρη ταχύτητα της μεταγλωττισμένης C++.
Είναι μια ισχυρή μέθοδος για την επέκταση της λειτουργικότητας του 3DCoat. Μπορείτε να αυτοματοποιήσετε την εργασία ή να προσθέσετε κυρίως νέα εργαλεία.

Scripting

Το 3DCoat χρησιμοποιείτην AngelScript , η οποία είναι μια γλώσσα που μοιάζει με C++. Το σενάριο είναι ένα αρχείο κειμένου με εντολές που εκτελούνται με προσωπική σειρά.

Αυτή η εντολή μπορεί να γίνει γνωστή με την εγγραφή της στη μνήμη πατώντας ταυτόχρονα τη συνάρτηση RMB+MMB. Ανοίγοντας ένα σημειωματάριο και επικολλώντας το, θα λάβουμε το κείμενο της αντίστοιχης εντολής. Είναι χρήσιμο να το προβάλετε και να το επεξεργαστείτε στο Notepad++ (επιλέξτε σύνταξη “C”). Στη συνέχεια, εκτελέστε το σενάριο μέσω του μενού αρχείου “Σενάρια / Εκτέλεση Σεναρίου”.

Core API

Το Core API είναι μια ισχυρή μέθοδος για την επέκταση της λειτουργικότητας του 3DCoat. Μπορείτε να αυτοματοποιήσετε την εργασία ή να προσθέσετε κυρίως νέα εργαλεία.
Αυτό δεν είναι μόνο το σενάριο. ο κώδικας που γράφετε εκτελείται με την πλήρη ταχύτητα της μεταγλωττισμένης C++.

Το σενάριο Core API είναι ένα συμβατό πρόγραμμα C++17 που λειτουργεί με την πλήρη εγγενή ταχύτητα C++. Αυτό είναι πολύ περισσότερο από ένα απλό σενάριο. Μπορείτε να κάνετε ακόμη και χρονικά κρίσιμες και πολλαπλών νημάτων εργασίες και να προσαρμόσετε το 3DCoat σε βάθος, δημιουργώντας κυρίως νέες λειτουργίες και εργαλεία.

Αλλά η όλη διαδικασία είναι απολύτως διαφανής για εσάς. Δεν χρειάζεται να διαμορφώσετε τίποτα ή να διαχειριστείτε πολύπλοκες διαμορφώσεις έργου. Το 3DCoat θα σας οδηγήσει σε όλη τη διαδικασία με έναν απλό οδηγό.

* Το Core API λειτουργεί σωστά για χρήστες με μη αγγλικά ονόματα χρηστών, όλη η διαδικασία εγκατάστασης είναι πλέον εξαιρετικά εύκολη.

* Η διαδικασία μεταγλώττισης CoreAPI άλλαξε ουσιαστικά. Τώρα χρησιμοποιείται μόνο το Visual Studio . δεν χρειάζεται clang-cl. Απλοποιεί τη χρήση επειδή χρειάζεται να εγκαταστήσετε μόνο ένα πρόσθετο λογισμικό, όχι δύο όπως πριν. Η διαδικασία λήψης και εγκατάστασης είναι πλήρως αυτοματοποιημένη.

* Το Core API υποστηρίζει και έγχρωμα voxel.

---

Python API

Το 3DCoat Python API προορίζεται να ενεργοποιεί εντολές διεπαφής χρήστη, να λειτουργεί πάνω από τη σκηνή και να δημιουργεί νέα εργαλεία. Είναι πολύ παρόμοιο με το C++ Core API, αλλά έχει τα δικά του πλεονεκτήματα και μειονεκτήματα.

• Δεν χρειάζεται καμία πρόσθετη ρύθμιση για τη δημιουργία των σεναρίων σας. Η Python είναι ενσωματωμένη στη διανομή 3DCoat .
• Η Python είναι σαν ένα ελβετικό μαχαίρι, που σας επιτρέπει να φέρετε όλη τη δύναμη των βιβλιοθηκών Python στο 3DCoat.
• Η Python είναι πολύ πιο αργή από την C++, επομένως μπορεί να χρησιμοποιηθεί μόνο για γενική διαχείριση, όχι για βαθιούς και πολύπλοκους αλγόριθμους.
• Εάν είστε ήδη εξοικειωμένοι με το C++ Core API, το Python API είναι πολύ παρόμοιο, σχεδόν 1:1, με την ίδια λογική και ονόματα συναρτήσεων.

---

Πώς να ξεκινήσετε;

Η αρχή είναι αρκετά εύκολη. Απλώς χρησιμοποιήστε σενάρια→Δημιουργία νέου σεναρίου Core API
Στη συνέχεια, επιλέξτε το πρότυπο και επιλέξτε μια διαδρομή για το έργο σας.

Εάν είναι εγκατεστημένο το Visual Studio (ή Visual Studio Code), θα ξεκινήσει με το νέο σας αρχείο. Κάθε παράδειγμα είναι καλά τεκμηριωμένο και χρησιμοποιεί σχετικά απλή σύνταξη, επομένως είναι εύκολο να κατανοηθεί από εύκολο σε σύνθετο.

 Δεν χρειάζεται να ορίσετε καμία τυπική σύνταξη στο VStudio.
 Απλώς πληκτρολογήστε κώδικα και εκτελέστε το σε 3DCoat, όχι στο Visual Studio.
 Το VStudio είναι ακριβώς σαν ένα πρόγραμμα επεξεργασίας κειμένου εκεί που μπορεί να δείχνει συμβουλές και βοήθεια κατά την κωδικοποίηση.
 Γράψτε τον κώδικά σας στο VStudio και αποθηκεύστε το *.cpp, ανοίξτε το σε 3DC και εκτελείται αυτόματα. 

---

Παραδείγματα

Η εξέταση των Παραδειγμάτων είναι ο καλύτερος τρόπος για να κατανοήσετε το API.

Χρησιμοποιήστε Scripts→ Δημιουργήστε μια νέα δέσμη ενεργειών Core API για να πειραματιστείτε με αυτά τα παραδείγματα.