Interface DisplaySettings
public interface DisplaySettings
This class defines the parameters that control how a given DisplayWindow
displays data from the Datastore.
It is immutable; construct it with a DisplaySettings.Builder.
You are not expected to implement this interface; it is here to describe how
you can interact with DisplaySettings created by Micro-Manager itself. If
you need a DisplaySettings.Builder, you can generate one via the
DisplayManager displaySettingsBuilder()
method or by using one of the copy() methods of an existing DisplaySettings instance.
This class uses a Builder pattern. Please see
https://micro-manager.org/wiki/Using_Builders for more information.-
Nested Class Summary
Nested ClassesModifier and TypeInterfaceDescriptionstatic interfaceBuilder for DisplaySettings.static enumColorMode enums.static interfaceDeprecated.TODO: explainstatic interfaceDeprecated.Use DisplaySettings.Builder instead -
Field Summary
Fields -
Method Summary
Modifier and TypeMethodDescriptioncopy()Deprecated.copyBuilderWithChannelSettings(int channel, ChannelDisplaySettings settings) copyBuilderWithComponentSettings(int channel, int component, ComponentDisplaySettings settings) doubleWhen autoscaling, the minimum value will have this fraction of pixels with lower intensities, and the maximum value will have this fraction of pixels with higher intensities.doubleWhen autoscaling, the minimum value will have this fraction of pixels with lower intensities, and the maximum value will have this fraction of pixels with higher intensities.getChannelColor(int channel) Deprecated.- use getColorMode() insteadDeprecated.getChannelSettings(int channel) Color mode or lookup table for displaying the image.intReturns the number of channels in these DisplaySettings Note that this number may be different from the number of the channels in the image being shown.doublegetSafeContrastGamma(int index, int component, Double defaultVal) Deprecated.getSafeContrastMax(int index, int component, Integer defaultVal) Deprecated.getSafeContrastMin(int index, int component, Integer defaultVal) Deprecated.getSafeContrastSettings(int index, DisplaySettings.ContrastSettings defaultVal) Deprecated.getSafeIsVisible(int index, Boolean defaultVal) Deprecated.Deprecated.doubleZoom level expressed as a ratio (i.e.booleanWhen autoscaling, take zero values into account or not? This can be useful for images that contain artificial zero values.booleanWhether to continuously apply autoscale.booleanisChannelVisible(int channel) booleanWhether the y-axis of the histogram uses a logarithmic or linear scale.booleanWhether to only look at the ROI when autoscaling.booleanWhether to use the same intensity scaling for every channel.
-
Field Details
-
FILENAME
-
-
Method Details
-
getZoomRatio
double getZoomRatio()Zoom level expressed as a ratio (i.e. 1.0 denotes that each pixel in the image occupies 1 pixel on the screen, 0.5 indicates that 4 image pixels are combined in 1 screen pixel.- Returns:
- Zoom ratio
-
getPlaybackFPS
double getPlaybackFPS() -
getColorMode
DisplaySettings.ColorMode getColorMode()Color mode or lookup table for displaying the image.- Returns:
- ColorMode used by these DisplaySettings
-
isUniformChannelScalingEnabled
boolean isUniformChannelScalingEnabled()Whether to use the same intensity scaling for every channel.- Returns:
- true if all channels use the same intensity scaling
-
isAutostretchEnabled
boolean isAutostretchEnabled()Whether to continuously apply autoscale.- Returns:
- true if AutoStretch is enabled
-
isROIAutoscaleEnabled
boolean isROIAutoscaleEnabled()Whether to only look at the ROI when autoscaling.- Returns:
- true if only the ROI should be taken into account when autoscaling
-
getAutoscaleIgnoredQuantile
double getAutoscaleIgnoredQuantile()When autoscaling, the minimum value will have this fraction of pixels with lower intensities, and the maximum value will have this fraction of pixels with higher intensities.- Returns:
- Number used in Autostretch mode to determine where to set the white and black points. Expressed as fraction.
-
getAutoscaleIgnoredPercentile
double getAutoscaleIgnoredPercentile()When autoscaling, the minimum value will have this fraction of pixels with lower intensities, and the maximum value will have this fraction of pixels with higher intensities.- Returns:
- Number used in Autostretch mode to determine where to set the white and black points. Expressed as percentage.
-
isAutoscaleIgnoringZeros
boolean isAutoscaleIgnoringZeros()When autoscaling, take zero values into account or not? This can be useful for images that contain artificial zero values.- Returns:
- Whether zero pixel values are ignored when autoscaling
-
isHistogramLogarithmic
boolean isHistogramLogarithmic()Whether the y-axis of the histogram uses a logarithmic or linear scale.- Returns:
- Logarithmic scale when true.
-
getNumberOfChannels
int getNumberOfChannels()Returns the number of channels in these DisplaySettings Note that this number may be different from the number of the channels in the image being shown.- Returns:
- number of channels in these DisplaySettings
-
getChannelSettings
-
getAllChannelSettings
List<ChannelDisplaySettings> getAllChannelSettings() -
getAllChannelColors
-
getChannelColor
-
getAllChannelVisibilities
-
isChannelVisible
boolean isChannelVisible(int channel) -
copyBuilder
DisplaySettings.Builder copyBuilder() -
copyBuilderWithChannelSettings
DisplaySettings.Builder copyBuilderWithChannelSettings(int channel, ChannelDisplaySettings settings) -
copyBuilderWithComponentSettings
DisplaySettings.Builder copyBuilderWithComponentSettings(int channel, int component, ComponentDisplaySettings settings) -
copy
Deprecated.Generate a new DisplaySettingsBuilder whose values are initialized to be the values of this DisplaySettings.- Returns:
- Copy of the DisplaySettingsBuilder
-
getChannelContrastSettings
Deprecated.The object containing contrast information for each channel.- Returns:
- An array of ContrastSettings objects, one per channel. May potentially be null or of inadequate length.
-
getSafeContrastSettings
@Deprecated DisplaySettings.ContrastSettings getSafeContrastSettings(int index, DisplaySettings.ContrastSettings defaultVal) Deprecated.Safely retrieve the ContrastSettings object for the specified channel. If the contrastSettings property is null, is too small to have a value for the given index, or has a value of null for that index, then the provided default value will be returned instead.- Parameters:
index- Channel index to get the ContrastSettings fordefaultVal- Default value to return if no contrast setting is available.- Returns:
- Contrast settings for the specified channel
-
getSafeContrastMin
Deprecated.Safely extract the channel contrast min property from the contrast settings for the specified channel and component. If the contrastSettings property is null, is too small to have a value for the given index, has a value of null for the given index, or has a ContrastSettings object whose contrastMin property is null, then the provided default value will be returned instead.- Parameters:
index- Channel index to get the contrast min for.component- Component index to get the contrast min for.defaultVal- Default value to return if no contrast min is available.- Returns:
- Black point for the specified channel/component
-
getSafeContrastMax
Deprecated.Safely extract the channel contrast max property from the contrast settings for the specified channel and component. If the contrastSettings property is null, is too small to have a value for the given index, has a value of null for the given index, or has a ContrastSettings object whose contrastMax property is null, then the provided default value will be returned instead.- Parameters:
index- Channel index to get the contrast max for.component- Component index to get the contrast max for.defaultVal- Default value to return if no contrast max is available.- Returns:
- White point for the specified channel/component
-
getSafeContrastGamma
Deprecated.Safely extract the channel contrast gamma property from the contrast settings for the specified channel and component. If the contrastSettings property is null, is too small to have a value for the given index, has a value of null for the given index, or has a ContrastSettings object whose contrastGamma property is null, then the provided default value will be returned instead.- Parameters:
index- Channel index to get the contrast gamma for.component- Component index to get the contrast gamma for.defaultVal- Default value to return if no contrast gamma is available.- Returns:
- Gamma for the specified channel/component
-
getSafeIsVisible
Deprecated.Safely determine if the specified channel is visible when in composite view mode. If the contrastSettings property is null, is too small to have a value for the given index, has a value of null for the given index, or has a ContrastSettings object whose isVisible property is null, then the provided default value will be returned instead.- Parameters:
index- Channel index to get visibility for.defaultVal- Default value to return if no visibility is available.- Returns:
- Flag indicating visibility of the specified channel
-
getChannelColorMode
Deprecated.- use getColorMode() insteadThe index into the "Display mode" control.- Returns:
- index into the "Display mode" control
-
getShouldSyncChannels
Deprecated.Whether histogram settings should be synced across channels.- Returns:
- True if histograms should sync between channels
-