Appendix

This page is available in

Appendix

AVS Image Converter XML Formatting

Example of AVSImageConverterPro.xml file for conversion to PNG:

<?xml  version="1.0"  encoding="utf-8"?>
<conversion fileFormat="PNG">
   <inputFiles>
      <file>..\Examples\imagefile1.jpg</file>
      <file>D:\Pictures\imagefile2.jpg</file>
   </inputFiles>
   <inputFolders>
      <folder></folder>
      <filter>*.jpg</filter>
      <includeSubfolders>false</includeSubfolders>
   </inputFolders>
   <outputFolder>%MYDOCUMENTS%\AVS4YOU\AVSImageConverter</outputFolder>
   <formatSettings>
      <jpeg>
         <quality>95</quality>
      </jpeg>
      <pdf>
         <pageFormat>1</pageFormat>
         <inOneDocument>false</inOneDocument>
         <fileName>Untitled</fileName>
      </pdf>
      <gif>
         <animated>true</animated>
         <fileName>Untitled</fileName>
         <frameDurationMs>100</frameDurationMs>
      </gif>
      <png>
         <animated>false</animated>
         <fileName>Untitled</fileName>
         <frameDurationMs>100</frameDurationMs>
      </png>
      <tiff>
         <compress>true</compress>
         <inOneDocument>true</inOneDocument>
         <fileName>Untitled</fileName>
      </tiff>
   </formatSettings>
   <resize>
      <profiles>ResizeProfile</profiles>
      <GUID></GUID>
   </resize>
   <rename>
      <profiles>NameProfile</profiles>
      <GUID></GUID>
   </rename>
   <corrections>
      <useAdvanced>false</useAdvanced>
      <basic>
         <effectNumber>0</effectNumber>
      </basic>
      <advanced>
         <brightness>
            <auto>false</auto>
            <value>0</value>
         </brightness>
         <contrast>
            <auto>false</auto>
            <value>0</value>
         </contrast>
         <temperature>
            <auto>false</auto>
            <value>0</value>
         </temperature>
         <blur-sharpen>
            <value>0</value>
         </blur-sharpen>
         <effects>
            <effect>0</effect>
         </effects>
         <texture>
            <mask>0</mask>
         </texture>
      </advanced>
   </corrections>
   <watermark>
      <profiles>UserWatermarkProfile</profiles>
      <GUID></GUID>
   </watermark>
   <saveFileDateTime>false</saveFileDateTime>
   <autostartConversion>true</autostartConversion>
   <minimizeForm>false</minimizeForm>
   <replaceFileAndDir>true</replaceFileAndDir>
   <priority>3</priority>
   <finalAction>2</finalAction>
   <openOutputFolder>true</openOutputFolder>
</conversion>

The following tags and their parameters are available for AVS Image Converter XML syntax:

conversion

The main output file parameters:

fileFormat - output format: JPEG, PDF, GIF, PNG, TIFF, BMP, TGA, RAS.

<conversion fileFormat="PNG">
</conversion>

[Back to Top]

conversion > inputFiles > file

The path to the input file(s).

<conversion fileFormat="PNG">
   <inputFiles>
      <file>D:\Pictures\imagefile1.jpg</file>
      <file>D:\Pictures\imagefile2.jpg</file>
   </inputFiles>
</conversion>

[Back to Top]

conversion > inputFolders

The path to the folder for the input file(s). The following subcategories are available here:

inputFolders > folder - the path to the folder where the input files are placed.
inputFolders > filter - the mask of the input files to be converted separated with semicolon.
inputFolders > includeSubfolders - either include the subfolders or not (possible values: true/false or 1/0).

<conversion fileFormat="PNG">
   <inputFolders>
      <folder>D:\Video\</folder>
      <filter>*.jpg</filter>
      <includeSubfolders>false</includeSubfolders>
   </inputFolders>
</conversion>

[Back to Top]

conversion > outputFolder

The path to the folder for the output file(s).

<conversion fileFormat="PNG">
   <outputFolder>D:\Pictures</outputFolder>
</conversion>

[Back to Top]

conversion > formatSettings

Parameters for conversion of files to various image formats. The following subcategories are available here:

