source: extensions/BuildPWGPicture/ReadMe.txt @ 3333

Fonctionnality:
===============
  From source directory, this tools allows you to build a ready structure for FTP transfer including thumbnails, normal, high definition pictures and index.php files.

  XnView must be installed.

  The +:
    - mass treatment
    - use of other line command program

Installation:
=============
  1: XnView version Complete (Plugins & NConvert) must be installed http://xnview.com/
  2: Copy filesBuildPWGPicture.cmd et BuildPWGPicture.Params.txt on your choice directory
  3: Modify default parameters on file fichier BuildPWGPicture.Params.txt
    => This 3 parameters must be correctly defined:
         o DirXnView
         o DirAlbum
         o DirFTP
       It's source and destination of build pictures
  4: Copy file index.php in DirAlbum directory.
     If exist file index.php in directory DirAlbum, this file will be copied in each directories.
     It's allow to not list files contained in a directory.

Usage:
======
  Syntax:
    - All directories: BuildPWGPicture [-options] [-ParFile <File Name>]
    - Selected Directory: BuildPWGPicture <Short Directory Name> [-DirDest <Full Directory Path>] [-options] [-ParFile <File Name>]
    - Selected Directories src/dest: BuildPWGPicture -DirSrc <Full Directory Path> -DirDest <Full Directory Path> [-options] [-ParFile <File Name>]

  Key:
    - <Short Directory Name> : Directory on Album directory
    - -DirSrc <Full Directory Path> : Source directory
      Override computed Album directory name
      Cannot be used with <Short Directory Name>
    - -DirDest <Full Directory Path> : Destination directory
      Override computed FTP directory name
    - [-options] can be composed of all parameters defined in BuildPWGPicture.Params.txt
      Override parameters defined in BuildPWGPicture.Params.txt
      Each option is composed with 2 line arguments -<parameter name> and <parameter value>
      Override before [-ParFile <File Name>]
    - [-ParFile <File Name>] : Full name of parameters file
      Override parameters defined in BuildPWGPicture.Params.txt
      Override after [-options]

  Examples:
    BuildPWGPicture 
    BuildPWGPicture -HDKeep N -TNQuality 70
    BuildPWGPicture 20050816
    BuildPWGPicture 20050816 -HDKeep N -TNQuality 70
    BuildPWGPicture 20050816 -DirDest c:\temp\FTP -HDKeep N -TNQuality 70
    BuildPWGPicture -DirSrc c:\temp\test -DirDest c:\temp\testII -HDKeep N -TNQuality 70

Overview:
=========
  Pictures are copied or converted by XnView to source directory from high destination directory.
  Pictures converted by XnView to high destination directory from "normal" destination directory.
  Pictures converted by XnView to high destination directory from thumbnail destination directory.
  index.php file are copied in all "FTP" directories, this file allow to avoid everybody to list contents.
  Pictures in high destination directory must be deleted (by default, pictures are not deleted).
  Different options of convertion or treatment are possible this execution of AddOn on each step.

Examples:
=========
  Source:
    F:.
    +---Album
    ¦   +---20040915
    ¦   +---rub

  Launch commandes:
    BuildPWGPicture.cmd rub
    BuildPWGPicture.cmd 20040915

  Destination:
    C:\DOCUMENTS AND SETTINGS\RUBEN\BUREAU\FTP
    +---rub
    ¦   +---pwg_high
    ¦   +---thumbnail
    +------20040915
    ¦   +---pwg_high
    ¦   +---thumbnail

Most simple use:
================
  o Have always the same directory "Album" and the same directory "FTP".
  o In other directory "MyImages", have sub-directories classified according to your choice
  o Make prior treatments (not possible with BuildPWGPicture) in this sub-directories
  o Copy this sub-directories in Album directory
  o Double-click on shortcut icone defined on the top
  o Launch script BuildPWGPicture.cmd on command line
  o All sub-directories in "FTP" directory are ready
  o Detele all sub-directories of "Album" directory

Example de AddOn:
=================
  - Remove EXIF:
      > Instal exiv2 http://www.exiv2.org/download.html
      > Create file HDAddOnFile.cmd in BuildPWGPicture directory
      > Add in file, this following line:
        C:\exiv2\exiv2.exe -d e %1\*.JPG