SoLUTEditor2D¶

InventorModule¶

genre	`LUT`
author	`MeVis Medical Solutions AG`
package	`MeVisLab/Standard`
dll	`SoLUTTools`
definition	SoLUTTools.def
see also	`SoMLLUT`, `ApplyLUT`, `SoGVRVolumeRenderer`, `SoLUTEditor`
inherits from	`SoLUTEditor`
keywords	`lookup`, `table`, `tag`

Purpose¶

The module SoLUTEditor2D allows editing of multiple RGBA LUTs.

These lookup tables can then be assigned to tag values of a two-dimensional LUT. Furthermore, each tag can be modified in color, transparency, and intensity.

Usage¶

Add, rename, and edit a LUT. Then, select a tag from the right hand side’s list and assign the current LUT to the tag by clicking on the arrow button.

Input Fields¶

inHistogram¶

name: inHistogram, type: CurveData(MLBase)¶: For accessing this object via scripting, see the Scripting Reference: MLCurveDataWrapper.

see SoLUTEditor.inHistogram

inTagHistogram¶

name: inTagHistogram, type: CurveData(MLBase)¶: For accessing this object via scripting, see the Scripting Reference: MLCurveDataWrapper.

Output Fields¶

outLUT¶

name: outLUT, type: LUTFunction(MLBase)¶: A ML LUT object to be used with SoMLLUT or ApplyLUT.

outInventorLUT¶

name: outInventorLUT, type: SoNode¶: The internal SoMLLUT can be placed in front of a SoView2D or SoGVRVolumeRenderer module to set the LUT in an Open Inventor scene.

self (hidden)¶

name: self, type: SoNode¶

Parameter Fields¶

Field Index¶

`-->`: `Trigger`	`Level`: `Float`	`Reset To Ramp`: `Trigger`
`Add LUT`: `Trigger`	`Lut List`: `String`	`Selected Marker Color`: `Color`
`Allow New Points`: `Bool`	`lutData`: `String`	`Selected Marker Radius`: `Integer`
`Alpha Factor`: `Float`	`lutListItem`: `String`	`Selected Triangle Size`: `Integer`
`Alpha Line Color`: `Color`	`lutNameChanged`: `Trigger`	`Show Alpha Editor`: `Bool`
`Alpha Line Width`: `Integer`	`marginColor`: `Color`	`Show Color Editor`: `Bool`
`alphaPoints`: `Vector2List`	`Marker Color`: `Color`	`Snap Marker Radius`: `Integer`
`Apply New Range`: `Trigger`	`Marker Radius`: `Integer`	`Tag Alpha`: `Float`
`applyWindowLevel`: `Trigger`	`New Range Max`: `Float`	`Tag Color`: `Color`
`Background Color`: `Color`	`New Range Min`: `Float`	`Tag Intensity`: `Float`
`Border Color`: `Color`	`New Range Mode`: `Enum`	`Tag List`: `String`
`clear`: `Trigger`	`newLutName`: `String`	`tagData`: `String`
`Clone LUT`: `Trigger`	`Next tag`: `Trigger`	`tagListItems`: `IntegerList`
`Col. Interpol.`: `Enum`	`Opacity`: `Float`	`Toggle cycling`: `Trigger`
`Color`: `Color`	`Position`: `Float`	`Triangle Size`: `Integer`
`Color Editor Height`: `Float`	`Previous tag`: `Trigger`	`Undo`: `Trigger`
`colorPoints`: `Vector4List`	`Range`: `String`	`Update LUT while dragging`: `Bool`
`Current range`: `String`	`rangeMax`: `Float`	`Update Range From Histogram`: `Trigger`
`cycleMessage`: `String`	`rangeMin`: `Float`	`Use Anti Aliasing`: `Bool`
`Draw Colored Markers`: `Bool`	`Redo`: `Trigger`	`viewMax`: `Float`
`Histogram Color`: `Color`	`Relative LUT`: `Bool`	`viewMin`: `Float`
`Index`: `Integer`	`Remove LUT`: `Trigger`	`Window`: `Float`

Visible Fields¶

Color¶

name: currentColor, type: Color, default: 0 0 0¶

Sets the color of the currently selected point in the editor.

The color editor to the right of this field can also be used to set the color.

Opacity¶

name: currentOpacity, type: Float, default: 0, minimum: 0, maximum: 1¶: Sets the opacity of the currently selected point in the editor.