formatSettings > jpeg > quality - output JPEG image file quality (possible values: 1-100 percentage range).

<conversion fileFormat="JPEG">
   <formatSettings>
      <jpeg>
         <quality>95</quality>
      </jpeg>
   </formatSettings>
</conversion>

formatSettings > pdf > pageFormat - page size (possible values: 0 - by image size (use resize settings), 1 - A5 148x210 mm, 2 - A4 210x297 mm, 3 - A3 297x420 mm, 4 - A2 420x594 mm, 5 - Letter 8.5x11 inch (ANSI A), 6 - Legal 8.5x14 inch, 7 - Ledger 17x11 inch (ANSI B), 8 - Tabloid 11x17 inch (ANSI B), 9 - Tabloid 17x22 inch (ANSI C)).
formatSettings > pdf > inOneDocument - create a multi-page document and save all images into one file or not (possible values: true/false or 1/0).
formatSettings > pdf > fileName - multi-page document file name.

<conversion fileFormat="PDF">
   <formatSettings>
      <pdf>
         <pageFormat>1</pageFormat>
         <inOneDocument>false</inOneDocument>
         <fileName>Untitled</fileName>
      </pdf>
   </formatSettings>
</conversion>

formatSettings > gif > animated - save all images into one animated GIF file (possible values: true/false or 1/0).
formatSettings > gif > fileName - animated GIF file name.
formatSettings > gif > frameDurationMs - animated GIF frame duration (possible values: 100-60000).

<conversion fileFormat="GIF">
   <formatSettings>
      <gif>
         <animated>true</animated>
         <fileName>Untitled</fileName>
         <frameDurationMs>100</frameDurationMs>
      </gif>
   </formatSettings>
</conversion>

formatSettings > png > animated - save all images into one animated PNG file (possible values: true/false or 1/0).
formatSettings > png > fileName - animated PNG file name.
formatSettings > png > frameDurationMs - animated PNG frame duration (possible values: 100-60000).

<conversion fileFormat="PNG">
   <formatSettings>
      <png>
         <animated>false</animated>
         <fileName>Untitled</fileName>
         <frameDurationMs>100</frameDurationMs>
      </png>
   </formatSettings>
</conversion>

formatSettings > tiff > compress - either apply LZW compression to the output image file or not (possible values: true/false or 1/0).
formatSettings > tiff > inOneDocument - create a multi-page document and save all images into one file or not (possible values: true/false or 1/0).
formatSettings > tiff > fileName - multi-page document file name.

<conversion fileFormat="TIFF">
   <formatSettings>
      <tiff>
         <compress>true</compress>
         <inOneDocument>true</inOneDocument>
         <fileName>Untitled</fileName>
      </tiff>
   </formatSettings>
</conversion>

[Back to Top]

conversion > resize

Image resize parameters:

profiles - name of the XML file without extension with resize profiles (ResizeProfile or UserResizeProfile) which can be found in the %%Program Files%\AVSImageConverterPro\ folder.
GUID - GUID of the needed profile taken from the profiles XML file.

<conversion fileFormat="PNG">
   <resize>
      <profiles>ResizeProfile</profiles>
      <GUID></GUID>
   </resize>
</conversion>

[Back to Top]

conversion > rename

Image rename parameters:

profiles - name of the XML file without extension with rename profiles (NameProfile or UserNameProfile) which can be found in the %%Program Files%\AVSImageConverterPro\ folder.
GUID - GUID of the needed profile taken from the profiles XML file.

<conversion fileFormat="PNG">
   <rename>
      <profiles>NameProfile</profiles>
      <GUID></GUID>
   </rename>
</conversion>

[Back to Top]

conversion > corrections > advanced

