DAZ Script |
---|
DzBasicCamera () |
void | depthOfFieldChanged () |
void | fStopChanged ( DzTimeRange range ) |
This is the basic camera implementation for DAZ Studio. It supplies commonly-used features like focal length adjustment and depth of field alteration.
Holds the current height of the view. (Read Only)
Holds the current width of the view. (Read Only)
Holds whether or not the camera performs depth of field calculations.
Holds the distance of the far DOF plane from this camera. (Read Only)
Since:
Holds the f/stop of the camera.
Holds whether or the camera is a perspective or orthographic view.
Holds the distance of the near DOF plane from this camera. (Read Only)
Since:
Holds whether or not the local dimensions will use the active viewport when enabled.
Since:
Create a camera.
Example:
(function(){ // Create a new camera var oCamera = new DzBasicCamera(); // Name the camera oCamera.setName( "My Camera" ); // Set the type to orthographic, forward facing along the Z axis oCamera.setType( DzCamera.FRONT_CAMERA ); // Add the camera to the scene Scene.addNode( oCamera ); })();
Boolean : applyDimensionsPreset( String preset )
Applies the settings in a dimensions preset.
Parameter(s):
Return Value:
true
if preset
was found, otherwise false
.Since:
DzVec3 : cursorToRay( Number x, Number y )
A ray through the scene for a perspective view.
Parameter(s):
Return Value:
DzVec3 : cursorToScene( Number x, Number y, Number z )
Calculates a location in the scene based on an x, y position in the viewport and distance from the camera.
Parameter(s):
Return Value:
DzFloatProperty : getApertureBladeRotationAngleControl()
Return Value:
Since:
DzIntProperty : getApertureNumBladesControl()
Return Value:
Since:
DzFloat2Property : getAspectRatioControl()
Return Value:
Since:
DzBoolProperty : getConstrainProportionsControl()
Return Value:
Since:
DzBoolProperty : getDepthOfFieldControl()
Return Value:
Since:
DzStringProperty : getDimensionPresetControl()
Return Value:
Since:
Boolean : getDimensionsPreset( String preset, DzSettings settings )
Retrieves the settings of a dimensions preset.
Parameter(s):
Return Value:
true
if preset
was found, otherwise false
.Since:
DzBoolProperty : getDisplayPersistenceControl()
Return Value:
Since:
DzColorProperty : getDofOverlayColorControl()
Return Value:
Since:
DzFloatProperty : getDofOverlayOpacityControl()
Return Value:
Since:
DzColorProperty : getDofPlaneColorControl()
Return Value:
Since:
DzBoolProperty : getDofPlaneVisibilityControl()
Return Value:
Since:
DzBoolProperty : getFarDofPlaneVisibilityControl()
Return Value:
Since:
DzFloatProperty : getFocalDistanceControl()
Return Value:
Since:
DzFloatProperty : getFocalLengthControl()
Return Value:
Since:
DzFloatProperty : getFocalPointScaleControl()
Return Value:
Since:
DzColorProperty : getFovColorControl()
Return Value:
Since:
DzFloatProperty : getFovLengthControl()
Return Value:
Since:
DzFloatProperty : getFovOpacityControl()
Return Value:
Since:
DzFloatProperty : getFrameWidthControl()
Return Value:
Since:
DzFloatProperty : getFStopControl()
Return Value:
Since:
DzFloatProperty : getHeadlampIntensityControl()
Return Value:
Since:
DzEnumProperty : getHeadlampModeControl()
Return Value:
Since:
DzFloatProperty : getLensDistortionK1Control()
Return Value:
See Also:
Since:
DzFloatProperty : getLensDistortionK2Control()
Return Value:
See Also:
Since:
DzFloatProperty : getLensDistortionK3Control()
Return Value:
See Also:
Since:
DzFloatProperty : getLensDistortionK4Control()
Return Value:
See Also:
Since:
DzFloatProperty : getLensDistortionK5Control()
Return Value:
See Also:
Since:
DzFloatProperty : getLensDistortionScaleControl()
Return Value:
Since:
DzEnumProperty : getLensDistortionTypeControl()
Return Value:
Attention:
ru
and the distorted radial pixel coordinate rd
with regards to the ideal perspective camera.rd = ru * (1 - k1 + k1 * ru2)
ru = rd * (1 - k1 + k1 * rd2)
also
make use of the value of getLensDistortionK2Control()rd = ru * (1 + k1 * ru2 + k2 * ru4)
ru = rd * (1 + k1 * rd2 + k2 * rd4)
also
make use of the value of getLensDistortionK3Control()rd = ru * (1 - k1 - k2 - k3 + k1 * ru + k2 * ru2 + k3 * ru3)
ru = rd * (1 - k1 - k2 - k3 + k1 * rd + k2 * rd2 + k3 * rd3)
also
make use of the values of getLensDistortionK4Control() and getLensDistortionK5Control()rd = ru * (k1 + k2 * ru + k3 * ru2 + k4 * ru3 + k5 * ru4)
ru = rd * (k1 + k2 * rd + k3 * rd2 + k4 * rd3 + k5 * rd4)
ru = k1 + k2 * rd + k3 * rd2 + k4 * rd3 + k5 * rd4
Since:
DzFloatProperty : getLensMaximumFovControl()
Return Value:
See Also:
Since:
DzFloatProperty : getLensRadialBiasControl()
Return Value:
Since:
DzFloatProperty : getLensShiftXControl()
Return Value:
Since:
DzFloatProperty : getLensShiftYControl()
Return Value:
Since:
DzFloatProperty : getLensStereoOffsetControl()
Return Value:
Since:
DzFloatProperty : getLensThicknessControl()
Return Value:
Since:
DzBoolProperty : getNearDofPlaneVisibilityControl()
Return Value:
Since:
DzBoolProperty : getPerspectiveControl()
Return Value:
Since:
DzInt2Property : getPixelSizeControl()
Return Value:
Since:
DzFloatProperty : getSightLineOpacityControl()
Return Value:
Since:
DzBoolProperty : getUseLocalDimensionsControl()
Return Value:
Since:
DzFloatProperty : getXHeadlampOffsetControl()
Return Value:
Since:
DzFloatProperty : getYHeadlampOffsetControl()
Return Value:
Since:
DzFloatProperty : getZHeadlampOffsetControl()
Return Value:
Since:
Boolean : isAtDefaultSceneCameraValues()
Return Value:
true
if this camera is at default scene camera values, otherwise false
.Boolean : isDefaultSceneCamera()
Return Value:
true
if this camera is the default scene camera, otherwise false
.void : setIsDefaultSceneCamera( Boolean yesNo )
Parameter(s):
true
, sets this camera as the default scene camera.Attention:
void : setType( DzCamera::CameraType type )
Changes the type of the camera.
Parameter(s):
DzFloatProperty : getFrameWidthChannel()
Deprecated
Exists only to keep old code working. Do not use in new code. Use getFrameWidthControl() instead.
DzFloatProperty : getFocalLengthChannel()
Deprecated
Exists only to keep old code working. Do not use in new code. Use getFocalLengthControl() instead.
DzBoolProperty : getDepthOfFieldChannel()
Deprecated
Exists only to keep old code working. Do not use in new code. Use getDepthOfFieldControl() instead.
DzFloatProperty : getFocalDistChannel()
Deprecated
Exists only to keep old code working. Do not use in new code. Use getFocalDistanceControl() instead.
DzFloatProperty : getFStopChannel()
Deprecated
Exists only to keep old code working. Do not use in new code. Use getFStopControl() instead.
DzBoolProperty : getDisplayPersistenceChannel()
Deprecated
Exists only to keep old code working. Do not use in new code. Use getDisplayPersistenceControl() instead.
DzFloatProperty : getSightLineOpacityChannel()
Deprecated
Exists only to keep old code working. Do not use in new code. Use getSightLineOpacityControl() instead.
DzFloatProperty : getFocalPointScaleChannel()
Deprecated
Exists only to keep old code working. Do not use in new code. Use getFocalPointScaleControl() instead.
DzColorProperty : getFovColorChannel()
Deprecated
Exists only to keep old code working. Do not use in new code. Use getFovColorControl() instead.
DzFloatProperty : getFovOpacityChannel()
Deprecated
Exists only to keep old code working. Do not use in new code. Use getFovOpacityControl() instead.
DzFloatProperty : getFovLengthChannel()
Deprecated
Exists only to keep old code working. Do not use in new code. Use getFovLengthControl() instead.
DzBoolProperty : getDofVisibilityChannel()
Deprecated
Exists only to keep old code working. Do not use in new code. Use getDofPlaneVisibilityControl() instead.
DzColorProperty : getDofColorChannel()
Deprecated
Exists only to keep old code working. Do not use in new code. Use getDofPlaneColorControl() instead.
DzColorProperty : getDofOverlayColorChannel()
Deprecated
Exists only to keep old code working. Do not use in new code. Use getDofOverlayColorControl() instead.
DzFloatProperty : getDofOverlayOpacityChannel()
Deprecated
Exists only to keep old code working. Do not use in new code. Use getDofOverlayOpacityControl() instead.
DzBoolProperty : getNearDofVisibilityChannel()
Deprecated
Exists only to keep old code working. Do not use in new code. Use getNearDofPlaneVisibilityControl() instead.
DzBoolProperty : getFarDofVisibilityChannel()
Deprecated
Exists only to keep old code working. Do not use in new code. Use getFarDofPlaneVisibilityControl() instead.
void : depthOfFieldChanged()
Signature:“projectionChanged()”
Emitted when the camera's depth of field setting has changed.
void : fStopChanged( DzTimeRange range )
Signature:“fStopChanged(const DzTimeRange&)”
Emitted when the camera's f-Stop setting has changed.