> For the complete documentation index, see [llms.txt](https://docs.incari.com/incari-studio/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.incari.com/incari-studio/toolbox/incari/media/getmediaprogress.md).

# 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://1553081948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FU990HLHWA30dTfELtDUK%2Fuploads%2Fgit-blob-a87836db687d4e4ec67300d95dd92abd3c3b079f%2Fgetmediaprogressnode20241frame.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**](/incari-studio/toolbox/overview.md#scopes): **Scene**, **Function**, **Prefab**.

### Attributes

![The Get Media Progress Node Attributes.](https://1553081948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FU990HLHWA30dTfELtDUK%2Fuploads%2Fgit-blob-ce7c86f4a51c9dbc4d1c01aa378a8743aa2a91cf%2Fgetmediaprogressattsframe20241.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://1553081948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FU990HLHWA30dTfELtDUK%2Fuploads%2Fgit-blob-b2a4c7bbf0fe47a8788cf4ca6771676276a40d66%2Fgetmediaprogressnode20241percentage.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**](/incari-studio/toolbox/overview.md#scopes): **Scene**, **Function**, **Prefab**.

### Attributes

![The Get Media Progress Node Attributes.](https://1553081948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FU990HLHWA30dTfELtDUK%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://1553081948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FU990HLHWA30dTfELtDUK%2Fuploads%2Fgit-blob-f26117c5c664f285daaa5c904f5c6a5d59452ec5%2Fgetmediaprogressnode20241.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**](/incari-studio/toolbox/overview.md#scopes): **Scene**, **Function**, **Prefab**.

### Attributes

![The Get Media Progress Node Attributes.](https://1553081948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FU990HLHWA30dTfELtDUK%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](/incari-studio/toolbox/incari/media/setmediaprogress.md)