unreal.CineCameraComponent

class unreal.CineCameraComponent(outer: Object | None = None, name: Name | str = 'None')

Bases: CameraComponent

A specialized version of a camera component, geared toward cinematic usage.

C++ Source:

  • Module: CinematicCamera

  • File: CineCameraComponent.h

Editor Properties: (see get_editor_property/set_editor_property)

  • absolute_location (bool): [Read-Write] If RelativeLocation should be considered relative to the world, rather than the parent

  • absolute_rotation (bool): [Read-Write] If RelativeRotation should be considered relative to the world, rather than the parent

  • absolute_scale (bool): [Read-Write] If RelativeScale3D should be considered relative to the world, rather than the parent

  • aspect_ratio (float): [Read-Write] Aspect Ratio (Width/Height)

  • aspect_ratio_axis_constraint (AspectRatioAxisConstraint): [Read-Write] Override for the default aspect ratio axis constraint defined on the local player

  • asset_user_data (Array[AssetUserData]): [Read-Write] Array of user data stored with the component

  • auto_activate (bool): [Read-Write] Whether the component is activated at creation or must be explicitly activated.

  • camera_mesh (StaticMesh): [Read-Write]

  • camera_mesh_hidden_in_game (bool): [Read-Write] If the camera mesh is visible in game. Only relevant when running editor builds.

  • can_ever_affect_navigation (bool): [Read-Write] Whether this component can potentially influence navigation

  • component_tags (Array[Name]): [Read-Write] Array of tags that can be used for grouping and categorizing. Can also be accessed from scripting.

  • constrain_aspect_ratio (bool): [Read-Write] If bConstrainAspectRatio is true, black bars will be added if the destination view has a different aspect ratio than this camera requested.

  • crop_settings (PlateCropSettings): [Read-Write] Controls the crop settings.

  • current_aperture (float): [Read-Write] Current aperture, in terms of f-stop (e.g. 2.8 for f/2.8)

  • current_focal_length (float): [Read-Write] Current focal length of the camera (i.e. controls FoV, zoom)

  • current_focus_distance (float): [Read-Only] Read-only. Control this value via FocusSettings.

  • current_horizontal_fov (float): [Read-Only] Read-only. Control this value with CurrentFocalLength (and filmback settings).

  • custom_near_clipping_plane (float): [Read-Write] Set bOverride_CustomNearClippingPlane to true if you want to use a custom clipping plane instead of GNearClippingPlane.

  • detail_mode (DetailMode): [Read-Write] If detail mode is >= system detail mode, primitive won’t be rendered.

  • draw_frustum_allowed (bool): [Read-Write] The Frustum visibility flag for draw frustum component initialization

  • editable_when_inherited (bool): [Read-Write] True if this component can be modified when it was inherited from a parent actor class

  • field_of_view (float): [Read-Write] The horizontal field of view (in degrees) in perspective mode (ignored in Orthographic mode)

    If the aspect ratio axis constraint (from ULocalPlayer, ALevelSequenceActor, etc.) is set to maintain vertical FOV, the AspectRatio property will be used to convert this property’s value to a vertical FOV.

  • filmback (CameraFilmbackSettings): [Read-Write] Controls the filmback of the camera.

  • focus_settings (CameraFocusSettings): [Read-Write] Controls the camera’s focus.

  • hidden_in_game (bool): [Read-Write] Whether to hide the primitive in game, if the primitive is Visible.

  • is_editor_only (bool): [Read-Write] If true, the component will be excluded from non-editor builds

  • lens_settings (CameraLensSettings): [Read-Write] Controls the camera’s lens.

  • lock_to_hmd (bool): [Read-Write] True if the camera’s orientation and position should be locked to the HMD

  • mobility (ComponentMobility): [Read-Write] How often this component is allowed to move, used to make various optimizations. Only safe to set in constructor.

  • on_component_activated (ActorComponentActivatedSignature): [Read-Write] Called when the component has been activated, with parameter indicating if it was from a reset

  • on_component_deactivated (ActorComponentDeactivateSignature): [Read-Write] Called when the component has been deactivated

  • ortho_far_clip_plane (float): [Read-Write] The far plane distance of the orthographic view (in world units)

  • ortho_near_clip_plane (float): [Read-Write] The near plane distance of the orthographic view (in world units)

  • ortho_width (float): [Read-Write] The desired width (in world units) of the orthographic view (ignored in Perspective mode)

  • override_aspect_ratio_axis_constraint (bool): [Read-Write] Whether to override the default aspect ratio axis constraint defined on the local player

  • override_custom_near_clipping_plane (bool): [Read-Write]

  • physics_volume_changed_delegate (PhysicsVolumeChanged): [Read-Write] Delegate that will be called when PhysicsVolume has been changed *

  • post_process_blend_weight (float): [Read-Write] Indicates if PostProcessSettings should be used when using this Camera to view through.

  • post_process_settings (PostProcessSettings): [Read-Write] Post process settings to use for this camera. Don’t forget to check the properties you want to override

  • primary_component_tick (ActorComponentTickFunction): [Read-Write] Main tick function for the Component

  • projection_mode (CameraProjectionMode): [Read-Write] The type of camera

  • relative_location (Vector): [Read-Write] Location of the component relative to its parent

  • relative_rotation (Rotator): [Read-Write] Rotation of the component relative to its parent

  • relative_scale3d (Vector): [Read-Write] Non-uniform scaling of the component relative to its parent. Note that scaling is always applied in local space (no shearing etc)

  • replicate_using_registered_sub_object_list (bool): [Read-Write] When true the replication system will only replicate the registered subobjects list When false the replication system will instead call the virtual ReplicateSubObjects() function where the subobjects need to be manually replicated.

  • replicates (bool): [Read-Write] Is this component currently replicating? Should the network code consider it for replication? Owning Actor must be replicating first!

  • should_update_physics_volume (bool): [Read-Write] Whether or not the cached PhysicsVolume this component overlaps should be updated when the component is moved. see: GetPhysicsVolume()

  • use_attach_parent_bound (bool): [Read-Write] If true, this component uses its parents bounds when attached. This can be a significant optimization with many components attached together.

  • use_field_of_view_for_lod (bool): [Read-Write] If true, account for the field of view angle when computing which level of detail to use for meshes.

  • use_pawn_control_rotation (bool): [Read-Write] If this camera component is placed on a pawn, should it use the view/control rotation of the pawn where possible? see: APawn::GetViewRotation()

  • visible (bool): [Read-Write] Whether to completely draw the primitive; if false, the primitive is not drawn, does not cast a shadow.

