---
name: "dtk_video_getstate"
section: "3"
platform: "linux"
package: "libdrawtk-dev"
version: "2.0-2.1"
release: "Debian 8 (Jessie)"
platforms: ["linux"]
url: "https://new.carta.tech/dtk_video_getstate"
---

# dtk\_video\_getstate(3)

returns the current state of a video texture

## NAME

dtk\_video\_getstate - returns the current state of a video texture

## SYNOPSIS

**#include \<dtk\_video.h\>**

**int dtk\_video\_getstate(dtk\_htex** *vid***);**\

## DESCRIPTION

This function returns the state of a video texture referenced by *vid* created by one of the functions **dtk\_create\_video\_\***(3) and is a BITOR combination of the following flags:

- **DTKV\_PLAYING** : Indicates whether the video is paused or playing

  - **DTKV\_EOS** : Indicates that the end of the video stream has been reached

  ## RETURN VALUE

This function returns the state of the video in case of success, -1 otherwise.

## SEE ALSO

[**dtk\_load\_video\_file**(3)](/dtk_load_video_file/3.md), [**dtk\_load\_video\_gst**(3)](/dtk_load_video_gst/3.md), [**dtk\_load\_video\_test**(3)](/dtk_load_video_test/3.md), [**dtk\_load\_video\_udp**(3)](/dtk_load_video_udp/3.md), [**dtk\_load\_video\_tcp**(3)](/dtk_load_video_tcp/3.md), [**dtk\_video\_exec**(3)](/dtk_video_exec/3.md)