home

program description: Fisheye Worker

The detailed description is in the text file "readMe". You can download it from this page at the bottom.

The program "Fisheye Worker" serves for the transformation of many fisheye pictures one behind the other with the same values. A constant participation, like an opening and saving file for file is not necessary. "Fisheye Worker" works not like a single image processing, but like a wizard or a batch program. In order to ensure a no-break processing of a large file number, in the case of errors no dialogue window will pop up. In the event of an error the current file is simply jumped over and the next begun. In a text file the logged procedures are held and can be examined subsequently.
For a faster processing a pre-calculation takes place and the transformation up to program closing is stored. Since through can be processed only a uniform dimension of picture area. The program does not have anti-aliasing (that is not pre-calculable), but an averaging when making smaller. So that the aliasing (when enlarging) does not disturb, 1536 pixels are given as minimum size for the source pictures. The camera or the frame-scanner is to be adjusted accordingly.

operating system: copy program file: Microsoft 32/64-bit-Windows, setup: 32/64-bit-NT-Windows (2000 / XP / Vista / 7)
main memory: from 500 MByte - else slow
file format: bmp (only 24 bits depth of shade)
- other formats (e.g. jpg) by integration of external programs
picture area: source 1536...8192 x 1536...8192, destination 10...8192 x 10...8192
transformations: fisheye~> conformal, fisheye~> normal, normal~> conformal, normal~> normal
("fisheye" stands for equisolid angle, "conform" for stereografic and "normal" for gnomonical)
programming: with Visual Basic 6 by Peter Wieden

The work of the "Fisheye Workers" runs off in 3 steps:

setting of parameters (first image)
pre-calculation (second image)
picture transformation (third and fourth image)

A return to earlier steps to the new setting of the parameters is not intended.

The following description is based on the example of a digital SLR in the APS format.

standard operating

