Object for accessing the UI's main window functions. More...

#include <MainWin.h>

Public Slots
void	signalChangeThemeMode ()
	Receives a signal from ThemeManager about a change in the Configuration UI to change the thread, or a signal from the theme monitoring thread that the system has automatically changed from Light to Dark mode.

void	loadDCM (string fileArg)
	Load DICOM via file list.

void	startDcmBrowser (string dir=string())
	Load DICOM browser from command line, optionally at a specific directory.

void	importBrukerMR (string directory=string())
	Imports a Bruker file via dialog box.

void	zoomIn ()
	Zooms in the Display.

void	zoomOut ()
	Zooms out of the Display.

void	normalSize ()
	Sets the slice images to their original size.

void	toggleFullScreen ()
	Switches the users viewer settings so that the entire computer screen displays VivoQuant.

void	showManual ()
	Opens the VivoQuant Manual.

void	launchLogFile ()
	Opens the current VivoQuant log file.

void	scaleImage (float factor)
	Scales the images in the Display to a desired size.

void	enableOpt (int mod, bool enable)
	Enable VQ mainwin UI functions based on image loaded state.

void	checkForUpdate (bool manualCheck=false)
	Checks if there is a newer version of VQ available.

void	forceSettingsMigrationCheck ()
	Ask the user if they want to run the migration check on the next VivoQuant session and close the application.

void	showMinMaxTool ()
	Displays the 'Min/Max' Tool.

void	showBrainAtlasTool ()
	Displays the 'Brain Atlas' Tool.

void	showWorklistTool ()
	Displays the 'Worklist' Tool.

void	showHistogram ()
	Displays the 'Histogram' tool User Interface.

void	bedRemoval ()
	Runs the 'Bed Removal' module.

void	advancedBedRemoval ()
	Opens the 'Bed Removal' tool User Interface.

void	matrixManipulationTool ()
	Opens the 'Matrix Manipulation Tool' User Interface.

void	showHints ()
	Opens the 'Hints' User Interface.

void	setupLayout2x2 ()
	Sets the Display layout to be 2x2.

void	setupLayout1x4 ()
	Sets the Display layout to be 1x4.

void	setupLayoutMIP ()
	Sets the Display layout to display only the MIP view.

void	setupLayoutTrans ()
	Sets the Display layout to display only the Transversal slice view.

void	setupLayoutSlice ()
	Sets the Display to the 'Slices Only' layout.

void	toggleCrosshair ()
	Toggles the Crosshair on/off.

void	setViewMode (ViewMode id)
	Sets the View mode to the desired mode.

void	showConfig ()
	Opens the 'Configuration' User Interface.

void	showCalibCTGeometrical ()
	Opens the 'NanoSPECT/CT Geometrical Calibration' User Interface.

void	showCalibMMP ()
	Opens the 'MultiPlexing-MultiPinhole Calibration' User Interface.

void	switchShowCursorInfo (bool b)
	Toggle the Cursor Info Widget to replace the standard tool tip.

void	showDICOMDump ()
	Opens the DICOM header User Interface.

void	showDICOMEdit ()
	Opens the DICOM editor User Interface.

void	renameDICOM ()
	Opens the 'Rename DICOM files' User Interface.

void	relabelDICOMStudies (bool quiet=false)
	Opens the 'Relabel DICOM Series' User Interface.

void	anonymizeDICOM (bool quiet=false)
	Opens the 'DICOM Anonymizer' User Interface.

void	closeAnonymizeDICOM ()
	Closes the 'DICOM Anonymizer' User Interface.

void	closeDICOMRelabeler ()
	Closes the 'DICOM Relabeler' User Interface.

void	imageToCapture ()
	Opens the 'Open Image File' User Interface.

void	saveSession (string name=string(), bool quiet=false)
	Saves a VivoQuant session.

void	loadSession ()
	Opens the 'Load Session' User Interface.

void	loadSession (string name, bool quiet=false)
	Opens a VivoQuant session.

void	exportSession ()
	Opens the 'Export Session' User Interface to export a session to the current iPACS Repository in use.

