> For the complete documentation index, see [llms.txt](https://docs.v-nova.com/technologies/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.v-nova.com/technologies/v-nova.presenz/getting-started/getting-started-with-v-nova-presenz-player.md).

# Getting Started with V-Nova PresenZ Player

Use V-Nova PresenZ Player to build and view PresenZ shots and sequences in VR. The player supports basic finishing adjustments and performance monitoring. Use its overlays and graphs to diagnose playback and rendering issues.

{% embed url="<https://vimeo.com/1167393933?fe=ci&fl=sv&share=copy>" %}

{% embed url="<https://vimeo.com/1167394284?fe=ci&fl=sv&share=copy>" %}

### Introduction

V-Nova PresenZ Player is a compact application for building and viewing PresenZ-based VR shots. It provides utilities for working with PresenZ files. It also includes performance graphs for diagnosing issues and improving playback.

**Features**

* View PresenZ content in VR
* Manage files with drag and drop
* Monitor performance with visual graphs
* Apply basic post-processing adjustments
* Customise a focused user interface

### UI overview

V-Nova PresenZ Player has a focused interface. Access its actions from the **Movie**, **View**, and **Performance** menus.

<div align="center"><figure><img src="/files/217AvDERcNn9IMAInXyK" alt="" width="375"><figcaption></figcaption></figure></div>

<div align="center"><img src="/files/xX20WMvT0MAsdBI9u2wF" alt=""></div>

{% tabs %}
{% tab title="Movie" %}

* Open
* Movie info
* Scene info
* Frame info
  {% endtab %}

{% tab title="View" %}

* Keys
* Playback
* Log
* Display colours
* About
* Inspect particles
* Adjust scene
* Postprocessing
* Shader tweaks
* Camera position
  {% endtab %}

{% tab title="Performance" %}

* Frame loader
* Audio
* Rendering
* Frame graph
* GPU memory
  {% endtab %}
  {% endtabs %}

### Supported media

The primary media type is <mark style="color:blue;">.prz</mark>. This losslessly compressed format is generated from <mark style="color:blue;">.przRender</mark> files. It supports efficient playback in the player.\
\
The player supports these file types:

#### PresenZ formats

* <mark style="color:blue;">.przShot</mark>
* <mark style="color:blue;">.prz</mark>

#### Background images

* <mark style="color:blue;">.png</mark>
* <mark style="color:blue;">.jpeg</mark>
* <mark style="color:blue;">.pitex</mark>
* <mark style="color:blue;">.exr</mark>

#### Background video

* <mark style="color:blue;">.mp4</mark> (HEVC)

#### Audio

* <mark style="color:blue;">.opus</mark>

## Movie

### Open and load media

Load media by dragging files into the workspace. Alternatively, select **Movie** → **Open**. The file browser lets you add files or open a <mark style="color:blue;">.przToc</mark> file for editing.

<figure><img src="/files/e0VftUYmzqleyG14tc85" alt=""><figcaption></figcaption></figure>

### Builder

Use the Builder to create and test shots. It automatically adds files dropped into the workspace. The Builder saves the scene as a <mark style="color:blue;">.przToc</mark> file. See [File formats and structures in V-Nova PresenZ](broken://spaces/i6eg1dFhczcq6mxQYODq/pages/o95AgbmklULmM7R1WCsv) for file-type details. The Builder header shows the file location and common directory.

<figure><img src="/files/zOCO69XRoQ82I4xYVsgy" alt=""><figcaption></figcaption></figure>

Added files appear in the **Files** section. Assemble the shot in the **Scene** section. This layout reflects the PresenZ three-stage construction. Drag files into the appropriate section.

**FG**: (Foreground) The Animated PresenZ Volumetric layer\
**BG:** (Background) The static PresenZ volumetric layer\
**Env**: The 360 environment sphere image or video layer<br>

### Movie info

View the number of frames and scenes, the current position, and file locations. Use this window to quickly identify sequence and frame numbers when investigating artifacts.

<figure><img src="/files/lJAJ404SUwsXkF5PBQxZ" alt=""><figcaption></figcaption></figure>

### Scene info

View information about the current scene. Create, remove, and switch scenes in the Builder. You can also use keyboard shortcuts.

<figure><img src="/files/TfDKXOwithrkavQX4iGK" alt=""><figcaption></figcaption></figure>

### Frame info

View the current layers, particle counts, motion vectors, compression, and format.

<figure><img src="/files/KdsuXOJD4ihMGgOcHiIf" alt=""><figcaption></figcaption></figure>

## View

### Keys

View the current keyboard shortcuts.

<figure><img src="/files/JT2nSAj5xFAowRwYBnii" alt=""><figcaption></figcaption></figure>

### Playback

Control shot playback speed and switch scenes.

<figure><img src="/files/qGd96MnqQoDwVpXwDCGT" alt=""><figcaption></figcaption></figure>

### Log

View information about actions in the scene. Some tools send diagnostic data here.

<figure><img src="/files/BEyqQpzK6Ce2y1kfk8R9" alt=""><figcaption></figcaption></figure>

### Display colours

View and change colour settings to match the input material.

<figure><img src="/files/CSKqRTV35bF6yv7qKiLS" alt=""><figcaption></figcaption></figure>

### About

View the installed V-Nova PresenZ Player version.

<figure><img src="/files/80ZDdQqyySFqhsXMHQKe" alt=""><figcaption></figcaption></figure>

### Inspect particles

Use this window with motion vectors to inspect particles and asset density. Enable the debug sky to replace the background with bright purple. This helps confirm that the PresenZ render contains complete geometry.

<figure><img src="/files/iCMNDtHbAjyTWuLx7cWN" alt=""><figcaption></figcaption></figure>

### Adjust scene

Make scene-level adjustments that persist until you reopen the movie. Rotate a background HDRI and adjust sound positioning. You can also set the viewing perspective before playback. This lets you position and rotate the VR agent away from the origin.

<figure><img src="/files/7ltQB4PZUo1NhSAm7fjT" alt=""><figcaption></figcaption></figure>

### Post-processing

Apply minor effects and adjustments to every scene. Available controls include fog, glow, brightness, and depth of field. These settings persist until you reopen the player.

<figure><img src="/files/Tck0KgL74U2HN5iX79AE" alt=""><figcaption></figcaption></figure>

### Shader tweaks

This developer feature supports adjustments to custom shaders in the player. It is covered in the advanced documentation and is not intended for standard use.

<figure><img src="/files/CnDZYw2jyLtakdEMzxL9" alt=""><figcaption></figcaption></figure>

### Camera position

Copy values between cameras. This helps maintain a consistent viewpoint between shots and avoids jarring cuts. Use it to check the current camera position across multiple shots.

<figure><img src="/files/M7Af6TLF5wIkkQbpkM9T" alt=""><figcaption></figcaption></figure>

## Performance

### Frame loader

View the frames currently loaded in the buffer and the playback frame rate. If the top bars reach the warning lines, the decoded-frame buffer may decrease.

<figure><img src="/files/C0WkDtp0Db6WgTFcAD1v" alt=""><figcaption></figcaption></figure>

### Audio

View the current audio and its load time. Use this information to diagnose sound issues.

<div align="center"><img src="/files/FPDw82N8eaLWCfWpDFv5" alt=""> <img src="/files/Mh7ljY0g97xZ5eBmHH6j" alt=""></div>

### Rendering

View the current render speed and active processing. Use the graph to analyse dropped frames and slow playback.

<figure><img src="/files/idGmkZgqdB51H5nlFVK7" alt=""><figcaption></figcaption></figure>

<div align="center"><img src="/files/bwuKAzKH1Kpy7ZB5XqRU" alt=""></div>

### Frame Graph

View the high, low, and average playback frame rates. You can also send this information to the log. The window shows the number of accumulated frames at the top. Enable **Report to log**, then use **Pause** to capture data between log entries.

<figure><img src="/files/R56qxnXb58G4Q1Myj6JW" alt=""><figcaption></figcaption></figure>

### GPU Memory

View current GPU memory usage, broken down by section.

<figure><img src="/files/7OE77QTlXEMkjxpMTjhz" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.v-nova.com/technologies/v-nova.presenz/getting-started/getting-started-with-v-nova-presenz-player.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.