"Fossies" - the Fresh Open Source Software Archive  

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

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

userguide  (fotoxx-23.0)	:	userguide  (fotoxx-23.1)
FOTOXX USER GUIDE v.23.0		FOTOXX USER GUIDE v.23.1
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 555		skipping to change at line 555
be almost instantaneous to search. You may not need this. You can skip this i nitially		be almost instantaneous to search. You may not need this. You can skip this i nitially
and add items later if needed. For more details, see \>INDEX FILES\>.		and add items later if needed. For more details, see \>INDEX FILES\>.
\bIndex Time Required		\bIndex Time Required
If you have many thousands of image files, the initial index function may nee d some		If you have many thousands of image files, the initial index function may nee d some
time. The speed can range from 300 to 10K files per minute, depending on proc essor		time. The speed can range from 300 to 10K files per minute, depending on proc essor
speed, disk speed, and average image file type and size:		speed, disk speed, and average image file type and size:
slow case: laptop, 1 GHz, slow disk, images >30 megapixels, RAW or PNG file s		slow case: laptop, 1 GHz, slow disk, images >30 megapixels, RAW or PNG file s
fast case: desktop, 4 GHz, 4 cores, SSD disk, images <10 megapixels, JPG fi les		fast case: desktop, 4 GHz, 4 cores, SSD disk, images <10 megapixels, JPG fi les
Here are a few real-world index benchmarks. Files were mostly JPEG averaging 2.5 MB.		Here are a few real-world index benchmarks. Files were mostly JPEG averaging 2.6 MB.
\bCPU GHz cores disk type files/minute		\bCPU GHz cores disk type files/minute
Intel 4.0 6 SSD PCIe 7402		Intel 3.5 6 SSD PCIe 19364
Intel 4.0 6 7200 rpm USB-C 1511		Intes 3.5 6 SSD USB-C 9287
Intel 4.0 6 5400 rpm USB-C 1207		Intel 3.5 6 7200 rpm USB-C 1511
ARM 1.2 4 micro-SD card 870		Intel 3.5 6 5400 rpm USB-C 1207
		ARM 1.2 4 micro-SD card 870
When you add new image files to your collection, the next Fotoxx startup will index		When you add new image files to your collection, the next Fotoxx startup will index
only the new files. If there are only a few new files, startup will be fast. If there		only the new files. If there are only a few new files, startup will be fast. If there
are many new files, startup will need time to index them, as described above.		are many new files, startup will need time to index them, as described above.
\bRemovable Storage		\bRemovable Storage
If your top image folders include folders on a removable drive, and you run F otoxx		If your top image folders include folders on a removable drive, and you run F otoxx
without the drive mounted, the index data and thumbnails are still preserved, even		without the drive mounted, the index data and thumbnails are still preserved, even
though the image files have temporarily disappeared. When the removable drive is		though the image files have temporarily disappeared. When the removable drive is
mounted again, and Fotoxx is started, the last status is restored. If any ima ge files		mounted again, and Fotoxx is started, the last status is restored. If any ima ge files
skipping to change at line 1011		skipping to change at line 1012
VIDEO files have the following menu addition:		VIDEO files have the following menu addition:
• Thumbnail Frame - select thumbnail frame (at minutes/seconds position)		• Thumbnail Frame - select thumbnail frame (at minutes/seconds position)
KEYBOARD SHORTCUTS		KEYBOARD SHORTCUTS
Keyboard shortcuts are available for most menu functions.		Keyboard shortcuts are available for most menu functions.
Use the menu Tools > KB Shortcuts to view all shortcuts and make custom addit ions.		Use the menu Tools > KB Shortcuts to view all shortcuts and make custom addit ions.
The notation "Ctrl+X" means press and hold the Ctrl key, then press the X key .		The notation "Ctrl+X" means press and hold the Ctrl key, then press the X key .
The following keyboard functions are fixed and cannot be changed:		The following keyboard functions are fixed and cannot be changed:
		• K key KB Shortcuts - dialog to view or change shortcuts
