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 kodpoint = 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 kodvector = 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 kodtransform = 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 kodbox = 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 kodredColor = 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 kodvalue = 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 kodplane = 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 kodline = 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 kodarc = 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:

ObiektTypFunkcja
Point3D.createGeometriaTworzy punkt w przestrzeni 3D.
Vector3D.createGeometriaTworzy wektor w przestrzeni 3D.
Matrix3D.createTransformacjaTworzy macierz transformacji.
Color.createWizualizacjaDefiniuje kolor RGBA.
ValueInput.createBy...MatematykaUstawia liczby dla parametrów.
Plane.createGeometriaTworzy płaszczyznę w przestrzeni.
BoundingBox3D.createAnalizaDefiniuje 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.