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
AreaReturns: L'area totale delle facce della shape.
BoundBoxReturns: Il BoundBox dell'oggetto
CenterOfMassReturns: 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.
CompSolidsReturns: Elenca le shape successive in questa shape.
CompoundsReturns: Elenca i Coumpounds in questa shape.
EdgesReturns: Elenca gli Edges in questa shape.
FacesReturns: Elenca le face in questa shape.
LengthReturns: Lunghezza totale degli edges della shape.
MatrixReturns: L'attuale trasformazione dell'oggetto come matrice
OrientationReturns: l'orientamento della shape.
PlacementReturns: L'attuale trasformazione dell'oggetto come placement
ShapeTypeReturns: Il tipo di shape.
ShellsReturns: Elenca le shape successive in questa shape.
SolidsReturns: Elenco delle shape successive in questa shape.
VertexesReturns: Elenco dei vertexes in questa shape.
VolumeReturns: Volume totale dei solid della shape.
WiresReturns: 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).
FirstParameterReturns: Il valore del parametro a un'estremità di Edge. Non necessariamente al vertice[0]. See Parametric Equations
LastParameterReturns: 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
Questa pagina è recuperata da https://wiki.freecad.org/TopoShape_API