• [+] [=] key Zoom image or thumbnails larger		• [+] [=] key Zoom image or thumbnails larger
• [-] key Zoom image or thumbnails smaller		• [-] key Zoom image or thumbnails smaller
• Z key Toggle image between 1x (full size) and fit to window		• Z key Toggle image between 1x (full size) and fit to window
• F1 key Display user guide for current or prior function		• F1 key Display user guide for current or prior function
• F2/F3/F4 key Change to File/Gallery/Map view mode		• F2/F3/F4 key Change to File/Gallery/Map view mode
• F10 key Toggle main window full-screen and back		• F10 key Toggle main window full-screen and back
• F11 key Same as F10, without menus, title bar and top panel		• F11 key Same as F10, without menus, title bar and top panel
• Escape key Kill running function, Exit active dialog		• Escape key Kill running function, Exit active dialog
• Arrow ←/→ Show previous/next image file in current gallery		• Arrow ←/→ Show previous/next image file in current gallery
• Arrow ↑/↓ File view: like ←/→ but show only last file versions		• Arrow ↑/↓ File view: like ←/→ but show only last file versions
skipping to change at line 1603		skipping to change at line 1605
• Blank the current image and pause the slide show, or restore the image ( toggle).		• Blank the current image and pause the slide show, or restore the image ( toggle).
Default 'B'.		Default 'B'.
• Show the next image, including the transition animation, in a paused sli de show.		• Show the next image, including the transition animation, in a paused sli de show.
Default 'N'.		Default 'N'.
• Pause or resume the slide show (toggle).		• Pause or resume the slide show (toggle).
Default 'P'.		Default 'P'.
• Magnify the image - simulated loupe (see the \>MAGNIFY IMAGE\> function) .		• Magnify the image - simulated loupe (see the \>MAGNIFY IMAGE\> function) .
Default 'X'.		Default 'X'.
The following KB keys are assigned to actions that cannot be changed:		The following KB keys are assigned to actions that cannot be changed:
• Escape: if a transition or zoom is in-progress, jump immediately to fina		• Escape: If a transition or zoom is in-progress, jump immediately to fina
l status.		l status.
• Escape: otherwise, Interrupt the slide show and return to the main dialo		• Escape: Otherwise, interrupt the slide show and return to the main dialo
g.		g.
• Left / right arrow keys: You can go back and forward at any time and the slide		• Left / right arrow keys: You can go back and forward at any time and the slide
show will continue from there.		show will continue from there.
You can configure keys other than P/B/N/X if desired, and the space bar (blan k)		You can configure keys other than P/B/N/X if desired, and the space bar (blan k)
can also be used. Do this by replacing the key name in the dialog with anothe r key.		can also be used. Do this by replacing the key name in the dialog with anothe r key.
Press [transitions] to start a dialog (Transition Preferences, bottom left) t o select		Press [transitions] to start a dialog (Transition Preferences, bottom left) t o select
and customize the transitions between images. These include instant replaceme nt,		and customize the transitions between images. These include instant replaceme nt,
fade-out/fade-in, and many animated methods of image replacement (e.g. the ne w image		fade-out/fade-in, and many animated methods of image replacement (e.g. the ne w image
expands from the center to replace the old image). Select the transitions to be used		expands from the center to replace the old image). Select the transitions to be used
skipping to change at line 1866		skipping to change at line 1868
image collection so that it can be easily searched. It would be good to revie w these		image collection so that it can be easily searched. It would be good to revie w these
before choosing an organization system for file and folder names and metadata tags,		before choosing an organization system for file and folder names and metadata tags,
titles, ratings, etc. See \>ORGANIZING IMAGES\>.		titles, ratings, etc. See \>ORGANIZING IMAGES\>.
Metadata standards are chaotic. Please review this issue in the topic \>BATCH MOVE META\>		Metadata standards are chaotic. Please review this issue in the topic \>BATCH MOVE META\>
before making decisions about which metadata keys to use for your image colle ction.		before making decisions about which metadata keys to use for your image colle ction.
VIEW META		VIEW META
VIEW ALL META		VIEW ALL META
+image: view-metadata.jpg		+image: view-metadata.jpg
The View Meta functions display available metadata for the current image file		The View Meta functions displays commonly useful metadata for the current ima
. EXIF		ge file.
metadata contains the date and time of a photo, shutter speed, focal length,		This includes the date and time of a photo, shutter speed, focal length, imag
pixel		e size,
dimensions, etc. Digital cameras store this data inside the image. IPTC metad		ISO, etc. Digital cameras store this data inside the image. Metadata may also
ata		contain
contains tags (from Fotoxx, Photoshop ...) a title or caption, and a descript		data added by a user: keywords or tags, title or caption, description, commen
ion or		ts added
comments added by the photographer or later editor (often found in published		by the photographer or later editor (sometimes found in published images).
images).
If an image is edited and then saved, the metadata is updated and stored with the new		If an image is edited and then saved, the metadata is updated and stored with the new
image. View Meta shows the most commonly needed data, including the photo dat		image. View Meta shows the history of edits that have been made to the image.
e/time,
user-assigned tags, image rating (0-5 stars), title, description, and the his		View All Meta reports all available metadata, and can be over 100 items you l
tory of		ikely
Fotoxx edits that have been made to the image. View All Meta reports all avai		don't care about.
lable
metadata. The [Extras] button on the View Meta window opens the dialog shown		The [Extras] button on the View Meta window opens the dialog shown on the rig
on the		ht, where
right, where you can add extra items to the report. Any item you see in the l		you can add extra items to the report. Any item available in the View All Met
ong report		a report
can be added to the short report. Click an item in the left column to add it to the		can be added to the short report. Click an item in the left column to add it to the
right column and to the report. Click an item in the right column to remove i t. Click		right column and to the report. Click an item in the right column to remove i t. Click
the entry "Other Item ..." to type-in any item name not contained in the defa ult list,		the entry "Other Item ..." to type-in any item name not contained in the defa ult list,
which is limited to the most likely needed items.		which is limited to the most likely needed items.
Fotoxx uses the following EXIF/IPTC data items (keys) for image editing and s earching:		Fotoxx uses the following metadata items (keys) for image editing and searchi ng:
\bData Name\b \bFotoxx function to add or change the data		\bData Name\b \bFotoxx function to add or change the data
Title Edit Meta - title		Title Edit Meta - title
Description Edit Meta - description		Description Edit Meta - description
Date/Time Original Edit Meta - date/time (normally from camera date/t		Date/Time Original Edit Meta - date/time - normally from camera date/
ime)		time
Rating Edit Meta - rating		Rating Edit Meta - rating - 0 to 5 stars
Keywords Edit Meta - tags		Geotags Edit Meta - location - may come from the camera GP
Geotags Edit Meta - location - (may come from camera GPS)		S
Tags Edit Meta - image tags		Tags Edit Meta - image tags (identifiers added by a use
		r)
