ImageGeneric
Purpose
The ImageGeneric app calls a 3rdparty application to process all images dragged to one of its tiles. The tile's configuration specififes how the 3rdparty application gets its parameters and in which filename the result is stored.
Using the ImageGeneric app you have a powerful tool in your hands to bind in all command line oriented 3rdparty imaging applications into the TooLine.
Configuration
The general configuration handling is described here.
| Property | Description |
|---|---|
| Application | The application to be started. The full path and application name must be specified. |
| Command Line | The command line of the application. Use {1} to insert the current filename, see documentation below for more information. |
| Result File Name | The result filename. Use {1} to insert the input file name, see documentation below for more information. |
| Sample Command Line | Sample command line with expanded variables. The used file name is "C:\temp\sample.png". The file will only used "virtual" so the path and the file must not exists. |
| Sample Result File Name | Sample result file path and -name with expanded variables. The used file name is "C:\temp\sample.png". The file will only used "virtual" so the path and the file must not exists. The value turns red in case of the output file is not created from the 3rdparty application as specified. |
Command line parameters
The command line and result file properties are using built-in functions to disassemble and assemble file paths and -names. All functions are working on parameters or strings. The used syntax is the following:
Syntax:
{<variable>|<string>[:<function>][, <parameter-1>, ..., <parameter-n>]}
Note:
Only one variable is allowed: the "1" which is containing the file name of the image dragged to the tile.
| Function | Parameters | Description | Sample |
|---|---|---|---|
| substring | startIndex, length | Retrieves a substring from the given string. The substring starts at a specified character position (0 ist the first position) and has a specified length. |
{'Hello':substring,1,2} => el {'Hello':substring,1,9} => ello {'Hello':substring,1} => ello |
| left | length | Retrieves a substring from the given string. The substring starts at the position 0 and has a specified length. If the original string is shorter than the given length the whole string is being returned. |
{'Hello':left,3} => Hel {'Hello':left,9} => Hello |
| right | length | Retrieves a substring from the given string. The length n chars from the end of the strings are returned. If the original string is shorter than the given length the whole string is being returned. |
{'Hello':right,2} => llo {'Hello':right,9} => Hello |
| trim | trim | Removes all leading and trailing white-space characters from the given string. | {' Hello ':trim} => Hello |
| length | Retrieves the length of the given string. | {'Hello':length} => 5 | |
| indexOf | stringToSearch | Reports the zero-based index of the first occurrence of the specified string in the given string. | {'Hello':indexOf,'l'} => 2 |
| regex | input, replacement | Replaces all occurrences of a specified regular expression pattern with a replacement string, starting at the first character in the input string. | {'Hello':regex,'l.','nn'} => Henno |
| name | filepath | Retrieves the filename (without the filepath and without the extension) from the given string. | {'\temp\Hello.png':name} => Hello |
| nameExt | filepath | Retrieves the filename and extension (without the filepath) from the given string. | {'\temp\Hello.png':nameExt} => Hello.png |
| ext | filepath | Retrieves the extension (without the filename) from the given string. The extension includes the leading ".". | {'\temp\Hello.png':ext} => .png |
| path | filepath | Retrieves the filepath (without the filename and the file extension) from the given string. The path ends not with the path seperator "\". | {'\temp\Hello.png':path} => \temp |
samples
The following examples gives you an impression, how the configuration settings will influence the image processing.
sample 1
The used 3rdparty application takes the parameter without change. The result file name is the input file name with a "-400" before the fix extension ".jpg". So we need to get the original file path and the name and add a fixe "-400.jpg" at the end.
sample 2
The used 3rdparty application takes the parameter without change. The result file name is the input file name with a "-800" before the fix extension ".jpg". So we need to get the original file path and the name and add a fixe "-800.jpg" at the end.
