SolidWorksMakroprogrammierung

Methode · ModelDoc2

GetSpotlightProperties-Methode (ModelDoc2)

Liest die Werte eines Spotlichts mit Position, Ziel und Kegelwinkel.

Syntax

Function GetSpotlightProperties( _
   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, _
   ByRef Targetx As Double, _
   ByRef Targety As Double, _
   ByRef Targetz As Double, _
   ByRef ConeAngle As Double _
) As Boolean
bOk = swModel.GetSpotlightProperties(sName, dUmg, dDiff, dGlanz, nFarbe, bAn, bFest, dX, dY, dZ, dZx, dZy, dZz, dKegel)

Parameter

NameStringByVal
Interner Name des Lichts (ModelDoc2.GetLightSourceName).
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 Position des Spots zurück.
Targetx, Targety, TargetzDoubleByRef · Rückgabe
Geben den Zielpunkt zurück.
ConeAngleDoubleByRef · Rückgabe
Gibt den Kegelwinkel in Grad 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, nFarbe As Long
Dim bAn As Boolean, bFest As Boolean
Dim dX As Double, dY As Double, dZ As Double
Dim dZx As Double, dZy As Double, dZz As Double, dKegel As Double
For i = 0 To swModel.GetLightSourceCount - 1
    sName = swModel.GetLightSourceName(i)
    If swModel.GetSpotlightProperties(sName, dUmg, dDiff, dGlanz, nFarbe, bAn, bFest, _
            dX, dY, dZ, dZx, dZy, dZz, dKegel) Then
        Debug.Print sName & ": Kegel " & dKegel & "°"
    End If
Next i

Bemerkungen

Ungewöhnlich: Der Kegelwinkel steht in Grad, nicht im Bogenmaß. Für Position und Ziel nennt die Hilfe keine Einheit.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2001Plus

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

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