There are also several batch functions for adding data into many image files at once.		There are also several batch functions for adding data into many image files at once.
These are found in the \>BATCH MENU\>.		These are found in the \>BATCH MENU\>.
METADATA STANDARDS CHAOS		METADATA STANDARDS CHAOS
Metadata standards are largely chaotic. Multiple standards bodies and corpora tions		Metadata standards are largely chaotic. Multiple standards bodies and corpora tions
(e.g. Adobe, Nikon) have developed multiple overlapping/conflicting standards over the		(e.g. Adobe, Nikon) have developed multiple overlapping/conflicting standards over the
decades. For example, the title of an image can be found in one or more of th e keys		decades. For example, the title of an image can be found in one or more of th e keys
'title', 'subject', or 'headline'. The author or photographer may be found in 'artist',		'title', 'subject', or 'headline'. The author or photographer may be found in 'artist',
'by-line', 'creator', 'author', or 'photographer' (not a standard but often p resent).		'by-line', 'creator', 'author', or 'photographer' (not a standard but often p resent).
The content description may be found in 'description', 'imagedescription', 'c omment',		The content description may be found in 'description', 'imagedescription', 'c omment',
'usercomment', or 'caption'.		'usercomment', or 'caption'.
Fotoxx uses the following IPTC names for editing, displaying, and searching i mage		Fotoxx uses the following metadata names for editing, displaying, and searchi ng image
files: 'creator', 'description', and 'title'. This choice was based on freque ncy of		files: 'creator', 'description', and 'title'. This choice was based on freque ncy of
use in a large sample of images. Likely you have image files using different metadata		use in a large sample of images. Likely you have image files using different metadata
keys. You can copy these other keys into the ones used by Fotoxx. For single files,		keys. You can copy these other keys into the ones used by Fotoxx. For single files,
use View Meta to show all available data in all keys, and Edit Meta to copy d ata into		use View Meta to show all available data in all keys, and Edit Meta to copy d ata into
the keys used by Fotoxx. Add all redundant keys to the 'extras' list in View Meta, so		the keys used by Fotoxx. Add all redundant keys to the 'extras' list in View Meta, so
you can see them. Run both View Meta and Edit Meta together while viewing ima ges to		you can see them. Run both View Meta and Edit Meta together while viewing ima ges to
be fixed. Copy and paste data from View Meta into Edit Meta. Both functions u pdate as		be fixed. Copy and paste data from View Meta into Edit Meta. Both functions u pdate as
you move to other images. \bBetter:\b You can process selected image files, o r all		you move to other images. \bBetter:\b You can process selected image files, o r all
files, using \>BATCH MOVE META\> to consolidate metadata into the preferred k eys.		files, using \>BATCH MOVE META\> to consolidate metadata into the preferred k eys.
skipping to change at line 2179		skipping to change at line 2182
(bold text) or enter a new one, click the tag, and press [create]. The tag wi ll move		(bold text) or enter a new one, click the tag, and press [create]. The tag wi ll move
from the old to the new category. To delete a tag, click the tag and press [d elete].		from the old to the new category. To delete a tag, click the tag and press [d elete].
Tags used in images but not assigned to a category will appear under "nocatg" .		Tags used in images but not assigned to a category will appear under "nocatg" .
A Category with no tags assigned can be deleted - click the category, clear t he tag		A Category with no tags assigned can be deleted - click the category, clear t he tag
name if present, and press [delete].		name if present, and press [delete].
Note: a newly created tag is appended to the end of the tag list for its cate gory.		Note: a newly created tag is appended to the end of the tag list for its cate gory.
The next time Fotoxx is started, all categories and their tag lists are sorte d		The next time Fotoxx is started, all categories and their tag lists are sorte d
alphabetically, except that "nocatg" is always last.		alphabetically, except that "nocatg" is always last.
Use the [orphan tags] button to list tags that are defined but not assigned t
o any
images. These may be deleted if no use is planned.
CAPTIONS		CAPTIONS
+image: choose-captions.jpg		+image: choose-captions.jpg
\_Choose Captions menu		\_Choose Captions menu
Choose which metadata items to use for text captions displayed in the top lef t corner		Choose which metadata items to use for text captions displayed in the top lef t corner
of the image in file-view mode. Subsequent image views will include all chose n items		of the image in file-view mode. Subsequent image views will include all chose n items
available in the image metadata. See \>SETTINGS\> for how to control line wra pping.		available in the image metadata. See \>SETTINGS\> for how to control line wra pping.
\_Toggle Captions menu		\_Toggle Captions menu
Toggle the display of captions ON or OFF.		Toggle the display of captions ON or OFF.
Assign a keyboard shortcut to quickly enable or disable captions display.		Assign a keyboard shortcut to quickly enable or disable captions display.
skipping to change at line 2370		skipping to change at line 2370
number = single numeric value - equal metadata values are selected		number = single numeric value - equal metadata values are selected
number => single numeric value - equal or greater values are selected		number => single numeric value - equal or greater values are selected
number <= single numeric value - less or equal values are selected		number <= single numeric value - less or equal values are selected
\bWildcard matching		\bWildcard matching
The 'matches' method allows the use of wildcards in the match criteria. An as terisk		The 'matches' method allows the use of wildcards in the match criteria. An as terisk
(*) can be used to match any sequence of characters, including zero character s.		(*) can be used to match any sequence of characters, including zero character s.
A question mark (?) can be used to match any single character. Example: "mar? *ony"		A question mark (?) can be used to match any single character. Example: "mar? *ony"
would match "mark anthony" but would not match "marony". "mar*ony" would matc h both.		would match "mark anthony" but would not match "marony". "mar*ony" would matc h both.
		The [x] buttons on the right side can be used to clear single metadata search
		items.
		\bDialog Buttons
		[Load] and [Save] can be used to load or save search criteria from a file.
		Clear] will clear all data in the dialog. [Proceed] will start the search pro
		cess.
