Documentation/Nightly/Developers/Slice Orientation Presets - Revision history

JChris.FillionR at 20:18, 8 June 2016

2016-06-08T20:18:47Z

2016-06-08T20:18:13Z

2016-06-08T20:15:50Z

Overview

2016-06-08T19:50:41Z

How to modify and set the orientation presets in Extensions ?

2016-06-08T19:49:11Z

How to modify and set the orientation presets in Extensions ?

2016-06-08T19:47:59Z

How to modify and set the orientation presets in Extensions ?

2016-06-08T19:47:07Z

2016-06-08T18:14:33Z

FAQ

2016-06-08T18:11:28Z

API

2016-06-08T16:59:10Z

What is "Reformat" orientation ?

@@ Line 6: / Line 6: @@
 By default, three slice orientation presets representing the [[Coordinate_systems#Anatomical_coordinate_system|anatomical coordinate system]] are available in Slicer: <code>Axial</code>, <code>Coronal</code> and <code>Sagittal</code>.
-Feature originally integrated to Slicer core in [http://viewvc.slicer.org/viewvc.cgi/Slicer4?view=revision&revision=25171 r25171]
+Feature originally integrated to Slicer core in [http://viewvc.slicer.org/viewvc.cgi/Slicer4?view=revision&revision=25171 r25171] and contributed by:
+* Davide Punzo (Kapteyn astronomical institute)
-Contributors: Davide Punzo (Kapteyn astronomical institute), Jean-Christophe Fillion-Robin (Kitware) and Andras Lasso (PerkLab, Queen's University).
+* Jean-Christophe Fillion-Robin (Kitware)
 == API ==

@@ Line 6: / Line 6: @@
 By default, three slice orientation presets representing the [[Coordinate_systems#Anatomical_coordinate_system|anatomical coordinate system]] are available in Slicer: <code>Axial</code>, <code>Coronal</code> and <code>Sagittal</code>.
-Feature originally integrated in [http://viewvc.slicer.org/viewvc.cgi/Slicer4?view=revision&revision=25171 r25171]
+Feature originally integrated to Slicer core in [http://viewvc.slicer.org/viewvc.cgi/Slicer4?view=revision&revision=25171 r25171]
 == API ==

← Older revision		Revision as of 20:15, 8 June 2016
Line 5:		Line 5:

	By default, three slice orientation presets representing the [[Coordinate_systems#Anatomical_coordinate_system\|anatomical coordinate system]] are available in Slicer: <code>Axial</code>, <code>Coronal</code> and <code>Sagittal</code>.		By default, three slice orientation presets representing the [[Coordinate_systems#Anatomical_coordinate_system\|anatomical coordinate system]] are available in Slicer: <code>Axial</code>, <code>Coronal</code> and <code>Sagittal</code>.
		+
		+	Feature originally integrated in [http://viewvc.slicer.org/viewvc.cgi/Slicer4?view=revision&revision=25171 r25171]

	== API ==		== API ==

@@ Line 91: / Line 91: @@
 === How to modify and set the orientation presets in Extensions ? ===
-Given an extension XXX, it is possible to set globally orientation presets for the SliceNode using:
+Given an extension XXX, it is possible to set, globally, the orientation presets for the SliceNode using:
 <pre>

@@ Line 91: / Line 91: @@
 === How to modify and set the orientation presets in Extensions ? ===
-Given an extension XXX, it is possible to set orientation preset of the SliceNode using:
+Given an extension XXX, it is possible to set globally orientation presets for the SliceNode using:
 <pre>

@@ Line 108: / Line 108: @@
 </pre>
-To be noted is that SliceNode already instantiated must be updated as follow:
+To be noted is that SliceNodes already instantiated must be updated as follow:
 <pre>

← Older revision		Revision as of 19:47, 8 June 2016
Line 88:		Line 88:

	This means that a preset can '''NOT''' be named "Reformat".		This means that a preset can '''NOT''' be named "Reformat".
		+
		+	=== How to modify and set the orientation presets in Extensions ? ===
		+
		+	Given an extension XXX, it is possible to set orientation preset of the SliceNode using:
		+
		+	<pre>
		+	vtkSmartPointer<vtkMRMLNode> defaultNode = vtkMRMLSliceNode::SafeDownCast
		+	(this->mrmlScene()->GetDefaultNodeByClass("vtkMRMLSliceNode"));
		+	if (!defaultNode)
		+	{
		+	vtkMRMLNode * foo = this->mrmlScene()->CreateNodeByClass("vtkMRMLSliceNode");
		+	defaultNode.TakeReference(foo);
		+	this->mrmlScene()->AddDefaultNode(defaultNode);
		+	}
		+	vtkMRMLSliceNode * defaultSliceNode = vtkMRMLSliceNode::SafeDownCast(defaultNode);
		+	defaultSliceNode->RenameSliceOrientationPreset("Axial", "XZ");
		+	defaultSliceNode->RemoveSliceOrientationPreset("Sagittal");
		+	etc..
		+	</pre>
		+
		+	To be noted is that SliceNode already instantiated must be updated as follow:
		+
		+	<pre>
		+	vtkSmartPointer<vtkCollection> sliceNodes = vtkSmartPointer<vtkCollection>::Take
		+	(this->mrmlScene()->GetNodesByClass("vtkMRMLSliceNode"));
		+
		+	for(int i = 0; i < sliceNodes->GetNumberOfItems(); i++)
		+	{
		+	vtkMRMLSliceNode* sliceNode =
		+	vtkMRMLSliceNode::SafeDownCast(sliceNodes->GetItemAsObject(i));
		+	if (sliceNode)
		+	{
		+	sliceNode->DisableModifiedEventOn();
		+	sliceNode->RenameSliceOrientationPreset("Axial", "XZ");
		+	sliceNode->RemoveSliceOrientationPreset("Sagittal");
		+	etc...
		+	sliceNode->DisableModifiedEventOff();
		+	}
		+	}
		+	</pre>

← Older revision		Revision as of 18:14, 8 June 2016
Line 55:		Line 55:

	Then, method <code>vtkMRMLSliceNode::AddDefaultSliceOrientationPresets(vtkMRMLScene scene)</code> ends up adding a default [{{doxygen-class-url\|vtkMRMLSliceNode}} vtkMRMLSliceNode] that will be used a template each time <code>vtkMRMLScene::CreateNodeByClass(const char className)</code>.		Then, method <code>vtkMRMLSliceNode::AddDefaultSliceOrientationPresets(vtkMRMLScene scene)</code> ends up adding a default [{{doxygen-class-url\|vtkMRMLSliceNode}} vtkMRMLSliceNode] that will be used a template each time <code>vtkMRMLScene::CreateNodeByClass(const char className)</code>.
		+
		+	=== Why default presets are not added in the vtkMRMLSliceNode contructor ? ===
		+
		+	Associating the list of default presets to the default <code>vtkMRMLSliceNode</code> allows to customize the template once and ensure any new node created using <code>vtkMRMLScene::CreateNodeByClass(const char* className)</code> will have the expected list of presets.

	=== How to ensure slice orientation presets are defined in unit tests ? ===		=== How to ensure slice orientation presets are defined in unit tests ? ===

@@ Line 8: / Line 8: @@
 == API ==
-The [{{doxygen-class-url|vtkMRMLSliceNode}} vtkMRMLSliceNode] class provides the following API:
+The [{{doxygen-class-url|vtkMRMLSliceNode}} vtkMRMLSliceNode] class provides the following API for managing slice orientation presets:
 <pre>
@@ Line 40: / Line 40: @@
 static void AddDefaultSliceOrientationPresets(vtkMRMLScene* scene)
 </pre>
 == FAQ ==

← Older revision		Revision as of 16:59, 8 June 2016
Line 84:		Line 84:
	"Reformat" is a reserved orientation name describing an arbitrary orientation matrix that do not correspond to an existing orientation preset.		"Reformat" is a reserved orientation name describing an arbitrary orientation matrix that do not correspond to an existing orientation preset.

−	This means that a preset can NOT be named as "Reformat".	+	This means that a preset can '''NOT''' be named "Reformat".