corrections > useAdvanced - either use advanced image correction effects or not (possible values: true/false or 1/0).
Note: setting 0 or false here will enable basic corrections.
brightness > auto - either use automatic brightness correction or not (possible values: true/false or 1/0).
brightness > value - brightness correction value (possible values: -100-100).
contrast > auto - either use automatic contrast correction or not (possible values: true/false or 1/0).
contrast > value - contrast correction value (possible values: -100-100).
temperature > auto - either use automatic temperature correction or not (possible values: true/false or 1/0).
temperature > value - temperature correction value (possible values: -100-100).
blur-sharpen > value - blur/sharpen correction value (possible values: -100-0 for blur or 0-100 for sharpen).
effects > effect - the effect number to be applied (possible values: 0 - original photo, 1 - autolevels, 2 - sepia, 3 - black and white, 4 - old photo, 5 - positive/negative, 6 - noise, 7 - anaglyph 3D red-cyan (standard), 8 - anaglyph 3D red-cyan (advanced), 9 - anaglyph 3D yellow-blue).
texture > mask - the mask number to be applied (possible values: 0 - none, 1 - random, 2 - mask 1, 3 - mask 2, 4 - mask 3, 5 - mask 4, 6 - mask 5, 7 - mask 6).

<conversion fileFormat="PNG">
   <corrections>
      <useAdvanced>false</useAdvanced>
      <advanced>
         <brightness>
            <auto>false</auto>
            <value>0</value>
         </brightness>
         <contrast>
            <auto>false</auto>
            <value>0</value>
         </contrast>
         <temperature>
            <auto>false</auto>
            <value>0</value>
         </temperature>
         <blur-sharpen>
            <value>0</value>
         </blur-sharpen>
         <effects>
            <effect>0</effect>
         </effects>
         <texture>
            <mask>0</mask>
         </texture>
      </advanced>
   </corrections>
</conversion>

[Back to Top]

conversion > corrections > basic > effectNumber

Number of the basic effect applied to the input image (possible values: 0 for original photo, 1 - 23 for the effects from the Basic Corrections panel).

<conversion fileFormat="PNG">
   <corrections>
      <basic>
         <effectNumber>0</effectNumber>
      </basic>
   </corrections>
</conversion>

[Back to Top]

conversion > watermark

Image watermark parameters:

profiles - name of the XML file without extension with watermark profiles (WatermarkProfile or UserWatermarkProfile) which can be found in the %%Program Files%\AVSImageConverterPro\ folder.
GUID - GUID of the needed profile taken from the profiles XML file.

<conversion fileFormat="PNG">
   <watermark>
      <profiles>UserWatermarkProfile</profiles>
      <GUID></GUID>
   </watermark>
</conversion>

[Back to Top]

conversion > saveFileDateTime

Either save the file modification date and time not (possible values: true/false or 1/0).

<conversion profiles="mp4profiles" name="PC - Standard Quality" GUID="e480ed40-f9bc-433d-9cef-c0c06a4d718d">
   <saveFileDateTime>false</saveFileDateTime>
</conversion>

[Back to Top]

conversion > autostartConversion

Either automatically start the conversion at the program startup or not (possible values: true/false or 1/0).

<conversion fileFormat="PNG">
   <autostartConversion>true</autostartConversion>
</conversion>

[Back to Top]

conversion > minimizeForm

Either minimize the application window to taskbar at the program startup or not (possible values: true/false or 1/0).

Note: this parameter is ignored if the autostartConversion is set to false.

<conversion fileFormat="PNG">
   <minimizeForm>false</minimizeForm>
</conversion>

[Back to Top]

conversion > replaceFileAndDir

Either automatically permit the program to replace files and folders in the output folder without the warning dialog or not (possible values: true/false or 1/0).

<conversion fileFormat="PNG">
   <replaceFileAndDir>true</replaceFileAndDir>
</conversion>

[Back to Top]

conversion > priority

Priority of threads in process (possible values: 1 - highest, 2 - above normal, 3 - normal, 4 - below normal).

<conversion fileFormat="PNG">
   <priority>3</priority>
</conversion>

[Back to Top]

conversion > finalAction

The application behavior after the conversion is finished (possible values: 1 - do nothing, 2 - close application, 3 - shutdown PC).

<conversion fileFormat="PNG">
   <finalAction>2</finalAction>
</conversion>

[Back to Top]

conversion > openOutputFolder

Either automatically open the folder containing output files upon the conversion end or not (possible values: true/false or 1/0).

<conversion fileFormat="PNG">
   <openOutputFolder>true</openOutputFolder>
</conversion>

[Back to Top]