Home
Addons
Useful tools and enhancements for special demands.
Advanced
Add-ons which have to be installed individually
Video
CTRL Functions
Verwaltung von Kameras
VIDEO_OA_getCameraNumFromDp()
Returns the camera number for the given data point name.

Version Information
Release Notes, Update information, Certifications and Frequently Asked Questions.
Concepts
Your first step into modern and powerful process visualization.
Deployment
Topics, you need to know, before using WinCC OA.
Security
Go beyond the norm in cybersecurity.
Engineering
Powerful tools for easy or complex engineering tasks.
Data Management
Classify, structure and archive your data.
Business Logic / Control
Endless possibilities in data processing for your projects.
Data Visualization
User interfaces, Trends and Reports for every purpose and device.
Southbound Interfaces
The process connection to the actual machines/sensors.
Northbound Interfaces
Your portal to the cloud or supervising systems.
Web Connectivity / Network Interfaces
Data exchange, APIs and web technologies
User Management
All about authorization, authentication and login-customization.
Availability
How to get your system uptime to the maximum.
Reporting
Create state of the art project reports without limits.
Addons
Useful tools and enhancements for special demands.
- Base
  Add-ons which are included within the WinCC OA installation
- Bundles
  Add-ons which need to be installed via the "Addons" package
- Advanced
  Add-ons which have to be installed individually
  - Advanced Maintenance Suite (AMS)
  - Video
    - Video Basics
    - Object Explorer Overview
    - Camera lists
    - Sequences
    - Configurations
    - External events
    - Video Export
    - Video Workstation
    - Playback
    - Human Interface Devices (HID)
    - CTRL Functions
      - VIDEO_OA_getDefaultStreamNumForDisplay()
        Returns the default stream for a display.
      - VIDEO_OA_getDefaultStreamNumForWorkstation()
        Returns the default stream for a user interface.
      - getFrameTimestampTickInterval()
        The function of provides information about the capture time of video frames.
      - VIDEO_OA_getStreamInfo()
        Returns the stream information, which is saved in a camera data point
      - VIDEO_OA_getStreamInfoForShowLiveDefaultDisplay()
        Returns the stream information to open a live stream on a display monitor. The default stream is used.
      - VIDEO_OA_getStreamInfoForShowLiveDefaultWidget()
        Returns the stream information to open a live stream on an EWO. The default stream is used.
      - VIDEO_OA_filterKeywordValue()
        Returns the value of a keyword.
      - VIDEO_OA_getUserPermission()
        The function returns the authorization for the given action.
      - VIDEO_OA_getWorkstationDp()
        Returns the data point name of the workstation for the given manager number.
      - onFrameRate()
      - onLatestFrameTimestamp
        The Event with which the frame timestamp information is reported for video_oa/control_functions/VIDEO_OA_getFrameTimestampTickIntervall.html and video_oa/control_functions/VIDEO_OA_setFrameTimestampTickIntervall.html.
      - onStreamStateChanged()
        The event which is triggerd by a change in the stream state .
      - VIDEO_OA_openMessageInfo()
        This function opens an information window and you can adjust the message individually.
      - VIDEO_OA_openMessageInfoAnswer()
        This function opens a dialog and you can adjust the message individually.
      - VIDEO_OA_openMessageWarning()
        This function opens a warning window and you can adjust the message individually.
      - VIDEO_OA_openNoPermission()
        Opens an information window. The window informs about the required authorization level.
      - VIDEO_OA_openObjectExplorer()
        This function opens the object explorer.
      - VIDEO_OA_getDefaultStreamNumForDisplay()
        Returns the default stream for a display.
      - setFpsReportInterval()
        The function delivers the current frame rate.
      - setFrameTimestampTickInterval()
        The function sets the capture time of video frames.
      - showLiveRtsp()
        This function starts the live streaming functionality of the video application.
      - Verwaltung von Kameras
        VIDEO_OA_getCameraDpFromNum()
        Converts a camera number to appropriate camera data point name.
        VIDEO_OA_getCameraNumFromDp()
        Returns the camera number for the given data point name.
        VIDEO_OA_getMaxPreset()
        Returns the number of defined preset positions in the configuration.
        VIDEO_OA_isCameraIP()
        The function checks whether the specified camera is an analog or an IP camera.
        VIDEO_OA_isCameraPTZ()
        The function checks whether the specified camera is a fixed or a PTZ camera.
        VIDEO_OA_openChildScreenLive()
        Opens a live image as a child panel in the opened module.
      - Video EWO
      - Konfigurationen und Sequenzen
      - Bedienpult
      - HID
    - Graphical objects
    - Data Point Types
    - vimacc OA - Release Notes
Reference Tables
Detailed and extensive content for special project adaptation.
Videos & Tutorials
Explore the capabilities of WinCC OA with our carefully selected collection of video tutorials and guides.
WinCC OA Documentation
Basic information about terms and functions within the documentation.
Disclaimer
A brief clarification of liability exclusions or legal notices.

VIDEO_OA_getCameraNumFromDp()

Returns the camera number for the given data point name.

Synopsis

int VIDEO_OA_getCameraNumFromDp(string sCameraDp);

Parameters


Parameter	Description
sCameraDp	Camera data point

Return Value

Camera number. In case of errors the function will return -1. If the data point does not exist or it is not of type VIDEO_OA_Camera, -1 will be returned.

Errors

Missing or wrong arguments

Description

Returns the camera number for the given data point name.

EXAMPLE

main()
{
  DebugN(VIDEO_OA_getCameraNumFromDp("Camera_00001"));
}

Assignment

Video functions

Availability

UI, CTRL