Language:
Page Info
Tags:
Engine Version:

NVIDIA Ansel Blueprint Node Reference

Choose your OS:

You can customize the end user's experience with the Ansel Photography plugin in order to improve that experience, i.e. by disabling certain effects that don't work well in captures, or to control the experience, such as limiting the movement of the camera. Several Blueprint events and functions are available to implement logic to customize the player's experience.

Events

On Photography Session Start

Event triggered upon entering Photography mode (before pausing, if r.Photography.AutoPause is 1).

Event On Photography Session Start

On Photography Session End

Event triggered upon leaving Photography mode (after unpausing, if r.Photography.AutoPause is 1).

Event On Photography Session End

On Photography Multi Part Capture Start

Event triggered upon the start of a multi-part photograph capture (i.e. a stereoscopic or 360-degree shot). This is an ideal time to turn off rendering effects that tile badly (UI, subtitles, vignette, very aggressive bloom, etc; most of these are automatically disabled when r.Photography.AutoPostprocess is 1).

Event On Photography Multi Part Capture Start

On Photography Multi Part Capture End

Event triggered upon the end of a multi-part photograph capture, when manual free-roaming photographic camera control is about to be returned to the user. Here you may re-enable whatever was turned off within OnPhotographyMultiPartCaptureStart.

Event On Photography Multi Part Capture End

Overridable Functions

To override the functions listed below:

  1. Create a new Blueprint Class with Player Camera Manager as the parent and open it in the Blueprint Editor.

  2. In the My Blueprint panel, place the mouse cursor over the Functions heading and click Override.

    BIE_Override.png

  3. Select the function you wish to override from the list of overridable functions. The function appears in the Functions list and the graph for it is opened so you can edit it.

Photography Camera Modify

This allows a PlayerCameraManager subclass to constrain or otherwise modify the camera during free-camera photography. For example, a blueprint may wish to limit the distance from the camera's original point, or forbid the camera from passing through walls. This function gives you the original, previous, and proposed camera positions and takes your modified camera position as a result.

PhotoCameraModify.png

Example

Below, is an example implementation of Photography Camera Modify which limits the photography camera to within 200 Unreal Units of its original position:

Tags