Obiekty adsk.core
Fusion 360 API udostępnia wiele klas z przestrzeni nazw adsk.core, które są często wykorzystywane w projektach CAD. Wiele z nich ma metodę .create(), służącą do tworzenia obiektów geometrycznych, wizualnych i matematycznych. Oto lista najczęściej używanych obiektów z adsk.core, które można tworzyć za pomocą metody .create():
1. Obiekty geometryczne
Te obiekty definiują punkty, linie, wektory, macierze, itp.
a) Point3D (Punkt w przestrzeni 3D)
- Reprezentuje współrzędne punktu w przestrzeni 3D.
- Tworzenie:pythonSkopiuj kod
point = adsk.core.Point3D.create(10, 20, 30) # Punkt w (x=10, y=20, z=30) - Przykłady użycia:
- Definiowanie punktów w szkicach.
- Ustalanie pozycji początkowej elementów.
b) Vector3D (Wektor w przestrzeni 3D)
- Reprezentuje kierunek i wielkość przesunięcia w przestrzeni 3D.
- Tworzenie:pythonSkopiuj kod
vector = adsk.core.Vector3D.create(1, 0, 0) # Wektor wzdłuż osi X - Przykłady użycia:
- Definiowanie kierunków (np. kierunek przesunięcia lub obrotu).
- Operacje matematyczne, takie jak dodawanie wektorów, normalizacja, itp.
c) Matrix3D (Macierz transformacji 3D)
- Reprezentuje transformacje w przestrzeni 3D (np. przesunięcie, obrót, skalowanie).
- Tworzenie:pythonSkopiuj kod
transform = adsk.core.Matrix3D.create() # Tworzy macierz jednostkową - Przykłady użycia:
- Przesuwanie, obracanie lub skalowanie komponentów.
- Zastosowanie niestandardowych transformacji do geometrii.
d) BoundingBox3D (Prostopadłościan ograniczający)
- Reprezentuje minimalne granice obiektu w przestrzeni 3D.
- Tworzenie:pythonSkopiuj kod
box = adsk.core.BoundingBox3D.create(minPoint, maxPoint) - Przykłady użycia:
- Obliczanie przestrzeni zajmowanej przez obiekt.
- Analiza kolizji lub ustawianie tolerancji.
2. Obiekty wizualne i kolorystyczne
a) Color (Kolor RGBA)
- Reprezentuje kolor w formacie RGBA (czerwony, zielony, niebieski, alfa).
- Tworzenie:pythonSkopiuj kod
redColor = adsk.core.Color.create(255, 0, 0, 255) # Czerwony, pełna nieprzezroczystość - Przykłady użycia:
- Ustawianie kolorów elementów projektu.
- Tworzenie wizualizacji lub wyróżnianie wybranych obiektów.
3. Obiekty matematyczne
a) ValueInput (Wartość wejściowa)
- Reprezentuje wartość liczbową (np. milimetry, stopnie), używaną w wielu funkcjach API.
- Tworzenie:pythonSkopiuj kod
value = adsk.core.ValueInput.createByString("5 mm") # Wartość w milimetrach value2 = adsk.core.ValueInput.createByReal(10.0) # Wartość w jednostkach bezwzględnych - Przykłady użycia:
- Definiowanie rozmiarów szkiców, przesunięć, odległości itp.
4. Obiekty analityczne
a) Plane (Płaszczyzna)
- Reprezentuje płaszczyznę w przestrzeni 3D (położenie + normalna).
- Tworzenie:pythonSkopiuj kod
plane = adsk.core.Plane.create(originPoint, normalVector) - Przykłady użycia:
- Tworzenie niestandardowych płaszczyzn konstrukcyjnych.
- Analiza geometrii w przestrzeni 3D.
b) Line3D (Linia w przestrzeni 3D)
- Reprezentuje nieskończoną linię w przestrzeni 3D.
- Tworzenie:pythonSkopiuj kod
line = adsk.core.Line3D.create(startPoint, endPoint) - Przykłady użycia:
- Analiza geometrii.
- Użycie jako referencji przy konstrukcji szkiców.
5. Inne przydatne obiekty
a) Arc3D (Łuk w przestrzeni 3D)
- Tworzy łuk o zdefiniowanych parametrach.
- Tworzenie:pythonSkopiuj kod
arc = adsk.core.Arc3D.createByThreePoints(startPoint, midPoint, endPoint) - Przykłady użycia:
- Tworzenie zakrzywionych krawędzi lub elementów szkiców.
6. Często używane obiekty w API:
| Obiekt | Typ | Funkcja |
|---|---|---|
Point3D.create | Geometria | Tworzy punkt w przestrzeni 3D. |
Vector3D.create | Geometria | Tworzy wektor w przestrzeni 3D. |
Matrix3D.create | Transformacja | Tworzy macierz transformacji. |
Color.create | Wizualizacja | Definiuje kolor RGBA. |
ValueInput.createBy... | Matematyka | Ustawia liczby dla parametrów. |
Plane.create | Geometria | Tworzy płaszczyznę w przestrzeni. |
BoundingBox3D.create | Analiza | Definiuje granice obiektów. |
Podsumowanie
Najczęściej używane obiekty geometryczne, takie jak Point3D, Vector3D, czy Matrix3D, są podstawą do tworzenia skryptów CAD. Funkcje create() pozwalają szybko i precyzyjnie tworzyć te obiekty i wykorzystywać je w operacjach projektowych, wizualizacyjnych i matematycznych.