PixInsight

Screen Transfer Function Documentation

updated: 2025-10-04


  • Edit STF
    Select this mode to modify the shadows clipping, midtones balance and highlights clipping parameters of the different channels by clicking and dragging on the STF editing area. If you hold the Shift key wile dragging, image screen updates will be blocked until the Shift key is released, which can be useful to improve performance with very big color images.

  • Zoom In
    Once selected, clicking on an editing area will duplicate its width. This is useful to perform more detailed adjustments. When the Link RGB channels option is enabled, the zoom in action is applied equally to the three RGB channels. Note that you can also increase or decrease magnification of the editing areas with the mouse wheel, irrespective of the current working mode, when the mouse cursor is over them.

  • Zoom Out
    Once selected, clicking on an editing area will reduce its width by a factor of two. This is the inverse operation to clicking in Zoom In mode.

  • Scroll
    Select this mode to pan around the editing area. Only useful if you have previously zoomed-in. You can also pan the editing areas by clicking with the middle mouse button and dragging.

  • Link RGB channels
    Enabling this option will cause that any change in any of the RGB channels will affect equally all three RGB channels. When disabled, you can modify each channel separately. Along with that, when the Link RGB channels option is disabled, automatic screen stretch STFs will be computed separately for each individual RGB channel. This is useful to improve the color balance of screen representations.

  • Zoom 1:1
    Resets the zoom to 1:1. You can increase or decrease the zoom level by clicking on the editing area in either Zoom In or Zoom Out working modes.

  • Auto Stretch
    Click this button to perform an automatic screen stretchCtrl-click this button to open the STF Auto Stretch dialog. On this dialog, you can modify the two parameters that control calculation of automatic STFs:

    Shadows clipping
    This controls the shadows clipping point of the computed STF. This parameter is expressed in sigma units, measured from the median of the target image. Recall that the median identifies the main histogram peak in deep sky images where the sky background strongly dominates their pixel value distributions. Hence, this parameter will normally have negative values, since we want to clip at the left side of the main histogram peak. The default value is −1.25.

    Target background
    This is the desired mean background value in the normalized [0,1] range. ScreenTransferFunction will compute the required nonlinear midtones balance transformations to achieve this mean background level in the screen representation of the target image. The default value is 0.25.

    Automatic STFs are computed separately for individual RGB channels when the Link RGB channels option is disabled; otherwise a unique STF is applied to the three RGB channels. By default, the Link RGB channels option is enabled. Separate STFs are useful to compensate for color balancing problems in raw data in most cases; however, always take into account that when separate STFs are being applied, you are not seeing, in general, a screen representation of the actual RGB color image that you have.
  • Edit STF Parameters
    Click this button to open a dialog box where you can define STF parameters manually for the RGB and L channels.
  • Reset Channel Parameters
    Click to bring the corresponding STF parameters to their default values: the shadows clipping point, midtones balance and highlights clipping point parameters are set to 0, 0.5 and 1, respectively, for the channel where the reset button has been clicked.

  • Black Point Readout
    STF readouts work by clicking on any view (main view or preview) of an image window in any of the readout modes (black, midtones, white point) to set the STF parameters accordingly. In this mode, while the mouse button is held down on an image, readout values are calculated for the cursor coordinates according to global readout options, and sent to the STF interface window. In other words, after clicking on this icon, hover over an image and click on it — the black point of all channels will be set to the readout values computed from the pixels where you just clicked.

  • Midtones Readout
    Same as Black Point Readout but to set the midtones balance parameters.

  • White Point Readout
     Same as Black Point Readout but to set the highlights clipping point parameters.

  • Enable/Disable STF
    This allows you to quickly tell the STF engine whether to apply the STF to the target image or not. When hovered, this tool button shows a tool tip text that informs you about the current enabled/disabled state and how it will change if you click the button. Note that the icon shown on this button is either a green check mark to indicate the enabled state, or a red cross mark when disabled. Note also that you can enable and disable the STF for the active view by selecting Image > Screen Transfer Functions > Enable, also available from the view context menu. Finally, you can press F12 to enable or disable the STF for the active view.



Created with the Personal Edition of HelpNDoc: Streamline Your CHM Help File Creation with HelpNDoc