property crop_settings: PlateCropSettings

[Read-Write] Controls the crop settings.

Type:

(PlateCropSettings)

property current_aperture: float

[Read-Write] Current aperture, in terms of f-stop (e.g. 2.8 for f/2.8)

Type:

(float)

property current_focal_length: float

[Read-Write] Current focal length of the camera (i.e. controls FoV, zoom)

Type:

(float)

property current_focus_distance: float

[Read-Only] Read-only. Control this value via FocusSettings.

Type:

(float)

property custom_near_clipping_plane: float

[Read-Write] Set bOverride_CustomNearClippingPlane to true if you want to use a custom clipping plane instead of GNearClippingPlane.

Type:

(float)

property filmback: CameraFilmbackSettings

[Read-Write] Controls the filmback of the camera.

Type:

(CameraFilmbackSettings)

property focus_settings: CameraFocusSettings

[Read-Write] Controls the camera’s focus.

Type:

(CameraFocusSettings)

get_crop_preset_name() str

Returns the lens name of the camera with the current settings.

Return type:

str

get_default_filmback_preset_name() str

Get Default Filmback Preset Name

Return type:

str

get_filmback_preset_name() str

Returns the filmback name of the camera with the current settings.

Return type:

str

classmethod get_filmback_presets_copy() Array[NamedFilmbackPreset]

Get Filmback Presets Copy

Return type:

Array[NamedFilmbackPreset]

get_horizontal_field_of_view() float

Returns the horizonal FOV of the camera with current settings.

Return type:

float

get_lens_preset_name() str

Returns the lens name of the camera with the current settings.

Return type:

str

classmethod get_lens_presets_copy() Array[NamedLensPreset]

Get Lens Presets Copy

Return type:

Array[NamedLensPreset]

get_vertical_field_of_view() float

Returns the vertical FOV of the camera with current settings.

Return type:

float

property lens_settings: CameraLensSettings

[Read-Write] Controls the camera’s lens.

Type:

(CameraLensSettings)

property override_custom_near_clipping_plane: bool

[Read-Write]

Type:

(bool)

set_crop_preset_by_name(preset_name) None

Set the current lens settings by preset name.

Parameters:

preset_name (str) –

set_filmback_preset_by_name(preset_name) None

Set the current preset settings by preset name.

Parameters:

preset_name (str) –

set_lens_preset_by_name(preset_name) None

Set the current lens settings by preset name.

Parameters:

preset_name (str) –