SolidWorksMakroprogrammierung

Methode · ModelDoc2

GetDirectionLightProperties-Methode (ModelDoc2)

Liest die Werte eines gerichteten Lichts samt Richtung.

Syntax

Function GetDirectionLightProperties( _
   ByVal Name As String, _
   ByRef Ambient As Double, _
   ByRef Diffuse As Double, _
   ByRef Specular As Double, _
   ByRef Colour As Long, _
   ByRef Enabled As Boolean, _
   ByRef Fixed As Boolean, _
   ByRef X As Double, _
   ByRef Y As Double, _
   ByRef Z As Double _
) As Boolean
bOk = swModel.GetDirectionLightProperties(sName, dUmg, dDiff, dGlanz, nFarbe, bAn, bFest, dX, dY, dZ)

Parameter

NameStringByVal
Name des Lichts.
AmbientDoubleByRef · Rückgabe
Gibt den Umgebungsanteil zurück.
DiffuseDoubleByRef · Rückgabe
Gibt den diffusen Anteil zurück.
SpecularDoubleByRef · Rückgabe
Gibt den Glanzanteil zurück.
ColourLongByRef · Rückgabe
Gibt die Farbe als COLORREF zurück.
EnabledBooleanByRef · Rückgabe
Gibt zurück, ob das Licht an ist.
FixedBooleanByRef · Rückgabe
Gibt zurück, ob das Licht fixiert ist.
X, Y, ZDoubleByRef · Rückgabe
Geben die Richtung des Lichts zurück.

Rückgabewert

True, wenn die Werte gelesen werden konnten.

Beispiel

' swModel ist das aktive Dokument.
Dim i As Long, sName As String
Dim dUmg As Double, dDiff As Double, dGlanz As Double
Dim nFarbe As Long, bAn As Boolean, bFest As Boolean
Dim dX As Double, dY As Double, dZ As Double
For i = 0 To swModel.GetLightSourceCount - 1
    sName = swModel.GetLightSourceName(i)
    If swModel.GetDirectionLightProperties(sName, dUmg, dDiff, dGlanz, nFarbe, bAn, bFest, dX, dY, dZ) Then
        Debug.Print sName & ": Richtung " & dX & " / " & dY & " / " & dZ
    End If
Next i

Bemerkungen

Wie bei ModelDoc2.GetAmbientLightProperties ist nicht dokumentiert, welcher Name erwartet wird; das Beispiel nimmt den internen Namen. Bei Lichtern anderer Art liefert der Befehl vermutlich False.

Auch beim Umgebungslicht liefert der Befehl True; die Richtung ist dann 0 / 0 / 0.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2001Plus

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

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