SolidWorksMakroprogrammierung

Objekt · SldWorks

SketchPicture-Objekt

Ein Bild in einer Skizze, etwa eine BMP-, JPG- oder TIF-Datei: Lage, Größe, Drehung, Spiegelung, Transparenz und die Pixel.

Deklaration Dim x As SldWorks.SketchPicture · in der englischen .NET-Hilfe: ISketchPicture

Beschreibung

SketchPicture gibt Zugriff auf Bilder in Skizzen, also .bmp-, .gif-, .jpg-, .jpeg-, .tif- und .wmf-Dateien. Ein Skizzenbild ist zugleich ein Feature im FeatureManager. Die Befehle gibt es seit SOLIDWORKS 2008.

Zugriff

Beispiel

' Gibt für jedes Bild in der Skizze "Sketch1" Name, Lage, Größe, Drehung und
' Spiegelung aus.
' Vorbedingung: Ein Teil mit der Skizze "Sketch1" ist offen, die Skizze enthält ein Bild.
' Ergebnis:     Die Werte stehen im Direktfenster, in Millimetern und Grad.
Option Explicit

Sub main()
    Const PI As Double = 3.14159265358979
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swPart As SldWorks.PartDoc
    Dim swFeat As SldWorks.Feature
    Dim swSketch As SldWorks.Sketch
    Dim vBilder As Variant
    Dim swBild As SldWorks.SketchPicture
    Dim x As Double, y As Double
    Dim dBreite As Double, dHoehe As Double
    Dim i As Long

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    If swModel.GetType <> swDocPART Then Exit Sub
    Set swPart = swModel
    Set swFeat = swPart.FeatureByName("Sketch1")
    If swFeat Is Nothing Then Exit Sub
    Set swSketch = swFeat.GetSpecificFeature2

    vBilder = swSketch.GetSketchPictures
    If Not IsArray(vBilder) Then Exit Sub
    For i = 0 To UBound(vBilder)
        Set swBild = vBilder(i)
        swBild.GetOrigin x, y
        swBild.GetSize dBreite, dHoehe
        Debug.Print swBild.GetFeature.Name & ": Ecke " & Format(x * 1000, "0.0") & " / " & Format(y * 1000, "0.0") & _
                    " mm, " & Format(dBreite * 1000, "0.0") & " x " & Format(dHoehe * 1000, "0.0") & " mm, " & _
                    Format(swBild.Angle * 180 / PI, "0.0") & "°" & IIf(swBild.Flipped, ", gespiegelt", "")
    Next i
End Sub

Bemerkungen

Lage und Einheiten: SketchPicture.GetOrigin und SketchPicture.SetOrigin geben die linke untere Ecke des Bilds in Skizzenkoordinaten an, in Metern. Breite und Höhe sind ebenfalls Meter, der Winkel ist Bogenmaß, gegen den Uhrzeigersinn ab der positiven X-Achse.

Pixel: SketchPicture.GetPixelmap liefert die Rohdaten der Bilddatei, ohne Verschiebung, Maßstab, Drehung und Spiegelung. Wo ein Pixel nach diesen Änderungen in der Skizze liegt, sagt dir SketchPicture.GetPointOnSketchFromPixel.

Einfügen: Das Hilfebeispiel „Flip Sketch Picture“ öffnet eine Skizze, fügt das Bild mit SketchManager.InsertSketchPicture2 ein, schließt die Skizze und spiegelt das Bild dann mit SketchPicture.Flip.

Eigenschaften und Methoden

Eigenschaften 2, davon 2 beschrieben

NameBeschreibung
AngleLiest oder setzt den Drehwinkel des Bilds in der Skizze im Bogenmaß.
FlippedLiefert, ob das Bild in der Skizze gespiegelt ist.

Methoden 11, davon 11 beschrieben

NameBeschreibung
FlipSpiegelt das Bild an Ort und Stelle, seitlich oder von oben nach unten.
GetFeatureLiefert das Feature des Skizzenbilds.
GetOriginLiefert die Lage der linken unteren Ecke des Bilds in der Skizze.
GetPixelmapLiefert die Pixel des Bilds als Zahlen-Array mit drei oder vier Werten je Pixel.
GetPixelmapSizeLiefert die Größe des Pixel-Arrays sowie Breite und Höhe des Bilds in Pixeln.
GetPointOnSketchFromPixelLiefert den Punkt in der Skizze, an dem ein Pixel des Bilds liegt.
GetSizeLiefert Breite und Höhe des Bilds in der Skizze in Metern.
GetTransparencyLiefert die Transparenz-Einstellungen des Bilds.
SetOriginSetzt die Lage der linken unteren Ecke des Bilds in der Skizze.
SetSizeSetzt Breite und Höhe des Bilds in der Skizze, auf Wunsch mit festem Seitenverhältnis.
SetTransparencySetzt die Transparenz-Einstellungen des Bilds.

Nicht aufgeführt sind 1 C++-Varianten (Namen mit I davor, zum Beispiel IGetPixelmap). In VBA nimmst du immer den Befehl ohne I.

Siehe auch

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

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