ShowTimeCourseOfVoxelEx Method


Description

Shows a time course from a Region-Of-Interest of the currently linked VTC file.

Syntax

objDocument.ShowTimeCourseOfVoxelEx(intX, intY, intZ, strTCWindowName, boolSingleVoxel, intXPos, intYPos, intWidth, intHeight, boolNewTCWindow, boolAddToWindow)

Remarks

Valid only if objDocument is of type VMR. A VTC file must be linked to the VMR. In contrast to the ShowTimeCourseOfVoxel version, this function allows to specify whether the invoked time course window shows the time course of a single voxel (boolSingleVoxel = 1) or of a functional cluster (boolSingleVoxel = 0). In the latter case, a statistical map has to be present and the specified voxel must hit a "hot" (significant) voxel.
This version allows to specify the position of the invoked ROI Time Course window on screen as well as its width and height (see MoveTimeCoursePlot method). The position is specified with respect to the left corner (intXPos = 0, intYPos = 0) of the corresponding VMR window.
If boolNewTCWindow is set to "1" (or "True"), a new ROI Time Course window is invoked for the specified time course. If this parameter is set to "0" (or "False"), a new window is only shown if no ROI Time Course window has been invoked previously for the corresponding VMR document. If there is already a ROI Time Course window, the last parameter specifies whether the time course shown in the existing window is replaced (boolAddToWindow = 0) by the new one or whether it is added to the existing window (boolAddToWindow = 1).

Example

' VBScript
Set doc = BrainVoyager.
OpenDocument("cg2_TAL.vmr")

doc.LinkVTC "CG_OBJECTS_SC.vtc", 0
doc.
ShowTimeCourseOfVoxelEx 100, 180, 145, "TC window", False, 523, 0, 500, 181, True, False

// JScript
doc = BrainVoyager.OpenDocument("cg2_TAL.vmr");
doc.LinkVTC("CG_OBJECTS_SC.vtc", 0);
doc.ShowTimeCourseOfVoxelEx(100, 180, 145, "TC window", false, 523, 0, 500, 181, true, false);

# PerlScript
$doc = $BrainVoyager->OpenDocument("cg2_TAL.vmr");
$doc->LinkVTC("CG_OBJECTS_SC.vtc", 0);
$doc->ShowTimeCourseOfVoxelEx(100, 180, 145, "TC window", 0, 523, 0, 500, 181, 1, 0);