###################################################################### # # -$RCSfile: bigmo.doc,v $ # $Revision: 1.4 $ # Rev-$Name: $ # Mod-$Date: 1999/08/31 01:24:54 $ # # Copyright (c) 1999 Stellacore Corporation. All Rights Reserved. # ###################################################################### # # 'bigmo.cfg' configuration file keyword possibilities # # Keyword values may be: # (bool) a TRUE or FALSE value e.g. TRUE # (int) integer value e.g. 23 # (double) real number value e.g. 34.567 # (string) literal string e.g. any string of words # (intList) list of (ints) e.g. 0:1:2 # (stringList) list of strings e.g. tiff:tif:TIFF:TIF # (colorSpec) R,G,B color specification e.g. 128,0,255 # # The Following Notes apply # # SET WITH GUI: # These values are accessible through the program graphic program # interface (GUI). You should utilize the GUI to set these values # so that the program can check for valid values and possible # dependencies between values. # # ADVANCED PARAMETER: # These values are only accessible from this file. In general # it is not expected that you should need to modify these values # from the defaults so it's a good idea to think twice before # doing so. You must use a text editor (of your choosing) # to modify these values. # # LICENSE DATA: # These data are automatically inserted (appended) this # file during the program license registration process. If you # have trouble registering a copy of the program, see the comments # in this section # # RESERVED: # Not currently used. Modification of these values will NOT have # an effect on the program. # ###################################################################### # # DO NOT CHANGE: # This line specifies the configuration file version ID - i.e. the # 'bigmo.cfg' version of this file and to which this documentation # and comments apply. # Version 2 # # #====================================================================== #==== Software License Registration #====================================================================== # # # LICENSE DATA # NOTE: After registration, a set of "License::" keywords and data values # are inserted into this configuration file. It is important that # NONE OF THESE KEYWORDS are present when running the register program. # If this configuration file is copied from another system and contains # registration data for that other system, delete all "License::" lines # from the file, before runing registration program. # NOTE: Normally the "License::" data will be located at end of this file # ## License:: (NOTE: several entries will start with "License::") # # #====================================================================== #==== General Software Configuration #====================================================================== # # # SET WITH GUI: (int): Cache size in MB # CacheSize 64 # # # ADVANCED PARAMETER: (int): Number of open file descriptors to be cached # Default value is about 100 # Normally the default if fine. Some NT systems have trouble handling # a large number of I/O files (e.g. if processing 100s/1,000s of images) # in which case, increasing this parameter (e.g. to 5000) may help # FDCacheSize 100 # # # ADVANCED PARAMETER: (int): Set default GUI font size # Default value is derived from system window manager # You can override the window manager default font size by changing # this value. Font size affects text in GUI (menus, buttons, etc.) # ## FontSize 12 # # # ADVANCED PARAMETER: (string): Filename for runtime detail logging # If set, the program will write vast quanties of runtime information # to this log file. NOTE: Use of a log file GREATLY SLOWS program # execution time and should not used unless suggested by technical support # ## LogFile # # #------------------ # Image/Background data interpretation #------------------ # # # SET WITH GUI: TRUE/FALSE: If TRUE, "background" pixel values are ignored # BackgroundCheck TRUE # # # SET WITH GUI: (intList): Range of 8-bit pixel values to consider valid 'image' # ImageMinMax 1:254 # # # ADVANCED PARAMETER: (colorSpec): # Default is 0,0,0 (black) # NOTE: Color spec is a comma separated list of 8-bit values R,G,B # Examples: Pure red 255,0,0 Pure blue is 0,0,255 Grey 128,128,128 # OutputBackground 0,0,0 # # #------------------ # Image Display #------------------ # # # SET WITH GUI: (intList): assign image channels to display channels (R:G:B) # Display::ChannelMap 0:1:2 # # # ADVANCED PARAMETER: (bool): Control display transparency settings # Default value is TRUE # If set, non-data pixels will be displayed as transparent # ImageDisp::Alpha TRUE # # # ADVANCED PARAMETER: (colorSpec): Input ortho footprints # OrthoColor::Base 255,0,0 # # # ADVANCED PARAMETER: (colorSpec): Input ortho names # OrthoColor::Text 0,128,128 # # # ADVANCED PARAMETER: (colorSpec): Output mosaic tile footprints # OutputColor::Base 0,255,255 # # # ADVANCED PARAMETER: (colorSpec): Output mosaic tile names # OutputColor::Text 255,0,255 # # # ADVANCED PARAMETER: (colorSpec): Output mosaic tile shading # OutputColor::Highlight 0,255,0 # # # ADVANCED PARAMETER: (colorSpec): Tile definition file footprints # TileColor::Base 0,0,255 # # #------------------ # GUI configuration/properties #------------------ # # # SET WITH GUI: (bool): If TRUE, show all toolbar icons # ExpertMode FALSE # # # ADVANCED PARAMETER: (bool): Control display refresh behavior # Default value is TRUE # If set, only objects that can be display fast are drawn during # dynamic GUI modifications # Frame::alwaysUpdate TRUE # # #====================================================================== #==== Tools and Utilities #====================================================================== # # #------------------ # Printing #------------------ # # # ADVANCED PARAMETER: (int): printer resolution (dots per inch) # Default is computed to fill page with displayed screen content # Displayed screen pixels will be printed at this many pixels to # the inch on paper # ## Printer::DPI 100 # # # ADVANCED PARAMETER: (double): page margin (inches) # Default value is 0.75 # ## Printer::Margin 0.75 # # #------------------ # Color Editor #------------------ # # # SET WITH GUI: (string): extension indicating "color map" data files # CMMExt cmap # # # ADVANCED PARAMETER: (bool): # Draw image-to-image connecting lines in Color Editor # Use FALSE to significantly speed display # Use TRUE to see connections between adjacent images # ColorEditor:DrawConnectingLines TRUE # # #====================================================================== #==== Processing options #====================================================================== # # #------------------ #---- General Processing #------------------ # # # SET WITH GUI: (bool): Automaticaly detect Image/Background border # Mosaic::AutoBorder TRUE # # # SET WITH GUI: (bool): If TRUE, perform Single Image balancing # ProcOpt::Balance FALSE # # # SET WITH GUI: (string): Name of Single Image balancing method to use # ProcOpt::BalanceMethod Hot Spot Removal # # # SET WITH GUI: (string): (C-style) filename format for balanced output images # ProcOpt::BalanceName %s.out.tif # # # SET WITH GUI: (string): Name of Multiple Image adjustment method to use # ProcOpt::TiltMethod Global Tilting Adjustment # # # SET WITH GUI: (bool): If TRUE, generate Mosaic output # ProcOpt::Mosaic TRUE # # # SET WITH GUI: (string): Name of Mosaic method to use # ProcOpt::MosaicMethod Plain Mosaic # # # SET WITH GUI: (string): (C-style fmt) filename spec for Mosaic output images # ProcOpt::MosaicName mosaic-%s.tif # # # SET WITH GUI: (string): Output image format selection # ProcOpt::OutType TIFF # # # SET WITH GUI: (string): Output georeference report format selection # ProcOpt::RptType TiffWorld # # # SET WITH GUI: (int): Output pixel downsample ratio # ProcOpt::OutRatio 1 # # # SET WITH GUI: (bool): If TRUE, source pixels are averaged during downsample # ProcOpt::PixelAvg FALSE # # # SET WITH GUI: (bool): If TRUE, rotate before saving adjusted input images # ProcOpt::RotateBalanced FALSE # # #------------------ #---- Single Image Adjustments (internal image adjustments) #------------------ # # # ADVANCED PARAMETER: (int): Threshold (percent) for sparse image warning # Default value is 20 (percent) # During adjustments, the border of image pixels is extracted from the nondata # background pixels. If the resulting image area is less than this # threshold a warning message is generated. The warning helps identify # input images which may have been requested to be processed but contain # mostly background (non-image) pixel data. # MinImageDataPercent 20 # # #------------------ # Single Image Adjustment "Hot Spot" method #------------------ # # # SET WITH GUI: (bool): If TRUE, adjust color as well as intensity # Balance::ColorAdjust TRUE # # # SET WITH GUI: (string): File containing complex region exclusion areas # ## Balance::ExclusionFile # # # SET WITH GUI: (int): If N, sample images at N by N grid locations # Balance::GridSize 50 # # # SET WITH GUI: (int): Output set to this intensity (if 0, auto compute) # Balance::Intensity 0 # # # SET WITH GUI: (bool): If TRUE use Multiplicative model, else Additive one # Balance::Multiply FALSE # # # SET WITH GUI: (int): Multiplicative solution's iterative limit # NOTE: This value has precidence over the "Balance::RMSDelta" tolerance # Balance::MaxIterations 20 # # # ADVANCED PARAMETER: (double): Multiplicative solution convergence tolerance # Default is 1e-5 # Smaller values improve quality of solution but increase processing time # NOTE: If the "Balance::MaxIterations" value is exceeded, computations # are stopped weither this tolerance is reached or not. # Balance::RMSDelta 1e-5 # # #------------------ # Single Image Adjustment "Intensity Dodging" method #------------------ # # # SET WITH GUI: (int): If N, sample images at N by N grid locations # SPBalance::AvgGridSize 50 # # # SET WITH GUI: (int): Degree of dodging (higher makes image more uniform) # SPBalance::ControlGridSize 5 # # # SET WITH GUI: (bool): If TRUE, adjust color as well as intensity # SPBalance::ColorAdjust FALSE # # # SET WITH GUI: (int): Output set to this intensity (if 0, auto compute) # SPBalance::Intensity 0 # # # SET WITH GUI: (bool): If TRUE use Multiplicative model, else Additive one # SPBalance::Multiply TRUE # # #------------------ #---- Multiple Image Adjustments (image-to-image matching) #------------------ # # #------------------ # Multiple Image Adjustment "Global Tilting" method #------------------ # # # ADVANCED PARAMETER: (int): If N, sample images using N by N grid. # Default value is 50 # This is used to determine the density of pixel samples used to # compute the radiometric 'tilting' correction. Images are sampled # at a incremental pixel spacing which yields, on average, this many # samples by this many samples for each image. # TiltAdj::GridSize 50 # # # ADVANCED PARAMETER: (bool): Adjust color as well as intensity # Default value is TRUE # If set to TRUE, the color components of the image are adjusted as # well as the intensity. If set to FALSE, only the intensity component # of the image is adjusted. # TiltAdj::ColorAdjust TRUE # # # SET WITH GUI: (int): Number of "Global Tilting" computation iterations # TiltAdj::Iterations 3 # # # SET WITH GUI: (bool): Retain radiometry at non-overlapping corners # Default value is TRUE # If set, radiometric image characteristics at non-overlapping image # corners are held fixed at original values. When TRUE the radiometry # values at the isolated corners will be held at the input value. The # radiometric properties at overlapping areas (e.g. edges and corners) # will still be modified. The result will be a "ramp-up" of radiometric # adjustment influence begining with zero at the isolated corner and # increasing toward areas where the image overlaps other images. # If FALSE, the radiometric properties at the isolated corners are # allowed to adjust to the overal mosaic average value. # TiltAdj::HoldCorners TRUE # # #------------------ #---- Mosaic Composition #------------------ # # # SET WITH GUI: (double): Rotation angle (degrees) of mosaic output # Heading 0.0 # # #------------------ # Mosaicking method "Plain Mosaic" #------------------ # # # ADVANCED PARAMETER: (bool): Average overlapping images # Default value is FALSE # During "Plain Mosaic" mosaic is normally created using a "latest # input image on top" composition strategy. If this value is set, # all overlapping input images are (uniformly) averaged together # to product the composite output mosaic. (Not generally a good # idea for production but setting this to TRUE can be of use in # testing to explore the pixel level alignment of input ortho images. # Mosaic::Average FALSE # # #------------------ # Mosaicking method "Adaptive Feathering" #------------------ # # # SET WITH GUI: (double): controls sharpness of image blending # SmoothMosaic::BlendFact 2.5 # # # SET WITH GUI: (int): N for NxN grid - controls resolution of image blending # SmoothMosaic::GridSize 80 # # # ADVANCED PARAMETER: (int): Feature detection sensitivity threshold # Default value is 50 (percent) # Higher values are more sensitive to image features (more crooked seams) # Lower values are less sensitive to image features (more straight seams) # SmoothMosaic::FeatureSensitivity 50 # # # ADVANCED PARAMETER: (bool): Replace mosaic output with "Blending Image" # Default is FALSE # If set, the output mosaic IS REPLACED by an image which indicates # the amount of 'mixing' of input pixel data. Image data is retained # for areas of the mosaic in which images do not overlap. This can # be "interesting" but is rather unproductive since normal mosaic # output is NOT produced when this option is on. # Mosaic::OverlayAlphaBlend FALSE # # #------------------ # Mosaicking method (Beta Version) "Auto Cutline" #------------------ # # # ADVANCED PARAMETER: (int): control cutline heirarchical stepsize # Valid values are 1 through 255 (default is about 12) # Larger values produce higher resolution cutlines (but take longer) # CutlineMosaic::QuantSteps 12 # # # RESERVED: (int): Currently NOT used # CutlineApplicator::FeatherSize 0 # # #====================================================================== #==== Image plugin formats #====================================================================== # # #------------------ # BIP/BIL format keys #------------------ # # # SET WITH GUI: (int): Interleave by Pixel(0), by Line(1) # BIP::Layout 0 # # #------------------ # Tiff image format keys #------------------ # # # SET WITH GUI: (bool): if TRUE, use "tiled" TIFF format # Tiff::Tiled TRUE # # # SET WITH GUI: (int): Rows per Stripe in TIFF "striped" format (0 use default) # Tiff::StripSize 0 # # # SET WITH GUI: (int): Tile dimension in TIFF "tiled" format (0 use default) # Tiff::TileSize 0 # # # SET WITH GUI: (int): Compression None(0), PackBits(1), LZW(2), JPEG(3) # Tiff::Compression 0 # # # SET WITH GUI: (int): JPEG Quality factor # Tiff::JPEGQuality 75 # # # SET WITH GUI: (int): Create overview only if image is larger than this # Tiff::MinImageSize 2048 # # # SET WITH GUI: (bool): If TRUE, put overview image in image file # Tiff::SaveOverview FALSE # # # SET WITH GUI: (int): Size (max dimension) of overview image # Default is 1024 # The maximum (width or height) dimension of the overview image is # set to this value while retaining the aspect ratio of the full # resolution image # Tiff::OverviewSize 1024 # # # ADVANCED PARAMETER: (string) # Default value "OrthoVista" # String to be associated with TIFF 'software version tag' # Tiff::Software OrthoVista # # # ADVANCED PARAMETER: (stringList): Identify TIFF image filename extensions # Default value is "tif" (e.g. all *.tif files) # Specifies a list of extensions which imply TIFF file format # TiffPlugin::extensions tif:tiff # # #------------------ # TIFF World georeference files #------------------ # # # ADVANCED PARAMETER: (stringList): Identify TiffWorld filename extensions # Default value is "tfw:tifw" # Specifies a list of extensions which imply TiffWorld georeference file format # TiffWRptPlugin::extensions tfw:tifw # # # ADVANCED PARAMETER: (string): TiffWorld field format specification # Default value is "%25.6f" (without the quotes) # This value is used to control the format with which each field is written. # The format specification is the "C-Language Style" used by "fprintf()". For # example "%15.6f" prints each field right justified within 15 columns and # with 6 digits after the decimal point; "%.9e" prints 9 significant digits # using "E-notation". # TiffWRptPlugin::fieldFormat %25.6f # # #------------------ # Zeiss/PHODIS image and georeference files #------------------ # # # SET WITH GUI: (bool): If TRUE, save overview image # Phodis::SaveOverview TRUE # # # ADVANCED PARAMETER: (stringList): Identify PHODIS image filename extensions # Default value is "tld" (e.g. all *.tld files) # Specifies a list of extensions which imply PHODIS file format # PhodisPlugin::extensions tld # # # ADVANCED PARAMETER: (string): file format tags # # The following strings are used to identify specific information # sections of the georeference report file # Zeiss::Camera # CAMERA file name Zeiss::DTM # DTM Zeiss::File # File : Zeiss::Image # IMAGE Zeiss::Ortho # ORTHOPHOTO # # #------------------ # Vision/Softplotter image and georeference files #------------------ # # # ADVANCED PARAMETER: (string): file format tags # # The following strings are used to identify specific information # sections of the georeference report file # # Vision::Bands Number of bands: Vision::Bounds Ortho bounds definition: Vision::DemID DEM ID: Vision::GSD Ground sample distance (.*): Vision::Height Y: Vision::LRX Lower right corner X (.*): Vision::LRY Lower right corner Y (.*): Vision::OrthoID Ortho ID: Vision::PCenter Pixel center Vision::PCorner Pixel corner Vision::Projection Projection: Vision::SrcImage Image: Vision::Status Status: Vision::Type Type: Vision::ULX Upper left corner X (.*): Vision::ULY Upper left corner Y (.*): Vision::Width X: # ###################################################################### #