# Get Media Progress

This **Node** can be used to navigate to a particular point of a **Media** **Object**. It has three different versions depending on the `Format` chosen. Find in the tabs below the documentation for all versions.

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

### Overview

![The Get Media Progress Node.](/files/2vHvot9uKBqpiccg8kKQ)

The **Get Media Progress Node** returns the partial duration of time that has progressed out of a **Media Object’s** temporal entirety in either `Frames`, `Seconds`, or a `Percentage`.

[**Scope**](/incari-studio/2023.2/toolbox/overview.md#scopes): **Scene**, **Function**, **Prefab**.

### Attributes

![The Get Media Progress Node Attributes.](/files/qUGuB2BqfoVaVwn1QGM2)

| Attribute | Type         | Description                                                                                                                          |
| --------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------ |
| `Format`  | **Dropdown** | The desired format of the time segment. It can be either `Frame Number`, `Percentage`, or `Seconds`. Here, `Frame Number` is chosen. |

### Inputs

| Input             | Type         | Description                                                           |
| ----------------- | ------------ | --------------------------------------------------------------------- |
| *Pulse Input* (►) | **Pulse**    | A standard **Input Pulse**, to trigger the execution of the **Node**. |
| `Object ID`       | **ObjectID** | The ID of the desired **Media Object**.                               |

### Outputs

| Output             | Type      | Description                                                                                                                            |
| ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| *Pulse Output* (►) | **Pulse** | A standard **Output Pulse**, to move onto the next **Node** along the **Logic Branch**, once this **Node** has finished its execution. |
| `Frame Number`     | **Int**   | The returned partial duration of time in frames, only if `Frame Number` is selected in the **Attributes**.                             |
| {% endtab %}       |           |                                                                                                                                        |

{% tab title="Percentage" %}

### Overview

![The Get Media Progress Node.](/files/ej45K7xOzbkzEYK5lejv)

The **Get Media Progress Node** returns the partial duration of time that has progressed out of a **Media Object’s** temporal entirety in either `Frames`, `Seconds`, or a `Percentage`.

[**Scope**](/incari-studio/2023.2/toolbox/overview.md#scopes): **Scene**, **Function**, **Prefab**.

### Attributes

![The Get Media Progress Node Attributes.](/files/MF682ttZHnRzZWnbUvPp)

| Attribute | Type         | Description                                                                                                                        |
| --------- | ------------ | ---------------------------------------------------------------------------------------------------------------------------------- |
| `Format`  | **Dropdown** | The desired format of the time segment. It can be either `Frame Number`, `Percentage`, or `Seconds`. Here, `Percentage` is chosen. |

### Inputs

| Input             | Type         | Description                                                           |
| ----------------- | ------------ | --------------------------------------------------------------------- |
| *Pulse Input* (►) | **Pulse**    | A standard **Input Pulse**, to trigger the execution of the **Node**. |
| `Object ID`       | **ObjectID** | The ID of the desired **Media Object**.                               |

### Outputs

| Output             | Type      | Description                                                                                                                            |
| ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| *Pulse Output* (►) | **Pulse** | A standard **Output Pulse**, to move onto the next **Node** along the **Logic Branch**, once this **Node** has finished its execution. |
| `Percentage`       | **Float** | The returned partial duration of time as a percentage, only if `Percentage` is selected in the **Attributes**.                         |
| {% endtab %}       |           |                                                                                                                                        |

{% tab title="Seconds" %}

### Overview

![The Get Media Progress Node.](/files/RDeDFLK7yUz4iZEF3LiN)

The **Get Media Progress Node** returns the partial duration of time that has progressed out of a **Media Object’s** temporal entirety in either `Frames`, `Seconds`, or a `Percentage`.

[**Scope**](/incari-studio/2023.2/toolbox/overview.md#scopes): **Scene**, **Function**, **Prefab**.

### Attributes

![The Get Media Progress Node Attributes.](/files/lvRghuO7o9AFKYacyAn1)

| Attribute | Type         | Description                                                                                                                     |
| --------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------- |
| `Format`  | **Dropdown** | The desired format of the time segment. It can be either `Frame Number`, `Percentage`, or `Seconds`. Here, `Seconds` is chosen. |

### Inputs

| Input             | Type         | Description                                                           |
| ----------------- | ------------ | --------------------------------------------------------------------- |
| *Pulse Input* (►) | **Pulse**    | A standard **Input Pulse**, to trigger the execution of the **Node**. |
| `Object ID`       | **ObjectID** | The ID of the desired **Media Object**.                               |

### Outputs

| Output             | Type      | Description                                                                                                                            |
| ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| *Pulse Output* (►) | **Pulse** | A standard **Output Pulse**, to move onto the next **Node** along the **Logic Branch**, once this **Node** has finished its execution. |
| `Seconds`          | **Float** | The returned partial duration of time in seconds, only if `Seconds` is selected in the **Attributes**.                                 |
| {% endtab %}       |           |                                                                                                                                        |
| {% endtabs %}      |           |                                                                                                                                        |

## See Also

* [Set Media Progress](/incari-studio/2023.2/toolbox/incari/media/setmediaprogress.md)


---

# Agent Instructions: 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:

```
GET https://docs.incari.com/incari-studio/2023.2/toolbox/incari/media/getmediaprogress.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.