SolidWorksMakroprogrammierung

Objekt · SldWorks

Camera-Objekt

Eine Kamera im Modell: Art, Lage, Zielpunkt, Blickrichtung und Sichtfeld.

Deklaration Dim x As SldWorks.Camera · in der englischen .NET-Hilfe: ICamera

Beschreibung

Camera gibt Zugriff auf das Kamera-Feature. Eine Kamera ist entweder auf ein Ziel gerichtet oder schwebend (Camera.Type). Ihre Lage gibst du kartesisch, in Kugelkoordinaten um das Ziel oder über ein Element an. Eine Modellansicht kann durch die Kamera schauen, siehe ModelView.Camera.

Zugriff

Beispiel

' Gibt für jede Kamera des aktiven Modells Name, Art, Lage, Blickrichtung und Blickwinkel aus.
' Vorbedingung: Ein Teil oder eine Baugruppe mit mindestens einer Kamera ist offen.
' Ergebnis:     Die Werte stehen im Direktfenster, das Modell bleibt unverändert.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swCamera As SldWorks.Camera
    Dim swFeat As SldWorks.Feature
    Dim swPunkt As SldWorks.MathPoint
    Dim swBlick As SldWorks.MathVector
    Dim vPunkt As Variant, vBlick As Variant
    Dim i As Long
    Const PI As Double = 3.14159265358979

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub

    For i = 0 To swModel.Extension.GetCameraCount - 1
        Set swCamera = swModel.Extension.GetCameraById(i)
        Set swFeat = swCamera                           ' eine Kamera ist auch ein Feature
        Debug.Print swFeat.Name & " (ID " & swCamera.ID & ")"
        If swCamera.Type = swCameraType_AimedAtTarget Then
            Debug.Print "  Art: auf ein Ziel gerichtet"
        Else
            Debug.Print "  Art: schwebend"
        End If

        Set swPunkt = swCamera.GetPosition
        vPunkt = swPunkt.ArrayData
        Debug.Print "  Lage: " & vPunkt(0) * 1000 & ", " & vPunkt(1) * 1000 & ", " & vPunkt(2) * 1000 & " mm"
        Set swBlick = swCamera.GetViewVector
        vBlick = swBlick.ArrayData
        Debug.Print "  Blickrichtung: " & Round(vBlick(0), 3) & ", " & Round(vBlick(1), 3) & ", " & Round(vBlick(2), 3)
        If swCamera.Perspective Then
            Debug.Print "  Blickwinkel: " & Round(swCamera.FieldOfViewAngle * 180 / PI, 1) & "°"
        End If
    Next i
End Sub

Bemerkungen

Kamera als Feature: Eine Kamera ist auch ein Feature. Das Hilfebeispiel „Turn Cameras On and Off“ weist sie einer Variablen vom Typ Feature zu und liest so ihren Namen. Umgekehrt liefert Feature.GetSpecificFeature2 die Kamera zum Feature.

Kennungen: Nach dem Hilfebeispiel liegen gültige Kennungen zwischen 0 und ModelDocExtension.GetCameraCount minus 1. Wird eine Kamera gelöscht, vergibt SOLIDWORKS die Kennungen neu.

Kameraansicht: Durch eine Kamera schaust du mit ModelView.SetCameraByName. Das Hilfebeispiel schaltet die Kameraansicht aus, indem es ModelView.Camera auf Nothing setzt.

Nur lesbar: Das Setzen ist bei Camera.AspectRatio, Camera.DepthOfFieldEnabled, Camera.DepthOfFieldOffset, Camera.FieldOfViewAngle, Camera.FieldOfViewDepth, Camera.FieldOfViewHeight und Camera.Perspective nicht umgesetzt. Über die API liest du diese Werte nur.

Einheiten: Der Blickwinkel ist im Bogenmaß. Für die übrigen Längen und Winkel nennt die Hilfe keine Einheit. In SOLIDWORKS 2024 waren Längen in Metern und Winkel im Bogenmaß.