void	toggleVCView ()
	Toggles on/off the 'Visual Control' tool.

void	toggleMCView ()
	Toggles on/off the 'MIP Control' tool.

void	toggleDMView ()
	Toggles on/off the 'Data Manager' tool.

void	toggleMinMaxTool ()
	Toggles on/off the 'Min/Max' tool.

void	toggleWorkflowWidget ()
	Toggles on/off the 'Workflow' tool.

void	openFromIPACSDialog ()
	Opens the 'Open from iPACS Dialog' User Interface

void	undo ()
	"Un-does" the previous action completed in VivoQuant

void	redo ()
	"Re-does" the previous action completed in VivoQuant

void	resetView ()
	Resets the view transform for the current view.

void	showMModeSegmentationTool ()
	Opens the 'M-Mode Segmentation Tool' User Interface.

void	openCorthicknessTool ()
	Open Cortical Thickness Tool.

void	showStopRecordingButton ()
	Shows the 'Stop Recording' button.

void	removeStopRecordingButton ()
	Removes the 'Stop Recording' button.

void	updateRecTime (string stopRecTime)
	Updates the time on 'Stop Recording' button.

Public Member Functions
void	setViewMode (string vm, string op=string())
	Sets the view mode and the operator.

virtual QList< QAbstractViewWidget * >	getViews ()
	Get the currently active views.

void	resizeWindow (int width, int height)
	Set the size of the VivoQuant window in pixels.

Array< string >	saveImage (string filename, int objectType, int colBarType=0, int width=0, int height=0, float magnification=1.f, string cornerLabelTemplateName="")
	Saves an image of the specified plane.

Array< string >	saveMovie (string filename, int objectType, int colBarType=0, string cornerLabelTemplateName="")
	Saves a movie (.gif) of the desired planar or 3D view.

Array< string >	saveImageSecondaryCapture (string filename, int objectType, float magnification, int size)
	Saves an image as a DICOM Secondary Capture.

Array< string >	saveMovieSecondaryCapture (string filename, int objectType, int size)
	Saves an image as a DICOM Secondary Capture.

Array< string >	saveSecondaryCapture (string filename, int objectType, int headerIdx, int size, AbstractDicomRepository *rep)
	Save a secondary capture of the specified data.

void	toggleMIP (bool toEnable)
	Turns the MIP viewer on or off.

void	installMouseRatAtlas ()
	Installs the default rodent atlas libraries.

void	setMessagePattern (string pattern)
	Change the message handler output format. Format options

Protected Member Functions
void	openFromIPACSFile (string filename)
	Opens a file from a known iPACS repository.

void	openFromIPACS (string url, bool urlFromFile=false)
	Download an ipacs file from an iPACS URL.

void	openFromIPACSZipacs (string url)
	Download a zipacs file from a zipacs URL.

void	showDICOMAnonymizer (int idx=-1, DataManager *dm=nullptr, bool quiet=false)
	Download DICOM files from an openin URL.

Friends
class	ScriptMaster

class	VisibilityManager

Detailed Description

Object for accessing the UI's main window functions.

This object can be used to perform toolbar related actions or to change the current view / operator.

See also ScriptMaster::mainWin() to obtain this object.

Member Function Documentation

◆ anonymizeDICOM

void anonymizeDICOM ( bool quiet = false )

slot

Opens the 'DICOM Anonymizer' User Interface.

Parameters

quiet Set to true to hide all popup dialog. The anonymization will automatically be applied to all dataset.

Note: See ScriptMaster::getDicomAnonymizer() to obtain the object

◆ checkForUpdate

void checkForUpdate ( bool manualCheck = false )

slot

Checks if there is a newer version of VQ available.

Parameters

manualCheck will launch a dialog if up to date

◆ enableOpt

void enableOpt	(	int	mod,
		bool	enable
	)

slot

Enable VQ mainwin UI functions based on image loaded state.

Parameters

mod
enable	the state to enable

◆ getViews()

virtual QList< QAbstractViewWidget * > getViews ( )

virtual

Get the currently active views.

Returns: a list of the currently active views

◆ importBrukerMR

