SolidWorksMakroprogrammierung

Methode · View

GetPolylines7-Methode (View)

Liefert die Kanten einer Zeichenansicht als Polyliniendaten und dazu die Modellkanten, wahlweise mit, ohne oder nur mit Schraffurlinien.

Syntax

Function GetPolylines7( _
   ByVal CrossHatchOption As Integer, _
   ByRef Polylines As Variant _
) As Variant
vKanten = swView.GetPolylines7(swCrossHatchExclude, vDaten)

Parameter

CrossHatchOptionIntegerByVal

Legt fest, welche Schraffurlinien geliefert werden. Die Hilfe nennt die Zahlen 0 bis 2, sie entsprechen den Werten aus swCrossHatchFilter_e:

  • swCrossHatchInclude (0): mit Schraffurlinien
  • swCrossHatchExclude (1): ohne Schraffurlinien
  • swCrossHatchOnly (2): nur Schraffurlinien
PolylinesVariantByRef · Rückgabe

SOLIDWORKS schreibt ein Array von Double-Werten mit den Linien der Ansicht hinein. Für jede Linie folgen hintereinander:

  • Typ: 0 Polylinie, 1 Bogen oder Kreis
  • Anzahl der folgenden Geometriewerte: bei Typ 0 ist sie 0, bei Typ 1 sind es 12
  • Geometriewerte, nur bei Typ 1: Mittelpunkt, Startpunkt, Endpunkt und Normale, je x, y, z
  • sechs Linienattribute: Farbe, Linienstil, Linienart, Linienstärke, Layer-ID, Layer-Bitmaske (siehe Bemerkungen)
  • Anzahl der Punkte der Polylinie
  • die Punkte, je x, y, z

Die Punkte gibt es bei jedem Typ, auch bei Bögen. Eine Einheit nennt die Hilfe nicht. Vermutlich sind es Meter. Ob die Punkte in Koordinaten der Ansicht oder des Blatts angegeben sind, sagt die Hilfe nicht.

Rückgabewert

Array mit den Modellkanten (Edge), die zu den Polylinien gehören. Die Einträge entsprechen den Polylinien in derselben Reihenfolge. Für Silhouettenkanten gibt es keine echte Kante. Die Bemerkungen der Hilfe geben den Eintrag dann als leer (Null) an. An anderer Stelle nennt die Hilfe für diese Einträge Silhouettenkanten (SilhouetteEdge). Was wirklich drinsteht, prüfst du am besten im eigenen Modell.

Beispiel

' swView ist eine Zeichenansicht (View), etwa aus DrawingDoc.ActiveDrawingView oder der Auswahl.
Dim vKanten As Variant
Dim vDaten As Variant
Dim lIdx As Long
Dim lGeom As Long
Dim lPunkte As Long
Dim lBoegen As Long
Dim lPolylinien As Long
vKanten = swView.GetPolylines7(swCrossHatchExclude, vDaten)
If IsEmpty(vDaten) Then
    Debug.Print "Keine Daten. Ist die Ansicht schattiert?"
Else
    Do While lIdx <= UBound(vDaten)
        If vDaten(lIdx) = 1 Then
            lBoegen = lBoegen + 1
            Debug.Print "Bogen um " & Format(vDaten(lIdx + 2) * 1000, "0.00") & " / " & Format(vDaten(lIdx + 3) * 1000, "0.00") & " mm"
        Else
            lPolylinien = lPolylinien + 1
        End If
        lGeom = vDaten(lIdx + 1)
        lPunkte = vDaten(lIdx + 2 + lGeom + 6)
        ' weiter zur nächsten Linie: Kopf, Geometrie, Attribute, Punktzahl, Punkte
        lIdx = lIdx + 2 + lGeom + 6 + 1 + lPunkte * 3
    Loop
    Debug.Print lBoegen & " Bögen oder Kreise, " & lPolylinien & " Polylinien"
    If Not IsEmpty(vKanten) Then Debug.Print UBound(vKanten) - LBound(vKanten) + 1 & " Einträge im Kanten-Array"
End If

Bemerkungen

Welche Kanten wie geliefert werden: Alle sichtbaren Kanten des Modells in der Ansicht kommen. Bögen und Kreise haben Typ 1 und zusätzlich Mittelpunkt, Start- und Endpunkt. Ellipsen und Splines kommen als angenäherte Polylinien, gerade Kanten ebenfalls, dort ohne Genauigkeitsverlust. Genaue Kurvenparameter für Ellipsen und Splines liefert View.GetPolyLinesAndCurves. Linien, die ein Benutzer in der Ansicht skizziert hat, sind nicht dabei. Die holst du mit View.GetArcs4, View.GetLines4, View.GetSplines3 und View.GetEllipses5.

Die sechs Linienattribute:

  • Farbe: entweder direkt eingestellt oder vom Layer.
  • Linienstil: kombiniert Linienart und Linienstärke. Zum Auswerten nennt die Hilfe die veralteten DrawingDoc.GetLineFontInfo und DrawingDoc.GetLineFontName. Der Wert -1 heißt, die Darstellung wurde vermutlich von Hand geändert. Dann gelten die beiden nächsten Werte.
  • Linienart: lässt sich an DrawingDoc.GetLineFontInfo2 und DrawingDoc.GetLineFontName2 übergeben. Nur gültig, wenn der Linienstil -1 ist.
  • Linienstärke: 0 dünn, 1 normal, 2 dick. Nur gültig, wenn der Linienstil -1 ist.
  • Layer-ID: den Layer dazu liefert LayerMgr.GetLayerById.
  • Layer-Bitmaske: 1 Farbe, 2 Linienart, 4 Linienstärke weichen vom Layer ab. Der Wert 3 heißt also: Farbe und Linienart sind abweichend eingestellt.

Anzeigemodus: Ist die Ansicht schattiert, schattiert mit Kanten, in Entwurfsqualität oder in schneller HLR/HLV-Darstellung, kommen keine Daten. Stell die Ansicht vorher auf Drahtgitter, verdeckte Kanten entfernt oder verdeckte Kanten sichtbar um. Die Hilfe nennt dafür SetDisplayMode3, aktuell ist View.SetDisplayMode4. In welcher Form "keine Daten" zurückkommt, sagt die Hilfe nicht. Das Beispiel prüft deshalb mit IsEmpty.

Wurden die Teile oder Baugruppen der Zeichnung geändert, erzeugt SOLIDWORKS beim Öffnen nur die Polylinien im sichtbaren Bereich. Mit ModelDoc2.ViewZoomtofit2 erzwingst du, dass alle Polylinien erzeugt werden.

Die Größe des Datenarrays liefert View.GetPolyLineCount5. Ersetzt View.GetPolylines6.

Die Punkte kommen in Metern und beziehen sich nicht auf das Blatt: Die Lage der Ansicht auf dem Blatt steckt nicht darin.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2008

Englisches Original: IView::GetPolylines7 in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)

Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.