Objekt · SldWorks
ReferenceCurve-Objekt
Eine Referenzkurve, etwa eine 3D-Spline-Kurve, eine Kurve aus einer Datei oder eine projizierte Kurve: ihre Segmente als Kanten, Farbe und Sichtbarkeit.
Beschreibung
ReferenceCurve gibt Zugriff auf Referenzkurven. Dazu zählt die Hilfe 3D-Spline-Kurven, Kurven aus einer Datei, Spiralen und importierte Kurven. Du gehst damit die Segmente der Kurve als Kanten durch, färbst die Kurve und blendest sie ein oder aus. Wie die Kurve festgelegt ist, steht in ihrer Definition, die du mit Feature.GetDefinition holst, bei einer Kurve durch Referenzpunkte etwa ReferencePointCurveFeatureData. GetSegments gibt es seit SOLIDWORKS 2009, für die übrigen Befehle nennt die Hilfe keine Version.
Zugriff
Feature.GetSpecificFeature2: beim Feature einer Kurve, etwa mit dem Typnamen3DSplineCurve,CompositeCurve,ImportedCurveoderRefCurveModelDoc2.FeatureReferenceCurve: legt aus Kurven ein Referenzkurven-Feature an und liefert die Referenzkurve
Beispiel
' Geht alle Features des aktiven Teils durch und gibt für jede Referenzkurve
' die Zahl der Segmente und ihre Gesamtlänge in Millimeter aus.
' Vorbedingung: Ein Teil mit Kurven-Features ist offen.
' Ergebnis: Die Kurven stehen im Direktfenster, das Teil bleibt unverändert.
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swFeat As SldWorks.Feature
Dim swObj As Object
Dim swRefKurve As SldWorks.ReferenceCurve
Dim swKante As SldWorks.Edge
Dim swKurve As SldWorks.Curve
Dim swParam As SldWorks.CurveParamData
Dim dLaenge As Double
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
Set swFeat = swModel.FirstFeature
Do While Not swFeat Is Nothing
Set swObj = swFeat.GetSpecificFeature2
If swObj Is Nothing Then
' manche Ordner liefern kein Objekt, TypeOf gäbe dann Fehler 91
ElseIf TypeOf swObj Is SldWorks.ReferenceCurve Then
Set swRefKurve = swObj
dLaenge = 0
Set swKante = swRefKurve.GetFirstSegment
Do While Not swKante Is Nothing
Set swKurve = swKante.GetCurve
Set swParam = swKante.GetCurveParams3
dLaenge = dLaenge + swKurve.GetLength3(swParam.UMinValue, swParam.UMaxValue)
Set swKante = swRefKurve.GetNextSegment
Loop
Debug.Print swFeat.Name & " (" & swFeat.GetTypeName2 & "): " & _
swRefKurve.GetSegmentCount & " Segment(e), " & Format(dLaenge * 1000, "0.00") & " mm"
End If
Set swFeat = swFeat.GetNextFeature
Loop
End SubBemerkungen
Welche Kurven: Die Hilfe ist hier widersprüchlich. Die Beschreibung sagt, dass ReferenceCurve keine Referenzkurven-Features wie projizierte Kurven herausgibt. Die Tabelle bei Feature.GetTypeName2 nennt ReferenceCurve aber auch für RefCurve (projizierte Kurve) und CompositeCurve (CompositeCurveFeatureData), und die Hilfebeispiele „Get Curve Segments“ und „Get Reference Curve Information“ holen ReferenceCurve gerade von einer projizierten Kurve. Für Spiralen (Helix) und Kurven aus einer Datei (CurveInFile) nennt die Tabelle dagegen nur die Definition, HelixFeatureData und FreePointCurveFeatureData. Das Beispiel hier prüft das Objekt deshalb mit TypeOf.
Segmente: Die Segmente sind Kanten (Edge). Sie lassen sich nicht auswählen, Select-Methoden liefern für sie Nothing. Ihre Geometrie liest du mit Edge.GetCurve und Edge.GetCurveParams3.
Anlegen: Kurven durch Punkte legst du mit ModelDoc2.Insert3DSplineCurve an, Kurven aus einer Datei mit ModelDoc2.InsertCurveFileBegin und ModelDoc2.InsertCurveFile, Referenzkurven aus Kurvenobjekten mit ModelDoc2.FeatureReferenceCurve. So macht es das Hilfebeispiel „Create Reference Curve“.
Einheiten: Die Hilfebeispiele rechnen Punkte und Längen der Segmente mit * 1000 in Millimeter um, also Meter.
Eigenschaften und Methoden
Methoden 6, davon 6 beschrieben
| Name | Beschreibung |
|---|---|
| GetFirstSegment | Liefert das erste Segment der Referenzkurve als Kante. |
| GetNextSegment | Liefert das nächste Segment der Referenzkurve als Kante. |
| GetSegmentCount | Liefert die Zahl der Segmente der Referenzkurve. |
| GetSegments | Liefert alle Segmente der Referenzkurve als Array. |
| SetColor | Setzt die Farbe des Referenzkurven-Features. |
| SetVisible | Blendet das Referenzkurven-Feature ein oder aus. |
Nicht aufgeführt sind 3 C++-Varianten (Namen mit I davor, zum Beispiel IGetFirstSegment). In VBA nimmst du immer den Befehl ohne I.
Siehe auch
Englisches Original: IReferenceCurve in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.