Image Surfer Pro Toolbar

File Button ISP Form Button Process Page Button View Button Tools Button Info Button Auto Range Override Direct URL Entry File Button ISP Form Button Process Page Button View Button Tools Button Info Button File Button ISP Form Button Process Page Button View Button Tools Button Info Button Auto Range Override Visualize Auto Range Modify Optimize Organize Cut/Copy/Paste Split Rollup Insert & Delete Nudging
Image Surfer Pro with Auto Range Overright input highlighted

Toolbar Extension:
Auto Range Override

The Auto Ranging Override toolbar extension is a text edit control which appears on the primary Image Surfer Pro toolbar just to the right of the Information Button

It allows you to override a couple of user preferences which may need to change frequently if you are building fusker collections from multiple sources. The following configurations in the Auto Ranging Configuration maybe overridden by changing the value in this :

Enabling The Override

You may use the {Show Auto Range Override at start up} configuration on the General tab of the Tools & Settings button from the Image Surfer Pro toolbar User's Preferences to assure this control is visible each time a new Image Surfer Pro window is created.

You may mannually enable and disable this extension through the Toolbars submenu from the Tools & Settings button from the Image Surfer Pro toolbar button. When the edit control is on the Image Surfer Pro toolbar, the user configurations are overriden by its value. If Auto Range Override is not on the toolbar it will have no effect.

Changing the value of the Auto Ranging Override does not change your user preferences and if the extension is not active has no affect on how those configurations are applied.

This extension to Image Surfer Pro is of great use when you are adding multiple pictorials to your fusker collection which are numerically fuseked but have different image counts.

Auto range when adding to the collection

This user configuration may be overridden by the Auto Range Override toolbar extension. If the Auto Range Override entry is blank, then {Auto range when adding to the collection} is essentially turned off regardless of the actual user configuration. Likewise, if the Auto Range Override entry is not blank then {Auto range when adding to the collection} is essentially turned on regardless of the actual user configuration.

Size of Range

The value in the Auto Range Override toolbar extension takes the place of this user configuration as long as the toolbar extension is visible on the Image Surfer Pro Toolbar. Changing the Auto Range Override value however does not change the {Size of range} user configuration.

The Auto Ranging Process

In the following discussion 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.

When chosen in the Fusker Tree Menu, auto ranging is always applied to the current segment selection in the fusker collection. If the selected segment is already fusked or is not a directory or file segment the Auto Range option will not be enabled.

Auto ranging is also applied when individual file references are added with either the Process webpage icon from the Image Surfer Pro toolbar button or the URL Capture Bar. In these cases it is applied to the last segment of the URL being added on if {Auto range when adding to the Collection} is enabled.

Files added through Process webpage icon from Image Surver Pro toolbar processing of a hosted gallery page, Image Surfer Pro Form, or during a Directed Search are not Auto Ranged.

Auto ranging consists of applying the following steps to the selected segment:

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). For file segments any file extenion is ignored (such as .mp4). 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, adjacent characters in the string which are also numeric digits are grouped into a substring. The text after the substring is placed in the segment's Post Text field while the text before the substring is placed in the segment's Pre Text field. The number of digits in the substring will be used as # of Digits in the numeric fusk. 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

For 2012_images_020.jpg Pre-Text=2012_images_ Post-Text=.jpg Value=20 size=3

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.

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.

Example:

For example using the sample image file name above and the following configurations will result in the different 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).

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.

Related User Preferences:

Image of User Preferences Dialog with the General tab selected - Toolbar Selection highlighted Image of User Preferences Dialog with the Processing tab selected - portion of Auto Ranging configuration block highlighted Image of User Preferences Dialog with the Processing tab selected - nothing highlighted Image of User Preferences Dialog with the Views tab selected - nothing highlighted
Image of User Preferences Dialog with the Images tab selected - nothing highlighted Image of User Preferences Dialog with the Videos tab selected - nothing highlighted Image of User Preferences Dialog with the Frames tab selected - nothing highlighted Image of User Preferences Dialog with the Pages tab selected - nothing highlighted


General Tab: Tool Bars
The Auto Range Override and URL Capture Bar will be visible by default in newly opened Image Surfer Pro windows based on the {Show Auto Range Override at start up} and {Show URL Capture Bar at startup up} configurations.

Processing Tab: Auto Range
The {Auto range when adding to the collection} and {Size of range} inputs in the Auto Ranging Configuration of your User Configuration are overridden by the value of the Auto Range Override toolbar extension when the extension is enabled.

Differences in Free and Full Versions

There are no differences in how the free and full versions of the Image Surfer Pro software utilizes the Auto Range Override interface.

Screen Capture Examples

Sample screen capture after using Auto Range Override and Processing

A short example of using the Auto Range Override interface to override the user configurations when when using the Process Page button from Image Surver Pro toolbar button.