Kameras einblenden: Im Grafikbereich blendest du Kameras mit swDisplayCameras aus swUserPreferenceToggle_e ein, etwa über ModelDocExtension.SetUserPreferenceToggle. Das Hilfebeispiel „Insert and Rotate Camera“ macht es so, allerdings mit dem veralteten ModelDoc2.SetUserPreferenceToggle.

Eigenschaften und Methoden

Eigenschaften 19, davon 19 beschrieben

NameBeschreibung
AspectRatioLiefert das Seitenverhältnis (Breite durch Höhe) des Sichtfelds der Kamera.
DepthOfFieldEnabledLiefert, ob die Tiefenschärfe (depth of field) der Kamera eingeschaltet ist.
DepthOfFieldOffsetLiefert ungefähr den Abstand von der Schärfeebene der Kamera bis zu dem Punkt, an dem die Schärfe verloren geht.
FieldOfViewAngleLiefert den waagrechten Blickwinkel der Kamera, im Bogenmaß.
FieldOfViewDepthLiefert die Tiefe des Sichtfelds der Kamera.
FieldOfViewHeightLiefert die Höhe des Sichtfelds der Kamera.
IDLiefert die Kennung (ID) der Kamera.
LockCameraPositionLiest oder setzt, ob die Lage der Kamera gesperrt ist.
PerspectiveLiefert, ob die Kamera mit Perspektive arbeitet.
PitchLiest oder setzt die Neigung (Winkel nach oben oder unten) einer schwebenden Kamera.
PositionTypeLiest oder setzt, wie die Lage der Kamera angegeben ist: kartesisch oder sphärisch um das Ziel.
RotationRollAngleLiest oder setzt den Rollwinkel der Kamera.
RotationRollBySelectionLiest oder setzt, ob die Rollrichtung der Kamera über ein ausgewähltes Element festgelegt wird.
RotationRollEntityLiest oder setzt das Element (Linie, Kante, Fläche oder Ebene), das die Richtung nach oben der Kamera festlegt.
RotationRollFlipDirectionLiest oder setzt, ob die Richtung der Kamera um 180° umgekehrt wird.
TargetPointBySelectionLiest oder setzt, ob der Zielpunkt der Kamera über ein ausgewähltes Element festgelegt wird.
TargetPointPositionLiest oder setzt die Lage des Zielpunkts der Kamera als Punkt (MathPoint).
TypeLiest oder setzt die Art der Kamera: auf ein Ziel gerichtet oder schwebend.
YawLiest oder setzt die Schwenkung (Winkel zur Seite) einer schwebenden Kamera.

Methoden 13, davon 13 beschrieben

NameBeschreibung
GetFocalDistanceLiefert den Fokusabstand (focal distance) der Kamera.
GetPointOfInterestDistanceLiefert den Abstand des betrachteten Punkts (point of interest) von der Kamera.
GetPositionLiefert die aktuelle Lage der Kamera als Punkt (MathPoint).
GetPositionCartesianLiefert die Lage der Kamera als X, Y und Z, bezogen auf den Ursprung des Modells.
GetPositionEntityLiefert das Element, an dem die Kamera hängt, mit Punkt und Lage entlang des Elements.
GetPositionSphericalLiefert die Lage der Kamera in Kugelkoordinaten um das Ziel: Abstand, Längen- und Breitenwinkel.
GetTargetPointEntityLiefert das Element, auf dem der Zielpunkt der Kamera liegt, mit Punkt und Lage entlang des Elements.
GetUpVectorLiefert die Richtung nach oben der Kamera als Vektor (MathVector).
GetViewVectorLiefert die Blickrichtung der Kamera als Vektor (MathVector).
SetPositionCartesianSetzt die Lage der Kamera als X, Y und Z, bezogen auf den Ursprung des Modells.
SetPositionEntityHängt die Kamera an ein Element, mit Punkt und Lage entlang des Elements.
SetPositionSphericalSetzt die Lage der Kamera in Kugelkoordinaten um das Ziel: Abstand, Längen- und Breitenwinkel.
SetTargetPointEntityLegt den Zielpunkt der Kamera auf ein Element, mit Punkt und Lage entlang des Elements.

Siehe auch

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

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