# 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.](https://2561100106-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff6JZovzOqBctA4C1o76u%2Fuploads%2Fgit-blob-4bc9b8737eb953e90696364681fb8fc8f13a62c4%2Fgetmediaprogressnodereal.png?alt=media)

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**](https://docs.incari.com/incari-studio/2023.2/overview#scopes): **Scene**, **Function**, **Prefab**.

### Attributes

![The Get Media Progress Node Attributes.](https://2561100106-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff6JZovzOqBctA4C1o76u%2Fuploads%2Fgit-blob-b2e269cc02a25c33fdc2067eea51c69e23f67707%2Fsetmediaprogressattsreal.png?alt=media)

| 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.](https://2561100106-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff6JZovzOqBctA4C1o76u%2Fuploads%2Fgit-blob-37068db5dce4dec841001e91fed98a1002c2e935%2Fgetmediaprogresspercentage.png?alt=media)

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**](https://docs.incari.com/incari-studio/2023.2/overview#scopes): **Scene**, **Function**, **Prefab**.

### Attributes

![The Get Media Progress Node Attributes.](https://2561100106-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff6JZovzOqBctA4C1o76u%2Fuploads%2Fgit-blob-692465f5e5b0f5ed4fa581fc939d4c0e1337415f%2Fgetmediaprogressattspercentages.png?alt=media)

| 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.](https://2561100106-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff6JZovzOqBctA4C1o76u%2Fuploads%2Fgit-blob-22eaa45ad89b799dbf4cee7e9147e7a43bae574f%2Fgetmediaprogressnode.png?alt=media)

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**](https://docs.incari.com/incari-studio/2023.2/overview#scopes): **Scene**, **Function**, **Prefab**.

### Attributes

![The Get Media Progress Node Attributes.](https://2561100106-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff6JZovzOqBctA4C1o76u%2Fuploads%2Fgit-blob-e4f03eee807603a1d7a868a702ccfe1cc3bbba0a%2Fgetmediaprogressattsseconds.png?alt=media)

| 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](https://docs.incari.com/incari-studio/2023.2/toolbox/incari/media/setmediaprogress)