Skrypty: Kształt topologiczny

From FreeCAD Documentation
This page is a translated version of the page TopoShape API and the translation is 100% complete.
(listopad 2018 r.) Informacje te mogą być niekompletne i nieaktualne. Najnowsze API - patrz dokumentacja API generowana automatycznie.

Kształt Topologiczny jest obiektem macierzystym modułu Część. Wszystkie typy kształtów (polilinia, ściana, bryła, itd...) modułu Część są Kształtami Topologicznymi i posiadają następujące atrybuty i metody. Przykład:

import Part
sh = Part.makeBox(10,10,10)
print sh.Faces
for f in sh.Faces:
   print f.Edges
Area

Returns: Całkowite pole powierzchni ścian figury.

BoundBox

Returns: Ramka otaczająca obiekt

CenterOfMass

Returns: Środek masy aktualnego układu. Jeżeli pole grawitacyjne jest jednorodne, jest to środek ciężkości. Współrzędne zwracane dla środka masy są wyrażone w bezwzględnym kartezjańskim układzie współrzędnych.

CompSolids

Returns: Wylicza kolejne figury w tym kształcie.

Compounds

Returns: Wylicza kolejne złożenia w tym kształcie.

Edges

Returns: Wylicza kolejne krawędzie w tym kształcie.

Faces

Returns: Wylicza kolejne ściany w tym kształcie.

Length

Returns: Całkowita długość krawędzi kształtu.

Matrix

Returns: Bieżąca transformacja obiektu jako macierz

Orientation

Returns: orientacja kształtu.

Placement

Returns: Bieżąca transformacja obiektu jako umiejscowienie

ShapeType

Returns: Typ kształtu.

Shells

Returns: Wyświetla listę następnych kształtów w tym kształcie.

Solids

Returns: Lista następnych kształtów w tym kształcie.

Vertexes

Returns: Lista wierzchołków w tym kształcie.

Volume

Returns: Całkowita objętość brył tego kształtu.

Wires

Returns: Lista polilinii w tym kształcie.

approximate( )

Description: Dokonuje aproksymacji krzywej złożonej z tej polilinii

Returns: obiekt BSplineCurve

check( )

Description: Sprawdza kształt i zgłasza błędy w strukturze kształtu. Jest to bardziej szczegółowe sprawdzenie jak w isValid().

Returns:

common(TopoShape)

Description: Przecięcie tego i danego kształtu topologicznego.

Returns: kształt topologiczny

complement( )

Description: Oblicza dopełnienie orientacji tego kształtu, tzn. odwraca wewnętrzny/zewnętrzny status granic tego kształtu..

Returns: kształt topologiczny

copy( )

Description: Creates a copy of this shape

Returns: kształt topologiczny

cut(TopoShape)

Description: Różnica pomiędzy obecnym a danym kształtem topologicznym.

Returns: kształt topologiczny

distToShape( TopoShape )

Description: Oblicza minimalną odległość pomiędzy obecnym i podanym kształtem topologicznym..

Returns: float<minimalny dystans>,list<najbliższe punkty>,list<najbliższe kształty podrzędne i parametry>

exportBrep( string )

Description: Eksportuje zawartość obecnego kształtu do pliku BREP. BREP jest natywnym formatem CasCade.

Returns:

exportIges( string )

Description: Eksportuje zawartość kształtu do pliku w formacie IGES.

Returns:

exportStep( string )

Description: Eksportuje zawartość kształtu do pliku w formacie STEP.

Returns:

exportStl( string )

Description: Eksportuje zawartość kształtu do pliku w formacie STL siatka.

Returns:

extrude(Vector)

Description: Wyciąga kształt wzdłuż kierunku.

Returns: kształt topologiczny

fuse(TopoShape)

Description: Połączenie obecnego i danego kształtu topologicznego.

Returns: kształt topologiczny

getAllDerivedFrom( )

