page id: 15

rpVTTutorial

rpVT > rpVTTutorial

rpVT Tutorial

Because of the new integrated Help system and the many changes made to rpVT functionality, this tutorial will be rewritten in the next few weeks. We are keeping in here the information about the Y commands because there were little or no changes in most of them. Read the FAQs in this mean time.

The Assist mode (Y command)

The nature of the Y command in ZTree allows it to be addressed to any assisting application. Coping with this concept, rpVT requires the first letter in the treating commands to be a capital R to identify the command as addressed to rpVT. To access the Treating Commands you have to use Y or Ctrl-Y from ZTree. If you use simple Y, the command entry and the filename under the highlighted bar are passed to rpVT for processing. If you use Ctrl-Y, the command entry and all tagged filenames are passed to rpVT for processing. Examples of currently implemented treating commands are: Output File Creation

Routput,filename.ext             (Y only)

The output file 'filename.ext' is created in the current directory where ZTree highlight bar is or in another full path directory (if specified). This file will become the temporary output file for several operations that require an output, until it is deleted or substituted for a new one. The path and name for that file will appear in the separation line at the bottom of rpVT screen. The file is created empty (zero size). File Splitting

Rsplit,alpha,120,file:00:.ext    (Y only) where: 
  alpha = alpha is for text lines files & bin is for a binary files. 
  120  = # of lines (or bytes) on each fragment (except remainder). 
  :00:  = incremental indexing number (also the starting value).

Splits the file (under the highlight bar in ZTree) into smaller pieces with the filename specified and consecutive index numbers. File Joining

Rjoin,                                   (Y & Ctrl-Y)

Ctrl-Y reads the tagged files in the order selected by ZTree and added them to the 'outfile.ext' defined previously by 'Routput'. The contents of outfile.ext are preserved and the files are added immediately after the original content. 'Y' adds only the selected file to 'outfile.ext' & Tags it (selected file), in ZTree. Text Sort

Rsort,alpha,a1,5,12               (Y & Ctrl-Y) where: 
  a   = sorting order, 'a' for ascending, 'd' for descending. 
  1   = number of the sorting table used (from 1 to 8). 
  5   = start comparing in the 5th character. 
  12 = compare for 12 consecutive characters.

Sorts a text file composed by lines of maximum size of 16384 chars terminated with a line feed, in an ascending order using the sort table #1 to control the order. The file cannot exceed 2.147 GB. The original file is kept and a new 'fname.ext.srt' file is created. Binary Sort

Rsort,bin,1700,d1,5,12          (Y & Ctrl-Y) where: 
  1700 = size in bytes of the binary records used. 
  d      = sorting order, 'a' for ascending, 'd' for descending. 
  1      = size of little endian entity. 0=byte, 1=word, 2=dword, 3=qword, 4=oword. 
  5      = start comparing in the 5th byte.
  12    = compare for 12 consecutive entities.

Sorts a binary file composed by records of 1700 bytes (max.16384) in a descending order, on words, started at byte #5 for a total of 12 words. The original file has to be a multiple of the record size (rpVT don't handle remainders). Maximum file size is also 2.147GB. File String Search

Rsearch,m,c,argument, (Y & Ctrl-Y) where:
    m = mode. 't' for tag/untag, 's' for displaying results.
    c = Case sensitivity, where:
       y = Case sensitive.
       o = Case insensitive considering all OEM characters that
             represent accented letters or characters like 'ÃƒÂ§' or 'ÃƒÂ±'.
       O = OEM diacritical reduction. Letters with any accents are
             seen as equal, ÃƒÂ§ cedilhas are equal to c, etc...
       a = Same as 'o' but for ANSI
       A = Same as 'O' but for ANSI
             argument = Text string (Some Regular Expressions supported).

The files are tagged or shown in the view screen if they contain occurrences of the argument. (Note the necessary ending comma, after the argument) If the 's' mode is used, the 'display mode' is activated for the search operation on single files. The search routine will then create a collection of all occurrences of the argument. This is then used in the file display routines for showing the occurrences. This display remains active only immediately after the operation of the search command. If the file is changed or refreshed, the data is rendered obsolete and the highlighted display of the occurrences is deactivated. The number of hits, (found occurrences), is displayed at the bottom right of the window. The 's' type search reads the whole file to find all the occurrences of the argument. Search supports:

\c=CR \l=LF \f=FF \t=Tab \\=\ \,=comma \.=.
   .=any character \b=word delimiter \s=white space
   \d=decimal digit \xHH=hexadecimal byte

File Search & Replace

Rreplace,c,argfrom,argto, (Y & Ctrl-Y) where:
    c = Case sensitivity. (Same rules as the Search command above)
    argfrom = Argument to search.
    argto = Argument to replace.

S&R supports the same Escape sequences described in the Search cmd above. Note that expressions that do not have a specific meaning cannot be used in the 'argto' argument. Ex: \s \d \b \h. The highlighted file is scanned and a replacement file is generated with the changes, using the same name with an extra .sar extension. The \o special sequence was created to represent a metacommand for use in the second field of the s&r routine. This expression makes the s&r command to work like a 'search & extract' tool, copying matched parts of the source file to the output file. The matching strings are copied to the result file as found in the original file. If \o is used alone, only the matching strings are copied. If additional data is specified in the 2nd argument, this data will also be inserted right after the searched input strings. Sequential File Show

Rslide,keep,xx          (keep tags)    (Ctrl-Y only) where: 
  Rslide,untag,xx         (remove tags) (Ctrl-Y only) where:

  xx  = time in units of 50 mS each to wait between 2 consecutive displays of the tagged files.

The tagged files are advanced each 'xx' units of time and the viewer will be naturally showing them in the proper format. Works like a 'slide show' for watching images or looking inside files. Rslide,keep,xx does not removes the tags from ZTree list as it goes over the files. If you use Rslide,untag,xx instead, each tag will be removed after the file is viewed. This makes a good way to mark where you stopped the view. Code Format Change

Rcode,c,Unicode,ANSI   (Y & Ctrl-Y) where:

The entry 'Unicode/ANSI' from the format tables is used to change the file from the Unicode format into the ANSI format. There are tables for several code formats and the user can build a table by himself for changing any hypothetical format into another or to fit special custom codes and formats. Code Execution

Rcode,e, jpegtran -rot 270 %1 %9=ver%4%5    (Y & Ctrl-Y) where:

The application 'jpegtran.exe' is launched with the specified switches -rot and 270, plus the filenames specified via the '%'s. Note that Rcode,e,.. does not accept comments and must be terminated with a C.R. right after the last parameter.

%1 - Full path\filename         C:\1997\sept\file.ext
     %2 - Driver letter                  C
     %3 - Path                            \1997\sept
     %4 - Filename                      file
     %5 - Extension                    .ext
     %9 - Full path                      C:\1997\sept\
     %c - Parameter is passed as is.

Note: This page originate from http://www.rpvt.com. This website being closed down, its original webpages have been included in this Wiki for posperity with some light editing. Thanks to John Clark who got a copy of the website

Contributors to this page: admin .
Page last modified on Wednesday 14 of February, 2007 00:45:54 EST by admin.

Slides

rpVTTutorial

rpVT Tutorial

The Assist mode (Y command)

Sidebar

Login

Search

Top Pages