Configure Video Wall and Open Roaming Window

Before performing any operations, you must configure the video wall, that is, adding signal sources, adding the video outputs, linking the video outputs to the jointed screens, and adjusting the position of jointed screens on video wall. Windowing is to open a new window on the screen(s). The window can be within a screen or span multiple screens. You can move the window on the valid screens as desired and this function is called roaming.

  • Make sure you have called NET_DVR_Init to initialize the development environment.

  • Make sure you have called NET_DVR_Login_V40 to log in to the device.

Figure 1 API Calling Flow of Configuring Video Wall and Opening Roaming Window

  1. Optional: Call NET_DVR_GetDeviceAbility with "WALL_ABILITY" (command No.: 0x212) to get the capability to check whether the function is supported by device.

    The video wall capability is returned in the message XML_WallAbility by pOutBuf.

  2. Call NET_DVR_GetDVRConfig with "NET_DVR_GET_VIDEOWALLDISPLAYNO" (command No.: 1732) to get the video output No. of device for linking to jointed screens.

    The video output information is returned in the structure NET_DVR_DISPLAYCFG by lpOutBuffer.

  3. Optional: Call NET_DVR_GetDeviceConfig with "NET_DVR_GET_VIDEOWALLDISPLAYPOSITION" (command No.: 1734) and set lpInBuffer to the video input No. for getting the default or configured relation between video input No. and jointed screen for reference.

    The relation information is returned in the structure NET_DVR_VIDEOWALLDISPLAYPOSITION by lpOutBuffer.

  4. Call NET_DVR_SetDeviceConfig with "NET_DVR_SET_VIDEOWALLDISPLAYPOSITION" (command No.: 1733), set lpInBuffer to the video input No., and set to lpInParamBuffer to the structure NET_DVR_VIDEOWALLDISPLAYPOSITION for linking each jointed screen of video wall with a video output and setting the logical position of screens.
  5. Optional: Call NET_DVR_GetSTDConfig with "NET_DVR_GET_LED_AREA_INFO_LIST" (command No.: 9295) and set lpCondBuffer to the structure NET_DVR_LED_AREA_COND for getting default or configured video output information (e.g., LED resolution of a specific area on video wall) for reference.

    The video output information is returned in the structure NET_DVR_LED_AREA_INFO_LIST by lpOutBuffer.

  6. Call NET_DVR_SetDeviceConfigEx with "NET_DVR_SET_VIDEOWALLWINDOWPOSITION" (command No.: 1736) and set lpInParam to the structure NET_DVR_VIDEOWALLWINDOWPOSITION for opening window(s) on video wall.
    Note:

    Two windowing modes are available: 0-windowing by coordinates, 1-windowing by configured resolution.

    The window opening status will be returned by lpStatusList of lpOutParam.

  7. Optional: Perform the following operation(s) after windowing.
    Option Description

    Roaming

    Call NET_DVR_SetDeviceConfigEx with "NET_DVR_SET_VIDEOWALLWINDOWPOSITION" (command No.: 1736) and set lpInParam to the structure NET_DVR_VIDEOWALLWINDOWPOSITION for roaming the window.

    Note:

    The window roaming status will be returned by lpStatusList of lpOutParam.

    Set Window Parameters

    1. Call NET_DVR_GetDVRConfig with "NET_DVR_WALLWINPARAM_GET" (command No.: 9006) to get default or configured window parameters for reference.

      The window parameters are returned in the structure NET_DVR_WALLWINPARAM by lpOutBuffer.

    2. Call NET_DVR_SetDVRConfig with "NET_DVR_WALLWINPARAM_SET" (command No.: 9005) and set lpInBuffer to the structure NET_DVR_WALLWINPARAM for setting the window parameters, e.g., division mode.

  8. Perform one of the following operations to close the window(s) on video wall.

Call NET_DVR_Logout and NET_DVR_Cleanup to log out and release the resources.