home *** CD-ROM | disk | FTP | other *** search
/ Softwarová Záchrana 3 / Softwarova-zachrana-3.bin / Siren / Siren.exe / 1036 / HTML / 20021 next >
Text File  |  2004-03-10  |  20KB  |  583 lines
  1.  
  2.  Did you look at the "First Contact" option ?
  3.  Ok, let's go further.
  4.  
  5.  The main window is devided into two parts. The top one contains
  6.  the file list, the bottom one is used to display the image
  7.  associated to the active file.
  8.  
  9.  The aim of Siren is to rename files.
  10.  
  11.  Its guiding principle is the use of expressions.
  12.  
  13.  An expression can contain text and information specific to
  14.  each treated file.
  15.  Each of these information is used through a "variable".
  16.  
  17.  A variable must be prefixed by a '%'.
  18.  
  19.  They can be assembled into different groups.
  20.  
  21.  Don't be frightened by the quantity. Tools like the completion
  22.  window or the right click on a value will enable you to
  23.  avoid having to remember them all.
  24.  
  25.  Here is a list:
  26.  (All dates are in format "YYYYMMDD"
  27.   and times in format "HHMMSS" (HH:24 hours))
  28.  
  29.  
  30.  Group of "base" information: all files
  31.    %f   : the full name (without the path)
  32.    %b   : the "base" name
  33.           (ie for "autoexec.bat" it is "autoexec")
  34.    %e   : the name extension
  35.           (ie for "autoexec.bat" it is "bat")
  36.    %s   : the size in the most appropriate unit
  37.    %sb  : the size in bytes
  38.    %sk  : the size in kilo bytes
  39.    %sm  : the size in mega bytes
  40.    %sg  : the size in giga bytes
  41.    %F   : the DOS name (without the path)
  42.    %B   : the base of the DOS name
  43.    %E   : the extension of the DOS name
  44.    %a   : the attributes
  45.    %y   : the type
  46.    %d   : the modification date and time (default value)
  47.    %dd  : the modification date
  48.    %dt  : the modification time
  49.    %dm  : the modification date and time
  50.    %dmd : the modification date
  51.    %dmt : the modification time
  52.    %dc  : the creation date and time
  53.    %dcd : the creation date
  54.    %dct : the creation time
  55.    %da  : the last access date and time
  56.    %dad : the last access date
  57.    %dat : the last access time
  58.    %t   : the modification time (default value)
  59.    %tc  : the creation time
  60.    %ta  : the last access time
  61.    %tm  : the modification time
  62.  
  63.  
  64.    %N   : a number contained in the base file name
  65.           it can be followed by a digit indicating its position
  66.           (1 is the default value)
  67.           for example, for Fic2_15zzz784.txt:
  68.              %N  will give   2
  69.              %N1 will give   2
  70.              %N2 will give  15
  71.              %N3 will give 784
  72.              %N4 will give "" (empty string)
  73.  
  74.    %n   : the selection number
  75.    %np  : the selection number relative to the file path
  76.           for example:
  77.           File               %n        %np
  78.           \Dir1\Img1.jpg     001       001
  79.           \Dir1\Img2.jpg     002       002
  80.           \Dir2\Img3.jpg     003       001
  81.           \Dir2\Img4.jpg     004       002
  82.  
  83.    Zeroes ('0') will be eventually added on the left of these
  84.    numbers to reach the size defined in "Options/Numbers"
  85.  
  86.  
  87.    %p   : the parent directory
  88.    %p2  : the grand parent directory
  89.    %pn  : the nth level parent directory
  90.    %P   : the full path to the file
  91.  
  92.    %D   : the current date and time
  93.    %Dd  : the current date
  94.    %Dt  : the current time
  95.    %T   : the current time
  96.  
  97.  Group of "audio" information: mp2, mp3, mpc, ogg, wma, wav
  98.    (%m, %M and %A variable prefixes are equivalent)
  99.    %Ab  : the bitrate
  100.    %As  : the sampling rate
  101.    %AM  : the mode (mono/stereo)
  102.    %Ad  : the duration
  103.    %Ai  : some information
  104.  
  105.  Group of "id3v1 tag" information: mp2, mp3, mpc
  106.    %mt  : the title
  107.    %ma  : the artist
  108.    %mA  : the album
  109.    %my  : the year
  110.    %mc  : the comment
  111.    %mT  : the track number
  112.    %mg  : the genre
  113.  
  114.  Group of "audio tag" information: mp2, mp3, mpc, ogg, wma, wav
  115.    (%M and %A variable prefixes are equivalent)
  116.    %At  : the title
  117.    %Aa  : the artist
  118.    %AA  : the album
  119.    %Ay  : the year
  120.    %Ac  : the comment
  121.    %AT  : the track number
  122.    %An  : the number of tracks
  123.    %Ak  : the track (text)
  124.    %Ag  : the genre
  125.    %Ap  : the composer
  126.    %Ao  : the original artist
  127.    %AC  : the copyright
  128.    %Au  : the URL
  129.    %Ae  : encoded by
  130.    %AIf : the format of an attached image
  131.  
  132.  Group of "video" information: avi, mpg, mpeg, asf, wmv
  133.    %Vx  : the width
  134.    %Vy  : the height
  135.    %Vs  : the sampling rate
  136.    %VM  : the mode (mono/stereo)
  137.    %Vd  : the duration
  138.    %Vf  : the number of frames per second
  139.    %Vi  : some information
  140.  
  141.  Group of "video tag" information: avi, asf, wmv
  142.    %Vt  : the title
  143.    %VU  : the subject
  144.    %Va  : the artist
  145.    %Vc  : the comment
  146.    %Vk  : the keywords
  147.    %VE  : the engineer
  148.    %VT  : the technician
  149.    %Vg  : the genre
  150.    %Vn  : the creation date
  151.    %VO  : the source
  152.    %VC  : the copyright
  153.    %VS  : the software used to create the file
  154.    %VIf : the format of an attached image
  155.  
  156.  Group of "image" information:
  157.         tif, tiff, jpg, jpeg, gif, png, pcx, bmp, dib, ico, cur
  158.    %Ix  : the width
  159.    %Iy  : the height
  160.    %Ib  : the number of bits per pixel
  161.    %Ii  : some information
  162.  
  163.  Group of "exif" information: jpeg, jpg
  164.    I've preferred to give there the "official" name of the tag
  165.    %Xde : ImageDescription
  166.    %Xmk : Make
  167.    %Xmo : Model
  168.    %Xor : Orientation
  169.    %Xxr : XResolution
  170.    %Xyr : YResolution
  171.    %Xru : ResolutionUnit
  172.    %Xso : Software
  173.    %Xar : Artist
  174.    %Xdt : DateTime
  175.    %Xdtd: DateTime "date part"
  176.    %Xdtt: DateTime "time part"
  177.    %Xwp : WhitePoint
  178.    %Xpc : PrimaryChromaticities
  179.    %Xyc : YCbCrCoefficients
  180.    %Xyp : YCbCrPositioning
  181.    %Xbw : ReferenceBlackWhite
  182.    %Xco : Copyright
  183.    %Xeo : ExifOffset
  184.    %Xgo : GPSOffset
  185.    %Xet : ExposureTime
  186.    %Xfn : FNumber
  187.    %Xep : ExposureProgram
  188.    %Xsy : SpectralSensitivity
  189.    %Xsr : ISOSpeedRatings
  190.    %Xve : ExifVersion
  191.    %Xdo : DateTimeOriginal
  192.    %Xdod: DateTimeOriginal "date part"
  193.    %Xdot: DateTimeOriginal "time part"
  194.    %Xdd : DateTimeDigitized
  195.    %Xddd: DateTimeDigitized "date part"
  196.    %Xddt: DateTimeDigitized "time part"
  197.    %Xcc : ComponentConfiguration
  198.    %Xbp : CompressedBitsPerPixel
  199.    %Xss : ShutterSpeedValue
  200.    %Xav : ApertureValue
  201.    %Xbv : BrightnessValue
  202.    %Xev : ExposureBiasValue
  203.    %Xma : MaxApertureValue
  204.    %Xsd : SubjectDistance
  205.    %Xmm : MeteringMode
  206.    %Xls : LightSource
  207.    %Xfa : Flash
  208.    %Xfl : FocalLength
  209.    %Xfe : FlashEnergy
  210.    %Xuc : UserComment
  211.    %Xfv : FlashPixVersion
  212.    %Xcs : ColorSpace
  213.    %Xiw : ExifImageWidth
  214.    %Xih : ExifImageHeight
  215.    %Xsf : RelatedSoundFile
  216.    %Xfx : FocalPlaneXResolution
  217.    %Xfy : FocalPlaneYResolution
  218.    %Xfu : FocalPlaneResolutionUnit
  219.    %Xei : ExposureIndex
  220.    %Xsm : SensingMethod
  221.    %Xfs : FileSource
  222.    %Xst : SceneType
  223.    %Xcr : CustomRendered
  224.    %Xem : ExposureMode
  225.    %Xwb : WhiteBalance
  226.    %Xdz : DigitalZoomRatio
  227.    %XfL : FocalLengthIn35mmFilm
  228.    %Xsc : SceneCaptureType
  229.    %Xgc : GainControl
  230.    %Xct : Contrast
  231.    %Xsu : Saturation
  232.    %Xsh : Sharpness
  233.    %XsD : SubjectDistanceRange
  234.    %Xgv : GPSVersionID
  235.    %XlA : GPSLatitudeRef
  236.    %Xla : GPSLatitude
  237.    %XlO : GPSLongitudeRef
  238.    %Xlo : GPSLongitude
  239.    %XaL : GPSAltitudeRef
  240.    %Xal : GPSAltitude
  241.    %Xts : GPSTimeStamp
  242.    %Xsa : GPSSatellites
  243.    %Xus : GPSStatus
  244.    %XmM : GPSMeasureMode
  245.    %Xdp : GPSDOP
  246.    %XsP : GPSSpeedRef
  247.    %Xsp : GPSSpeed
  248.    %XtR : GPSTrackRef
  249.    %Xtr : GPSTrack
  250.    %XiD : GPSImgDirectionRef
  251.    %Xid : GPSImgDirection
  252.    %Xmd : GPSMapDatum
  253.    %XLA : GPSDestLatitudeRef
  254.    %XLa : GPSDestLatitude
  255.    %XLO : GPSDestLongitudeRef
  256.    %XLo : GPSDestLongitude
  257.    %XbE : GPSDestBearingRef
  258.    %Xbe : GPSDestBearing
  259.    %XDR : GPSDestDistanceRef
  260.    %XDr : GPSDestDistance
  261.  
  262.  Group of "karaoke" information: kar, mid
  263.    %Ky  : the type
  264.    %Kv  : the version
  265.    %Ki  : an information
  266.    %Kl  : the language
  267.    %Kt  : the title
  268.    %Ka  : the author
  269.    %KC  : the copyright
  270.  
  271.  Group of "office & pdf" information:
  272.         doc, xls, pot, pps, ppt, mpp, dot, pdf
  273.    %Ot  : the title
  274.    %Os  : the subject
  275.    %Oa  : the author
  276.    %Ok  : the keywords
  277.    %Oc  : the comments
  278.    %OT  : the template
  279.    %OA  : the last author
  280.    %Or  : the revision number
  281.    %Oe  : the edit time (in minutes)
  282.    %Op  : the last print date
  283.    %Opd : the last print date "date part"
  284.    %Opt : the last print date "time part"
  285.    %On  : the creation date
  286.    %Ond : the creation date "date part"
  287.    %Ont : the creation date "time part"
  288.    %Ob  : the last save date
  289.    %Obd : the last save date "date part"
  290.    %Obt : the last save date "time part"
  291.    %OP  : the page count
  292.    %OW  : the word count
  293.    %OC  : the char count
  294.    %ON  : the application
  295.    %OS  : the security level
  296.  
  297.  
  298.  
  299.  You can put one or more character modifiers just after the "%":
  300.    u : all characters upper case
  301.    l : all characters lower case
  302.    U : first character of each word upper case, the others
  303.        lower case. The words are separated by the characters
  304.        specified in "Options/Modifications"
  305.    L : first character uppercase, the rest lowercase
  306.    @ : accented characters to standard ASCII
  307.        ('Θ' to 'e', 'ⁿ' to 'u', '┴' to 'A' ...)
  308.  
  309.  For example, for the file "╔b÷lie family photo.JPG":
  310.  
  311.       Expression                  Result
  312.       %uf                         ╔B╓LIE FAMILY PHOTO.JPG
  313.       %lf                         Θb÷lie family photo.jpg
  314.       %Uf                         ╔b÷lie Family Photo.jpg
  315.       %Lf                         ╔b÷lie family photo.jpg
  316.       %@f                         Ebolie family photo.JPG
  317.       %@uf                        EBOLIE FAMILY PHOTO.JPG
  318.       %@Lf                        Ebolie family photo.jpg
  319.  
  320.  
  321.  
  322.  Of course, the character '*' can be used.
  323.  Depending upon the position of the '.' (the dot which delineates
  324.  file base name from extension) in an expression, the '*' will
  325.  represent either the base name or the extension.
  326.  It is not a variable and its value can not be modified.
  327.  
  328.  
  329.  
  330.  Here are some examples based on the file
  331.  "autoexec.bat" modified the 01/01/2002 at 14:10:01
  332.  
  333.       Expression                  Result
  334.       %b                          autoexec
  335.       File_%f                     File_autoexec.bat
  336.       %b_%dmd.%e                  autoexec_20020101.bat
  337.       %ub_%t.%e                   AUTOEXEC_141001.bat
  338.       base %b - extension %e      base autoexec - extension bat
  339.       base %Ub - extension %Ue    base Autoexec - extension Bat
  340.  
  341.  
  342.  
  343.  Every variable can be postfixed by a "[]" modifier.
  344.  It will be split into an array of substrings following the
  345.  specified separator characters.
  346.  The usage is: "[ i , "sep" ]"
  347.    i   : number of the substring to extract
  348.          If negative, the extraction is done from the end
  349.          If "0" (zero), it's equivalent to the complete string
  350.          without the begining and ending spaces
  351.    sep : list of separator characters, optional.
  352.          If not specified, the list defined in
  353.          "Options/Modifications" is used
  354.  
  355.  If the chosen string is "%b", "%b[n]" contains the file base
  356.  name characters between the n-1 and nth separator occurrences.
  357.  Begining and ending spaces are deleted (full trim).
  358.  
  359.  For example, using the file:
  360.  "01 -   Artist_Group   - Song title   .mp3"
  361.  with "-" in the array elements separators list in
  362.  "Options/Modifications":
  363.  
  364.       Expression           Result
  365.       %b[3].%e             "Song title.mp3"
  366.       %ub[3] - %b[2].%e    "SONG TITLE - Artist_Group.mp3"
  367.       %b[1].%e             "01.mp3"
  368.       %b[-3].%e            "01.mp3"
  369.       %b[-1].%e            "Song title.mp3"
  370.       %b[0]                "01 -   Artist_Group   - Song title"
  371.       %b[2,"_"]            "Group   - Song title"
  372.       %b[2][2,"_"]         "Group"
  373.  
  374.  
  375.  Every variable can be postfixed by a "()" modifier.
  376.  This modifier can have two functions:
  377.  
  378.  - Substring extraction
  379.    The usage is very near of the standard "substr":
  380.    "( pos, nb )"
  381.    pos  : starting position
  382.           If negative, it is relative to the end of the string
  383.    nb   : number of characters
  384.           If not present, the extraction is done until the end
  385.           If negative, the number of characters to extract is
  386.           computed from the end of the string
  387.  
  388.  - String replacement
  389.    The usage is near of the standard "replace":
  390.    "( "str1", "str2", i1, i2, cs )"
  391.    str1 : String to replace
  392.    str2 : Replacement string
  393.           If not present the string to replace is deleted
  394.    i1   : Starting occurrence
  395.           If negative, it is relative to the end of the string
  396.    i2   : Number of replacements to do
  397.           If negative, all remaining occurences are treated
  398.    cs   : Number indicating if the search is case sensitive:
  399.           0 for no, any other value for yes
  400.  
  401.    The last four parameters are optional.
  402.    By default all occurrences are treated and the search is
  403.    case insensitive.
  404.  
  405.  
  406.  You can "concat" as many modifiers "()" and "[]" as you want.
  407.  They will be evaluated from left to right.
  408.  The character modifiers (u,l,@...) will be applied on the result
  409.  so obtained.
  410.  
  411.  Here are some examples using the file "autoexec.bat" with "-" in the
  412.  array elements separators list:
  413.  
  414.       Expression                       Result
  415.       %b(1,4).%e                       auto.bat
  416.       %ub(5,2).%e(1,1)                 EX.b
  417.       %b(5)_%dmd(3).%Ue                exec_020101.Bat
  418.       %b(-4,3).bat                     exe.bat
  419.       %b(1,-4).bat                     auto.bat
  420.       %b(-4,-2).bat                    ex.bat
  421.       %b("auto","automatic").%e        automaticexec.bat
  422.       %b("exe").%e                     autoc.bat
  423.       %b("e","#",2,1).*                autoex#c.bat
  424.       %b("e","#",-1).*                 autoex#c.bat
  425.       %b("e","#",1,1).*                auto#xec.bat
  426.       %b("e","#",-2,1).*               auto#xec.bat
  427.       %b("E","#",1,-1).*               auto#x#c.bat
  428.       %b("E","#",1,-1,0).*             auto#x#c.bat
  429.       %b("E","#",1,-1,1).*             autoexec.bat
  430.       %b("auto","auto_")(1,8).%e       auto_exe.bat
  431.       %f("exec","x")("auto","oto")     otox.bat
  432.       %Lb("auto","auto-")[2](3).%e     Ec.bat
  433.  
  434.  Let's examine, step by step, the last example:
  435.  
  436.    %Lb("auto","auto-")[2](3).%e on "autoexec.bat":
  437.  
  438.    %b                   on "autoexec.bat" gives "autoexec"
  439.    ("auto","auto-")     on "autoexec"     gives "auto-exec"
  440.    [2]                  on "auto-exec"    gives "exec"
  441.    (3)                  on "exec"         gives "ec"
  442.    the modifier 'L'     on "ec"           gives "Ec"
  443.    add fixed text "."   on "Ec"           gives "Ec."
  444.    add "%e" (extension) on "Ec."          gives "Ec.bat"
  445.  
  446.  
  447.  Like under DOS:
  448.  The expression "*." will rename "autoexec.bat" to "autoexec".
  449.  
  450.  If you want to use one of the special characters (%*()[]...) as
  451.  a standard character, put a '\' in front of it.
  452.  
  453.  
  454.  To this have been added options to modify the string previously
  455.  composed (File menu, Options/Modifications).
  456.  
  457.  Two lists of characters to delete can be specified:
  458.    - The first contains the characters to delete
  459.      For example, the file "image.bmp" with "aei" in the list
  460.      will be proposed "mg.bmp"
  461.    - The second one, the for which no repetition is allowed.
  462.      For example, the file "a---b.txt" with "-" in the list
  463.      will be proposed "a-b.txt".
  464.  
  465.  Two replacement character lists are present.
  466.  The first (From) indicates which characters to replace and the
  467.  second (To) indicates by what to replace them.
  468.  For example, the file "image_rua.bmp" with "_r" and "-s" in
  469.  the lists "From" and "To" will be proposed "image-sua.bmp"
  470.  
  471.  There is a box to specify by what to replace invalid
  472.  filename characters (*\? ...etc...).
  473.  If you let it empty, they will be deleted.
  474.  
  475.  You can enter a maximum name length, 64 characters for example.
  476.  If possible, only the base name will be truncated.
  477.  
  478.  For audio files, you can choose to use the value from one tag
  479.  or another if the needed one is empty.
  480.  Only common id3v1 and audio tag values are concerned
  481.  (title, artist, album, year, comment, track number and genre).
  482.  Choose too if a variable will be empty or not if it's associated
  483.  data is not valid. This concerns only dates.
  484.  
  485.  For Exif, you've surely noticed that many information contain
  486.  a "/" (division symbol). But this character is not allowed in file
  487.  names and will be replaced. You can specify which string to use as
  488.  separator.
  489.  For example " divided by ".
  490.  
  491.  
  492.  Siren will help you to write your renaming expression:
  493.  If, in the file list, you right click on an information that
  494.  interests you, you'll be able to insert it's corresponding
  495.  variable or current value in the expression.
  496.  During the writing of an expression:
  497.    - Enter: recomputes the "Future names" and adds the expression
  498.      to the combo list
  499.    - Ctrl+Space, F1 or right click: displays the completion window.
  500.      Double click on an element to add it in the current expression
  501.    - Ctrl+I: pastes the current file name
  502.    - Ctrl+P: displays the current cursor column in the status bar
  503.  
  504.  
  505.  The loading of a directory can include all its subdirectories
  506.  allowing the renaming off all files in a directory tree.
  507.  In this mode, directories cannot be renamed.
  508.  
  509.  
  510.  In the "Filter" combo, you can enter a string to limit the file
  511.  list (for example: *.mp3).
  512.  A filter can be compound of many "file specs", separated by ';'.
  513.  For example, to list only "mp3", "bmp" or files beginning with a
  514.  'F', type: *.mp3;*.bmp;F*
  515.  The "DOS" filter functionnalities have been extended to the
  516.  UNIX "standard" ones.
  517.  The meta characters list limited to "*" and "?" has been
  518.  completed with "[!-]".
  519.  It is possible to specify allowed or refused lists.
  520.  For example, the files:
  521.      "mp3" containing a "#" or a "=" : *[#=]*.mp3
  522.      begining with an alpha character: [A-Z]*
  523.      not begining with 'T'           : [!T]*
  524.  ... etc ...
  525.  
  526.  
  527.  During a renaming, if a "system error" occurs,
  528.  the file (or files) concerned will be colored "near red"
  529.  and the associated message will be displayed in the status bar.
  530.  
  531.  
  532.  Files drops are allowed: select files in another program
  533.  (Windows Explorer for example) and move them onto Siren.
  534.  The parent directory is loaded and files selected.
  535.  A directory drop can be done directly on the "directory" combo.
  536.  
  537.  
  538.  To activate the shell contextual menu for the current directory,
  539.  right click on the directory combo or on "..".
  540.  
  541.  
  542.  You can personnalize the list and the order of the displayed
  543.  columns. Each one will be visible only if it is checked in
  544.  "Options/Columns" and if the toolbar button associated to his
  545.  group is checked too.
  546.  You can let Siren automatically select groups of used columns
  547.  and eventually display only non empty columns.
  548.  
  549.  The "Favorites" menu will enable to keep and reuse your
  550.  preferred rename expressions.
  551.  
  552.  
  553.  
  554.  By using the program you will see that there are many different
  555.  ways of getting the same results simply.
  556.  In case of mistake, don't worry, until you change of directory or
  557.  you quit Siren, the renamings can be undone.
  558.  
  559.  
  560.  The rest of the program:
  561.    - choosing the directory
  562.    - choosing and ordering the columns
  563.    - search/select with a file filter
  564.    - sort
  565.    - selection number
  566.    - number formats
  567.    - selections
  568.    - directory monitoring
  569.    - create DOS batch file of rename commands
  570.    - open, delete
  571.    - image visualization
  572.    - splitter usage
  573.    - system shortcuts to Siren
  574.    - copy selected files list to the clipboard
  575.  ... etc ...
  576.  wouldn't be difficult.
  577.  
  578.  
  579.  Do not hesitate to share with me your remarks and suggestions.
  580.  
  581.  
  582. PS: Sorry for my poor frenglish
  583.