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.
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
SketchManager.InsertSketchPicture2: fügt ein neues Bild in die offene Skizze einSketch.GetSketchPictures: alle Bilder einer SkizzeView.GetSketchPictures: die Bilder einer ZeichnungsansichtFeature.GetSpecificFeature2: bei einem Feature mit dem TypnamenSketchBitmap
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| Angle | Liest oder setzt den Drehwinkel des Bilds in der Skizze im Bogenmaß. |
| Flipped | Liefert, ob das Bild in der Skizze gespiegelt ist. |
Methoden 11, davon 11 beschrieben
| Name | Beschreibung |
|---|---|
| Flip | Spiegelt das Bild an Ort und Stelle, seitlich oder von oben nach unten. |
| GetFeature | Liefert das Feature des Skizzenbilds. |
| GetOrigin | Liefert die Lage der linken unteren Ecke des Bilds in der Skizze. |
| GetPixelmap | Liefert die Pixel des Bilds als Zahlen-Array mit drei oder vier Werten je Pixel. |
| GetPixelmapSize | Liefert die Größe des Pixel-Arrays sowie Breite und Höhe des Bilds in Pixeln. |
| GetPointOnSketchFromPixel | Liefert den Punkt in der Skizze, an dem ein Pixel des Bilds liegt. |
| GetSize | Liefert Breite und Höhe des Bilds in der Skizze in Metern. |
| GetTransparency | Liefert die Transparenz-Einstellungen des Bilds. |
| SetOrigin | Setzt die Lage der linken unteren Ecke des Bilds in der Skizze. |
| SetSize | Setzt Breite und Höhe des Bilds in der Skizze, auf Wunsch mit festem Seitenverhältnis. |
| SetTransparency | Setzt 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.