Lightness

module demonstrating the computation of the lightness image on a color image More...

module demonstrating the computation of the lightness image on a color image

Overview

This application computes the lightness image on a color input image loaded from a given input TIFF file, and saves the result in a given TIFF file.

See also

lightness algorithm

Usage

The application can be called through a command line as follows:

   <application_script_filename> [--inputImgFilePath <input_image_file_path>] [--outputImgFilePath <output_image_file_path>]
     
   Arguments:
      --inputImgFilePath  optional; specifies the name of the TIFF file, from
                          which the input image will be loaded; if not 
                          specified by the user, the input image is loaded from
                          file 
                          <DEV_ROOT>/data/Sample/images/Lena_RGB_510x509_UInt8.tif
                          
      --outputImgFilePath optional; specifies the name of the TIFF file, in
                          which the output image resulting from the 
                          computation of the lightness will be saved;
                          if not specified by the user, the output image is 
                          saved in file
                          <TEMPORARY_IPSDK_DIR>/Sample/lightness.tif

Here is a snapshot of default input image used by the application and of corresponding output image when application is launched without any argument:

Source code documentation

We start by importing all necessary libraries:

import os
import sys, getopt
import PyIPSDK
import PyIPSDK.IPSDKIPLColor as color

Then we define the input parameters.

    # retrieve program parameters
    inputImgPath, outputImgPath = readCmdArguments(argv)

We load our input image from the associated Tiff file, by calling the function ipsdk::image::file::loadTiffImageFile.

    # opening of input image
    inImg = PyIPSDK.loadTiffImageFile(inputImgPath)

We then apply the lightness calculation on the input image.

    # lightness computation
    outImg = color.lightnessImg(inImg)

Lastly, we save the image resulting from the operation to the Tiff file.

    # save generated image
    print("Writing result in file : " + outputImgPath)
    PyIPSDK.saveTiffImageFile(outputImgPath, outImg)

See the full source listing