poI3DViewCtrl GetCropping

Gets the number of pixels cropped from each side of the image plane associated with the view.

Syntax

poI3DViewCtrl_handle GetCropping name

Application

HyperView Tcl Query

Description

Returns a string consisting of top, bottom, left, and right values. These values represent numbers of pixels pre-cropped from each corresponding side of the image plane. Captured videos/images are often processed before using them for video overlaying, one typical process is cropping the borders of a video/image.

Inputs

name
If specified, the offset of the view with that name will be returned. Otherwise, the current view’s offset will be returned.

Example

To get the cropping values of a view named "View 1":
hwi OpenStack
hwi GetSessionHandle session_handle
session_handle GetProjectHandle project_handle
project_handle GetPageHandle page_handle [project_handle GetActivePage]
page_handle GetWindowHandle window_handle [page_handle GetActiveWindow]
window_handle GetViewControlHandle view_handle
view_handle GetCropping “View 1”
hwi CloseStack

Error

Returns HW_InvalidHandle if the view handle is invalid.

Returns HW_InvalidArgs if the named view does not exist.