\bPerformance		\bPerformance
Searching and reporting of indexed metadata is almost instantaneous. The spee d for		Searching and reporting of indexed metadata is almost instantaneous. The spee d for
non-indexed metadata depends on computer and disk speed. A strong CPU and SSD disk		non-indexed metadata depends on computer and disk speed. A strong CPU and SSD disk
can search and report up to 1000 files per second. There is a separate topic		can search over 2000 files per second. There is a separate topic which explai
which		ns
explains options for optimizing image searching: \>ORGANIZING IMAGES\>.		options for optimizing image searching: \>ORGANIZING IMAGES\>.
\bsearch_results\b (album)		\bsearch_results\b (album)
The output of Search Images is automatically saved in the album "search_resul ts".		The output of Search Images is automatically saved in the album "search_resul ts".
This is for convenience. You may perform a search and then perform other func tions		This is for convenience. You may perform a search and then perform other func tions
which change the current gallery. If you need to refer to the previous search , this		which change the current gallery. If you need to refer to the previous search , this
remains available in the album "search_results". Rename this album if you wan t to keep		remains available in the album "search_results". Rename this album if you wan t to keep
later searches from replacing it.		later searches from replacing it.
Limitation: The search function is limited to 40,000 results (images found th at meet		Limitation: The search function is limited to 40,000 results (images found th at meet
the search criteria). If this limit is exceeded, you are notified and the sea rch is		the search criteria). If this limit is exceeded, you are notified and the sea rch is
skipping to change at line 3890		skipping to change at line 3896
CARTOON		CARTOON
+image: cartoon.jpg		+image: cartoon.jpg
Transform a photo into a cartoon-like drawing. Black lines are drawn over fea ture		Transform a photo into a cartoon-like drawing. Black lines are drawn over fea ture
edges in the image, wherever the brightness or color changes abruptly. Line T hreshold		edges in the image, wherever the brightness or color changes abruptly. Line T hreshold
sets the sensitivity for edge detection and line drawing, causing fewer or mo re lines		sets the sensitivity for edge detection and line drawing, causing fewer or mo re lines
to be drawn. Line Width makes the lines thicker or thinner. Blur Radius contr ols a		to be drawn. Line Width makes the lines thicker or thinner. Blur Radius contr ols a
blur function which can make the lines look more curvy or less jagged. Kuwaha ra Depth		blur function which can make the lines look more curvy or less jagged. Kuwaha ra Depth
controls a sharpen function which can strengthen feature edges within the ima ge.		controls a sharpen function which can strengthen feature edges within the ima ge.
This function can be quite slow to respond (10+ seconds) if the image is larg e and if		This function can be quite slow to respond (20+ seconds) if the image is larg e and if
the blur and kuwahara controls are set to high values. It works faster and be tter on		the blur and kuwahara controls are set to high values. It works faster and be tter on
smaller images, around 2 megapixels or less. I suggest you start with small v alues		smaller images, around 2 megapixels or less. I suggest you start with small v alues
(2-3) for kuwahara and blur, then adjust line threshold to optimize the densi ty of the		(2-3) for kuwahara and blur, then adjust line threshold to optimize the densi ty of the
drawn lines. Now change kuwahara and blur in small steps and re-adjust line t hreshold.		drawn lines. Now change kuwahara and blur in small steps and re-adjust line t hreshold.
If you are working with a large image, I suggest you select a small but impor tant area		If you are working with a large image, I suggest you select a small but impor tant area
within the image so that optimization can proceed faster. Then delete the are a and do		within the image so that optimization can proceed faster. Then delete the are a and do
the entire image. You may be close to optimum already. You can kill the proce ss in		the entire image. You may be close to optimum already. You can kill the proce ss in
mid-stream with the Escape key.		mid-stream with the Escape key.
Other edit functions, applied before or after Cartoon, may enhance the effect . These		Other edit functions, applied before or after Cartoon, may enhance the effect . These
skipping to change at line 5180		skipping to change at line 5186
Fotoxx needs to know where all your image files are located (folder and file names)		Fotoxx needs to know where all your image files are located (folder and file names)
and their embedded metadata (dates, tags (keywords), geotags, titles, descrip tions,		and their embedded metadata (dates, tags (keywords), geotags, titles, descrip tions,
ratings). This data is indexed for fast searching. Fotoxx also creates thumbn ail		ratings). This data is indexed for fast searching. Fotoxx also creates thumbn ail
images so that the gallery windows (thumbnail pages) will work fast. Fotoxx d oes not		images so that the gallery windows (thumbnail pages) will work fast. Fotoxx d oes not
modify or copy your image files - it only reads them to make the index and th umbnails.		modify or copy your image files - it only reads them to make the index and th umbnails.
These are typically 2% as large as the JPEG files from a modern camera.		These are typically 2% as large as the JPEG files from a modern camera.
The Index Files function runs whenever Fotoxx is started. This function will create		The Index Files function runs whenever Fotoxx is started. This function will create
missing thumbnails, replace outdated ones, and refresh the metadata index usi ng current		missing thumbnails, replace outdated ones, and refresh the metadata index usi ng current
data from your image files. This may need significant time if you have many t housands		data from your image files. This may need significant time if you have many t housands
of new files. The speed can range from 300 to 10000 files per minute, dependi		of new files. The speed can range from 300 to >20K files/minute, depending on
ng on		computer
computer speed, disk speed, and average file size. If there are few or no new		speed, disk speed, and average file size (the big number is for a 4 GHz CPU w
files,		ith 8
indexing completes quickly. Indexing can also be started manually from the To		cores and a PCIe SSD). If there are few or no new files, indexing completes q
ols menu.		uickly.
		Indexing can also be started manually from the Tools menu.