Description: Zwraca wszystkie pochodne tego typu obiektu

Returns: lista

hashCode( )

Description: Wartość ta jest obliczana na podstawie wartości bazowego odniesienia kształtu i lokalizacji. Orientacja nie jest brana pod uwagę..

Returns: string

isClosed( )

Description: Sprawdza czy kształt ma formę zamkniętą.

Returns: boolean

isDerivedFrom(string)

Description: Zwraca wartość Prawda, jeśli podany typ jest ojcem.

Returns: boolean

isEqual(TopoShape)

Description: Zwraca wartość Prawda, jeśli oba kształty korzystają z tego samego kształtu topologicznego, mają to samo położenie i mają tę samą orientację.

Returns: boolean

isInside(Vector,float,Boolean)

Description: Sprawdza, czy punkt znajduje się wewnątrz bryły o określonej tolerancji. Jeśli trzeci parametr jest Prawda, punkt na powierzchni jest uważany za wewnętrzny.

Returns: boolean

isNull( )

Description: Sprawdza, czy kształt jest istniejący.

Returns: boolean

isPartner(TopoShape)

Description: Zwraca wartość Prawda, jeśli oba kształty mają ten sam kształt topologiczny, ale mogą mieć inne położenie i orientację.

Returns: boolean

isSame(TopoShape)

Description: Sprawdza czy oba kształty mają tę samą geometrię, zwraca wartość true jeśli oba kształty mają ten sam kształt topologiczny, mają to samo położenie, ale mogą mieć różną orientację.

Returns: boolean

isValid( )

Description: Sprawdza, czy kształt jest poprawny, tzn. czy istnieje, czy nie jest pusty lub uszkodzony.

Returns: boolean

makeFillet(float,TopoShape)

Description: Zwraca nowy obiekt oparty na kształcie topologicznym, ale z zaokrągleniem o promieniu "float" zastosowanym do każdej krawędzi.

Returns: kształt topologiczny

makeHomogenousWires(wire)

Description: Sprawia, że obecna i dany polilinia są jednorodne i mają taką samą liczbę krawędzi

Returns: polilinia

makeOffset(float)

Description: Przesuwa kształt o zadaną wartość.

Returns: kształt topologiczny

makePipe(wire)

Description: Wykonuje rurę przez przeciąganie po polilinii.

Returns: kształt topologiczny

makePipeShell(wire)

Description: Tworzy przeciągnięcie zdefiniowane przez profile wzdłuż polilinii.

Returns: kształt topologiczny

makeShapeFromMesh(mesh)

Description: Tworzy kształt złożony z danych siatki. Uwaga: Powinno być używane tylko dla raczej małych oczek.

Returns: kształt topologiczny

makeThickness(list,float,float)

Description: Bryłę wydrążoną buduje się z bryły wejściowej i zbioru ścian tej bryły, które mają zostać usunięte. Pozostałe ściany bryły stają się ścianami wydrążonej bryły, a ich grubość jest określana w czasie konstrukcji. Przekazywane argumenty to lista ścian, które mają zostać pominięte, grubość ścian oraz wartość tolerancji.

Returns: kształt topologiczny

nullify( )

Description: Niszczy referencję do kształtu przechowywaną w tym kształcie. W wyniku tego kształt ten staje się pusty.

Returns:

project(TopoShape)

Description: Rzutuj kształt na ten kształt.

Returns: kształt topologiczny

read(string)

Description: Wczytuje plik typu IGES, STEP lub BREP.

Returns: kształt topologiczny

reverse( )

Description: Odwraca orientację tego kształtu.

Returns:

revolve(Vector, Vector, float)

Description: Obraca kształt wokół osi o zadany stopień. ex: Part.revolve(Vector(0,0,0),Vector(0,0,1),360) obraca kształt wokół osi Z o 360 stopni.

Returns: kształt topologiczny

rotate(Vector<position>, Vector<direction>, float<angle>)

