poIImagePlane ManipIdentity

Clears the 2D or 3D user transform for the image plane.

Syntax

Imageplane_handle ManipIdentity

Application

HyperView Tcl Modify

Description

The image plane maintains a separate user transform to track the position, rotation, and scaling applied to the image plane. This command resets the transform, however it does not alter any data regarding alignment of a 3D image plane to a model.

Example

To create a 3D image plane, locate it in a 3D space, and then reset the user transform:
hwi OpenStack
if {[catch {
    ::post::GetPostHandle client_handle
    hwi GetSessionHandle session_handle
    client_handle GetImagePlaneCtrlHandle ipc_handle
    set ipid1 [ipc_handle AddImagePlane Logo1]
    ipc_handle GetImagePlaneHandle imageplane_handle $ipid1
    imageplane_handle SetFileName g:/samples2/VideoOverlay/Altair_logo.jpg
    imageplane_handle SetMode background
    imageplane_handle SetCrop 0 0 0.9995 0.995
    imageplane_handle SetFilterType ColorAlpha;
    imageplane_handle SetFilterMode Equal
    imageplane_handle SetColorAlphaTarget "255 255 255"
    imageplane_handle SetColorAlphaTolerance 18
    imageplane_handle SetMipMapMode Linear1
    imageplane_handle SetMode 3D
    imageplane_handle SetUserTransform "1.0 0.0 0.0 0.0 1.0 0.0 0.0 0.0 1.0 0.0 43.82 43.38"
    imageplane_handle ManipIdentity;
    imageplane_handle ReleaseHandle;
    client_handle Draw
} result]} {
    global errorInfo;
    puts stderr $result;
    puts "[session_handle GetError]";
    puts stderr "*** Tcl TRACE ***";
    puts stderr $errorInfo;
} else {
    puts "No errors.";
    puts "Warnings: ";
    puts "    [session_handle GetError]";
}

hwi CloseStack

Errors

Returns HW_InvalidHandle if the image plane handle is invalid, or poIInvalidImgFilterMode if the specified filter mode is not recognized.