Navigation
API > API/Runtime > API/Runtime/CinematicCamera
A specialized version of a camera component, geared toward cinematic usage.
| Name | UCineCameraComponent |
| Type | class |
| Header File | /Engine/Source/Runtime/CinematicCamera/Public/CineCameraComponent.h |
| Include Path | #include "CineCameraComponent.h" |
Syntax
UCLASS (HideCategories=(CameraSettings), HideFunctions=(SetFieldOfView, SetAspectRatio),
Blueprintable, ClassGroup=Camera, Meta=(BlueprintSpawnableComponent), Config=Engine,
MinimalAPI)
class UCineCameraComponent : public UCameraComponent
Inheritance Hierarchy
- UObjectBase → UObjectBaseUtility → UObject → UActorComponent → USceneComponent → UCameraComponent → UCineCameraComponent
Implements Interfaces
Derived Classes
Constructors
| Name | Remarks | Include Path | Unreal Specifiers |
|---|---|---|---|
UCineCameraComponent() |
Default constuctor. | CineCameraComponent.h |
Variables
Public
| Name | Type | Remarks | Include Path | Unreal Specifiers |
|---|---|---|---|---|
| bOverride_CustomNearClippingPlane | uint32 | CineCameraComponent.h |
|
|
| CropSettings | FPlateCropSettings | Controls the crop settings. | CineCameraComponent.h |
|
| CurrentAperture | float | Current aperture, in terms of f-stop (e.g. 2.8 for f/2.8) | CineCameraComponent.h |
|
| CurrentFocalLength | float | Current focal length of the camera (i.e. controls FoV, zoom) | CineCameraComponent.h |
|
| CurrentFocusDistance | float | Read-only. Control this value via FocusSettings. | CineCameraComponent.h |
|
| CurrentHorizontalFOV | float | Read-only. Control this value with CurrentFocalLength (and filmback settings). | CineCameraComponent.h |
|
| CustomNearClippingPlane | float | Set bOverride_CustomNearClippingPlane to true if you want to use a custom clipping plane instead of GNearClippingPlane. | CineCameraComponent.h |
|
| ExposureMethod | ECameraExposureMethod | Exposure method, for determining whether exposure-related post-process settings should be automatically set from camera parameters | CineCameraComponent.h |
|
| Filmback | FCameraFilmbackSettings | Controls the filmback of the camera. | CineCameraComponent.h |
|
| FocusSettings | FCameraFocusSettings | Controls the camera's focus. | CineCameraComponent.h |
|
| LensSettings | FCameraLensSettings | Controls the camera's lens. | CineCameraComponent.h |
|
Functions
Public
| Name | Remarks | Include Path | Unreal Specifiers |
|---|---|---|---|
virtual void GetCameraView
(
float DeltaTime, |
CineCameraComponent.h | ||
FString GetCropPresetName() |
Returns the lens name of the camera with the current settings. | CineCameraComponent.h |
|
FString GetDefaultFilmbackPresetName() |
Returns the name of the default filmback preset. | CineCameraComponent.h |
|
FString GetFilmbackPresetName() |
Returns the filmback name of the camera with the current settings. | CineCameraComponent.h |
|
virtual FText GetFilmbackText() |
CineCameraComponent.h | ||
float GetHorizontalFieldOfView() |
Returns the horizonal FOV of the camera with current settings. | CineCameraComponent.h |
|
float GetHorizontalProjectionOffset() |
CineCameraComponent.h |
|
|
FString GetLensPresetName() |
Returns the lens name of the camera with the current settings. | CineCameraComponent.h |
|
float GetVerticalFieldOfView() |
Returns the vertical FOV of the camera with current settings. | CineCameraComponent.h |
|
float GetVerticalProjectionOffset() |
CineCameraComponent.h |
|
|
float GetWorldToMetersScale() |
Returns the world to meters scale for the current UWorld | CineCameraComponent.h | |
void SetCropPresetByName
(
const FString& InPresetName |
Set the current lens settings by preset name. | CineCameraComponent.h |
|
void SetCropSettings
(
const FPlateCropSettings& NewCropSettings |
CineCameraComponent.h |
|
|
void SetCurrentAperture
(
const float NewCurrentAperture |
CineCameraComponent.h |
|
|
void SetCurrentFocalLength
(
float InFocalLength |
CineCameraComponent.h |
|
|
void SetCustomNearClippingPlane
(
const float NewCustomNearClippingPlane |
Sets near clipping plane of the cine camera. | CineCameraComponent.h |
|
virtual void SetFieldOfView
(
float InFieldOfView |
Override setting FOV to manipulate Focal Length. | CineCameraComponent.h | |
void SetFilmback
(
const FCameraFilmbackSettings& NewFilmback |
CineCameraComponent.h |
|
|
void SetFilmbackPresetByName
(
const FString& InPresetName |
Set the current preset settings by preset name. | CineCameraComponent.h |
|
void SetFocusSettings
(
const FCameraFocusSettings& NewFocusSettings |
CineCameraComponent.h |
|
|
void SetLensPresetByName
(
const FString& InPresetName |
Set the current lens settings by preset name. | CineCameraComponent.h |
|
void SetLensSettings
(
const FCameraLensSettings& NewLensSettings |
CineCameraComponent.h |
|
|
void UpdateDebugFocusPlane() |
Update the debug focus plane position and orientation. | CineCameraComponent.h |
Protected
| Name | Remarks | Include Path | Unreal Specifiers |
|---|---|---|---|
virtual void NotifyCameraCut() |
CineCameraComponent.h | ||
virtual void OnComponentDestroyed
(
bool bDestroyingHierarchy |
CineCameraComponent.h | ||
virtual void OnRegister() |
CineCameraComponent.h | ||
virtual void PostEditChangeProperty
(
FPropertyChangedEvent& PropertyChangedEvent |
CineCameraComponent.h | ||
virtual void PostInitProperties() |
CineCameraComponent.h | ||
void RecalcDerivedData() |
CineCameraComponent.h | ||
virtual void ResetProxyMeshTransform() |
CineCameraComponent.h | ||
virtual void Serialize
(
FArchive& Ar |
CineCameraComponent.h | ||
virtual void TickComponent
(
float DeltaTime, |
CineCameraComponent.h | ||
virtual void UpdateCameraLens
(
float DeltaTime, |
CineCameraComponent.h |
Static
| Name | Remarks | Include Path | Unreal Specifiers |
|---|---|---|---|
static TArray< FNamedFilmbackPreset > const & GetFilmbackPresets() |
Returns a list of available filmback presets. | CineCameraComponent.h | |
static TArray< FNamedFilmbackPreset > GetFilmbackPresetsCopy() |
Returns a copy of the list of available filmback presets. | CineCameraComponent.h |
|
static TArray< FNamedLensPreset > const & GetLensPresets() |
Returns a list of available lens presets. | CineCameraComponent.h | |
static TArray< FNamedLensPreset > GetLensPresetsCopy() |
Returns a copy of the list of available lens presets. | CineCameraComponent.h |
|
Deprecated Variables
| Name | Type | Remarks | Include Path | Unreal Specifiers |
|---|---|---|---|---|
| DefaultFilmbackPresetName_DEPRECATED | FString | Deprecated. See DefaultFilmbackPreset | CineCameraComponent.h |
|
| FilmbackSettings_DEPRECATED | FCameraFilmbackSettings | CineCameraComponent.h |