Difference between revisions of "IC Python API:RLPy RICamera"

Revision as of 02:14, 9 April 2020

Main article: Modules.

Last modified: 04/9/2020

Description

This class is used to access camera objects in the scene. A camera can be divided into 3 main parts: the device body, camera lens, and viewing area. Therefore, the interfaces available are: aperture, focal length, angle of view, depth of field, near / far plane settings, and viewport fitting.

See Also: RCameraDofData, RScene.

Inheritance

RIBase > RIObject > RICamera 

Examples

camera = RLPy.RScene.FindObject(RLPy.EObjectType_Camera, "Camera")

# Set the camera transform values
control = camera.GetControl("Transform")
transform = RLPy.RTransform.IDENTITY
transform.T().x = -75.0
transform.T().y = -150.0
transform.T().z = 250.0
time = RLPy.RTime(0)
control.SetValue(time, transform)
# update after adding a key
camera.Update()

# Set the camera name
camera.SetName( "new_name" )

# Get camera bounds
ret_max = RLPy.RVector3()
ret_center = RLPy.RVector3()
ret_min = RLPy.RVector3()
ret = camera.GetBounds( ret_max, ret_center, ret_min )
print(ret)

# Get the camera pivot transform values
ret_pos = RLPy.RVector3()
ret_rot = RLPy.RVector3()
camera.GetPivot( ret_pos, ret_rot )
print(ret)

# Check whether or the camera is selected
RLPy.RScene.SelectObject(camera)
print(camera.IsSelected()) #True

Member Functions

AddDofKey ( self, kKey, kDofData )

Key the camera's Depth of Field (DOF) at a given time. Use RCameraDofData to adjust the DOF settings.

Parameters

kKey [IN] Designated time - RKey

kDofData [IN] DOF settings - RCameraDofData

Returns

Success - RLPy.RStatus.Success

Failure - RLPy.RStatus.Failure

# Add a DOF key
new_data = RLPy.RCameraDofData()
new_data.SetEnable( True )
new_data.SetFocus(20)
data.SetRange(80)
dof_key = RLPy.RKey()
dof_key.SetTime(RLPy.RTime(66))
dof_key.SetTransitionType(RLPy.ETransitionType_Linear)
dof_key.SetTransitionStrength(50)
camera.AddDofKey(dof_key, new_data)

GetAngleOfView ( self, kTime )

Get the camera's Angle of View (AOV) at a given time, in degrees (1° to 165°).

Parameters

kTime [IN] Time at which to get the AOV value - RTime

Returns

The camera's angle of view - float

camera = RLPy.RScene.FindObject(RLPy.EObjectType_Camera, "Camera")
camera.GetAngleOfView(RLPy.RGlobal.GetTime())

GetAperture ( self, fWidth, fHeight )

Get the camera's aperture dimensions, i.e. the width and height of the photo-sensitive capture plate.

Parameters

fWidth [IN] Width of the camera aperture - float

fHeight [IN] Height of the camera aperture - float

Returns

Success - RLPy.RStatus.Success

Failure - RLPy.RStatus.Failure

# Get the camera aperture
width = 0
height = 0
result = camera.GetAperture(width,height)
print(result[0])
print(result[1])
print(result[2])

GetDOFData ( self )

Get the camera's Depth of Field (DOF) data.

Returns

Camera DOF data - RCameraDofData

# Grab camera DOF data
camera = RLPy.RScene.FindObject(RLPy.EObjectType_Camera, "Camera")
data = camera.GetDOFData()
if data is not None:
       print(data.GetEnable())
       print(data.GetFocus())
       print(data.GetRange())
       print(data.GetNearTransitionRegion())
       print(data.GetFarTransitionRegion())
       print(data.GetNearBlurScale())
       print(data.GetFarBlurScale())
       print(data.GetMinBlendDistance())
       print(data.GetCenterColorWeight())
       print(data.GetEdgeDecayPower())

GetFarClippingPlane ( self )