NOTE about indexing speed: The rates stated above are for JPEG files around 3 MB.		NOTE about indexing speed: The rates stated above are for JPEG files around 3 MB.
Larger JPEGs and TIFFs are slower. RAW files and large PNG files may be very slow,		Larger JPEGs and TIFFs are slower. RAW files and large PNG files may be very slow,
200 per minute or less. You can find more about performance limitations in th e		200 per minute or less. You can find out more about performance limitations i n the
\>TECHNICAL NOTES\> topic.		\>TECHNICAL NOTES\> topic.
Image files modified or moved within Fotoxx are taken care of automatically. The Index		Image files modified or moved within Fotoxx are taken care of automatically. The Index
function is used only for new image files created from outside Fotoxx (e.g. a new batch		function is used only for new image files created from outside Fotoxx (e.g. a new batch
of photos was added), and for files modified, moved or renamed from outside F otoxx.		of photos was added), and for files modified, moved or renamed from outside F otoxx.
Enter your top image folders (e.g. /home/<user>/Pictures). Use the [browse] b utton to		Enter your top image folders (e.g. /home/<user>/Pictures). Use the [browse] b utton to
locate and add folders. These folders and any subfolders containing images wi ll be		locate and add folders. These folders and any subfolders containing images wi ll be
processed. It does not matter if other files are mixed with the images. The s implest		processed. It does not matter if other files are mixed with the images. The s implest
way is to use /home/<user> as the only top folder, but it is better to sepa rate the		way is to use /home/<user> as the only top folder, but it is better to sepa rate the
skipping to change at line 5665		skipping to change at line 5672
APPIMAGE FILES		APPIMAGE FILES
If Fotoxx is an Appimage build, all user settings and preference files includ ed in		If Fotoxx is an Appimage build, all user settings and preference files includ ed in
the Appimage container are exported to a chosen folder. These files contain d efault		the Appimage container are exported to a chosen folder. These files contain d efault
settings. Corresponding files containing the current settings (with user addi tions)		settings. Corresponding files containing the current settings (with user addi tions)
are in the Fotoxx home folder (default: /home/<user>/.fotoxx/).		are in the Fotoxx home folder (default: /home/<user>/.fotoxx/).
Some important files for customizing are the following:		Some important files for customizing are the following:
• custom_kernel/* custom kernel data files		• custom_kernel/* custom kernel data files
• palettes/* color palettes used by the Dither function		• palettes/* color palettes used by the Dither function
• patterns/* background patterns		• patterns/* background patterns
• custom_menu functions included in custom user menu		• custom_menu functions included in custom user menu
• KB-shortcuts_* keyboard shortcuts		• KB-shortcuts_* custom keyboard shortcuts
• meta_picklist_* metadata key names for GUI pick lists		• meta_picklist_* metadata key names for GUI pick lists
• widgets.css styling changes to standard GTK widgets		• widgets.css styling changes to standard GTK widgets
APPIMAGE UNINSTALL		APPIMAGE UNINSTALL
Uninstall the appimage executable file and related files in /home/<user>/.loc al.		Uninstall the appimage executable file and related files in /home/<user>/.loc al.
HELP MENU		HELP MENU
+image: ug-help.png		+image: ug-help.png
skipping to change at line 6256		skipping to change at line 6263
lines when entering long text - just let the text overflow to the next line b y itself.		lines when entering long text - just let the text overflow to the next line b y itself.
In this case, column alignment is not possible.		In this case, column alignment is not possible.
\bDialog Window Positioning		\bDialog Window Positioning
For commonly used dialogs, Fotoxx saves the dialog window position (relative to the		For commonly used dialogs, Fotoxx saves the dialog window position (relative to the
main window) and tries to restore the same position the next time the dialog is used.		main window) and tries to restore the same position the next time the dialog is used.
This works, mostly. Sometimes the window manager decides some other position.		This works, mostly. Sometimes the window manager decides some other position.
\bFotoxx Performance		\bFotoxx Performance
Fotoxx has four significant performance limitations:		Fotoxx has four significant performance limitations:
• Indexing newly added image files at Fotoxx startup time		• Indexing newly added image files found at Fotoxx startup time
• Startup time for large image database on a slow disk drive		• Startup time for a large image database on a slow disk drive
• Search time for non-indexed metadata		• Search time for non-indexed metadata
• Editing very large images (>100 megapixels)		• Editing very large images (>100 megapixels)
At startup time, Fotoxx searches all declared image folders to update thumbna ils and		At startup time, Fotoxx searches all declared image folders to update thumbna ils and
the metadata index. The processing speed for NEW image files can range from 3 00/minute		the metadata index. The processing speed for NEW image files can range from 3 00/minute
for a slow computer and slow spinning disk, up to 10K/minute for a fast compu ter and		for a slow computer and slow spinning disk, up to 20K/minute for a fast compu ter and
fast SSD disk. File size is also a factor: large RAW files (20-50 MB) are slo wer than		fast SSD disk. File size is also a factor: large RAW files (20-50 MB) are slo wer than
ordinary JPEG files (1-5 MB).		ordinary JPEG files (1-5 MB).
The search for new image files needs time, even if there are no new files to process.		The search for new image files needs time, even if there are no new files to process.
The speed can range from 10K files/sec. for a slow spinning disk, up to 30K/s ec. for		The speed can range from 10K files/sec. for a slow spinning disk, up to 30K/s ec. for
a fast SSD disk. This is for the first Fotoxx startup after the computer was booted.		a fast SSD disk. This is for the first Fotoxx startup after the computer was booted.
Subsequent startups are about 2-3x faster, because some folder and file data is cached		Subsequent startups are about 2-3x faster, because some folder and file data is cached
in memory. You can omit the automatic search for new files if wanted, to keep Fotoxx		in memory. You can omit the automatic search for new files if wanted, to keep Fotoxx
startup time under 1 second (see \>SETTINGS\>). Use this option for image fil		startup time under 1 second (see \>SETTINGS\>). Use this option for files cli
es		cked in
clicked in a file manager (Nautilus etc.), to make the file display instantly		a file manager (Nautilus etc.), to make the file display instantly.
.
Searching for metadata that is indexed is almost instantaneous. Metadata that is often		Searching for metadata that is indexed is almost instantaneous. Metadata that is often
used for searching (e.g. tags, locations, image titles) is indexed by default , and you		used for searching (e.g. tags, locations, image titles) is indexed by default , and you
can add other items if wanted (see \>INDEX FILES\>). The search speed for non -indexed		can add other items if wanted (see \>INDEX FILES\>). The search speed for non -indexed
metadata can range from 4K to 50K files/minute, depending on computer and dis k speed.		metadata can range from 4K to 100K files/minute, depending on computer and di sk speed.
For 100K files on an SSD disk, searching for non-indexed metadata would requi re about		For 100K files on an SSD disk, searching for non-indexed metadata would requi re about
2 minutes, whereas searching for indexed metadata < 1 second.		1-2 minutes, whereas searching for indexed metadata is under 1 second. If the
		re is some
		metadata you need to search often, include this in your list of indexed metad
		ata.
Fotoxx can edit images up to about 256 megapixels. On a strong computer, resp onsiveness		Fotoxx can edit images up to about 256 megapixels. On a strong computer, resp onsiveness
for most edit functions is below 1 second for images up to 30 megapixels or s o. Beyond		for most edit functions is below 1 second for images up to 30 megapixels or s o. Beyond
this, expect responsiveness to decline. The following table shows the time in seconds		this, expect responsiveness to decline. The following table shows the time in seconds
to open and view the image, start an edit function, and respond to dialog con trols.		to open and view the image, start an edit function, and respond to the dialog controls.
The computer used was my fairly strong desktop - 4 GHz, 16 GB, SSD disk. The long open		The computer used was my fairly strong desktop - 4 GHz, 16 GB, SSD disk. The long open
time for the 754 megapixel image was due to >1 million page faults to allocat e 12 GB.		time for the 754 megapixel image was due to >1 million page faults to allocat e 12 GB.
edit - unsharp mask		edit - unsharp mask
image size megapixels open file startup response		image size megapixels open file startup response
8K x 6.7K 54 0.4 1.9 0.8		8K x 6.7K 54 0.4 1.9 0.8
10K x 8.4K 84 0.8 3.2 1.2		10K x 8.4K 84 0.8 3.2 1.2
12K x 10.0K 120 1.3 4.4 1.9		12K x 10.0K 120 1.3 4.4 1.9
16K x 13.4K 214 1.8 7.4 2.7		16K x 13.4K 214 1.8 7.4 2.7
20K x 16.8K 335 2.7 too large to edit		20K x 16.8K 335 2.7 too large to edit
skipping to change at line 6350		skipping to change at line 6358
The folder "image_index_*" (within Fotoxx home) contains the following files:		The folder "image_index_*" (within Fotoxx home) contains the following files:
• image_folders: top folders for indexed image files, and thumbnails folde r		• image_folders: top folders for indexed image files, and thumbnails folde r
• image_index: large text file containing image file names and indexed met adata		• image_index: large text file containing image file names and indexed met adata
• meta_index: list of optional metadata items that are indexed		• meta_index: list of optional metadata items that are indexed
\bFiles in Fotoxx home		\bFiles in Fotoxx home
• albums/ image albums from Manage Albums function		• albums/ image albums from Manage Albums function
• custom_kernel/ saved custom kernel data files		• custom_kernel/ saved custom kernel data files
• custom scripts/ saved script files for custom edits or batch edits		• custom scripts/ saved script files for custom edits or batch edits
		• file_maps/ map files for both downloaded maps and custom maps
• image_index_*/ top folders, thumbnail folder, image index file		• image_index_*/ top folders, thumbnail folder, image index file
• image_table_maps/ saved image table maps		• image_table_maps/ saved image table maps
• markup/ saved text strings for markup->draw text		• markup/ saved text strings for markup->draw text
• mashup/ saved mashup project files		• mashup/ saved mashup project files
• palettes color palettes used by the Dither function		• palettes color palettes used by the Dither function
• patterns/ saved background patterns		• patterns/ saved background patterns
• printer_color/ saved printer color calibration files		• printer_color/ saved printer color calibration files
• retouch/ saved settings for the Retouch function		• retouch/ saved settings for the Retouch function
• saved_areas/ "cutout" files saved from the Select Area > Save d ialog		• saved_areas/ "cutout" files saved from the Select Area > Save d ialog
• saved_curves/ saved node points for saved edit curves (e.g. reto uch)		• saved_curves/ saved node points for saved edit curves (e.g. reto uch)
• search_images/ saved settings for the Search Images function		• saved_searches/ saved settings for the Search Images function
• slideshows/ user settings from Slide Show function		• slideshows/ user settings from Slide Show function
• slideshow_trans/ saved slide show transition parameters		• slideshow_trans/ saved slide show transition parameters
• temp/ temporary files for current sessions (can be more
than 1)
• thumbnails/ thumbnail files (default location, user can change
this)
• file_maps/ map files for both downloaded maps and custom maps
• blacklist list of files with internal errors - not usable by Fotoxx		• blacklist list of files with internal errors - not usable by Fotoxx
• bookmarks bookmark names and image file locations		• bookmarks bookmark names and image file locations
		• capskeys metadata keys for captions shown at top of image