Position¶

name: currentPosition, type: Float, default: 0¶: Sets the position of a LUT entry corresponding with the target image value.

Index¶

name: currentIndex, type: Integer, default: 0¶

Sets the index of a LUT entry point.

With adjusting the index, a certain LUT entry point can be chosen without risking to accidentally move an entry point while selecting it.

Window¶

name: window, type: Float, default: 1, minimum: 0, maximum: 1¶: Sets the relative window value of the LUT.

Level¶

name: level, type: Float, default: 0.5, minimum: 0, maximum: 1¶: Sets the relative level value of the LUT.

Allow New Points¶

name: allowNewPoints, type: Bool, default: TRUE¶

If checked, new points can interactively be placed by clicking onto the editor’s graph.

Otherwise, the editor only allows for interactively moving points or deleting them.

Update LUT while dragging¶

name: updateLutWhileDragging, type: Bool, default: TRUE¶

If checked, the output LUTs are updated while dragging an entry point.

Otherwise, the output LUTs are update on finishing a drag.

Relative LUT¶

name: relativeLut, type: Bool, default: FALSE¶

If checked, the module outputs a relative LUT.

Otherwise, the output LUT is absolute.

Current range¶

name: rangeInfo, type: String, persistent: no¶

Shows the current range of the LUT.

Even if the output is a relative LUT, the min and max values remain.

Range¶

name: viewRangeInfo, type: String, persistent: no¶: Shows the current value range of the LUT.

Col. Interpol.¶

name: colorInterpolation, type: Enum, default: InterpolateRGB¶: Defines the interpolation scheme of the color values.

Alpha Factor¶

name: alphaFactor, type: Float, default: 1, minimum: 0, maximum: 10¶

Sets a global alpha multiplier value.

Be careful with this setting!

Undo¶

name: undo, type: Trigger¶

When pressed, the last interactive change is undone.

Press CTRL-Z in the editor.

Redo¶

name: redo, type: Trigger¶

When pressed, the last undone command is redone.

Press CTRL-Y in the editor.

New Range Min¶

name: newRangeMin, type: Float, default: 0¶: Sets a new minimum value to the LUT’s range.

New Range Max¶

name: newRangeMax, type: Float, default: 4095¶: Sets a new maximum value to the LUT’s range.

New Range Mode¶

name: newRangeMode, type: Enum, default: ClipFormerLUT¶: Defines how the old LUT entries should be translated to a new range.

Apply New Range¶

name: applyNewRange, type: Trigger¶

When pressed, the new min/max values of the LUT are applied.

The new LUT is computed from the old LUT based on the New Range Mode.

Update Range From Histogram¶

name: updateRangeFromHistogram, type: Trigger¶: Sets the min/max values of the LUT to the min/max values of the input histogram.

Reset To Ramp¶

name: resetToRamp, type: Trigger¶

When pressed, the LUT is reset to a standard ramp.

The standard ramp yields two entry points with the first entry point being black and fully transparent while the second and last point being white and fully opaque.

Color Editor Height¶

name: colorEditorHeight, type: Float, default: 24¶: Sets the height of the color editor, which shows the color gradient.

Show Color Editor¶

name: showColorEditor, type: Bool, default: TRUE¶

If checked, the editor shows the color gradient of the current LUT.

Also, the color gradient allows for an interactive placement of LUT entry points.

Show Alpha Editor¶

name: showAlphaEditor, type: Bool, default: TRUE¶

If checked, the LUT entry points reflect the opacity in their vertical placement.

Otherwise, the editor only shows the color gradient.

Marker Radius¶

name: markerRadius, type: Integer, default: 4¶: Sets the size of the LUT entry points in the interactive editor.

Selected Marker Radius¶

name: selectedMarkerRadius, type: Integer, default: 6¶: Sets the size of the selected LUT entry points in the interactive editor.

Snap Marker Radius¶

name: snapMarkerRadius, type: Integer, default: 10¶: Sets the radius for selecting an entry point in the interactive editor.

Alpha Line Width¶

name: alphaLineWidth, type: Integer, default: 2¶: Sets the width of the line indicating the alpha values in the interactive editor.

Background Color¶

name: backgroundColor, type: Color, default: 0.800000011920929 0.800000011920929 0.800000011920929¶: Sets the background color of the interactive editor.

Border Color¶

