Click or drag to resize

Camera3D Class

LightningChart .NET Help
Camera in 3D view.

Defines how and from what direction the world is seen from.

Inheritance Hierarchy
SystemObject
  Arction.WinForms.ChartingChartNode
    Arction.WinForms.Charting.Views.View3DCamera3D

Namespace:  Arction.WinForms.Charting.Views.View3D
Assembly:  Arction.WinForms.Charting.LightningChart (in Arction.WinForms.Charting.LightningChart.dll) Version: 10.3.1
Syntax
[SerializableAttribute]
[TypeConverterAttribute(typeof(GeneralTypeConverter))]
public class Camera3D : ChartNode

The Camera3D type exposes the following members.

Constructors
Properties
  NameDescription
Public propertyFieldOfViewAngle
Field of view, that is, perspective angle.
Public propertyMinimumViewDistance
Minimum View distance. Limits the adjust range of ViewDistance. In some cases, you don't want to let the user set the camera too near.
Public propertyOrientationMode
Type of orientation angle definition used in camera orientation.

This affects how on the orientation angles (RotationX, RotationY and RotationZ) are interpreted and how do they affect the camera orientation / position.

See OrientationModes for more detailed description of options.

Public propertyProjection
Gets or sets camera projection type.
Public propertyRotationX
Part of defining camera orientation and position, by setting its looking direction rotation around X-axis (pitch, elevation) in degrees.

Selected Orientation mode (OrientationMode) defines how the value affects camera orientation and position. See OrientationModes enumeration for more information.

RotationY and RotationZ needs to be set as well for defining camera orientation. The rotation values are taken into account on a specific order, NOT on the order they are set.

In some orientation modes setting this value causes user device horizontal rotation axis to be set.

Public propertyRotationXMaximum
Maximum allowed value of RotationX property.

This can be used to limit camera orientation / location to some specific area.

Public propertyRotationXMinimum
Minimum allowed value of RotationX property.

This can be used to limit camera orientation / location to some specific area.

Public propertyRotationY
Part of defining camera orientation and position, by setting its looking direction rotation around Y-axis (Yaw, Heading, Bearing) in degrees.

Selected Orientation mode (OrientationMode) defines how the value affects camera orientation and position. See OrientationModes enumeration for more information.

RotationX and RotationZ needs to be set as well for defining camera orientation. The rotation values are taken into account on a specific order, NOT on the order they are set.

In some orientation modes setting this value causes user device horizontal rotation axis to be set.

Public propertyRotationYMaximum
Maximum allowed value of RotationY property.

This can be used to limit camera orientation / location to some specific area.

Public propertyRotationYMinimum
Minimum allowed value of RotationY property.

This can be used to limit camera orientation / location to some specific area.

Public propertyRotationZ
Part of defining camera orientation and position, by setting its looking direction rotation around Z-axis (pitch, elevation) in degrees. This property has highly different effects on different orientation modes.

Selected Orientation mode (OrientationMode) defines how the value affects camera orientation and position. See OrientationModes enumeration for more information.

RotationY and RotationX needs to be set as well for defining camera orientation. The rotation values are taken into account on a specific order, NOT on the order they are set.

In some orientation modes setting this value causes user device horizontal rotation axis to be set.

Public propertyRotationZMaximum
Maximum allowed value of RotationZ property.

This can be used to limit camera orientation / location to some specific area.

Public propertyRotationZMinimum
Minimum allowed value of RotationZ property.

This can be used to limit camera orientation / location to some specific area.

Public propertyTarget
Target 3D world coordinate. Camera is targeted towards this coordinate. Use (0,0,0) to center in the 3D view. View distance is calculated from this target.
Public propertyViewDistance
View distance. You should use values in range 10...1000. Distance is calculated from Target. MinimumViewDistance[!:MaximumViewDistance]
Top
Methods
  NameDescription
Public methodDispose
Release all resources used by this instance.
(Inherited from ChartNode.)
Public methodDistanceToOrthographicViewArea
Converts view distance value into a orthographic view area. Used for building projection matrix.
Public methodEquals
Determines whether the specified object is equal to the current object.
(Inherited from Object.)
Public methodGetFarClipDistance
Getter of the far clipping distance for the 3D projection. This is an advanced setting that is not supported in normal use and should not be modified.
Public methodGetHashCode
Serves as the default hash function.
(Inherited from Object.)
Public methodGetLocationAs3DWorldCoord
Gets camera location in 3D world space.
Public methodGetNearClipDistance
Getter of the near clipping distance for the 3D projection. This is an advanced setting that is not supported in normal use and should not be modified.
Public methodGetType
Gets the Type of the current instance.
(Inherited from Object.)
Public methodLockPointerDeviceHorizRotationAxis
Locks user pointer device (mouse etc) based rotation to use current camera orientation settings for rotation axis. This affects the way horizontal rotation behaves on certain OrientationModes values.

This has no effect when OrientationMode is XYZ_Mixed.

This method is intended mostly as internal operation of LC. It's run when RotationX, RotationY or RotationZ properties are changed, causing horizontal rotation axis to be locked based on the current rotation settings. The method has been left as public for special cases, where users need to make the same operation without modifying the rotation parameters.

Public methodOrthographicViewAreaToDistance(SizeFloat)
Converts orthographic view's area into a view distance value.
Public methodStatic memberOrthographicViewAreaToDistance(SizeFloat, Double, Double)
Converts orthographic view's area into a view distance value.
Public methodSetEulerAngles
Same as setting RotationX, RotationY and RotationZ properties separately. Allows easier setting of the properties and is faster than separate setting of the properties.
Public methodSetFarClipDistance
Setter of the far clipping distance for the 3D projection. This is an advanced setting that is not supported in normal use and should not be modified.
Public methodSetNearClipDistance
Setter of the near clipping distance for the 3D projection. This is an advanced setting that is not supported in normal use and should not be modified.
Public methodSetPredefinedCamera
Sets camera orientation angles to values based given predefined orientation setting.
Public methodToString
Convert class description to string
(Overrides ObjectToString.)
Top
See Also