Powered by

Appendix
This page is available in English
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!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!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]

Please note that AVS4YOU programs do not allow you to copy protected material. You may use this software in copying material in which you own the copyright or have obtained permission to copy from the copyright owner.

AVS4YOU is a registered trademark of Online Media Technologies, Ltd., UK. Intel and Core 2 Duo are registered trademarks of Intel Corporation. AMD and Athlon X2 are registered trademarks of Advanced Micro Devices, Inc. Windows 10/8.1/8/7/XP/2003/Vista are registered trademarks of Microsoft Corporation. All other trademarks are the property of their respective owners.