"Fossies" - the Fresh Open Source Software Archive  

Source code changes of the file "data/userguide" between
fotoxx-22.41.tar.gz and fotoxx-22.50.tar.gz

About: fotoxx is a program for photo editing and collection management.

userguide  (fotoxx-22.41):userguide  (fotoxx-22.50)
FOTOXX USER GUIDE v.22.40 FOTOXX USER GUIDE v.22.50
View using the Fotoxx menu Help > User Guide View using the Fotoxx menu Help > User Guide
INTRODUCTION INTRODUCTION
\>FOTOXX OVERVIEW\> - description, prerequisites, license, downloads \>FOTOXX OVERVIEW\> - description, prerequisites, license, downloads
\>FOTOXX CAPABILITIES\> - summary of Fotoxx functions and tools \>FOTOXX CAPABILITIES\> - summary of Fotoxx functions and tools
\>FOTOXX USAGE\> \>FOTOXX USAGE\>
\>USER GUIDE\> ← \bclick here\b - how to use this user guide browser \>USER GUIDE\> ← \bclick here\b - how to use this user guide browser
\>INSTALLATION\> - Fotoxx software installation, dependencies \>INSTALLATION\> - Fotoxx software installation, dependencies
\>FIRST STARTUP\> - information for when Fotoxx is started for the first time \>FIRST STARTUP\> - information for when Fotoxx is started for the first time
skipping to change at line 55 skipping to change at line 55
\>VIEW 360° PANO\> - view a 360° panorama image with rotating viewpoint \>VIEW 360° PANO\> - view a 360° panorama image with rotating viewpoint
\>RENAME\> - rename an image file \>RENAME\> - rename an image file
\>PERMISSIONS\> - view and set permissions for an image file \>PERMISSIONS\> - view and set permissions for an image file
\>REMOVE ALPHA\> - apply alpha to RGB values and remove alpha channel \>REMOVE ALPHA\> - apply alpha to RGB values and remove alpha channel
\>BLANK IMAGE\> - create a new blank image file with specified size and color \>BLANK IMAGE\> - create a new blank image file with specified size and color
\>BLANK WINDOW\> - blank or restore (toggle) the current image window \>BLANK WINDOW\> - blank or restore (toggle) the current image window
\>COPY/MOVE\> - copy or move an image file to another folder \>COPY/MOVE\> - copy or move an image file to another folder
\>COPY TO DESKTOP\> - copy an image file to the desktop \>COPY TO DESKTOP\> - copy an image file to the desktop
\>COPY TO CLIPBOARD\> - copy an image file to the clipboard \>COPY TO CLIPBOARD\> - copy an image file to the clipboard
\>DELETE/TRASH\> - delete or trash an image files \>DELETE/TRASH\> - delete or trash an image files
\>CONVERT ADOBE\> - convert Adobe files (.pdf/.ps/.eps/.psd) to jpeg images
\>SET WALLPAPER\> - set the desktop wallpaper from the current image file (Gn ome) \>SET WALLPAPER\> - set the desktop wallpaper from the current image file (Gn ome)
\>SHOW ON MAP\> - show an image file position in Net Map View \>SHOW ON MAP\> - show an image file position in Net Map View
\>PRINT\> - print an image file \>PRINT\> - print an image file
\>PRINT CALIBRATED\> - print an image file using printer color calibration da ta \>PRINT CALIBRATED\> - print an image file using printer color calibration da ta
\>QUIT\> - exit from Fotoxx \>QUIT\> - exit from Fotoxx
\>GALLERY MENU\> \>GALLERY MENU\>
\>THUMB VIEW\> - Gallery View with large thumbnails and file names only \>THUMB VIEW\> - Gallery View with large thumbnails and file names only
\>META VIEW\> - Gallery View with thumbnail and basic metadata used by Fotoxx \>META VIEW\> - Gallery View with thumbnail and basic metadata used by Fotoxx
\>RECENT FILES\> - open Gallery View of most recently seen image files \>RECENT FILES\> - open Gallery View of most recently seen image files
skipping to change at line 157 skipping to change at line 158
\>SHARPEN\> - sharpen a blurred image, multiple methods \>SHARPEN\> - sharpen a blurred image, multiple methods
\>BLUR\> - blur an image or image area, multiple methods \>BLUR\> - blur an image or image area, multiple methods
\>DENOISE\> - reduce image noise (small random specks) \>DENOISE\> - reduce image noise (small random specks)
\>DEFOG\> - add or remove fog/haze from an image or selected area \>DEFOG\> - add or remove fog/haze from an image or selected area
\>RED EYES\> - remove red eyes from flash photos \>RED EYES\> - remove red eyes from flash photos
\>SMART ERASE\> - remove power lines, trash, signs, other small image spoiler s \>SMART ERASE\> - remove power lines, trash, signs, other small image spoiler s
\>REMOVE HALO\> - remove halos left by sharpen and other edit functions \>REMOVE HALO\> - remove halos left by sharpen and other edit functions
\>ADJUST RGB\> - adjust image colors using RGB or CMY colors \>ADJUST RGB\> - adjust image colors using RGB or CMY colors
\>ADJUST HSL\> - select and change colors using HSL colors \>ADJUST HSL\> - select and change colors using HSL colors
\>COLOR PROFILE\> - convert color profile (e.g. sRGB <--> Adobe RGB) \>COLOR PROFILE\> - convert color profile (e.g. sRGB <--> Adobe RGB)
\>VIGNETTE\> - change brightness or color radially around a chosen center
\>REMOVE DUST\> - remove dust spots on images scanned from old photos \>REMOVE DUST\> - remove dust spots on images scanned from old photos
\>CHROMATIC 1\> - fix chromatic aberration (color fringes, mainly image perip hery) \>CHROMATIC 1\> - fix chromatic aberration (color fringes, mainly image perip hery)
\>CHROMATIC 2\> - fix chromatic aberration (color bands along bright/dark edg es) \>CHROMATIC 2\> - fix chromatic aberration (color bands along bright/dark edg es)
\>REFINE MENU\> \>REFINE MENU\>
\>VOODOO 1\> - automatic 1-click enhancement that may work OK \>VOODOO 1\> - automatic 1-click enhancement that may work OK
\>VOODOO 2\> - automatic 1-click enhancement that may work OK \>VOODOO 2\> - automatic 1-click enhancement that may work OK
\>EDIT DIST\> - edit brightness distribution, rebalance dark and bright areas \>EDIT DIST\> - edit brightness distribution, rebalance dark and bright areas
\>FLATTEN DIST\> - flatten brightness distribution to improve details \>FLATTEN DIST\> - flatten brightness distribution to improve details
\>LOCAL CONTRAST\> - add contrast adapted to brightness of each image area \>LOCAL CONTRAST\> - add contrast adapted to brightness of each image area
\>GRADIENTS\> - increase contrast where it is weakest \>GRADIENTS\> - increase contrast where it is weakest
\>GLOBAL RETINEX\> - rescale RGB values to remove color cast and fog/haze \>GLOBAL RETINEX\> - rescale RGB values to remove color cast and fog/haze
\>LOCAL RETINEX\> - rescale RGB values to remove color cast and fog/haze \>LOCAL RETINEX\> - rescale RGB values to remove color cast and fog/haze
\>SATURATION\> - adjust color saturation, optionally based on brightness \>SATURATION\> - adjust color saturation, optionally based on brightness
\>SOFT FOCUS\> - apply classic "soft focus" effect to an image \>SOFT FOCUS\> - apply classic "soft focus" effect to an image
\>MATCH COLORS\> - match the colors in one image to those in another image \>MATCH COLORS\> - match the colors in one image to those in another image
\>BRITE RAMP\> - add a brightness/color ramp across an image \>BRITE RAMP\> - add a brightness/color ramp across an image
\>VIGNETTE\> - change brightness or color radially around a chosen center
\>EFFECTS MENU\> \>EFFECTS MENU\>
\>SKETCH\> - convert an image into a simulated sketch \>SKETCH\> - convert an image into a simulated sketch
\>CARTOON\> - convert an image to a cartoon-like drawing \>CARTOON\> - convert an image to a cartoon-like drawing
\>DRAWING\> - convert an image to a simulated line drawing \>DRAWING\> - convert an image to a simulated line drawing
\>EMBOSS\> - convert an image to a simulated embossing (3D effect) \>EMBOSS\> - convert an image to a simulated embossing (3D effect)
\>TILES\> - convert an image into simulated square tiles \>TILES\> - convert an image into simulated square tiles
\>PAINTING\> - convert an image into a simulated painting \>PAINTING\> - convert an image into a simulated painting
\>TEXTURE\> - add texture to an image or selected area \>TEXTURE\> - add texture to an image or selected area
\>PATTERN\> - add a background pattern to an image \>PATTERN\> - add a background pattern to an image
skipping to change at line 242 skipping to change at line 243
\>BATCH RAW\> - convert RAW files to JPEG/PNG/TIFF, 8 or 16 bit color \>BATCH RAW\> - convert RAW files to JPEG/PNG/TIFF, 8 or 16 bit color
\>BATCH OVERLAY\> - add overlay image (copyright ...) to selected host images \>BATCH OVERLAY\> - add overlay image (copyright ...) to selected host images
\>BATCH TAGS\> - add or remove tags for selected images \>BATCH TAGS\> - add or remove tags for selected images
\>BATCH RENAME TAGS\> - rename tags for selected or all images \>BATCH RENAME TAGS\> - rename tags for selected or all images
\>BATCH PHOTO DATE\> - change photo dates or times, or shift time zone \>BATCH PHOTO DATE\> - change photo dates or times, or shift time zone
\>BATCH CHANGE META\> - add or revise metadata for selected or all images \>BATCH CHANGE META\> - add or revise metadata for selected or all images
\>BATCH REPORT META\> - report metadata for selected or all images \>BATCH REPORT META\> - report metadata for selected or all images
\>BATCH MOVE META\> - move metadata between keywords - fix irregular usage \>BATCH MOVE META\> - move metadata between keywords - fix irregular usage
\>BATCH GEOTAGS\> - add or revise geotags for selected or all images \>BATCH GEOTAGS\> - add or revise geotags for selected or all images
\>BURN DVD/BRD\> - create a DVD or BlueRay disc with selected image files \>BURN DVD/BRD\> - create a DVD or BlueRay disc with selected image files
\>EXPORT FILE LIST\> - create a list of selected files (e.g. for use in a she ll script) \>EXPORT FILE LIST\> - create a list of selected files (e.g. for a shell scri pt)
\>EXPORT FILES\> - export selected files to a folder (e.g. for web upload) \>EXPORT FILES\> - export selected files to a folder (e.g. for web upload)
\>CONVERT ADOBE\> - convert Adobe files (.pdf .ps .eps) to jpeg images, one p er page
\>SCRIPT FILES\> - script files (macros) overview \>SCRIPT FILES\> - script files (macros) overview
\>EDIT SCRIPT\> - record a series of edits in a script file, execute on many files \>EDIT SCRIPT\> - record a series of edits in a script file, execute on many files
\>RUN SCRIPT\> - execute script on current image file (a custom edit function ) \>RUN SCRIPT\> - execute script on current image file (a custom edit function )
\>BATCH SCRIPT\> - execute script on all selected image files \>BATCH SCRIPT\> - execute script on all selected image files
\>TOOLS MENU\> \>TOOLS MENU\>
\>INDEX FILES\> - 1-time job to find and index all image files \>INDEX FILES\> - 1-time job to find and index all image files
\>QUICK INDEX\> - quick incremental index with no user interaction \>QUICK INDEX\> - quick incremental index with no user interaction
\>MOVE FOTOXX HOME\> - move fotoxx home folder to a new location \>MOVE FOTOXX HOME\> - move fotoxx home folder to a new location
\>SETTINGS\> - user preferences and settings for Fotoxx operation \>SETTINGS\> - user preferences and settings for Fotoxx operation
\>KB SHORTCUTS\> - show and revise keyboard shortcuts for menu functions \>KB SHORTCUTS\> - show and revise keyboard shortcuts for menu functions
\>RGB DISTRIBUTION\> - show a brightness distribution graph for the current i mage file \>RGB DISTRIBUTION\> - show a brightness distribution graph for the current i mage
\>MAGNIFY IMAGE\> - turn mouse into a magnifying glass over image \>MAGNIFY IMAGE\> - turn mouse into a magnifying glass over image
\>FIND DUPLICATES\> - find duplicate images in a gallery or the entire image collection \>FIND DUPLICATES\> - find duplicate images in a gallery or entire image coll ection
\>MEASURE IMAGE\> - measure pixel distances within an image \>MEASURE IMAGE\> - measure pixel distances within an image
\>SHOW RGB\> - show RGB values at mouse position or for selected points \>SHOW RGB\> - show RGB values at mouse position or for selected points
\>POPUP TEXT\> - show popup window with characters/texts to insert into edit widgets \>POPUP TEXT\> - show popup window with characters/texts to insert into edit widgets
\>CALIBRATE PRINTER\> - calibrate printer color - compensate for color shifts \>CALIBRATE PRINTER\> - calibrate printer color - compensate for color shifts
\>GRID SETTINGS\> - show or remove grid lines, set line count or spacing \>GRID SETTINGS\> - show or remove grid lines, set line count or spacing
\>LINE COLOR\> - set color for select area outlines \>LINE COLOR\> - set color for select area outlines
\>DARK/BRIGHT PIXELS\> - tool to highlight clipping \>DARK/BRIGHT PIXELS\> - tool to highlight clipping
\>MONITOR COLOR\> - tool to adjust monitor brightness and contrast \>MONITOR COLOR\> - tool to adjust monitor brightness and contrast
\>MONITOR GAMMA\> - tool to adjust monitor gamma \>MONITOR GAMMA\> - tool to adjust monitor gamma
\>SHOW RESOURCES\> - show CPU time and current memory usage \>SHOW RESOURCES\> - show CPU time and current memory usage
skipping to change at line 451 skipping to change at line 451
to install them. You can also view the list using the menu Help > Outboard Pr ograms. to install them. You can also view the list using the menu Help > Outboard Pr ograms.
\brequired Debian package function \brequired Debian package function
exiftool libimage-exiftool-perl read and write image metadata exiftool libimage-exiftool-perl read and write image metadata
dcraw dcraw RAW file read, index (\>SETTINGS \>) dcraw dcraw RAW file read, index (\>SETTINGS \>)
addr2line binutils fatal error report (crash backtr ace) addr2line binutils fatal error report (crash backtr ace)
\boptionial \boptionial
ffmpeg ffmpeg video thumbnails, extract frame image ffmpeg ffmpeg video thumbnails, extract frame image
dwebp webp read WEBP image files (.webp) dwebp webp read WEBP image files (.webp)
heif-convert heif-examples read Apple iPhone files (.heic) heif-convert heif-examples read Apple iPhone files (.heic)
opj_decompress libopenjp2-tools read jpeg2000 image files (.jp2) opj_decompress libopenjp2-tools read jpeg2000 image files (.jp2)
gs command ghostscript read Adobe files (.pdf/.ps/.eps) gs command ghostscript Adobe doc. files (.pdf/.ps/.eps)
>> .jpg
convert command imagemagick Adobe image files (.psd) >> .jpg
rawtherapee rawtherapee edit RAW images within Fotoxx rawtherapee rawtherapee edit RAW images within Fotoxx
rawtherapee-cli rawtherapee read RAW files (\>SETTINGS\>) rawtherapee-cli rawtherapee read RAW files (\>SETTINGS\>)
darktable darktable edit RAW images within Fotoxx darktable darktable edit RAW images within Fotoxx
darktable-cli darktable read RAW files (\>SETTINGS\>) darktable-cli darktable read RAW files (\>SETTINGS\>)
growisofs grwoisofs copy images to DVD or BlueRay di sc growisofs grwoisofs copy images to DVD or BlueRay di sc
vlc vlc play videos, slide-show music vlc vlc play videos, slide-show music
Package naming and contents vary by Linux distro (the usual chaos). The above names, Package naming and contents vary by Linux distro (the usual chaos). The above names,
or something similar, should be findable in your Linux flavor. Happy hunting. or something similar, should be findable in your Linux flavor. Happy hunting.
skipping to change at line 1240 skipping to change at line 1241
+image: delete-trash.jpg +image: delete-trash.jpg
The current file (File View), or the file of a clicked thumbnail (Gallery Vie w), is The current file (File View), or the file of a clicked thumbnail (Gallery Vie w), is
deleted or moved to trash, depending on the option selected. Fotoxx uses the Linux deleted or moved to trash, depending on the option selected. Fotoxx uses the Linux
desktop standard for trash (~/.local/share/Trash). Because GTK cannot trash f iles on desktop standard for trash (~/.local/share/Trash). Because GTK cannot trash f iles on
mounted volumes, files are moved to ~/Desktop first, and then to trash. If su ch a file mounted volumes, files are moved to ~/Desktop first, and then to trash. If su ch a file
is restored from trash, it will show up on the desktop. If you have multiple files to is restored from trash, it will show up on the desktop. If you have multiple files to
remove, you can leave the dialog open to speed the process. If another file i s opened, remove, you can leave the dialog open to speed the process. If another file i s opened,
the file name in the dialog updates itself. In Gallery View, if another thumb nail is the file name in the dialog updates itself. In Gallery View, if another thumb nail is
clicked, the dialog updates itself. clicked, the dialog updates itself.
CONVERT ADOBE
+image: convert-adobe.jpg
Convert an Adobe document file (.pdf .ps .eps) into a set of jpeg image files
, one per
document page. The output file names have the input file name with the page n
umber
appended: filename-N.jpg. The output file pixel size depends on the 'paper si
ze' of
the document file (US Letter: 2479 x 3508). The program ghostscript must be i
nstalled.
Photoshop image files (.psd) can be converted to .jpg, one output file with t
he same
root name as the input file, and the same pixel size. The program imagemagick
must be
installed.
SET WALLPAPER SET WALLPAPER
The desktop wallpaper is set from the current file. The desktop wallpaper is set from the current file.
NOTE: this is Gnome specific and likely does not work for other windowing sys tems. NOTE: this is Gnome specific and likely does not work for other windowing sys tems.
SHOW ON MAP SHOW ON MAP
Change to Net Map View and show the location of the current image. Change to Net Map View and show the location of the current image.
The map may need time show up, depending on internet response time. The map may need time show up, depending on internet response time.
PRINT PRINT
+image: print-setup.jpg +image: print-margins.jpg +image: print-setup.jpg +image: print-margins.jpg
skipping to change at line 3310 skipping to change at line 3322
not have been exposed at the same time and have the same blur (mechanical or electronic not have been exposed at the same time and have the same blur (mechanical or electronic
moving shutter). This method may still produce better results than nothing, o r sharpen moving shutter). This method may still produce better results than nothing, o r sharpen
tools that work in all directions (these make feature edges sharper but do no thing to tools that work in all directions (these make feature edges sharper but do no thing to
recover lost detail). It should work better on old photos made with film came ras. recover lost detail). It should work better on old photos made with film came ras.
BLUR BLUR
+image: blur.jpg +image: blur.jpg
Choose a method with the corresponding check-box, input the required paramete rs, Choose a method with the corresponding check-box, input the required paramete rs,
press [apply]. If \>SELECT AREA\> is active, only the selected areas are affe cted. press [apply]. If \>SELECT AREA\> is active, only the selected areas are affe cted.
\bNormal \bNormal Blur
Mix each pixel with surrounding pixels within radius. Mix each pixel with surrounding pixels within radius.
Closer pixels have a higher weight. Closer pixels have a higher weight.
\bRadial \bRadial Blur
Mix each pixel with pixels along a line from a chosen center. Radius defines a Mix each pixel with pixels along a line from a chosen center. Radius defines a
central area that is not blurred. Length sets the blur line range: 0-length f rom central area that is not blurred. Length sets the blur line range: 0-length f rom
center to edge. Choose the center by clicking on the image. center to edge. Choose the center by clicking on the image.
\bDirected \bDirected Blur
Pull a position on the image using the mouse. The area around the mouse will be Pull a position on the image using the mouse. The area around the mouse will be
blurred in this direction. Span determines the size of the area blurred. blurred in this direction. Span determines the size of the area blurred.
Intensity determines the strength of the blur. Intensity determines the strength of the blur.
\bGraduated \bGraduated Blur
Only pixels with less contrast than the given contrast limit are blurred, and the Only pixels with less contrast than the given contrast limit are blurred, and the
blur radius ranges from 1 to the given value for pixels with a corresponding blur radius ranges from 1 to the given value for pixels with a corresponding
contrast ranging from the given limit to zero. In short: low-contrast pixels are contrast ranging from the given limit to zero. In short: low-contrast pixels are
blurred more than high-contrast pixels. This can be used to smooth skin tones blurred more than high-contrast pixels. This can be used to smooth skin tones
without blurring hair or reducing the sparkle in the eyes. Taken to extremes, it without blurring hair or reducing the sparkle in the eyes. Taken to extremes, it
produces a "cartoon" effect. produces a "cartoon" effect.
\bPaint \bPaint Blur
Blend image pixels together by painting with the mouse. Radius sets a circle Blend image pixels together by painting with the mouse. Radius sets a circle
around the mouse pointer which shows the image area being blended. Use left d rag around the mouse pointer which shows the image area being blended. Use left d rag
to blend, right drag to restore. Power determines how fast the image is blend ed to blend, right drag to restore. Power determines how fast the image is blend ed
or restored, at the center and edges of the circle. or restored, at the center and edges of the circle.
\bBackground \bBackground Blur
+image: blur-background.jpg
Blur background image areas while leaving the foreground sharp. Select one or more Blur background image areas while leaving the foreground sharp. Select one or more
areas that are to remain sharp (menu Areas > Select). After selecting the for eground areas that are to remain sharp (menu Areas > Select). After selecting the for eground
areas, invert the selection so that the background is now selected (Areas > I nvert). areas, invert the selection so that the background is now selected (Areas > I nvert).
This is the area that will be blurred. There are two blur methods available: This is the area that will be blurred. There are two blur methods available:
Constant blur: a constant blur radius is used for all areas blurred. Constant blur: a constant blur radius is used for all areas blurred.
Increase blur with distance: use the minimum blur radius for pixels adjacent to the Increase blur with distance: use the minimum blur radius for pixels adjacent to the
foreground and the maximum blur radius for pixels at the maximum distance fro m the foreground and the maximum blur radius for pixels at the maximum distance fro m the
foreground. This requires that the edge distance for all background pixels be foreground. This requires that the edge distance for all background pixels be
calculated, which can take significant time for a large image. Blur radius ca n be calculated, which can take significant time for a large image. Blur radius ca n be
varied without recalculating the edge distances. Tilt-Shift Effect: You can d o this varied without recalculating the edge distances. Tilt-Shift Effect: You can d o this
by selecting a horizontal rectangular area to remain sharp, and increasing th e blur by selecting a horizontal rectangular area to remain sharp, and increasing th e blur
with increasing distance from this area. with increasing distance from this area.
\bAdd Motion Blur \bAdd Motion Blur
+image: add-motionblur.jpg +image: add-motionblur1.jpg +image: add-motionbl ur2.jpg +image: add-motionblur1.jpg +image: add-motionblur2.jpg
This tool adds motion blur to an image. Motion blur is blur in a single direc tion. This tool adds motion blur to an image. Motion blur is blur in a single direc tion.
Image feature edges perpendicular to this direction have maximum blur. Those parallel Image feature edges perpendicular to this direction have maximum blur. Those parallel
to the blur direction remain sharp. Use \>SELECT AREA\> to isolate image area s to blur to the blur direction remain sharp. Use \>SELECT AREA\> to isolate image area s to blur
separately from the unchanged background. separately from the unchanged background.
DENOISE DENOISE
+image: denoise.jpg +image: denoise.jpg
This function reduces the noise in photos taken in low light conditions (high ISO), This function reduces the noise in photos taken in low light conditions (high ISO),
making uniform surfaces appear speckled. Multiple methods are provided becaus e the making uniform surfaces appear speckled. Multiple methods are provided becaus e the
best method varies with noise characteristics. Mixing methods (using one and then best method varies with noise characteristics. Mixing methods (using one and then
skipping to change at line 3543 skipping to change at line 3554
color, you can change to sRGB for better colors on a monitor, or for uploadin g to a color, you can change to sRGB for better colors on a monitor, or for uploadin g to a
web site. Any EXIF embedded color profile is removed, and the EXIF key "ICCPr ofileName" web site. Any EXIF embedded color profile is removed, and the EXIF key "ICCPr ofileName"
is set to the new profile. Because the relevant metadata is changed, a new fi le version is set to the new profile. Because the relevant metadata is changed, a new fi le version
is created automatically, and the input file is left unchanged with the old c olor is created automatically, and the input file is left unchanged with the old c olor
profile. To view the color changes, use the KB arrow keys to switch back and forth profile. To view the color changes, use the KB arrow keys to switch back and forth
instantly between the old and new images. The changes are usually very small. instantly between the old and new images. The changes are usually very small.
You may need to install ICC color profiles. In Ubuntu, the package names are You may need to install ICC color profiles. In Ubuntu, the package names are
icc-profiles and icc-profiles-free. icc-profiles and icc-profiles-free.
VIGNETTE
+image: vignette.jpg +image: vignette2.jpg
This function is used to correct the darkening sometimes seen in the corners
of a
photo. It can also be used to highlight or colorize an object or area within
an image.
Click or drag the mouse on the image to change the vignette center, which is
initially
at the center of the image.
Select Brightness to change the brightness of the image in a radial pattern:
Adjust the
left or right end of the curve to change the brightness of the center and edg
es of the
image respectively. You can give a dark surround to a portrait face, or you c
an fix an
image with darkened corners. The curve middle level corresponds to no change.
Use lower
values to darken and higher values to brighten. The example above gradually d
arkens the
periphery of the image while leaving a broad central area unchanged.
Select Color to add a chosen color to the image in a radial pattern. Curve va
lues of
zero represent no change, and higher values add the chosen color to the image
. The
highest value corresponds to 100% color. Use this function to add a color sur
round to
an image, e.g. surround a face with a gradually increasing color.
\bIrregular Vignette
+image: vignette3.jpg
You can make a vignette with arbitrary shape as follows:
• Select Area - select the image area to remain visible
• Invert the area to select the areas outside the image
• Set a blend width value for the edge fade-out width
• Keep the Select Area dialog active
• Paint Image - paint the outside areas with the desired color
(the image edges will fade-out over blend width pixels)
• Adjust the blend width value and paint again until satisfied
REMOVE DUST REMOVE DUST
+image: remove-dust.jpg +image: remove-dust2.jpg +image: remove-dust.jpg +image: remove-dust2.jpg
Images made from dusty scanned slides can have many small dark spots - shadow s of the Images made from dusty scanned slides can have many small dark spots - shadow s of the
dust on the slides. Historical photos from the internet often have a similar problem. dust on the slides. Historical photos from the internet often have a similar problem.
This function can be used to remove the majority of such spots. Move the thre e sliders This function can be used to remove the majority of such spots. Move the thre e sliders
until the maximum number of dust spots are painted red, then press the [erase ] button until the maximum number of dust spots are painted red, then press the [erase ] button
to erase them. Press [red] to bring back the red view, then you can adjust th e sliders to erase them. Press [red] to bring back the red view, then you can adjust th e sliders
again and press [erase]. The "spot size limit" slider limits the size of the spots that again and press [erase]. The "spot size limit" slider limits the size of the spots that
will be erased. The "max. brightness" slider sets a threshold for ignoring sp ots that will be erased. The "max. brightness" slider sets a threshold for ignoring sp ots that
are not dark enough. The "min. contrast" slider screens out spots having low contrast are not dark enough. The "min. contrast" slider screens out spots having low contrast
skipping to change at line 3721 skipping to change at line 3701
LOCAL CONTRAST LOCAL CONTRAST
+image: localcon.jpg +image: localcon2.jpg +image: localcon.jpg +image: localcon2.jpg
Local Contrast increases the contrast in every area of an image, using the av erage Local Contrast increases the contrast in every area of an image, using the av erage
brightness of an area to determine how much individual pixel brightness value s are to brightness of an area to determine how much individual pixel brightness value s are to
be increased or decreased. This function implements a widely used textbook me thod. be increased or decreased. This function implements a widely used textbook me thod.
Radius controls the size of the area around each pixel that is used for the a verage Radius controls the size of the area around each pixel that is used for the a verage
brightness value. Power determines the strength of contrast change. Brighten is used brightness value. Power determines the strength of contrast change. Brighten is used
to brighten the darker areas of an image, which may become too dark after the contrast to brighten the darker areas of an image, which may become too dark after the contrast
changes are made. Color is used to increase the color saturation. changes are made. Color is used to increase the color saturation.
Local Contrast can crete "halos" under some circumstances: Local Contrast can create "halos" under some circumstances:
+image: localcon3.jpg +image: localcon3.jpg
The original image is on the left. The middle image had Local Contrast applie d at max. The original image is on the left. The middle image had Local Contrast applie d at max.
power. A halo can be seen along the border between the dark hills and lighter sky. This power. A halo can be seen along the border between the dark hills and lighter sky. This
can be fixed with a simple trick (right image). Select the sky areas separate ly, using can be fixed with a simple trick (right image). Select the sky areas separate ly, using
\>SELECT AREA\>. Apply Local Contrast to this area. Invert the selection and apply Local \>SELECT AREA\>. Apply Local Contrast to this area. Invert the selection and apply Local
Contrast to the rest of the image. \>GRADIENTS\> was applied afterward to the entire Contrast to the rest of the image. \>GRADIENTS\> was applied afterward to the entire
image to increase details in the darkened image. image to increase details in the darkened image.
GRADIENTS GRADIENTS
+image: gradients.jpg +image: gradients2.jpg +image: gradients.jpg +image: gradients2.jpg
skipping to change at line 3854 skipping to change at line 3834
BRITE RAMP BRITE RAMP
+image: brite-ramp1.png +image: brite-ramp2.png +image: brite-ramp1.png +image: brite-ramp2.png
This function varies brightness or color across the image. You can use this t o This function varies brightness or color across the image. You can use this t o
compensate for uneven lighting or a color cast that varies across the image. The compensate for uneven lighting or a color cast that varies across the image. The
direction of change is determined by drawing a line on the image. Create the line by direction of change is determined by drawing a line on the image. Create the line by
clicking on the image, then drag either end to set the direction wanted. In t he example clicking on the image, then drag either end to set the direction wanted. In t he example
above, green is increased in the direction of the line. Edit the All curve fi rst to above, green is increased in the direction of the line. Edit the All curve fi rst to
adjust overall brightness (all colors), then adjust the individual RGB color curves if adjust overall brightness (all colors), then adjust the individual RGB color curves if
needed. The image reacts quickly to both line changes and curve edits. needed. The image reacts quickly to both line changes and curve edits.
VIGNETTE
+image: vignette.jpg +image: vignette2.jpg
This function is used to correct the darkening sometimes seen in the corners
of a
photo. It can also be used to highlight or colorize an object or area within
an image.
Click or drag the mouse on the image to change the vignette center, which is
initially
at the center of the image.
Select Brightness to change the brightness of the image in a radial pattern:
Adjust the
left or right end of the curve to change the brightness of the center and edg
es of the
image respectively. You can give a dark surround to a portrait face, or you c
an fix an
image with darkened corners. The curve middle level corresponds to no change.
Use lower
values to darken and higher values to brighten. The example above gradually d
arkens the
periphery of the image while leaving a broad central area unchanged.
Select Color to add a chosen color to the image in a radial pattern. Curve va
lues of
zero represent no change, and higher values add the chosen color to the image
. The
highest value corresponds to 100% color. Use this function to add a color sur
round to
an image, e.g. surround a face with a gradually increasing color.
\bIrregular Vignette
+image: vignette3.jpg
You can make a vignette with arbitrary shape as follows:
• Select Area - select the image area to remain visible
• Invert the area to select the areas outside the image
• Set a blend width value for the edge fade-out width
• Keep the Select Area dialog active
• Paint Image - paint the outside areas with the desired color
(the image edges will fade-out over blend width pixels)
• Adjust the blend width value and paint again until satisfied
EFFECTS MENU EFFECTS MENU
+image: ug-effects.png +image: ug-effects.png
SKETCH SKETCH
+image: sketch.jpg +image: sketch.jpg
This function transforms a photo into something like a sketch. Dark pixels ar e This function transforms a photo into something like a sketch. Dark pixels ar e
aggregated into fewer pixels, leaving vacated areas brighter. Contrast can al so be aggregated into fewer pixels, leaving vacated areas brighter. Contrast can al so be
used as a proxy for dark pixels. Threshold can be used to filter the input im age by used as a proxy for dark pixels. Threshold can be used to filter the input im age by
brightness. Clip Level is used to filter the output to further reduce isolate d or brightness. Clip Level is used to filter the output to further reduce isolate d or
skipping to change at line 4034 skipping to change at line 4045
Regenerating the mosaic is quite fast, so do this if you want the popups to w ork. Regenerating the mosaic is quite fast, so do this if you want the popups to w ork.
ADD NOISE ADD NOISE
+image: add-noise.jpg +image: add-noise.jpg
Add random color noise to an image. Set a target spot size 1-10 and noise lev el 0-100%. Add random color noise to an image. Set a target spot size 1-10 and noise lev el 0-100%.
At 100%, random noise in the range -127 to +127 is added to each RGB value of each At 100%, random noise in the range -127 to +127 is added to each RGB value of each
pixel. The mean value is zero. Overflows outside the range 0-255 are truncate d. Average pixel. The mean value is zero. Overflows outside the range 0-255 are truncate d. Average
color over a large area is preserved, with the noise superimposed. You can us e Add color over a large area is preserved, with the noise superimposed. You can us e Add
Noise with Select Area or Paint Edits to add noise to selected areas. Noise with Select Area or Paint Edits to add noise to selected areas.
\bSupression of 'banding' \bSuppression of 'banding'
In image areas where the brightness distribution has been 'stretched', visibl e 'banding' In image areas where the brightness distribution has been 'stretched', visibl e 'banding'
can occurr in areas of uniform color. I have noticed this in sky and especial ly in very can occur in areas of uniform color. I have noticed this in sky and especiall y in very
dark image areas. You can reduce this problem by adding noise to affected are as and dark image areas. You can reduce this problem by adding noise to affected are as and
also adding blur afterwards. If the edges of visible bands are made irregular , they also adding blur afterwards. If the edges of visible bands are made irregular , they
become less visible to the human eye. become less visible to the human eye.
COLOR DEPTH COLOR DEPTH
+image: color-depth2.jpg +image: color-depth1.jpg +image: color-depth2.jpg +image: color-depth1.jpg
This function changes the normal 16 bits per RGB color to any value between 1 and 16 This function changes the normal 16 bits per RGB color to any value between 1 and 16
bits per color. At 8 bits per color, there are 16.8 million colors (256 x 256 x 256). bits per color. At 8 bits per color, there are 16.8 million colors (256 x 256 x 256).
SHIFT COLORS SHIFT COLORS
skipping to change at line 4769 skipping to change at line 4780
+image: ug-batch.png +image: ug-batch.png
These are functions that process multiple selected image files, a few or thou sands. These are functions that process multiple selected image files, a few or thou sands.
These functions can be canceled in mid-process using the Escape key, but this will These functions can be canceled in mid-process using the Escape key, but this will
leave some files processed and some not. There is a popup report showing file names leave some files processed and some not. There is a popup report showing file names
as they are processed. as they are processed.
BATCH CONVERT BATCH CONVERT
+image: batch-convert.jpg +image: batch-convert.jpg
This function is used to rename, convert, resize, upright and move multiple This function is used to rename, convert, resize, upright and move multiple i
image files at once. An overlay image can also be added at a selected positio mage
n files at once.
(e.g. credit line or copyright notice).
Dialog Inputs Dialog Inputs
• Select Files - Select files to convert from gallery windows (\>SELECT IM AGE FILES\>). • Select Files - Select files to convert from gallery windows (\>SELECT IM AGE FILES\>).
• New Name - Optional new name with optional inserted text (see below). Replace Text - replace text string in file names (see Replace Text below
).
New Name - Optional new name with optional inserted text (see Plugins be
low).
• Sequence Numbers - Starting sequence number and adder for each output fi le. • Sequence Numbers - Starting sequence number and adder for each output fi le.
• New Location - Optional new folder location for the converted files. • New Location - Optional new folder location for the converted files.
• new file type - File type for converted images, or "no change". • new file type - File type for converted images, or "no change".
• color depth - specify 8 or 16 bits for tif or png output. • color depth - specify 8 or 16 bits for tif or png output.
• max. width, height - Output images will fit within these limits. • max. width, height - Output images will fit within these limits.
• delete originals - Delete input files after successful conversion. • delete originals - Delete input files after successful conversion.
• copy metadata - Copy all EXIF and IPTC metadata to the output files. • copy metadata - Copy all EXIF and IPTC metadata to the output files.
• upright - If an image is rotated 90 degrees, upright it (based on EXIF d ata). • upright - If an image is rotated 90 degrees, upright it (based on EXIF d ata).
• sharpen - Sharpen output images using the two supplied parameters. • sharpen - Sharpen output images using the two supplied parameters.
\bPlugins \bReplace Text
If text is entered here, file names are scanned for this text, and if found,
the given
replacement text is substututed. The replacement text can have a different le
ngth and
can also be empty, in which the text is removed from the file name.
\bNew Name and Plugins
The new file name may have inserted text: a photo date (from EXIF metadata), a sequence The new file name may have inserted text: a photo date (from EXIF metadata), a sequence
number, or the original file name. Specify what and where to insert as follow s: number, or the original file name. Specify what and where to insert as follow s:
• $oldname - The original file name is inserted here • $oldname - The original file name is inserted here
• $sss - A running sequence number is inserted here. See below. • $sss - A running sequence number is inserted here. See below.
• $yyyy $mm $dd - The photo date (year, month, day) is inserted at these p ositions. • $yyyy $mm $dd - The photo date (year, month, day) is inserted at these p ositions.
Example: San Francisco $yyyy-$mm-$dd $oldname $sss Example: San Francisco $yyyy-$mm-$dd $oldname $sss
The input file "Golden Gate Bridge.jpg", with a photo date of May 12, 2014, w ould The input file "Golden Gate Bridge.jpg", with a photo date of May 12, 2014, w ould
convert to the output file name "San Francisco 2014-05-12 Golden Gate Bridge 123.jpg". convert to the output file name "San Francisco 2014-05-12 Golden Gate Bridge 123.jpg".
skipping to change at line 4866 skipping to change at line 4882
downsize options if wanted, and set the auto sharpen parameters if wanted. Se e the downsize options if wanted, and set the auto sharpen parameters if wanted. Se e the
\>SHARPEN\> function for an explanation of these parameters. \>SHARPEN\> function for an explanation of these parameters.
The image files are converted one at a time and displayed in the main window. Depending The image files are converted one at a time and displayed in the main window. Depending
on the number of files, this can take a long time (a strong PC does about 30 files per on the number of files, this can take a long time (a strong PC does about 30 files per
minute using Dcraw and TIFF-16 output). PNG-16 produces smaller files than TI FF-16 but minute using Dcraw and TIFF-16 output). PNG-16 produces smaller files than TI FF-16 but
the time to compress is greater. the time to compress is greater.
BATCH OVERLAY BATCH OVERLAY
+image: batch-overlay.jpg +image: batch-overlay.jpg
A small overlay image can be added at a selected position on the selected hos A small overlay image can be added at a selected position on the selected inp
t images. ut images.
This can be used to add a credit line, copyright, etc. to the host images. This can be used to add a credit line, copyright, etc. on top of the images.
Prepare the overlay image as follows: Use New Blank Image to create a base im age to Prepare the overlay image as follows: Use New Blank Image to create a base im age to
hold the text. The scale does not matter, so make it larger than needed, say 1000 hold the text. The scale does not matter, so make it larger than needed, say 1000
pixels wide. Use Paint Transparency to paint the entire base image transparen t. Use pixels wide. Use Paint Transparency to paint the entire base image transparen t. Use
\>MARKUP\> > draw text to put the desired text on the base image, using font, color, \>MARKUP\> > draw text to put the desired text on the base image, using font, color,
and other attributes as desired. Scale the text to fill most of the base imag e. The and other attributes as desired. Scale the text to fill most of the base imag e. The
base image (background) is transparent. Remove excess margins with \>CROP\> i f needed. base image (background) is transparent. Remove excess margins with \>CROP\> i f needed.
Save the final image. A convenient location is <fotoxx home>/saved_areas, but any Save the final image. A convenient location is <fotoxx home>/saved_areas, but any
folder can be used. This image can now be used as an overlay image for Batch Overlay. folder can be used. This image can now be used as an overlay image for Batch Overlay.
skipping to change at line 5069 skipping to change at line 5085
+image: export-files.jpg +image: export-files.jpg
This function copies selected image files to another folder. This could be us ed for This function copies selected image files to another folder. This could be us ed for
copying files to a thumb drive, uploading files to a photo web service, etc. Select copying files to a thumb drive, uploading files to a photo web service, etc. Select
image files by clicking gallery thumbnails (\>SELECT IMAGE FILES\>). Select a folder image files by clicking gallery thumbnails (\>SELECT IMAGE FILES\>). Select a folder
where the image files will be copied. If 'export metadata' is selected, a lim ited set where the image files will be copied. If 'export metadata' is selected, a lim ited set
of metadata is also copied (relevant for a photo web services like Flickr). T hese are: of metadata is also copied (relevant for a photo web services like Flickr). T hese are:
photo date, keywords (tags), copyright, title, description, and geotag data ( location). photo date, keywords (tags), copyright, title, description, and geotag data ( location).
Privacy notice: others would be able to find your location by date if this me tadata Privacy notice: others would be able to find your location by date if this me tadata
is included in uploaded files. is included in uploaded files.
CONVERT ADOBE
+image: convert-adobe.jpg
This function can be used to convert an Adobe document file (.pdf .ps .eps) i
nto a set
of jpeg image files, one per document page. The resulting file names have the
input
file name with the page number appended: inputfile-N.jpg, where N = 1, 2, 3 .
..
Page width sets the pixel width of the output files. This is approximate and
most
accurate if the input file page width parameter is 8.5 inches (USA letter siz
e).
If input width is X and it comes out Y, do again with a page width of X*X/Y.
SCRIPT FILES SCRIPT FILES
Menu Functions: Menu Functions:
• Edit Script - Perform a set of edits on one image file, recording all funct ions and • Edit Script - Perform a set of edits on one image file, recording all funct ions and
settings in a named script file. settings in a named script file.
• Run Script - Run a script file using the current image file, like an edit f unction. • Run Script - Run a script file using the current image file, like an edit f unction.
• Batch Script - Select any number of image files and run a script file on al l of • Batch Script - Select any number of image files and run a script file on al l of
them, in batch mode. them, in batch mode.
Script files allow you to define a set of edits once, and repeat them on sing le or Script files allow you to define a set of edits once, and repeat them on sing le or
multiple image files at a later time. This can be useful when many photos of the same multiple image files at a later time. This can be useful when many photos of the same
skipping to change at line 6113 skipping to change at line 6120
\bFile Types Supported \bFile Types Supported
Fotoxx uses Linux library functions to support reading and writing of image f iles: Fotoxx uses Linux library functions to support reading and writing of image f iles:
the GDK pixbuf library, libjpeg, libpng, libtiff. The file types that can be read and the GDK pixbuf library, libjpeg, libpng, libtiff. The file types that can be read and
written include JPG/JPEG, PNG, and TIF/TIFF. Three RGB colors with 8 bits per color written include JPG/JPEG, PNG, and TIF/TIFF. Three RGB colors with 8 bits per color
are supported for all types. PNG and TIFF also support 16 bits per color and an alpha are supported for all types. PNG and TIFF also support 16 bits per color and an alpha
channel (opacity level). Fewer than 8 bits per color and grayscale images are partly channel (opacity level). Fewer than 8 bits per color and grayscale images are partly
supported, and are converted to RGB internally. Some other file types are par tly supported, and are converted to RGB internally. Some other file types are par tly
supported: they are indexed and thumbnailed and can be viewed and edited norm ally, but supported: they are indexed and thumbnailed and can be viewed and edited norm ally, but
modified files are saved as .jpg files with a version number. These file type s are: modified files are saved as .jpg files with a version number. These file type s are:
.heic .webp .jp2 .pdf .ps .eps. Adobe files (.pdf/.ps/.eps) can be converted .heic .webp .jp2. Adobe files (.pdf/.ps/.eps/.psd) can be converted into jpeg
into jpeg image
image files using the function \>CONVERT ADOBE\>. files using the function \>CONVERT ADOBE\>.
\b.MPO Files \b.MPO Files
These are containers for the left and right images of a 3D image pair. In Fot oxx, .MPO These are containers for the left and right images of a 3D image pair. In Fot oxx, .MPO
files are treated mostly as RAW files. For .MPO files to be recognized, the . MPO type files are treated mostly as RAW files. For .MPO files to be recognized, the . MPO type
must be entered in the list of RAW file types in the Tools > Settings functio n. The must be entered in the list of RAW file types in the Tools > Settings functio n. The
left image is used for the thumbnail and file view. A function is available t o extract left image is used for the thumbnail and file view. A function is available t o extract
the left and right images as JPEG files: right-click the thumbnail for a menu . the left and right images as JPEG files: right-click the thumbnail for a menu .
\bIndex Data Files \bIndex Data Files
These can be found in the folder [fotoxx-home]/image_index_*/ These can be found in the folder [fotoxx-home]/image_index_*/
skipping to change at line 6494 skipping to change at line 6501
\>CARTOON\> - convert an image to a cartoon-like drawing \>CARTOON\> - convert an image to a cartoon-like drawing
\>CHOOSE MAP\> - choose from available maps (USA, France, NYC, etc.) \>CHOOSE MAP\> - choose from available maps (USA, France, NYC, etc.)
\>CHROMATIC 1\> - fix chromatic aberration (color fringes, mainly image perip hery) \>CHROMATIC 1\> - fix chromatic aberration (color fringes, mainly image perip hery)
\>CHROMATIC 2\> - fix chromatic aberration (color bands along bright/dark edg es) \>CHROMATIC 2\> - fix chromatic aberration (color bands along bright/dark edg es)
\>CLEAR AREA\> - remove an area \>CLEAR AREA\> - remove an area
\>COLLECTION MANAGEMENT\> - collection management and image searching \>COLLECTION MANAGEMENT\> - collection management and image searching
\>COLOR DEPTH\> - reduce the number of colors (posterize) \>COLOR DEPTH\> - reduce the number of colors (posterize)
\>COLOR MODE\> - convert to black & white, color, negative, positive, sepia \>COLOR MODE\> - convert to black & white, color, negative, positive, sepia
\>COLOR PROFILE\> - convert color profile (e.g. sRGB <--> Adobe RGB) \>COLOR PROFILE\> - convert color profile (e.g. sRGB <--> Adobe RGB)
\>COMMAND PARAMETERS\> - Fotoxx startup options using command line parameters \>COMMAND PARAMETERS\> - Fotoxx startup options using command line parameters
\>CONVERT ADOBE\> - convert Adobe files (.pdf/.ps/.eps/.psd) to jpeg images
\>COPY COLORS\> - copy selected colors from current image \>COPY COLORS\> - copy selected colors from current image
\>COPY/COMPLEX\> - select and copy area with complex edges (e.g. hair) \>COPY/COMPLEX\> - select and copy area with complex edges (e.g. hair)
\>COPY FROM IMAGE\> - copy pixels from another image using the mouse \>COPY FROM IMAGE\> - copy pixels from another image using the mouse
\>COPY IN IMAGE\> - copy pixels within an image using the mouse \>COPY IN IMAGE\> - copy pixels within an image using the mouse
\>COPY META\> - copy metadata from one image file to another \>COPY META\> - copy metadata from one image file to another
\>COPY/MOVE\> - copy or move an image file to another folder \>COPY/MOVE\> - copy or move an image file to another folder
\>COPY/PASTE AREA\> - copy an area and insert somewhere else later \>COPY/PASTE AREA\> - copy an area and insert somewhere else later
\>COPY PRIOR EDIT\> - copy pixels from prior edits using the mouse \>COPY PRIOR EDIT\> - copy pixels from prior edits using the mouse
\>COPY TO CLIPBOARD\> - copy an image file to the clipboard \>COPY TO CLIPBOARD\> - copy an image file to the clipboard
\>COPY TO DESKTOP\> - copy an image file to the desktop \>COPY TO DESKTOP\> - copy an image file to the desktop
skipping to change at line 6530 skipping to change at line 6538
\>EDGE BLEND\> - mouse-blend edges of edits made within a selected area \>EDGE BLEND\> - mouse-blend edges of edits made within a selected area
\>EDIT ANY META\> - edit any metadata (add, change) \>EDIT ANY META\> - edit any metadata (add, change)
\>EDIT DIST\> - edit brightness distribution, rebalance dark and bright areas \>EDIT DIST\> - edit brightness distribution, rebalance dark and bright areas
\>EDIT META\> - edit commonly used metadata \>EDIT META\> - edit commonly used metadata
\>EDIT PROCEDURES\> - how to edit image files \>EDIT PROCEDURES\> - how to edit image files
\>EDIT SCRIPT\> - record a series of edits in a script file, execute on many files \>EDIT SCRIPT\> - record a series of edits in a script file, execute on many files
\>EDIT WORKFLOW\> - alternative edit methods - simple and complex \>EDIT WORKFLOW\> - alternative edit methods - simple and complex
\>EMBOSS\> - convert an image to a simulated embossing (3D effect) \>EMBOSS\> - convert an image to a simulated embossing (3D effect)
\>ENABLE/DISABLE AREA\> - enable or disable an area for editing \>ENABLE/DISABLE AREA\> - enable or disable an area for editing
\>ESCHER SPIRAL\> - transform an image into an endless inward spiral \>ESCHER SPIRAL\> - transform an image into an endless inward spiral
\>EXPORT FILE LIST\> - create a list of selected files (e.g. for use in a she ll script) \>EXPORT FILE LIST\> - create a list of selected files (e.g. for a shell scri pt)
\>EXPORT FILES\> - export selected files to a folder (e.g. for web upload) \>EXPORT FILES\> - export selected files to a folder (e.g. for web upload)
\>CONVERT ADOBE\> - convert Adobe files (.pdf .ps .eps) to jpeg images, one p er page
\>EXTRACT MPO FILES\> - (MPO files only) extract left/right files from 3D pai r \>EXTRACT MPO FILES\> - (MPO files only) extract left/right files from 3D pai r
\>FILE MAP\> - use local map files \>FILE MAP\> - use local map files
\>FILE SAVE\> - save an image file (replace, new version, new file name) \>FILE SAVE\> - save an image file (replace, new version, new file name)
\>FILE VIEW\> - File View window (view single image file) \>FILE VIEW\> - File View window (view single image file)
\>FIND AREA GAP\> - find gap in hand-drawn area outline \>FIND AREA GAP\> - find gap in hand-drawn area outline
\>FIND DUPLICATES\> - find duplicate images in a gallery or the entire image collection \>FIND DUPLICATES\> - find duplicate images in a gallery or entire image coll ection
\>FIRST STARTUP\> - information for when Fotoxx is started for the first time \>FIRST STARTUP\> - information for when Fotoxx is started for the first time
\>FLATTEN DIST\> - flatten brightness distribution to improve details \>FLATTEN DIST\> - flatten brightness distribution to improve details
\>FLATTEN PHOTO\> - flatten a photo of a curved surface \>FLATTEN PHOTO\> - flatten a photo of a curved surface
\>DEFOG\> - add or remove fog/haze from an image or selected area \>DEFOG\> - add or remove fog/haze from an image or selected area
\>FOTOXX CAPABILITIES\> - summary of Fotoxx functions and tools \>FOTOXX CAPABILITIES\> - summary of Fotoxx functions and tools
\>FOTOXX OVERVIEW\> - description, prerequisites, license, downloads \>FOTOXX OVERVIEW\> - description, prerequisites, license, downloads
\>GALLERY END\> - jump to gallery end \>GALLERY END\> - jump to gallery end
\>GALLERY HOME\> - jump to gallery start \>GALLERY HOME\> - jump to gallery start
\>GALLERY SCREEN\> - select newest, oldest, matching pattern ... \>GALLERY SCREEN\> - select newest, oldest, matching pattern ...
\>GALLERY SORT\> - change the sort order of a gallery \>GALLERY SORT\> - change the sort order of a gallery
skipping to change at line 6700 skipping to change at line 6707
================================================================================ ========== ================================================================================ ==========
following are tests for audit_docfile() function following are tests for audit_docfile() function
run test as follows: $ fotoxx -m "audit user guide" run test as follows: $ fotoxx -m "audit user guide"
\>DELIBERATE BAD TOPIC 1\> xxxxxx \>DELIBERATE BAD TOPIC 2\> \>DELIBERATE BAD TOPIC 1\> xxxxxx \>DELIBERATE BAD TOPIC 2\>
+image: deliberate-badfile1.png +image: deliberate-badfile2.jpg +image: deliberate-badfile1.png +image: deliberate-badfile2.jpg
list_F1_topics $: ./list_F1_topics list_F1_topics $: ./list_F1_topics
source folder: /home2/mico/programs/fotoxx-22.35/*.cc source folder: /home2/mico/programs/fotoxx-22.50/*.cc
file: /home2/mico/programs/fotoxx-22.35/f.effects.cc file: /home2/mico/programs/fotoxx-22.50/f.refine.cc
topic: \>SKETCH\> topic: \>VOODOO 1\>
topic: \>CARTOON\> topic: \>VOODOO 2\>
topic: \>DRAWING\> topic: \>EDIT DIST\>
topic: \>EMBOSS\> topic: \>FLATTEN DIST\>
topic: \>TILES\> topic: \>LOCAL CONTRAST\>
topic: \>PAINTING\> topic: \>GRADIENTS\>
topic: \>TEXTURE\> topic: \>GLOBAL RETINEX\>
topic: \>PATTERN\> topic: \>LOCAL RETINEX\>
topic: \>DITHER\> topic: \>SATURATION\>
topic: \>DITHER\> topic: \>SOFT FOCUS\>
topic: \>DITHER\> topic: \>MATCH COLORS\>
topic: \>DITHER\> topic: \>BRITE RAMP\>
topic: \>DITHER\> topic: \>VIGNETTE\>
topic: \>MOSAIC\> file: /home2/mico/programs/fotoxx-22.50/f.edit.cc
topic: \>ADD NOISE\> topic: \>PAINT EDITS\>
topic: \>COLOR DEPTH\> topic: \>ROTATE\>
topic: \>SHIFT COLORS\> topic: \>CROP\>
topic: \>ALIEN COLORS\> topic: \>RETOUCH\>
topic: \>COPY COLORS\> topic: \>RESIZE\>
topic: \>PASTE COLORS\> topic: \>UPRIGHT\>
topic: \>CUSTOM KERNEL\> topic: \>MIRROR\>
file: /home2/mico/programs/fotoxx-22.35/f.widgets.cc topic: \>MARKUP\>
topic: \>COLOR MODE\>
topic: \>PAINT IMAGE\>
topic: \>PAINT TRANSP\>
topic: \>COPY IN IMAGE\>
topic: \>COPY FROM IMAGE\>
topic: \>COPY FROM IMAGE\>
topic: \>COPY PRIOR EDIT\>
topic: \>PLUGINS\>
topic: \>PLUGINS\>
topic: \>PLUGINS\>
topic: \>RAW THERAPEE\>
topic: \>DARKTABLE\>
topic: \>EXTRACT MPO FILES\>
file: /home2/mico/programs/fotoxx-22.50/f.widgets.cc
topic: \>CUSTOM MENU\> topic: \>CUSTOM MENU\>
topic: \>CUSTOM MENU\> topic: \>CUSTOM MENU\>
file: /home2/mico/programs/fotoxx-22.35/fotoxx.cc file: /home2/mico/programs/fotoxx-22.50/f.batch.cc
topic: \>FIRST STARTUP\>
topic: \>UNDO/REDO BUTTON\>
file: /home2/mico/programs/fotoxx-22.35/f.batch.cc
topic: \>BATCH CONVERT\> topic: \>BATCH CONVERT\>
topic: \>BATCH COPY/MOVE\> topic: \>BATCH COPY/MOVE\>
topic: \>BATCH UPRIGHT\> topic: \>BATCH UPRIGHT\>
topic: \>BATCH DELETE/TRASH\> topic: \>BATCH DELETE/TRASH\>
topic: \>BATCH RAW\> topic: \>BATCH RAW\>
topic: \>BATCH OVERLAY\> topic: \>BATCH OVERLAY\>
topic: \>BURN DVD/BRD\> topic: \>BURN DVD/BRD\>
topic: \>EXPORT FILE LIST\> topic: \>EXPORT FILE LIST\>
topic: \>EXPORT FILES\> topic: \>EXPORT FILES\>
topic: \>CONVERT ADOBE\>
topic: \>SCRIPT FILES\> topic: \>SCRIPT FILES\>
topic: \>SCRIPT FILES\> topic: \>SCRIPT FILES\>
topic: \>SCRIPT FILES\> topic: \>SCRIPT FILES\>
topic: \>SCRIPT FILES\> topic: \>SCRIPT FILES\>
file: /home2/mico/programs/fotoxx-22.35/f.file.cc file: /home2/mico/programs/fotoxx-22.50/f.file.cc
topic: \>NEW SESSION\> topic: \>NEW SESSION\>
topic: \>OPEN IMAGE FILE\> topic: \>OPEN IMAGE FILE\>
topic: \>CYCLE 2\> topic: \>CYCLE 2\>
topic: \>CYCLE 3\> topic: \>CYCLE 3\>
topic: \>VIEW 360° PANO\> topic: \>VIEW 360° PANO\>
topic: \>RENAME\> topic: \>RENAME\>
topic: \>PERMISSIONS\> topic: \>PERMISSIONS\>
topic: \>REMOVE ALPHA\> topic: \>REMOVE ALPHA\>
topic: \>ZOOM\> topic: \>ZOOM\>
topic: \>BLANK IMAGE\> topic: \>BLANK IMAGE\>
topic: \>BLANK WINDOW\> topic: \>BLANK WINDOW\>
topic: \>COPY/MOVE\> topic: \>COPY/MOVE\>
topic: \>COPY TO DESKTOP\> topic: \>COPY TO DESKTOP\>
topic: \>COPY TO CLIPBOARD\> topic: \>COPY TO CLIPBOARD\>
topic: \>DELETE/TRASH\> topic: \>DELETE/TRASH\>
topic: \>CONVERT ADOBE\>
topic: \>SET WALLPAPER\> topic: \>SET WALLPAPER\>
topic: \>PRINT\> topic: \>PRINT\>
topic: \>HELP MENU\> topic: \>HELP MENU\>
topic: \>FILE SAVE\> topic: \>FILE SAVE\>
file: /home2/mico/programs/fotoxx-22.35/f.mashup.cc file: /home2/mico/programs/fotoxx-22.50/fotoxx.cc
topic: \>MASHUP\> topic: \>FIRST STARTUP\>
topic: \>IMAGE TABLE\> topic: \>UNDO/REDO BUTTON\>
file: /home2/mico/programs/fotoxx-22.35/f.comb.cc file: /home2/mico/programs/fotoxx-22.50/f.warp.cc
topic: \>HDR\> topic: \>UNBEND\>
topic: \>HDF\> topic: \>PERSPECTIVE\>
topic: \>STACK/PAINT\> topic: \>WARP AREA\>
topic: \>STACK/NOISE\> topic: \>WARP CURVED\>
topic: \>STACK/LAYER\> topic: \>WARP LINEAR\>
topic: \>STACK/SPLIT\> topic: \>WARP AFFINE\>
topic: \>IMAGE DIFFS\> topic: \>AREA RESCALE\>
topic: \>PANORAMA\> topic: \>UNWARP CLOSEUP\>
topic: \>VERT. PANORAMA\> topic: \>MAKE WAVES\>
topic: \>SHOW CIM FILES\> topic: \>TWIST\>
file: /home2/mico/programs/fotoxx-22.35/f.edit.cc topic: \>SPHERE\>
topic: \>PAINT EDITS\> topic: \>STRETCH\>
topic: \>ROTATE\> topic: \>INSIDE-OUT\>
topic: \>CROP\> topic: \>TINY PLANET\>
topic: \>RETOUCH\> topic: \>ESCHER SPIRAL\>
topic: \>RESIZE\> topic: \>FLATTEN PHOTO\>
topic: \>UPRIGHT\> file: /home2/mico/programs/fotoxx-22.50/f.meta.cc
topic: \>MIRROR\> topic: \>VIEW META\>
topic: \>MARKUP\> topic: \>VIEW META\>
topic: \>COLOR MODE\> topic: \>EDIT META\>
topic: \>PAINT IMAGE\> topic: \>EDIT ANY META\>
topic: \>PAINT TRANSP\> topic: \>DELETE META\>
topic: \>COPY IN IMAGE\> topic: \>COPY META\>
topic: \>COPY FROM IMAGE\> topic: \>MANAGE TAGS\>
topic: \>COPY FROM IMAGE\> topic: \>CAPTIONS\>
topic: \>COPY PRIOR EDIT\> topic: \>CAPTIONS\>
topic: \>PLUGINS\> topic: \>BATCH TAGS\>
topic: \>PLUGINS\> topic: \>BATCH RENAME TAGS\>
topic: \>PLUGINS\> topic: \>BATCH PHOTO DATE\>
topic: \>RAW THERAPEE\> topic: \>BATCH CHANGE META\>
topic: \>DARKTABLE\> topic: \>BATCH REPORT META\>
topic: \>EXTRACT MPO FILES\> topic: \>BATCH MOVE META\>
file: /home2/mico/programs/fotoxx-22.35/f.select.cc topic: \>BATCH GEOTAGS\>
topic: \>PLACES/DATES\>
topic: \>TIMELINE\>
topic: \>SEARCH IMAGES\>
topic: \>MARKERS\>
topic: \>DOWNLOAD MAPS\>
topic: \>FILE MAP\>
topic: \>CHOOSE MAP\>
topic: \>NET MAP\>
topic: \>SHOW ON MAP\>
topic: \>NET MAP LOCS\>
file: /home2/mico/programs/fotoxx-22.50/f.tools.cc
topic: \>INDEX FILES\>
topic: \>QUICK INDEX\>
topic: \>MOVE FOTOXX HOME\>
topic: \>SETTINGS\>
topic: \>KB SHORTCUTS\>
topic: \>RGB DISTRIBUTION\>
topic: \>MAGNIFY IMAGE\>
topic: \>FIND DUPLICATES\>
topic: \>MEASURE IMAGE\>
topic: \>SHOW RGB\>
topic: \>POPUP TEXT\>
topic: \>CALIBRATE PRINTER\>
topic: \>CALIBRATE PRINTER\>
topic: \>PRINT CALIBRATED\>
topic: \>GRID SETTINGS\>
topic: \>GRID SETTINGS\>
topic: \>LINE COLOR\>
topic: \>DARK/BRIGHT PIXELS\>
topic: \>MONITOR COLOR\>
topic: \>MONITOR GAMMA\>
topic: \>SHOW RESOURCES\>
topic: \>APPIMAGE FILES\>
topic: \>APPIMAGE UNINSTALL\>
file: /home2/mico/programs/fotoxx-22.50/f.select.cc
topic: \>SELECT AREA\> topic: \>SELECT AREA\>
topic: \>FIND AREA GAP\> topic: \>FIND AREA GAP\>
topic: \>EDGE BLEND\> topic: \>EDGE BLEND\>
topic: \>COPY/COMPLEX\> topic: \>COPY/COMPLEX\>
topic: \>SHOW/HIDE AREA\> topic: \>SHOW/HIDE AREA\>
topic: \>SHOW/HIDE AREA\> topic: \>SHOW/HIDE AREA\>
topic: \>ENABLE/DISABLE AREA\> topic: \>ENABLE/DISABLE AREA\>
topic: \>ENABLE/DISABLE AREA\> topic: \>ENABLE/DISABLE AREA\>
topic: \>INVERT AREA\> topic: \>INVERT AREA\>
topic: \>CLEAR AREA\> topic: \>CLEAR AREA\>
topic: \>COPY/PASTE AREA\> topic: \>COPY/PASTE AREA\>
topic: \>LOAD/SAVE AREA\> topic: \>LOAD/SAVE AREA\>
topic: \>LOAD/SAVE AREA\> topic: \>LOAD/SAVE AREA\>
topic: \>COPY/PASTE AREA\> topic: \>COPY/PASTE AREA\>
file: /home2/mico/programs/fotoxx-22.35/f.refine.cc file: /home2/mico/programs/fotoxx-22.50/f.mashup.cc
topic: \>VOODOO 1\> topic: \>MASHUP\>
topic: \>VOODOO 2\> topic: \>IMAGE TABLE\>
topic: \>EDIT DIST\> file: /home2/mico/programs/fotoxx-22.50/f.effects.cc
topic: \>FLATTEN DIST\> topic: \>SKETCH\>
topic: \>LOCAL CONTRAST\> topic: \>CARTOON\>
topic: \>GRADIENTS\> topic: \>DRAWING\>
topic: \>GLOBAL RETINEX\> topic: \>EMBOSS\>
topic: \>LOCAL RETINEX\> topic: \>TILES\>
topic: \>SATURATION\> topic: \>PAINTING\>
topic: \>SOFT FOCUS\> topic: \>TEXTURE\>
topic: \>MATCH COLORS\> topic: \>PATTERN\>
topic: \>BRITE RAMP\> topic: \>DITHER\>
file: /home2/mico/programs/fotoxx-22.35/f.pixmap.cc topic: \>DITHER\>
file: /home2/mico/programs/fotoxx-22.35/f.gallery.cc topic: \>DITHER\>
topic: \>DITHER\>
topic: \>DITHER\>
topic: \>MOSAIC\>
topic: \>ADD NOISE\>
topic: \>COLOR DEPTH\>
topic: \>SHIFT COLORS\>
topic: \>ALIEN COLORS\>
topic: \>COPY COLORS\>
topic: \>PASTE COLORS\>
topic: \>CUSTOM KERNEL\>
file: /home2/mico/programs/fotoxx-22.50/f.gallery.cc
topic: \>ZOOM\> topic: \>ZOOM\>
topic: \>ZOOM\> topic: \>ZOOM\>
topic: \>THUMB VIEW\> topic: \>THUMB VIEW\>
topic: \>META VIEW\> topic: \>META VIEW\>
topic: \>RECENT FILES\> topic: \>RECENT FILES\>
topic: \>NEWEST FILES\> topic: \>NEWEST FILES\>
topic: \>GALLERY SORT\> topic: \>GALLERY SORT\>
topic: \>GALLERY SCREEN\> topic: \>GALLERY SCREEN\>
topic: \>SOURCE FOLDER\> topic: \>SOURCE FOLDER\>
topic: \>ALL FOLDERS\> topic: \>ALL FOLDERS\>
topic: \>SELECT IMAGE FILES\> topic: \>SELECT IMAGE FILES\>
topic: \>RENAME FOLDER\> topic: \>RENAME FOLDER\>
topic: \>ADD SUBFOLDER\> topic: \>ADD SUBFOLDER\>
topic: \>BOOKMARKS\> topic: \>BOOKMARKS\>
topic: \>BOOKMARKS\> topic: \>BOOKMARKS\>
topic: \>VIDEO FILES\> topic: \>VIDEO FILES\>
file: /home2/mico/programs/fotoxx-22.35/f.repair.cc file: /home2/mico/programs/fotoxx-22.50/f.pixmap.cc
file: /home2/mico/programs/fotoxx-22.50/f.repair.cc
topic: \>SHARPEN\> topic: \>SHARPEN\>
topic: \>BLUR\> topic: \>BLUR\>
topic: \>BLUR\>
topic: \>BLUR\>
topic: \>BLUR\>
topic: \>BLUR\>
topic: \>BLUR\>
topic: \>DENOISE\> topic: \>DENOISE\>
topic: \>DEFOG\> topic: \>DEFOG\>
topic: \>RED EYES\> topic: \>RED EYES\>
topic: \>SMART ERASE\> topic: \>SMART ERASE\>
topic: \>REMOVE HALO\> topic: \>REMOVE HALO\>
topic: \>ADJUST RGB\> topic: \>ADJUST RGB\>
topic: \>ADJUST HSL\> topic: \>ADJUST HSL\>
topic: \>COLOR PROFILE\> topic: \>COLOR PROFILE\>
topic: \>VIGNETTE\>
topic: \>REMOVE DUST\> topic: \>REMOVE DUST\>
topic: \>CHROMATIC 1\> topic: \>CHROMATIC 1\>
topic: \>CHROMATIC 2\> topic: \>CHROMATIC 2\>
file: /home2/mico/programs/fotoxx-22.35/f.warp.cc file: /home2/mico/programs/fotoxx-22.50/f.comb.cc
topic: \>UNBEND\> topic: \>HDR\>
topic: \>PERSPECTIVE\> topic: \>HDF\>
topic: \>WARP AREA\> topic: \>STACK/PAINT\>
topic: \>WARP CURVED\> topic: \>STACK/NOISE\>
topic: \>WARP LINEAR\> topic: \>STACK/LAYER\>
topic: \>WARP AFFINE\> topic: \>STACK/SPLIT\>
topic: \>AREA RESCALE\> topic: \>IMAGE DIFFS\>
topic: \>UNWARP CLOSEUP\> topic: \>PANORAMA\>
topic: \>MAKE WAVES\> topic: \>VERT. PANORAMA\>
topic: \>TWIST\> topic: \>SHOW CIM FILES\>
topic: \>SPHERE\> file: /home2/mico/programs/fotoxx-22.50/f.albums.cc
topic: \>STRETCH\>
topic: \>INSIDE-OUT\>
topic: \>TINY PLANET\>
topic: \>ESCHER SPIRAL\>
topic: \>FLATTEN PHOTO\>
file: /home2/mico/programs/fotoxx-22.35/f.tools.cc
topic: \>INDEX FILES\>
topic: \>QUICK INDEX\>
topic: \>MOVE FOTOXX HOME\>
topic: \>SETTINGS\>
topic: \>KB SHORTCUTS\>
topic: \>RGB DISTRIBUTION\>
topic: \>MAGNIFY IMAGE\>
topic: \>FIND DUPLICATES\>
topic: \>MEASURE IMAGE\>
topic: \>SHOW RGB\>
topic: \>POPUP TEXT\>
topic: \>CALIBRATE PRINTER\>
topic: \>CALIBRATE PRINTER\>
topic: \>PRINT CALIBRATED\>
topic: \>GRID SETTINGS\>
topic: \>GRID SETTINGS\>
topic: \>LINE COLOR\>
topic: \>DARK/BRIGHT PIXELS\>
topic: \>MONITOR COLOR\>
topic: \>MONITOR GAMMA\>
topic: \>SHOW RESOURCES\>
topic: \>APPIMAGE FILES\>
topic: \>APPIMAGE UNINSTALL\>
file: /home2/mico/programs/fotoxx-22.35/f.meta.cc
topic: \>VIEW META\>
topic: \>VIEW META\>
topic: \>EDIT META\>
topic: \>EDIT ANY META\>
topic: \>DELETE META\>
topic: \>COPY META\>
topic: \>MANAGE TAGS\>
topic: \>CAPTIONS\>
topic: \>CAPTIONS\>
topic: \>BATCH TAGS\>
topic: \>BATCH RENAME TAGS\>
topic: \>BATCH PHOTO DATE\>
topic: \>BATCH CHANGE META\>
topic: \>BATCH REPORT META\>
topic: \>BATCH MOVE META\>
topic: \>BATCH GEOTAGS\>
topic: \>PLACES/DATES\>
topic: \>TIMELINE\>
topic: \>SEARCH IMAGES\>
topic: \>MARKERS\>
topic: \>DOWNLOAD MAPS\>
topic: \>FILE MAP\>
topic: \>CHOOSE MAP\>
topic: \>NET MAP\>
topic: \>SHOW ON MAP\>
topic: \>NET MAP LOCS\>
file: /home2/mico/programs/fotoxx-22.35/f.albums.cc
topic: \>MANAGE ALBUMS\> topic: \>MANAGE ALBUMS\>
topic: \>UPDATE ALBUMS\> topic: \>UPDATE ALBUMS\>
topic: \>GALLERY TO ALBUM\> topic: \>GALLERY TO ALBUM\>
topic: \>ALBUM MASS UPDATE\> topic: \>ALBUM MASS UPDATE\>
topic: \>SLIDE SHOW\> topic: \>SLIDE SHOW\>
 End of changes. 43 change blocks. 
242 lines changed or deleted 260 lines changed or added

Home  |  About  |  Features  |  All  |  Newest  |  Dox  |  Diffs  |  RSS Feeds  |  Screenshots  |  Comments  |  Imprint  |  Privacy  |  HTTP(S)