README-tcltk 4.76 KB
Newer Older
1 2 3
------------------------------------------------------------------------------
                                xorriso-tcltk
------------------------------------------------------------------------------
4 5 6
Copyright (C) 2012 - 2013
Thomas Schmitt <scdbackup@gmx.net>, libburnia-project.org
Provided under BSD license: Use, modify, and distribute as you like.
7 8 9 10 11
------------------------------------------------------------------------------

xorriso-tcltk is mainly a proof of concept for a frontend that operates
xorriso in dialog mode.

12 13 14 15 16 17
Dependencies:
- xorriso ISO 9660 Rock Ridge filesystem manipulator and CD/DVD/BD burn program
- Tcl programming language
- Tk widget toolkit
- optionally the Tcl/Tk package BWidget

18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33
It exercises several fundamental gestures of communication:
- connecting via two pipes
- sending commands
- receiving replies
- inquiring the xorriso message sieve
- using the xorriso parsing service

Note that any other language than Tcl/Tk could be used, if it only can
do i/o via standard input and standard output or via named pipes.
Further it has to perform integer arithmetics and string manipulations.
And, well, a graphical widget set would be nice.

See man xorriso for a documentation of xorriso concepts and commands.
See man xorrecord for details of the burn image file feature.


34
                             Quick start
35

36
In the xorriso build directory, without installation of xorriso:
37

38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56
  xorriso/xorriso -launch_frontend frontend/xorriso-tcltk --stdio --

After installation of xorriso by make install:

  xorriso-tcltk


                            Overview of GUI

The window is separated into three main areas:
- Connection to xorriso.
- Management of drives and image files.
- Inspection, manipulation, and exploitation of xorriso ISO image model.

Click the rightmost mouse button while being over any of the GUI elements
in order to get the particular help text for that element.
There is no need to close the help window. Just click another element to
get another help text.

57 58 59
The "Help" button in the upper right corner gives a short overview and
instructions for several common use cases.

60 61

                         Program start options
62 63 64 65

The Tcl shell "wish" is allergic to options which start by "-h".
So here is the output of  xorriso-tcltk --help :
------------------------------------------------------------------------
66

67
Usage:
68
  frontend/xorriso-tcltk [options]
69 70 71 72 73 74
Options:
 All options must be given with two dashes ("--option") in
 order to distinguish them from any options of the Tcl shell.
 --help
     Print this text and exit.
 --stdio
75
     Establish connection to xorriso via stdin and stdout.
76 77 78
     E.g. when letting xorriso start this frontend program:
       xorriso -launch_frontend $(which xorriso-tcltk) --stdio --
 --named_pipes cmd_fifo reply_fifo
79
     Establish connection to a xorriso process started by:
80 81 82 83 84 85
       xorriso -dialog on <cmd_fifo >reply_fifo
     which is then ready for a run of:
       xorriso-tcltk --named_pipes cmd_fifo reply_fifo
     It is important that the parent of xorriso and of this
     tcl/tk frontend opens the named pipe for commands before
     it opens the named pipe for replies. This avoids deadlock.
86 87 88
 --silent_start
     Do not issue the start message xorriso-tcltk-version.
     This works only if --silent_start is the first argument.
89 90 91
 --no_extract
     Do not allow extraction of files from ISO filesystem to
     hard disk. This is not revokable during the program run.
92 93 94
 --no_bwidget
     Do not try to load the Tcl/Tk package BWidget which is
     a prerequisite for the "/" file browser buttons.
95 96 97 98
 --geometry {+|-}X{+|-}Y
     Sets the position of the main window.
 --click_to_focus
     Chooses that input fields and list boxes get the keyboard
99
     focus only when being clicked by the mouse. (Default)
100 101
 --auto_focus
     Chooses that the keyboard focus is where the mouse
102 103
     pointer is.
 --pipe_log_file path
104
     Set a file address for logging of xorriso commands and
105 106 107
     reply messages and enable this logging.
     The log lines will be appended. Path "-" means stderr.
 --script_log_file path
108 109
     Set a file address for logging of essential xorriso
     commands and enable this logging.
110
     The log lines will be appended. Path "-" means stderr.
111 112
 --script_log_all_commands
     With logging of commands log non-essential commands too.
113 114 115 116 117
 --use_command_move
     Use xorriso command -move for the "Move to: button
     if xorriso version is >= 1.2.8
 --use_command_mv
     Use xorriso command -mv for the "Move to:" button.
118

119 120 121
If neither --stdio nor --named_pipes is given, then this script
will try to locate itself in the filesystem and start a xorriso
run that launches it again.
122

123 124
In the running GUI, click with the rightmost mouse button on
any GUI element to get its particular help text.
125 126 127

------------------------------------------------------------------------