TopoShape API

From FreeCAD Documentation
This page is a translated version of the page TopoShape API and the translation is 100% complete.
Other languages:
(novembre 2018) Queste informazioni potrebbero essere incomplete e obsolete. Per l'API più recente, consulta la documentazione API generata automaticamente.

Il TopoShape è l'oggetto madre del Part Module. Tutti i tipi di forma (filo, faccia, solido, ecc...) del modulo Parte sono TopoShapes e condividono i seguenti attributi e metodi. Esempio:

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

Returns: L'area totale delle facce della shape.

BoundBox

Returns: Il BoundBox dell'oggetto

CenterOfMass

Returns: Il centro di massa del sistema attuale. Se il campo gravitazionale è uniforme, è il centro di gravità. Le coordinate restituite per il centro di massa sono espresse nel sistema di coordinate cartesiane assolute.

CompSolids

Returns: Elenca le shape successive in questa shape.

Compounds

Returns: Elenca i Coumpounds in questa shape.

Edges

Returns: Elenca gli Edges in questa shape.

Faces

Returns: Elenca le face in questa shape.

Length

Returns: Lunghezza totale degli edges della shape.

Matrix

Returns: L'attuale trasformazione dell'oggetto come matrice

Orientation

Returns: l'orientamento della shape.

Placement

Returns: L'attuale trasformazione dell'oggetto come placement

ShapeType

Returns: Il tipo di shape.

Shells

Returns: Elenca le shape successive in questa shape.

Solids

Returns: Elenco delle shape successive in questa shape.

Vertexes

Returns: Elenco dei vertexes in questa shape.

Volume

Returns: Volume totale dei solid della shape.

Wires

Returns: Elenco dei wire in ​​questa forma.

approximate( )

Description: Approssima una curva B-Spline da questo wire

Returns: un oggetto BSplineCurve

check( )

Description: Controlla la shape e segnala gli errori nella struttura della shape. Questo è un controllo più dettagliato rispetto a come fatto in isValid().

Returns:

common(TopoShape)

Description: Intersezione di questo e una data topo-shape.

Returns: a TopoShape

complement( )

Description: Calcola il complemento dell'orientamento di questa shape, ovvero inverte lo stato interno/esterno dei boundary di questa shape.

Returns: a TopoShape

copy( )

Description: Crea una copia di questa shape

Returns: a TopoShape

cut(TopoShape)

Description: Differenza tra questa e una determinata topo-shape.

Returns: a TopoShape

distToShape( TopoShape )

Description: Calcola la distanza minima tra questo e una data TopoShape.

Returns: float<minimum distance>,list<nearest points>,list<nearest subshapes & parameters>

exportBrep( string )

Description: Esporta il contenuto di questa shape in un file BREP. BREP è un formato nativo di CasCade.

Returns:

exportIges( string )

Description: Esporta il contenuto di questa shape in un file IGES.

Returns:

exportStep( string )

Description: Esporta il contenuto di questa shape in un file STEP.

Returns:

exportStl( string )

Description: Esporta il contenuto di questa shape in un file mesh STL.

Returns:

extrude(Vector)

Description: Estrude la shape lungo una direzione.

Returns: a TopoShape

fuse(TopoShape)

Description: Unione di questa e di una data topo shape.

Returns: a TopoShape

getAllDerivedFrom( )

Description: Restituisce tutte le discendenze di questo tipo di oggetto

Returns: a list

hashCode( )

Description: Questo valore viene calcolato dal valore del riferimento alla shape sottostante e dalla posizione. L'orientamento non viene preso in considerazione.

Returns: a string

isClosed( )

Description: Controlla se la shape è chiusa.

Returns: a boolean

isDerivedFrom(string)

Description: Restituisce vero se il tipo indicato è un padre

Returns: boolean

isEqual(TopoShape)

Description: Restituisce vero se entrambe le shape condividono la stessa TShape, hanno la stessa posizione e hanno lo stesso orientamento.

Returns: a boolean

isInside(Vector,float,Boolean)

Description: Controlla se un point si trova all'interno di un solid con una certa tolleranza. Se il 3° parametro è True un point su una face è considerato interno

Returns: a boolean

isNull( )

Description: Controlla se la shape è null.

Returns: a boolean

isPartner(TopoShape)

Description: Restituisce True se entrambe le shape condividono la stessa TShape, ma possono avere una Location diversa e un Orientation diverso.

Returns: a boolean

isSame(TopoShape)

Description: Controlla se entrambe le shape condividono la stessa geometria, vero se entrambe le shape condividono la stessa TShape e hanno la stessa Location, ma potrebbero avere un Orientation diverso.

Returns: a boolean

isValid( )

Description: Controlla se la shape è valida, cioè né nulla, né vuota né corrotta.

Returns: a boolean

makeFillet(float,TopoShape)

Description: Restituisce un nuovo oggetto basato su una TopoShape, ma con un raccordo di raggio "float" applicato a ciascun bordo.

Returns: a TopoShape

makeHomogenousWires(wire)

Description: Rende omogeneo questo e il wire dato in modo che abbiano lo stesso numero di bordi

Returns: a wire

