poI3DViewCtrl GetFocalLength

Gets the focal length of the current or specified view.

Syntax

poI3DViewCtrl_handle GetFocalLength name

Application

HyperView Tcl Query

Description

The focal length value simulates the focal length of a camera lens. Adjusting this value is similar to zooming. This command retrieves a floating point value.

Inputs

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

Example

Get the focal length 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 GetFocalLength "View 1"
hwi CloseStack

Error

Returns HW_Error if the name is not a valid saved view.