Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision Next revision Both sides next revision | ||
|
stacker:support:knownissues [2020/03/04 23:32] rjlittlefield |
stacker:support:knownissues [2020/09/21 21:13] rjlittlefield [Zerene Stacker Known Issues] add periods for consistent formatting |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| ~~NOTOC~~ | ~~NOTOC~~ | ||
| - | ====== Zerene Stacker Known Issues ====== | + | ===== Zerene Stacker Known Issues ===== |
| Known Issues is a list of unusual problems that can be quite challenging to diagnose and solve from scratch. We keep this list mainly for our own use in providing support, but we're making it publicly available in case it may be useful to other people also. | Known Issues is a list of unusual problems that can be quite challenging to diagnose and solve from scratch. We keep this list mainly for our own use in providing support, but we're making it publicly available in case it may be useful to other people also. | ||
| Line 9: | Line 9: | ||
| * [[#license_keys_that_contain_accented_or_non-english_characters_may_get_corrupted_in_email_transmission|License keys that contain accented or non-English characters may get corrupted in email transmission.]] | * [[#license_keys_that_contain_accented_or_non-english_characters_may_get_corrupted_in_email_transmission|License keys that contain accented or non-English characters may get corrupted in email transmission.]] | ||
| - | * [[#settings_are_retained_across_uninstall_reinstall|Settings are retained across uninstall / reinstall.]] | + | * [[#settings_are_retained_across_uninstallreinstall|Settings are retained across uninstall/reinstall.]] |
| * [[#license_key_must_be_installed_for_each_user_account|License key must be installed for each user account.]] | * [[#license_key_must_be_installed_for_each_user_account|License key must be installed for each user account.]] | ||
| - | * [[#bit_tiff_files_should_be_uncompressed|16-bit TIFF files should be uncompressed]] | + | * [[#bit_tiff_files_should_be_uncompressed|16-bit TIFF files should be uncompressed.]] |
| * [[#certain_grayscale_images_may_cause_incompatible_colormodel|Certain grayscale images may cause "incompatible ColorModel".]] | * [[#certain_grayscale_images_may_cause_incompatible_colormodel|Certain grayscale images may cause "incompatible ColorModel".]] | ||
| * [[#zonealarm_toolbar_may_significantly_reduce_available_memory|ZoneAlarm Toolbar may significantly reduce available memory.]] | * [[#zonealarm_toolbar_may_significantly_reduce_available_memory|ZoneAlarm Toolbar may significantly reduce available memory.]] | ||
| Line 17: | Line 17: | ||
| * [[#to_process_large_images_at_full_resolution_you_must_increase_the_memory_allocation_above_the_default_values|To process large images at full resolution, you must increase the memory allocation above the default values.]] | * [[#to_process_large_images_at_full_resolution_you_must_increase_the_memory_allocation_above_the_default_values|To process large images at full resolution, you must increase the memory allocation above the default values.]] | ||
| * [[#continuous_backup_or_indexing_may_interfere_with_image_caching|Continuous backup or indexing may interfere with image caching.]] | * [[#continuous_backup_or_indexing_may_interfere_with_image_caching|Continuous backup or indexing may interfere with image caching.]] | ||
| - | * [[#must_use_double-click_not_the_open_button_to_navigate_into_a_folder_when_using_file_open_project|Must use double-click, not the Open button, to navigate into a folder when using File > Open Project]] | + | * [[#must_use_double-click_not_the_open_button_to_navigate_into_a_folder_when_using_file_open_project|Must use double-click, not the Open button, to navigate into a folder when using File > Open Project .]] |
| * [[#windows_my_documents_and_my_pictures_may_not_be_writable|Windows, "My Documents" and "My Pictures" may not be writable.]] | * [[#windows_my_documents_and_my_pictures_may_not_be_writable|Windows, "My Documents" and "My Pictures" may not be writable.]] | ||
| * [[#windows_cannot_navigate_through_a_shortcut|Windows, cannot navigate through a shortcut.]] | * [[#windows_cannot_navigate_through_a_shortcut|Windows, cannot navigate through a shortcut.]] | ||
| - | * [[#windows_manually_edited_program_files_persist_across_re-installation|Windows, manually edited program files persist across re-installation]] | + | * [[#windows_manually_edited_program_files_persist_across_re-installation|Windows, manually edited program files persist across re-installation.]] |
| - | * [[#macintosh_os_x_could_not_establish_communications_with_stackshot_controller|Macintosh OS X, "Could not establish communications with StackShot controller"]] | + | * [[#macintosh_os_x_could_not_establish_communications_with_stackshot_controller|Macintosh OS X, "Could not establish communications with StackShot controller".]] |
| - | * [[#macintosh_os_x_zerene_stacker_will_work_on_only_one_stack_at_a_time|Macintosh OS X, Zerene Stacker will work on only one stack at a time]] | + | * [[#macintosh_os_x_zerene_stacker_will_work_on_only_one_stack_at_a_time|Macintosh OS X, Zerene Stacker will work on only one stack at a time.]] |
| - | * [[#macintosh_os_x_mountain_lion_reports_installation_bundle_is_damaged_move_to_trash|Macintosh OS X (Mountain Lion) reports installation bundle is "damaged, move to trash"]] | + | * [[#macintosh_os_x_mountain_lion_reports_installation_bundle_is_damaged_move_to_trash|Macintosh OS X (Mountain Lion) reports installation bundle is "damaged, move to trash".]] |
| * [[#macintosh_os_x_how_to_recover_from_excessive_memory_allocation|Macintosh OS X, how to recover from excessive memory allocation.]] | * [[#macintosh_os_x_how_to_recover_from_excessive_memory_allocation|Macintosh OS X, how to recover from excessive memory allocation.]] | ||
| * [[#macintosh_os_x_tiff_files_may_be_very_slow_to_read|Macintosh OS X, TIFF files may be very slow to read.]] | * [[#macintosh_os_x_tiff_files_may_be_very_slow_to_read|Macintosh OS X, TIFF files may be very slow to read.]] | ||
| Line 35: | Line 35: | ||
| * [[#red_rasterformatexception_occurs_during_retouching|Red "RasterFormatException" occurs during retouching.]] | * [[#red_rasterformatexception_occurs_during_retouching|Red "RasterFormatException" occurs during retouching.]] | ||
| * [[#graphics_acceleration_sometimes_makes_the_retouching_brush_very_slow_and_jerky|Graphics "acceleration" sometimes makes the retouching brush very slow and jerky.]] | * [[#graphics_acceleration_sometimes_makes_the_retouching_brush_very_slow_and_jerky|Graphics "acceleration" sometimes makes the retouching brush very slow and jerky.]] | ||
| - | * [[#retouching_brush_disappears|Retouching brush disappears]] | + | * [[#retouching_brush_disappears|Retouching brush disappears.]] |
| * [[#external_tiff_reader_cannot_handle_commas_in_file_or_directory_names|External TIFF reader cannot handle commas in file or directory names.]] | * [[#external_tiff_reader_cannot_handle_commas_in_file_or_directory_names|External TIFF reader cannot handle commas in file or directory names.]] | ||
| * [[#macintosh_os_x_the_downloaded_bundle_runs_once_but_not_again|Macintosh OS X, the downloaded bundle runs once but not again.]] | * [[#macintosh_os_x_the_downloaded_bundle_runs_once_but_not_again|Macintosh OS X, the downloaded bundle runs once but not again.]] | ||
| Line 46: | Line 46: | ||
| If that doesn't work, then please contact support@zerenesystems.com and we'll get the problem taken care of. | If that doesn't work, then please contact support@zerenesystems.com and we'll get the problem taken care of. | ||
| - | ===== Settings are retained across uninstall / reinstall ===== | + | ===== Settings are retained across uninstall/reinstall ===== |
| On **Windows**, the uninstaller program removes only folders and files that it created. This causes some state information to be retained, so that uninstall/reinstall will not restore the program to a factory-fresh condition. To get back to a factory-fresh condition, you must uninstall, then manually remove one folder and the files it contains, before reinstalling. | On **Windows**, the uninstaller program removes only folders and files that it created. This causes some state information to be retained, so that uninstall/reinstall will not restore the program to a factory-fresh condition. To get back to a factory-fresh condition, you must uninstall, then manually remove one folder and the files it contains, before reinstalling. | ||
| Line 60: | Line 60: | ||
| On Windows 10, usually it is not possible to open the Start > Run dialog. Instead, you can open a File Explorer window, then in that window's address bar, type in %APPDATA% and hit the Enter key. On some systems, it is also necessary to set the folder view options to "Show hidden files, folders, and drives". See for example [[http://www.windows10themes.net/guides/how-to-view-the-appdata-folder-in-windows-10/]] | On Windows 10, usually it is not possible to open the Start > Run dialog. Instead, you can open a File Explorer window, then in that window's address bar, type in %APPDATA% and hit the Enter key. On some systems, it is also necessary to set the folder view options to "Show hidden files, folders, and drives". See for example [[http://www.windows10themes.net/guides/how-to-view-the-appdata-folder-in-windows-10/]] | ||
| - | On **Macintosh OS X**, dragging the application bundle to the trash leaves behind some state information in other files and folders, so that reinstalling the program will not restore the program to a factory-fresh condition. To get back to a factory-fresh condition, you must manually remove one folder and the files it contains, before reinstalling. The folder you need to remove is ~/Library/Preferences/ZereneStacker, where ~ denotes your account's home directory. Note that the ~/Library folder is normally hidden. To open it, hold down your keyboard's Option (Alt) key while selecting Go > Library in a Finder window. Be careful that you do not remove other folders in ~/Library/Preferences, as these contain settings for other programs. | + | On **Macintosh OS X**, dragging the application bundle to the trash leaves behind some state information in other files and folders, so that reinstalling the program will not restore the program to a factory-fresh condition. To get back to a factory-fresh condition, you must manually remove one folder and the files it contains, before reinstalling. The folder you need to remove is ~/Library/Preferences/ZereneStacker, where ~ denotes your account's home directory. Note that the ~/Library folder is normally hidden. To open it, hold down your keyboard's Option (Alt) key while selecting Go > Library in a Finder window. Once you have the ~/Library folder, then find and go into the Preferences folder. From there, the ZereneStacker folder will be at the bottom of the list, or very close to it. Be careful that you do not remove other folders or files in ~/Library/Preferences, because these contain settings for other programs. |
| Note that removing ~/Library/Preferences/ZereneStacker will also uninstall your license key, so be sure you have a copy of that saved first. If you do not already have a separate copy of your license key, you can make one by running Zerene Stacker and extracting the key using copy/paste at Options > Registration. | Note that removing ~/Library/Preferences/ZereneStacker will also uninstall your license key, so be sure you have a copy of that saved first. If you do not already have a separate copy of your license key, you can make one by running Zerene Stacker and extracting the key using copy/paste at Options > Registration. | ||
| Line 151: | Line 151: | ||
| java.io.FileNotFoundException: C:\Users\Me\Pictures\unnamedZSproj20111103154858382\previewimages\-Unaligned-117.jpg (Access is denied) | java.io.FileNotFoundException: C:\Users\Me\Pictures\unnamedZSproj20111103154858382\previewimages\-Unaligned-117.jpg (Access is denied) | ||
| at java.io.RandomAccessFile.open(Native Method) | at java.io.RandomAccessFile.open(Native Method) | ||
| - | | + | |
| There are several possible workarounds for the problem: | There are several possible workarounds for the problem: | ||
| - Turn off or pause the backup or indexing facility while ZS is running. | - Turn off or pause the backup or indexing facility while ZS is running. | ||
| Line 277: | Line 277: | ||
| ===== Macintosh OS X, accessing external drives may be awkward ===== | ===== Macintosh OS X, accessing external drives may be awkward ===== | ||
| - | **Note:** In all recent versions, you can drag-and-drop directly onto the input files list. There is no need to File > Add Files to open a filechooser as described below. Just open a separate Finder window, select your image files there, then use drag-and-drop to enter them directly into Zerene Stacker's "Input Files" panel, at the place where it says "(Drop files or folders here to begin)". | + | On Macs, Zerene Stacker normally attempts to open a Finder window to use as a helper service for navigating and selecting files. On a few Macs, for unknown reasons, the Finder window refuses to open. In that case, Zerene Stacker automatically switches to a different method, using a facility named "JFileChooser" that is part of the Java Runtime Environment that Zerene Stacker runs on top of. (The use of JFileChooser can also be selected explicitly, by removing the checkmark at Options > Preferences > Look & Feel > "Use system native File Choosers if possible".) |
| - | + | ||
| - | Further explanation and other approaches follow. | + | |
| - | + | ||
| - | The JFileChooser that can be selected for use by Zerene Stacker does not display alternate volumes like the native Mac filechooser does. External drives can still be accessed, but the procedure is somewhat awkward. | + | |
| - | + | ||
| - | On OS X 10.5 (Leopard) and later, the easiest approach is to open a filechooser dialog box in Zerene Stacker, using File > Add Files. Then separately, use Finder to open the external drive or network share, go to the appropriate directory, and select the files of interest. Drag and drop those files onto the Add Files dialog of Zerene Stacker, then click the Add button in the Zerene Stacker dialog. This method also has the advantage of showing you a thumbnail preview of the files to be added. | + | |
| - | Alternatively (and required for OS X 10.4), you can go to the bar at the top of the window, the one where the current directory is shown. Click once on that bar and it will expand into a pull-down list of enclosing directories. At the bottom of the list will be an entry like "Macintosh HD", representing the main file system of the computer. Click that. Scroll to the bottom of the list and double-click on Volumes. That should give you a list of all your currently mounted media. Double-click on any external drive to open that, then navigate as usual. | + | Unfortunately the JFileChooser interface looks much different from Finder, and it requires more mouseclicks to access drives other than the default. |
| - | The latter approach is required on OS X 10.4 because drag-and-drop into the Zerene Stacker filechooser does not work on that system. | + | To access alternate drives using JFileChooser, proceed as follows: |
| + | - Open a JFileChooser window, for example by File > Add File(s) or File > Save Output Image(s). | ||
| + | - Go to the bar at the top of the window, the one where the current folder is shown. Click on that bar and it will expand into a pull-down list of enclosing folders. | ||
| + | - At the top or bottom of the list will be an entry like "/" or "Macintosh HD", representing the main file system of the computer. Click that to open it. | ||
| + | - Scroll to the bottom of the list and double-click on Volumes. That should open to give you a list of all your currently mounted media. | ||
| + | - Double-click on any external drive to open that, then navigate as usual. | ||
| ===== Macintosh OS X, launch fails due to Courier font problems ===== | ===== Macintosh OS X, launch fails due to Courier font problems ===== | ||