• colorwheel.jpg color selection palette for Paint Image function		• colorwheel.jpg color selection palette for Paint Image function
• custom_menu list of functions included in custom user menu		• custom_menu list of functions included in custom user menu
• gallery_memory saved sort order and position for gallery windows		• gallery_memory saved sort order and position for gallery windows
• KB-shortcuts_* user-defined or modified keyboard shortcuts		• image_folders list of top image folders
		• KB-shortcuts_* user-defined keyboard shortcuts
• logfile outputs that may be relevant for diagnosing proble ms		• logfile outputs that may be relevant for diagnosing proble ms
• meta_picklist_* metadata key names for GUI pick lists		• meta_picklist_* metadata key names for GUI pick lists
• meta_report_items list of metadata items reported by Batch Report Me ta		• meta_report_items list of metadata items reported by Batch Report Me ta
• meta_view_extra extra custom items for the metadata short report		• meta_view_extra extra custom items for the metadata short report
• netmap_locations saved locations in net map view		• netmap_locations saved locations in net map view
• pagesetup saves page setup data for print function		• pagesetup saves page setup data for print function
• parameters setup parameters that are saved across Fotoxx sess ions		• parameters setup parameters that are saved across Fotoxx sess ions
• plugins saves the plugins menu contents		• plugins saves the plugins menu contents
• popup_text collection of special characters for text widget i nputs		• popup_text collection of special characters for text widget i nputs
• printsettings saves print settings data for print function		• printsettings saves print settings data for print function
• README text file - how to install Fotoxx from source tarb all		• README text file - how to install Fotoxx from source tarb all
• recent_files list of the last 1000 files opened by Fotoxx		• recent_files list of the last 1000 files opened by Fotoxx
• recent_topics recent topics seen in the user guide (for quick re ference)		• recent_topics recent topics seen in the user guide (for quick re ference)
		• search_results output of image search function, list of image fil es
