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.