void importBrukerMR ( string directory = string() )

slot

Imports a Bruker file via dialog box.

Parameters

directory (Optional) The directory of the desired file on iPACS

◆ loadDCM

void loadDCM ( string fileArg )

slot

Load DICOM via file list.

Parameters

fileArg files to open

◆ loadSession

void loadSession	(	string	name,
		bool	quiet = `false`
	)

slot

Opens a VivoQuant session.

Parameters

name	The name of the VivoQuant session being loaded

◆ matrixManipulationTool

void matrixManipulationTool ( )

slot

Opens the 'Matrix Manipulation Tool' User Interface.

Note: See ScriptMaster::matrixManipulationTool() to obtain the object

◆ openFromIPACS()

void openFromIPACS	(	string	url,
		bool	urlFromFile = `false`
	)

protected

Download an ipacs file from an iPACS URL.

Parameters

url	The web URL of the desired file on iPACS
urlFromFile	Whether or not the url is from a .ipacs file

◆ openFromIPACSFile()

void openFromIPACSFile ( string filename )

protected

Opens a file from a known iPACS repository.

Parameters

filename The file name and path of the desired file to be opened by the function (eg: home/ipacs/projects/filename.txt)

◆ relabelDICOMStudies

void relabelDICOMStudies ( bool quiet = false )

slot

Opens the 'Relabel DICOM Series' User Interface.

Parameters

quiet Set to true to hide all popup dialog. The relabeling will automatically be applied to all dataset.

Note: See ScriptMaster::getDicomRelabeler() to obtain the object

◆ resizeWindow()

void resizeWindow	(	int	width,
		int	height
	)

Set the size of the VivoQuant window in pixels.

Parameters

width
height

◆ saveImage()

Array< string > saveImage	(	string	filename,
		int	objectType,
		int	colBarType = `0`,
		int	width = `0`,
		int	height = `0`,
		float	magnification = `1.f`,
		string	cornerLabelTemplateName = `""`
	)

Saves an image of the specified plane.

Parameters

filename	The location and desired name of the image you are about to save, with the file extension
objectType	The plane in which you would like to capture an image (eg: 0 = MIP, 1 = Sag, 2 = Cor, 3 = Tra, 4 = all separate, 5 == all together)
colBarType	The color bar type (eg: 0 = none, 1 = no labels, 2 = simple labels, 3 = smart labels)
width	The requested output width, if other than zero we ignore height value and maintain aspect ratio
height	The requested output height, if other than zero and width is zero, width will follow the aspect ratio
magnification	The Magnification factor for the image, this is applied after any width and height adjustments
cornerLabelTemplateName	The name of an existing corner label template ("None" to save the image without any corner label)

Returns: a list of files saved successfully

◆ saveImageSecondaryCapture()

Array< string > saveImageSecondaryCapture	(	string	filename,
		int	objectType,
		float	magnification,
		int	size
	)

Saves an image as a DICOM Secondary Capture.

Parameters

filename	The location and desired name of the image you are about to save, with the file extension
objectType	The plane in which you would like to capture an image (eg: 0 = MIP, 1 = Sag, 2 = Cor, 3 = Tra, 4 = all separate, 5 == all together)
magnification	The Magnification factor for the image
size	The scaling in percent

Returns: a list of files saved successfully

◆ saveMovie()

Array< string > saveMovie	(	string	filename,
		int	objectType,
		int	colBarType = `0`,
		string	cornerLabelTemplateName = `""`
	)

Saves a movie (.gif) of the desired planar or 3D view.

Parameters

filename	The location and desired name of the .gif file you are about to save (eg: C:/Desktop/filename.png)
objectType	The plane in which the movie will use for the fly-through (eg: 0 = MIP, 1 = Sag, 2 = Cor, 3 = Tra, 4 = all separate, 5 == all together, only for time series movies)
colBarType	The color bar type (eg: 0 = none, 1 = no labels, 2 = simple labels, 3 = smart labels), Default is 0
cornerLabelTemplateName	The name of an existing corner label template ("None" to save the movie without any corner label), Default is an empty string

