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.
- PM Agent
  The PM Add-ons product portfolio enhances the base functionality of the WinCC product range. Now this is also supported by WinCC OA.
- Recipes, basics
  Recipe Management Systems are used for managing and storing the set points and commands of automated systems defined by numerous data point elements. Even when simulating or testing an application, a relatively large number of set points or input values need to be sent to the peripheral devices by the control system. In these and other situations such a tool represents a great simplification.
- Scheduler, basics
  The main task of the scheduler is to allow you to create, configure and administrate a number of schedules of either time or event triggered actions.
- Maintenance package, basics
  Maintenance is a necessity wherever different pieces of equipment are used. For example, drives, valves, motors, where it is necessary to perform maintenance work at specific intervals so as to ensure proper functioning. But prolonging the service life of equipment by means of regular maintenance and cost reduction are also key factors in plant engineering and automation technology.
- BACnet Application
- Communication Center
- SmartSCADA
  The WinCC OA feature SmartSCADA provides two packages: the Analytics package and the KPI framework.
- 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.
Documentation
Basic information about terms and functions within the documentation.
Support & Services
An experienced team of support agents, consultants and trainers are ready to facilitate active partnerships with our customers, so they can profit from our comprehensive service.
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