• slideshow-tone.oga a short music tone for slide show		• slideshow-tone.oga a short music tone for slide show
• tags_defined list of all categories and tags currently in use		• tags_defined list of all categories and tags currently in use
		• temp/ temporary files for current sessions (can be more
		than 1)
		• thumbnails/ thumbnail files (default location, user can change
		this)
• userguide text file copy of user guide without images		• userguide text file copy of user guide without images
• wallpaper fotoxx wallpaper tool - last used wallpaper file		• wallpaper fotoxx wallpaper tool - last used wallpaper file
• widgets.css styling changes to standard GTK widgets		• widgets.css styling changes to standard GTK widgets
• zdialog_geometry saved dialog window positions (relative to main wi ndow)		• zdialog_geometry saved dialog window positions (relative to main wi ndow)
• zdialog_inputs saved dialog data for dialogs that recall prior in puts		• zdialog_inputs saved dialog data for dialogs that recall prior in puts
\bMetadata used by Fotoxx		\bMetadata used by Fotoxx
The following metadata items (stored inside the image files) are used by Foto xx. These		The following metadata items (stored inside the image files) are used by Foto xx. These
items (and any other metadata) can be viewed or edited using Fotoxx. Images c an be		items (and any other metadata) can be viewed or edited using Fotoxx. Images c an be
searched using these items (or any other metadata) as selection criteria. Tho se marked		searched using these items (or any other metadata) as selection criteria. Tho se marked
skipping to change at line 6431		skipping to change at line 6442
\bQuestions, Problems, Bugs		\bQuestions, Problems, Bugs
If you have a question or a problem, you may contact me: mkornelix@gmail.com.		If you have a question or a problem, you may contact me: mkornelix@gmail.com.
If you get a crash with a traceback dump (zappcrash file), please send this t o me.		If you get a crash with a traceback dump (zappcrash file), please send this t o me.
Please explain how to produce the error, if you can.		Please explain how to produce the error, if you can.
\bFotoxx for Microsoft Windows 11		\bFotoxx for Microsoft Windows 11
The starting point is Windows with WSL2 and some Linux flavor installed (e.g. Ubuntu).		The starting point is Windows with WSL2 and some Linux flavor installed (e.g. Ubuntu).
This is done entirely within Windows. Instructions for installing Fotoxx can be found		This is done entirely within Windows. Instructions for installing Fotoxx can be found
here: \_https://kornelix.net/fotoxx_topics/win11/install.html.		here: \_https://kornelix.net/fotoxx_topics/win11/install.html.
Fotoxx on Windows 11 is usable with limitations. Performance is very slow for startup,		Fotoxx on Windows 11 is usable with limitations. Performance is very slow for startup,
indexing, gallery display, and image search. Image edit functions, which are CPU bound,		indexing, gallery display, and image search. Image edit functions, which are CPU bound,
run about as fast on Windows/WSL2 as on Linux. The problem is that file manag		run about as fast as on native Linux. The Windows NTFS file system is much sl
ement and		ower than
I/O operations run much slower on Windows NTFS compared to Linux EXT4. More i		the Linux ext4 file system. If you use the Linux file system included in WSL2
nformation		, the
is available in the above link.		performance will be good, but these files are not accessible from Windows. Mo
		re
		information is available in the above link.