Returns: A .gif file in the specified pathway

◆ saveMovieSecondaryCapture()

Array< string > saveMovieSecondaryCapture	(	string	filename,
		int	objectType,
		int	size
	)

Saves an image as a DICOM Secondary Capture.

Parameters

filename	The location and desired name of the image you are about to save, with the file extension
objectType	The plane in which you would like to capture an image (eg: 0 = MIP, 1 = Sag, 2 = Cor, 3 = Tra)
size	The scaling in percent

Returns: a list of files saved successfully

◆ saveSecondaryCapture()

Array< string > saveSecondaryCapture	(	string	filename,
		int	objectType,
		int	headerIdx,
		int	size,
		AbstractDicomRepository *	rep
	)

Save a secondary capture of the specified data.

Parameters

filename	The location and desired name of the image you are about to save, with the file extension
objectType	The plane in which you would like to capture an image (eg: 0 = MIP, 1 = Sag, 2 = Cor, 3 = Tra)
headerIdx	The index of the data in the Data Manager to use as a reference for the secondary capture.
size	The scaling in percent
rep	A DICOM repository to save to

Returns: a list of files saved successfully

◆ saveSession

void saveSession	(	string	name = `string()`,
		bool	quiet = `false`
	)

slot

Saves a VivoQuant session.

Parameters

name	The desired name of the session being saved

◆ scaleImage

void scaleImage ( float factor )

slot

Scales the images in the Display to a desired size.

Parameters

factor The scaling factor, or the quantity in which the current image dimensions will be multiplied

◆ setMessagePattern()

void setMessagePattern ( string pattern )

Change the message handler output format. Format options

Parameters

pattern The pattern that will be used by log messages

◆ setViewMode() [1/2]

void setViewMode	(	string	vm,
		string	op = `string()`
	)

Sets the view mode and the operator.

Parameters

vm	The desired viewer mode (Slice View, Tile View, Multi View, MPR View)
op	The operator within the view mode that is desired (Navigator, Reorientation/Registration, 3D ROI Tool, etc.)

◆ setViewMode [2/2]

void setViewMode ( ViewMode id )

slot

Sets the View mode to the desired mode.

Parameters

id	The corresponding desired viewmode (-1 - Logo, 0 = Slice View, 1 = Tile View, 2 = Multi View, 3 = MPR View)

◆ signalChangeThemeMode

void signalChangeThemeMode ( )

slot

Receives a signal from ThemeManager about a change in the Configuration UI to change the thread, or a signal from the theme monitoring thread that the system has automatically changed from Light to Dark mode.

This should be the main triggering to update the rest of the UI to match the intended theme.

◆ startDcmBrowser

void startDcmBrowser ( string dir = string() )

slot

Load DICOM browser from command line, optionally at a specific directory.

Parameters

dir	a directory to open to

◆ switchShowCursorInfo

void switchShowCursorInfo ( bool b )

slot

Toggle the Cursor Info Widget to replace the standard tool tip.

Parameters

b

◆ toggleMIP()

void toggleMIP ( bool toEnable )

Turns the MIP viewer on or off.

Parameters

toEnable A true/false value to instruct the function to turn the MIP on or off (True = on, False = off)

Public Slots

Public Member Functions

Protected Member Functions

Friends

Detailed Description

Member Function Documentation

◆ anonymizeDICOM

◆ checkForUpdate

◆ enableOpt

◆ getViews()

◆ importBrukerMR

◆ loadDCM

◆ loadSession

◆ matrixManipulationTool

◆ openFromIPACS()

◆ openFromIPACSFile()

◆ relabelDICOMStudies

◆ resizeWindow()

◆ saveImage()

◆ saveImageSecondaryCapture()

◆ saveMovie()

◆ saveMovieSecondaryCapture()

◆ saveSecondaryCapture()

◆ saveSession

◆ scaleImage

◆ setMessagePattern()

◆ setViewMode() [1/2]

◆ setViewMode [2/2]

◆ signalChangeThemeMode

◆ startDcmBrowser

◆ switchShowCursorInfo

◆ toggleMIP()