name: borderColor, type: Color, default: 0 0 0¶: Sets the color of the border of the interactive editor and the LUT entry points.

Alpha Line Color¶

name: alphaLineColor, type: Color, default: 0 0 0¶: Sets the color of the line indicating the alpha value in the interactive editor.

Histogram Color¶

name: histogramColor, type: Color, default: 0.400000005960464 0.400000005960464 0.400000005960464¶: Sets the color of the optional histogram in the background of the interactive editor.

Draw Colored Markers¶

name: drawColoredMarkers, type: Bool, default: TRUE¶

If checked, the entry points are rendered in their corresponding color of the LUT.

Otherwise, the color of the selected and the unselected entry points can be adjusted.

Marker Color¶

name: markerColor, type: Color, default: 1 1 1¶: Sets the color of the entry points.

Selected Marker Color¶

name: selectedMarkerColor, type: Color, default: 1 0.5 0.5¶: Sets the color of the selected entry point.

Selected Triangle Size¶

name: selectedTriangleSize, type: Integer, default: 8¶: Sets the size of the selected triangle in the color editor.

Triangle Size¶

name: triangleSize, type: Integer, default: 6¶: Sets the size of the triangles in the color editor.

Use Anti Aliasing¶

name: useAntiAliasing, type: Bool, default: TRUE¶: If checked, the editor is rendered with anti-aliasing.

Tag Color¶

name: tagColor, type: Color, default: 0 0 0¶: Sets the tag’s LUT base color.

Lut List¶

name: lutList, type: String, persistent: no¶

Shows the list of currently existing LUTs.

Existing LUTs can be selected to be renamed or deleted.

Tag Intensity¶

name: tagIntensity, type: Float, default: 1, minimum: 0, maximum: 1¶: Sets the intensity of a selected tag’s color.

Tag Alpha¶

name: tagAlpha, type: Float, default: 1, minimum: 0, maximum: 1¶: Sets the overall alpha value for a selected tag.

Add LUT¶

name: addLut, type: Trigger¶: When pressed, a new LUT is added to the list of LUTs with a default name.

Clone LUT¶

name: cloneLut, type: Trigger¶: When pressed, a selected LUT is being cloned and added to the list of LUTs.

Remove LUT¶

name: removeLut, type: Trigger¶: When pressed, the selected LUT is being removed.

–>¶

name: assignToLut, type: Trigger¶: When pressed, the selected LUT is being assigned to the selected tag(s).

clear¶

name: clear, type: Trigger¶: When pressed, the selected tag(s) are cleared from their associated LUT.

Toggle cycling¶

name: enableCycle, type: Trigger¶

When pressed, cycling through the tags of the tag list is either enabled or disabled.

If cycling is enabled, only the currently active tag’s LUT is being used.

Next tag¶

name: nextCycle, type: Trigger¶: If cycling is enabled and this button pressed, the next existing tag’s LUT becomes the only active LUT.

Previous tag¶

name: prevCycle, type: Trigger¶: If cycling is enabled and this button pressed, the previous existing tag’s LUT becomes the only active LUT.

Hidden Fields¶

rangeMin¶

name: rangeMin, type: Float, default: 0¶

rangeMax¶

name: rangeMax, type: Float, default: 4095¶

viewMin¶

name: viewMin, type: Float, default: 0, minimum: :field:`rangeMin`, maximum: :field:`viewMax`¶

viewMax¶

name: viewMax, type: Float, default: 4095, minimum: :field:`viewMin`, maximum: :field:`rangeMax`¶

applyWindowLevel¶

name: applyWindowLevel, type: Trigger¶

colorPoints¶

name: colorPoints, type: Vector4List, default: [ 0 0 0 0, 4095 1 1 1 ]¶

alphaPoints¶

name: alphaPoints, type: Vector2List, default: [ 0 0, 4095 1 ]¶

marginColor¶

name: marginColor, type: Color, default: 0.830999970436096 0.815999984741211 0.783999979496002¶

lutListItem¶

name: lutListItem, type: String, persistent: no¶

tagListItems¶

name: tagListItems, type: IntegerList, persistent: no¶

lutNameChanged¶

name: lutNameChanged, type: Trigger¶

cycleMessage¶

name: cycleMessage, type: String, persistent: no¶

newLutName¶

name: newLutName, type: String, default: Untitled¶

lutData¶

name: lutData, type: String¶

tagData¶

name: tagData, type: String¶