Objekt · SldWorks
Camera-Objekt
Eine Kamera im Modell: Art, Lage, Zielpunkt, Blickrichtung und Sichtfeld.
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
ModelDocExtension.InsertCamera: eine neue Kamera im ModellModelDocExtension.GetCameraById: eine Kamera des Modells über ihre KennungModelDocExtension.GetCameraDefinition: eine Kamera, die nicht im Modell stehtModelView.Camera: die Kamera, durch die eine Modellansicht schautFeature.GetSpecificFeature2: aus dem Feature einer Kamera (TypnameCameraFeature)
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| AspectRatio | Liefert das Seitenverhältnis (Breite durch Höhe) des Sichtfelds der Kamera. |
| DepthOfFieldEnabled | Liefert, ob die Tiefenschärfe (depth of field) der Kamera eingeschaltet ist. |
| DepthOfFieldOffset | Liefert ungefähr den Abstand von der Schärfeebene der Kamera bis zu dem Punkt, an dem die Schärfe verloren geht. |
| FieldOfViewAngle | Liefert den waagrechten Blickwinkel der Kamera, im Bogenmaß. |
| FieldOfViewDepth | Liefert die Tiefe des Sichtfelds der Kamera. |
| FieldOfViewHeight | Liefert die Höhe des Sichtfelds der Kamera. |
| ID | Liefert die Kennung (ID) der Kamera. |
| LockCameraPosition | Liest oder setzt, ob die Lage der Kamera gesperrt ist. |
| Perspective | Liefert, ob die Kamera mit Perspektive arbeitet. |
| Pitch | Liest oder setzt die Neigung (Winkel nach oben oder unten) einer schwebenden Kamera. |
| PositionType | Liest oder setzt, wie die Lage der Kamera angegeben ist: kartesisch oder sphärisch um das Ziel. |
| RotationRollAngle | Liest oder setzt den Rollwinkel der Kamera. |
| RotationRollBySelection | Liest oder setzt, ob die Rollrichtung der Kamera über ein ausgewähltes Element festgelegt wird. |
| RotationRollEntity | Liest oder setzt das Element (Linie, Kante, Fläche oder Ebene), das die Richtung nach oben der Kamera festlegt. |
| RotationRollFlipDirection | Liest oder setzt, ob die Richtung der Kamera um 180° umgekehrt wird. |
| TargetPointBySelection | Liest oder setzt, ob der Zielpunkt der Kamera über ein ausgewähltes Element festgelegt wird. |
| TargetPointPosition | Liest oder setzt die Lage des Zielpunkts der Kamera als Punkt (MathPoint). |
| Type | Liest oder setzt die Art der Kamera: auf ein Ziel gerichtet oder schwebend. |
| Yaw | Liest oder setzt die Schwenkung (Winkel zur Seite) einer schwebenden Kamera. |
Methoden 13, davon 13 beschrieben
| Name | Beschreibung |
|---|---|
| GetFocalDistance | Liefert den Fokusabstand (focal distance) der Kamera. |
| GetPointOfInterestDistance | Liefert den Abstand des betrachteten Punkts (point of interest) von der Kamera. |
| GetPosition | Liefert die aktuelle Lage der Kamera als Punkt (MathPoint). |
| GetPositionCartesian | Liefert die Lage der Kamera als X, Y und Z, bezogen auf den Ursprung des Modells. |
| GetPositionEntity | Liefert das Element, an dem die Kamera hängt, mit Punkt und Lage entlang des Elements. |
| GetPositionSpherical | Liefert die Lage der Kamera in Kugelkoordinaten um das Ziel: Abstand, Längen- und Breitenwinkel. |
| GetTargetPointEntity | Liefert das Element, auf dem der Zielpunkt der Kamera liegt, mit Punkt und Lage entlang des Elements. |
| GetUpVector | Liefert die Richtung nach oben der Kamera als Vektor (MathVector). |
| GetViewVector | Liefert die Blickrichtung der Kamera als Vektor (MathVector). |
| SetPositionCartesian | Setzt die Lage der Kamera als X, Y und Z, bezogen auf den Ursprung des Modells. |
| SetPositionEntity | Hängt die Kamera an ein Element, mit Punkt und Lage entlang des Elements. |
| SetPositionSpherical | Setzt die Lage der Kamera in Kugelkoordinaten um das Ziel: Abstand, Längen- und Breitenwinkel. |
| SetTargetPointEntity | Legt 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.