makeOffset(float)

Description: Compensa la shape di una determinata quantità

Returns: a TopoShape

makePipe(wire)

Description: Crea una pipe scorrendo lungo un wire.

Returns: a TopoShape

makePipeShell(wire)

Description: Crea un loft definito da profili lungo una wire.

Returns: a TopoShape

makeShapeFromMesh(mesh)

Description: Crea una shape composta dai dati mesh. Nota: questo dovrebbe essere usato solo per mesh piuttosto piccole.

Returns: a TopoShape

makeThickness(list,float,float)

Description: Crea un solid cavo partendo da un solid iniziale e da una serie di face su questo solid che devono essere rimosse. Le restanti face del solid diventano le pareti del solid cavo, il cui spessore è definito al momento della costruzione. Gli argomenti da passare sono un elenco di face da rimuovere, lo spessore dei muri e un valore di tolleranza.

Returns: a TopoShape

nullify( )

Description: Distrugge il riferimento alla shape sottostante archiviata in questa shape. Di conseguenza, questa shape diventa nulla.

Returns:

project(TopoShape)

Description: Proietta una shape su questa shape

Returns: a TopoShape

read(string)

Description: Legge un file IGES, STEP o BREP.

Returns: a TopoShape

reverse( )

Description: Inverte l'orientamento di questa forma.

Returns:

revolve(Vector, Vector, float)

Description: Ruota la shape attorno a un asse di un determinato angolo. es: Part.revolve(Vector(0,0,0),Vector(0,0,1),360) ruota la shape attorno all'asse Z di 360 gradi.

Returns: a TopoShape

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

Description: Ruota questa shape in base ai gradi angolari attorno a un asse specificato dalla posizione e dalla direzione. es: Shp.rotate(Vector(0,0,0),Vector(0,0,1),180) ruota la shape attorno all'asse Z di 180 gradi.

Returns:

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

Description: Ridimensiona uniformemente questa forma in base ad un fattore. Facoltativamente specificare il centro della trasformazione in scala.

Returns:

section(TopoShape)

Description: Sezione di questo con una data topo-shape.

Returns: a TopoShape

sewShape( )

Description: Cuce la forma se c'è uno spazio vuoto.

Returns:

tessellate(float)

Description: Tassella la forma e restituisce un elenco di vertice e indici di face. Il float dato è la tolleranza.

Returns: a list

toNurbs( )

Description: Conversione della geometria completa di una shape in geometria NURBS. Ad esempio, tutte le curve che supportano edge della forma base vengono convertite in curve BSpline e tutte le superfici che supportano le sue face vengono convertite in superfici BSpline.

Returns: a NURBS curve

transformGeometry(matrix)

Description: Applica la trasformazione geometrica su una copia della shape. La trasformazione da applicare è definita come matrice 4x4. La geometria sottostante delle seguenti shape può trasformarsi in una curva che supporta un bordo della shape o una superficie che supporta una face della shape. Ad esempio, un cerchio può essere trasformato in un'ellisse quando si applica una trasformazione di affinità. Può anche succedere che il cerchio venga rappresentato come una curva b-spline. La trasformazione viene applicata a tutte le curve che supportano i bordi della shape e a tutte le superfici che supportano le face della shape. Nota: se si desidera trasformare una shape senza modificarne la geometria sottostante, utilizzare i metodi trasla o ruota.

Returns: a TopoShape

transformShape(matrix)

Description: Applica la trasformazione su una shape senza modificare la geometria sottostante.

Returns:

translate(Vector)

Description: Applica la traslazione alla posizione corrente di questa forma.

Returns:

writeInventor( )

Description: Scrive la mesh nel formato OpenInventor in una stringa.

Returns: a string

Alcuni attributi e metodi si applicano solo a determinati TopoShapes. Questi elementi si applicano ai bordi (TopoShapeEdge).


FirstParameter

Returns: Il valore del parametro a un'estremità di Edge. Non necessariamente al vertice[0]. See Parametric Equations

LastParameter

Returns: Il valore del parametro all'altra estremità di Edge. Non necessariamente al vertice[1].

getParameterByLength(Float)

Description: Mappa l'intervallo [0,Length] sull'intervallo [FirstParameter,LastParameter]

Returns: Float

valueAt(Float)

Description: Restituisce il vettore 3D corrispondente al valore di un parametro.

Returns: Vector

parameterAt(Vertex,[Face])

Description: Restituisce il valore del parametro corrispondente a un vertice (punto 3D).

Returns: Float

tangentAt(Float)

Description: Restituisce il vettore di direzione della tangente al bordo in corrispondenza del valore di un parametro (se esiste).

Returns: Vector

normalAt(Float)

Description: Restituisce il vettore di direzione della normale al bordo in corrispondenza del valore di un parametro (se esiste in modo univoco).

Returns: Vector

curvatureAt(Float)

Description: Restituisce la curvatura del bordo in corrispondenza di un valore del parametro.

Returns: Float

centerOfCurvatureAt(Float)

Description: Restituisce il centro (punto 3D) del cerchio osculatore in corrispondenza di un valore del parametro.

Returns: Vector