Get the camera's Far Clipping Plane distance.

Returns

The camera's far clipping plane distance - int

camera = RLPy.RScene.FindObject(RLPy.EObjectType_Camera, "Camera")
far_clipping_plane = camera.GetFarClippingPlane()

GetFitFovType ( self )

Get the camera's Fit value for the Field of View. The possible values are the following:

• RLPy.ECameraFitResolution_Horizontal - use the horizontal width value for fitting.
• RLPy.ECameraFitResolution_Vertical - use the vertical height value for fitting.

Returns

the type of setting ( Horizontal / Vertical ) - RLPy.ECameraFitResolution

• RLPy.ECameraFitResolution_Horizontal
• RLPy.ECameraFitResolution_Vertical
• RLPy.ECameraFitResolution_None

camera = RLPy.RScene.FindObject(RLPy.EObjectType_Camera, "Camera")
fov_type = camera.GetFitRenderRegionType()
print(fov_type)

GetFitRenderRegionType ( self )

Get the camera's Fit Resolution setting. The possible values are the following:

• RLPy.ECameraFitResolution_Horizontal - use the horizontal width value for fitting.
• RLPy.ECameraFitResolution_Vertical - use the vertical height value for fitting.

Returns

The camera's Fit Type ( Horizontal / Vertical ) - RLPy.ECameraFitResolution

• RLPy.ECameraFitResolution_Horizontal
• RLPy.ECameraFitResolution_Vertical
• RLPy.ECameraFitResolution_None

type = camera.GetFitRenderRegionType()

GetFocalLength ( self, kTime )

Get the camera's Focal Length distance at a given time.

Parameters

kTime [IN] Time at which to get the Focal Length distance - RTime

Returns

Camera's focal length distance at a given time, in millimeters (2.5 mm to 3,500 mm) - float

camera = RLPy.RScene.FindObject(RLPy.EObjectType_Camera, "Camera")
camera.GetFocalLength(RLPy.RTime(60))    # get focal length

GetNearClippingPlane ( self )

Get the camera's Near Clipping Plane distance.

Returns

The Near Clipping Plane distance (always a positive value) - int

camera = RLPy.RScene.FindObject(RLPy.EObjectType_Camera, "Camera")
camera.GetNearClippingPlane()

SetFarClippingPlane ( self, nFarPlane )

Set the Far Clipping Plane distance. This value must be larger than the Near Clipping Plane distance.

Parameters

nFarPlane [IN] Far Clipping Plane distance - int

Returns

Success - RLPy.RStatus.Success

Failure - RLPy.RStatus.Failure

camera = RLPy.RScene.FindObject(RLPy.EObjectType_Camera, "Camera")
camera.SetFarClippingPlane(RLPy.RTime(60), 1000.0)
print(camera.GetFarClippingPlane())

SetFocalLength ( self, kTime, fFocalLength )

Set the camera's Focal Length at a given point in time. The possible values lie between 2.5 and 3,500 mm. If the value set lies outside of this range, then the original Focal Length value remains unchanged.

Parameters

kTime [IN] Time for setting the focal length - RTime

fFocalLength [IN] Target distance for the focal length in millimeters - float

Returns

Success - RLPy.RStatus.Success

Failure - RLPy.RStatus.Failure

camera = RLPy.RScene.FindObject(RLPy.EObjectType_Camera, "Camera")
camera.SetFocalLength(RLPy.RTime(60), 100.0)

SetNearClippingPlane ( self, nNearPlane )

Set the Near Clipping Plane distance, must be smaller than the Far Clipping Plane distance.

Parameters

nNearPlane [IN] The Near Clipping Plane distance - int

Returns

Success - RLPy.RStatus.Success

Failure - RLPy.RStatus.Failure

camera = RLPy.RScene.FindObject(RLPy.EObjectType_Camera, "Camera")
camera.SetNearClippingPlane(RLPy.RTime(60), 10.0)
print(camera.GetNearClippingPlane())