\bAcknowledgements		\bAcknowledgements
Several edit methods were adapted from "Introduction to Image Processing and Analysis"		Several edit methods were adapted from "Introduction to Image Processing and Analysis"
by Russ and Russ. Other libraries and utilities used by Fotoxx include libgtk , libjpeg,		by Russ and Russ. Other libraries and utilities used by Fotoxx include libgtk , libjpeg,
libtiff, libpng, libchamplain, liblcms, dcraw, exiftool, and many others avai lable in		libtiff, libpng, libchamplain, liblcms, dcraw, exiftool, and many others avai lable in
Gnu/Linux. Development was started in 2008. Many users have contributed ideas and help		Gnu/Linux. Development was started in 2008. Many users have contributed ideas and help
with testing and debugging. As of 2022 Fotoxx has about 115K lines of C/C++ c ode.		with testing and debugging. As of 2023 Fotoxx has about 115K lines of C/C++ c ode.
The primary author is Michael Cornelison.		The primary author is Michael Cornelison.
ALL TOPICS INDEX		ALL TOPICS INDEX
\>ADD NOISE\> - add random noise to an image		\>ADD NOISE\> - add random noise to an image
\>ADD SUBFOLDER\> - add new subfolder to existing image folder		\>ADD SUBFOLDER\> - add new subfolder to existing image folder
\>ADJUST HSL\> - select and change colors using HSL colors		\>ADJUST HSL\> - select and change colors using HSL colors
\>ADJUST RGB\> - adjust image colors using RGB or CMY colors		\>ADJUST RGB\> - adjust image colors using RGB or CMY colors
\>ALBUM MASS UPDATE\> utilities for mass update of multiple album files		\>ALBUM MASS UPDATE\> utilities for mass update of multiple album files
\>ALIEN COLORS\> - add random strange colors to an image		\>ALIEN COLORS\> - add random strange colors to an image
\>ALL FOLDERS\> - show all image file folders in a tree structure		\>ALL FOLDERS\> - show all image file folders in a tree structure
End of changes. 33 change blocks.
78 lines changed or deleted		93 lines changed or added

---