arrange files: Arrange pictures with same width and same height (landscape and portrait are to separate) and of only one optics (e.g. fisheye 8 mm). Width and height must be in the range 1536 to 8192. The directory with that pictures must be writable and have sufficiently place for the destination pictures.
convert files: The pictures are to be converted to 24-Bit-BMP files (true color) with an external program. A source conversion during the transformation by external program-integration with temporary bmp files (saves storage space) is described in readMe.txt.
Fisheye Worker: launch program (without command line parameters)
step 1 - make settings:
outer frame source (...picture)
  inner frame area (...of picture)
    text field width: enter source pixels (range 1536...8192)
    text field height: enter source pixels (range 1536...8192)
      only pictures, which fit the entered size, are processed
  innerer frame axis offset (decentring)
    text field dx: enter axis pixels placing to the right (negative values if left the center)
    text field dy: Enter axis pixels placing downward (negative values if above the center)
      If possible determines values, if unknown enter 0 (zero)
  pulldown list: to select the type of the used optics (e.g. fisheye)
  text field focal length: enter in pixels
      (e.g. 1229 for Sigma8 at 'EOS Digital Rebel' XT (Kiss Digital / 350 D)
outer frame destination (...picture)
  inner frame area (...of picture)
    text field width: enter destination pixels (range 10...8192)
    text field height: enter destination pixels (range 10...8192)
  checkbox axis centered specifies whether no axis offset in destination picture
      (yes: centered, no: better utilization of picture)
  pulldown list: to select the (mapping) type of the optics to make (e.g. normal).
  text field zoom: enter magnification
      (point number, zoom = 1 corresponds to the full format fitting)
step 2 - start pre-calculation: press Button ready
Depending upon kind of transformation a dialogue with an optimization proposal for the destination dimension of picture area appears (or not). The proposal should not be accepted, if the source picture doesn't reach until the corners (black corners).
  [Yes] changes the destination picture format appropriately to the proposal and starts the pre-calculation.
  [No] starts the pre-calculation without format change.
  [Cancel] jumps back to step 1 to change the settings
The with [no] or [yes] launched pre-calculation goes through 4 partial steps.
  left half marked: allocating memory space for source data
  right half marked: allocating memory space for destination data
  bar run from left to center: storing forward transformation
  bar run to right: storing backward transformation
The window changes its form suitably the destination picture and gets another color.
step 3 - picture transformation: The program is ready to transform very many pictures according to the before-computed scheme. The directory with the pictures must be recordable and have sufficiently place for the destination pictures. The source pictures remain. The destination pictures get their file name automatically, as between file name head and extension a intermediate extension is inserted. In addition a log file is created in the picture directory. The file names are built according to the following rule:
  given source file: <picturename>.bmp
  logfile: <type>~<f2>.txt
  destination file: <picturename>.<type>~<f2>.bmp
    <type>: classification number for destination optics (conformal=1, normal=2)
    <f2>: (rounded) focal length pixels of the destination optics
checking the settings: Click with right mouse button or press F1. If the setting are not correct, the program must be terminated and started again.
start of the processing:
- open Explorer
- mark files
- Either drag & drop: Draw and release files into the "Fisheye Worker" and start the processing with a mouse movement or an Enter.
- or copying and inserting: Copy files into the clipboard (Ctrl + C or Ctrl + Ins), changing to the "Fisheye Worker" and inserting (Ctrl + V or Shift + Ins). The processing starts automatically.
A "file open"-dialogue is not available.
The processing of each picture is observable in the program window
1. A color bar starts streching downwards - the destination memory is reset and filled with desctop-color. (with zoom < 1.0 this color remains beside the destination picture as border color [passepartout].)
2. The source picture develops itself upwards - the source file is read and the destination pixels are partly set. Boundary regions, which do not arrive in the destination picture, are marked (border line). Thus can be seen at once, which picture parts are taken.
3. The destination picture develops itself from down - the destination pixels are completed and written directly into the destination file.
The next picture follows with step 1.
Headline during the processing shows e.g. "1/2 = image.bmp"
    (<enumerator of file>/<number of files> = <file name>)
During the processing further files can be added by drag & drop or inserting.
    (the file number is updated with the picture change)
After the last picture, the window takes its initial color again and is ready for the next files.
Header after the processing e.g. "score = 2:2, 0 unprocessed""
    (score = <number works on>:<number rejected>, <number incomplete>) unprocessed
Fisheye Worker: Program terminate (Close-button in header [x] )
convert files: The pictures are to be converted with an external program from BMP-format into the wanted format (e.g. JPG). A destination conversion during the transformation by external program-integration with temporary bmp files (saves storage space) is described in readMe.txt.
sort and rename files: Move pictures into the wanted directories and rename as wished.

program description: Fisheye Worker 98

This version is intended for older computers and computers with less main memory. There are the following differences to "Fisheye Worker":

operating system: copy program file: Microsoft 32/64-bit-Windows, setup: 32 bit Windows based on DOS (98 / ME)
main memory: enough for good Windows Performance
hard disk space: app. 200 MB in TEMP-directory (4 * sourcePixel + 12 * destinationPixel)
programing: with Visual Basic 5

program description: Fisheye Worker Chrome

This version is intended for computers capable of performance with a lot of main memory and offers the following extra:

- separated transformation for red, green and blue for the decrease of colour edges (lens error).
- processing of picture shortcuts (new since version 1.1, Aug 2008)

other differences to "Fisheye Worker":

operating system: copy program file: Microsoft 32/64-bit-Windows, Setup: not present
Setup can be implemented by "Fisheye Worker". Afterwards copy the program file and make a shortcut.
main memory: from 1 GByte - else slow

Software License Agreement
for the programs "Fisheye Worker", "Fisheye Worker 98", "Fisheye Worker Chrome"
by Peter Wieden and with a routine by Terry Kreft

By downloading the software you agree to be bound by the terms of this agreement.

You agree to use the software only in accordance with the following terms and conditions.

You are allowed to use the software free of charge.

Ownership and copyright: All right in this software and its documentation is owned by Peter Wieden or other authors who have allowed to utilize their routines. You shall not modify, remove or delete a copyright notice in the software or its documentation.

You are not permitted to rent, lease, loan, sell, modify, reverse-engineer the software or its related documentation.

I'm not bound for support nor update. You should take security measures to prevent damages, e.g. by making backups of all image-files of those directorys where you will work.
Especialy the two setup's may run only in the Windows-versions designated for that. A mixing up can destroy Windows (Windows older than XP).

I'm interested in hints and advices so that I can work in possibillities and one's own discretion. You'll find my mail-adress at the download-page for this program.

THE SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OR CONDITION OF ANY KIND.
THERE ARE NO WARRANTIES OR CONDITIONS AS TO QUALITY AND/OR FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE SOFTWARE IS WITH YOU.
SHOULD THE SOFTWARE PROVE DEFECTIVE, YOU ASSUME THE ENTIRE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
I DO NOT WARRANT THAT THE FUNCTIONS CONTAINED IN THE SOFTWARE WILL MEET YOUR REQUIREMENTS OR THAT THE OPERATION OF THE SOFTWARE WILL BE UNINTERRUPTED OR ERROR FREE.

ACKNOWLEDGMENT: BY THE ACTION OF INDICATING YOUR ACCEPTANCE OR USING THE SOFTWARE, YOU ACKNOWLEDGE THAT YOU HAVE READ THIS AGREEMENT, UNDERSTOOD IT AND AGREED TO BE BOUND BY ITS TERMS AND CONDITIONS.

If a provision of this Agreement is invalid, that shall not affect the validity of any other provision of this Agreement.

Download Version 1.0.0.3 (Win98: Version 1.1.0.1, Chrome: Version 1.1.0.0)

Setup complete (zip) 1.4 MB	Fisheye Worker only program 160 KB	Setup Win98 complete (zip) 1.47 MB	Fisheye Worker (Win98) only program 92 KB	Fisheye Worker Chrome only program 252 KB	read Me (english) 84 KB	lies Mich (german) 89 KB
`files for installation from Windows 2000 in fisheyeWorker.zip ------------------------- setup.exe SETUP.LST bmpFisheyeWorker.CAB ... with bmpFisheyeWorker.exe COMCAT.DLL dialog en-de.txt liesMich.txt msvbvm60.dll OLEAUT32.DLL OLEPRO32.DLL readMe.txt SETUP1.EXE ST6UNST.EXE STDOLE2.TLB VB6DE.DLL VB6STKIT.DLL`		files for installation under Windows 98 in fisheyeWorker98.zip name after expansion --------------------------------------------- AsycFilt.dl_ AsycFilt.dll bmpFisheyeWorker98.DE_ bmpFisheyeWorker98.DEP bmpFisheyeWorker98.ex_ bmpFisheyeWorker98.exe ComCat.dl_ ComCat.dll Ctl3d32.dl_ Ctl3d32.dll liesMich.tx_ liesMich.txt MSVBVM50.dl_ MSVBVM50.dll OleAut32.dl_ OleAut32.dll OlePro32.dl_ OlePro32.dll readMe.tx_ readMe.txt setup1.ex_ setup1.exe SETUP.EXE SETUP.LST ST5UNST.EX_ ST5UNST.EXE StdOle2.tl_ StdOle2.tlb VB5DE.dl_ ; VB5DE.dll VB5StKit.dl_ ; VB5StKit.dll automatic expansion of "*.??_" -files during the installation (or manually with the DOS command "EXPAND")		`bmpFisheyeWorkerChrome.exe`	`readMe.txt`	`liesMich.txt`

Appendix: Using of the routine "Shellwait" from Terry Kreft

(The routine "Shellwait" including its subroutines puts "Fisheye Worker" in a waiting state while using an integrated external program.)

This code was originally written by Terry Kreft. It is not to be altered or distributed, except as part of an application. You are free to use it in any application, provided the copyright notice is left unchanged. 'Code Courtesy of ' Terry Kreft