Fusker Collection View Menu:
Auto Range
The Auto Range option in the Image Surfer Pro Tree Menu attempts to reference similarly named directories or files on the image hosting server.
Through
you can configure
to auto range when a new image reference is added to the fusker collection – however, this will only auto range the image
file name (the final segment in the image reference).
The Auto Range menu option can be used on any directory or file segment in the tree. This option will look at the segment for the last group of numeric characters in the segment text and replace them with a suitable Fusk.
The Auto Ranging Process
Auto ranging is always applied to the current segment selection in the fusker collection. When adding a new
URL reference via
or the URL Capture Bar, the selection is set to the final
file or directory in the URL before Auto Ranging is applied. Auto ranging consists of applying the following
steps to the selected segment:
- Determine segment's numeric value and size information
- Determine the start of the numeric range
- Determine the end of the numeric range
- Create the segment fusk
Determining a segment's numeric value:
Image Surfer Pro reverse searches the entire text of the selected segment looking for a numeric digit (i.e. 0 through 9). If it does not find any numeric digits in the string then auto ranging can not be applied and the segment is unchanged.
When a digit is found, the text after the digit in the string is placed in the segment's Post Text field. Image Surfer Pro then searches for additional digits next to found digit in the rest of the text. The number of digits found will be used as # of Digits in the numeric fusk. The text preceding the string of digits is stored in the segment's Pre Text field. The numeric value of the segment is defined as the numeric value of the string of digits found.
If there are multiple strings of digits in the segment text, only the last string of digits is used. In order to fusk over both strings you must manually split the segment such that each split segment has one of the numeric strings.
For example
Determining the start of the numeric range:
The start value of the numeric fusk is chosen in one of three ways based on what is activated in the user configuration.
If {Always start with image number} is enabled the start value will be set to the value from the user configuration. This is useful if you know many of the image sequences you are collecting have the same starting number but you don't always have access directly to the first image in the sequence.
If neither {Always start with image number} nor {Search above and below added image} are selected then the numeric value of the segment will be used as the start value.
if {Search above and below added image} is enabled the value of {Size of Range} and {Auto add zero in possible range of references} are used to determine the start value. The start value will be the segment value minus one half of {Size of Range} unless the value would be less than 1. If the start value would be 0 or less and {Auto add zero in possible range of references} is enabled then start value will be set to 0, otherwise it will be set to 1.
For example using the sample image file name above and the following configurations will result in the differnet numerical fusks.
| 2012_images_020.jpg | |||
|---|---|---|---|
| Configuration | # of Digits | Start Value | End Value |
|
Size of Range = 17 Always start with image number {Disabled} Search Above and below added image {Disabled} |
3 | 20 | 36 |
|
Size of Range = 17 Always start with image number {Enabled} = 1 Search Above and below added image {Disabled} |
3 | 1 | 17 |
|
Size of Range = 17 Always start with image number {Disabled} Search above and below added image {Enabled} Auto add zero in possible range of references {Enabled} |
3 | 12 | 28 |
|
Size of Range = 25 Always start with image number {Disabled} Search above and below added image {Disabled} |
3 | 20 | 44 |
|
Size of Range = 25 Always start with image number {Enabled} = 10 Search above and below added image {Disabled} |
3 | 10 | 34 |
|
Size of Range = 25 Always start with image number {Disabled} Search above and below added image {Enabled} Auto add zero in possible range of references {Enabled} |
3 | 0 | 24 |
Search above and below added image} and {Always start with image number} can not both be enabled at the same time (selecting one will unselect the other).
Determining the end of the numeric range:
The end of the numeric range is always the start value plus {Size of Range} minus 1. This assures the numeric range contains exactly {Size of Range} values.
Creating the segment fusk:
The original text which contained the digits is removed and a Numeric Fusk is placed in the segment. The fusk will have {# of Digits} set to the segment's numeric size from step 1, {Start Value} set to the start value computed in step 2, and {End Value} set to the end value computed in step 3.
Remember the values of {Auto range when adding to the Collection} and {Size of Range} can be overridden by the use of the Auto Range Override toolbar extension.