Description: Obraca ten kształt o wartość kąta w stopniach wokół osi określonej przez położenie i kierunek. np: Shp.rotate(Vector(0,0,0),Vector(0,0,1),180) obróć kształt wokół osi Z o 180 stopni.

Returns:

scale(float<factor>, [Vector<centre>])

Description: Równomiernie skaluje ten kształt o współczynnik. Opcjonalnie określ środek transformacji skalującej.

Returns:

section(TopoShape)

Description: Przekrój tego z danym kształtem topologicznym.

Returns: kształt topologiczny

sewShape( )

Description: Zszywa kształt, jeśli występuje szczelina.

Returns:

tessellate(float)

Description: Tesseluje kształt i zwraca listę wierzchołków i indeksów ścian. Podana wartość "float" jest tolerancją.

Returns: lista

toNurbs( )

Description: Konwersja kompletnej geometrii kształtu na geometrię NURBS. Na przykład, wszystkie krzywe podpierające krawędzie kształtu bazowego są konwertowane na krzywe złożone, a wszystkie powierzchnie podpierające jego ściany są konwertowane na powierzchnie krzywych złożonych.

Returns: krzywa NURBS

transformGeometry(matrix)

Description: Stosuje transformację geometryczną na kopii kształtu. Zastosowana transformacja jest zdefiniowana jako macierz 4x4. Podstawowa geometria poniższych kształtów może zmienić się w krzywą, która obsługuje krawędź kształtu, lub powierzchnię, która obsługuje powierzchnię kształtu. Na przykład, okrąg może zostać przekształcony w elipsę podczas stosowania transformacji powinowactwa. Może się również zdarzyć, że okrąg zostanie wtedy przedstawiony jako krzywa złożona. Przekształcenie jest stosowane do wszystkich krzywych, które obsługują krawędzie kształtu oraz do wszystkich powierzchni, które obsługują ściany kształtu. Uwaga: Jeżeli chcesz przekształcić kształt bez zmiany jego geometrii, użyj metod translate lub rotate.

Returns: kształt topologiczny

transformShape(matrix)

Description: Stosuje transformację na kształcie bez zmiany geometrii bazowej.

Returns:

translate(Vector)

Description: Stosuje przesunięcie do aktualnego położenia tego kształtu.

Returns:

writeInventor( )

Description: Zapisuje siatkę w formacie OpenInventor do łańcucha znaków.

Returns: string

Niektóre atrybuty i metody mają zastosowanie tylko do określonych Kształtów Topologicznych. Te elementy mają zastosowanie do krawędzi (TopoShapeEdge).


FirstParameter

Returns: Wartość parametru na jednym końcu Krawędzi. Niekoniecznie na Vertex[0]. Patrz równania parametryczne

LastParameter

Returns: Wartość parametru na drugin końcu Krawędzi. Niekoniecznie na Vertex[1].

getParameterByLength(Float)

Description: Mapuje przedział [0,Długość] na przedział [FirstParameter,LastParameter]

Returns: Float

valueAt(Float)

Description: Zwraca wektor 3D odpowiadający parametrowi value.

Returns: Vector

parameterAt(Vertex,[Face])

Description: Zwraca wartość parametru odpowiadającą wierzchołkowi (3D point).

Returns: Float

tangentAt(Float)

Description: Zwraca wektor kierunku stycznej do krawędzi przy wartości parametru (jeśli istnieje).

Returns: Vector

normalAt(Float)

Description: Zwraca wektor kierunku normalnej do krawędzi na wartość parametru (jeśli istnieje jednoznacznie).

Returns: Vector

curvatureAt(Float)

Description: Zwraca krzywiznę krawędzi przy parametrze value.

Returns: Float

centerOfCurvatureAt(Float)

Description: Zwraca środek (punkt 3D) okręgu oscylującego przy parametrze value.

Returns: Vector