Methode · ModelDocExtension
AddDecal-Methode (ModelDocExtension)
Bringt ein Abziehbild am Modell an.
Syntax
Function AddDecal( _
ByVal PDecal As Decal, _
ByRef DecalID As Long _
) As BooleanbOk = swModel.Extension.AddDecal(swDecal, nID)Parameter
PDecalDecalByVal- Das Abziehbild (
Decal). DecalIDLongByRef · Rückgabe- Gibt die Kennung des Abziehbilds zurück.
Rückgabewert
True, wenn das Abziehbild angebracht wurde.
Beispiel
' swModel ist ein Teil, eine Fläche ist ausgewählt, ein Raytracing-Renderer ist aktiv.
Dim swFace As SldWorks.Face2
Dim swDecal As SldWorks.Decal
Dim swMaterial As SldWorks.RenderMaterial
Dim nID As Long
Set swFace = swModel.SelectionManager.GetSelectedObject6(1, -1)
swModel.ClearSelection2 True
Set swDecal = swModel.Extension.CreateDecal
Set swMaterial = swDecal
If swMaterial.AddEntity(swFace) Then
swMaterial.FileName = "C:\Program Files\SOLIDWORKS Corp\SOLIDWORKS\data\graphics\Decals\Logos\sw.p2d"
swMaterial.TextureFilename = "C:\Program Files\SOLIDWORKS Corp\SOLIDWORKS\data\graphics\Decals\Logos\sw.bmp"
swMaterial.MappingType = 0
If swModel.Extension.AddDecal(swDecal, nID) Then Debug.Print "Abziehbild " & nID
End IfBemerkungen
Das Abziehbild legst du vorher mit ModelDocExtension.CreateDecal an. Bild, Abbildung und Fläche stellt das Hilfebeispiel „Add Decal“ nicht über Decal ein, sondern über RenderMaterial: Es weist das Decal einer Variablen vom Typ RenderMaterial zu, fügt mit RenderMaterial.AddEntity die Fläche hinzu und setzt Datei (*.p2d), Bilddatei und Abbildung mit RenderMaterial.FileName, RenderMaterial.TextureFilename und RenderMaterial.MappingType. Die Auswahl hebt es vorher auf, die Fläche kommt also über AddEntity. Als Vorbedingung muss ein Raytracing-Renderer aktiv sein. Nach AddDecal baut das Hilfebeispiel das Modell mit ModelDocExtension.Rebuild neu auf.
In SOLIDWORKS 2024 enthält der Ordner Decals\Logos keine sw.bmp. Passe den Pfad in TextureFilename an ein vorhandenes Bild an.
Siehe auch
Verfügbarkeit
SOLIDWORKS 2008
Englisches Original: IModelDocExtension::AddDecal in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.