http://www.jpicedt.org

jpicedt.ui.util
Class RunExternalCommand

java.lang.Object
  extended by java.lang.Thread
      extended by jpicedt.ui.util.RunExternalCommand
All Implemented Interfaces:
java.lang.Runnable

public class RunExternalCommand
extends java.lang.Thread

A class implementing methods for calling external processes like latex, (x)dvi, ghostscript... on the current picture file (e.g. the active internal frame)

A "tmp" file is generated on-the-fly in the "tmp" directory of the underlying platform, This tmp file contains an adequate preamble (e.g. usepackage{epic}) depending on current options, and LaTeX commands (or PsTricks or eepic commands) corresponding to each object found in the given picture.

These command lines may include the following special symbols :
- {f} : tmp file name w/o extension (the user need to specify explicitely any extension required by the external program)
- {p} : tmp file path including trailing separator
- {i} : jPicEdt add-ons dir, that is : "jpicedt.home/add-ons" (trailing separtor excluded)

Ex : kghostview {p}{f}.ps or {i}run_latex.bat {p}{f}

Since we don't want to resort on platform dependent tricks (working dirs, PATH variables, root directory names differing on UNIX and Win32 systems, latex command line which might also differ, aso...), the better thing the user could do is to write one batch/shell script per process he wants to launch, then provide the names of these scripts to PicEdt.

Scripts are easy to write on UNIX/Window platforms, and very likely on MacOS platforms by using AppleScript.

Since:
PicEdt 1.2
Version:
$Id: RunExternalCommand.java,v 1.10.2.1 2007/09/02 11:56:30 reynal Exp $
Author:
Sylvain Reynal

Nested Class Summary
 class RunExternalCommand.DlgBoxDisplayProcessIOStream
          An inner class implementing a JDialog to display external process inputStream and send keyboard events to process outputStream
 
Nested classes/interfaces inherited from class java.lang.Thread
java.lang.Thread.State, java.lang.Thread.UncaughtExceptionHandler
 
Field Summary
static java.lang.String BITMAP_CREATION
          static field defining an external bitmap creation command, and also used by ActionLocalizer
static java.lang.String DEFAULT_BITMAP_CREATION_COMMAND
          default commands parameters
static java.lang.String DEFAULT_DVI_COMMAND
          default commands parameters
static java.lang.String DEFAULT_DVIPS_COMMAND
          default commands parameters
static java.lang.String DEFAULT_GS_COMMAND
          default commands parameters
static java.lang.String DEFAULT_LATEX_COMMAND
          default commands parameters
static java.lang.String DEFAULT_USER1_COMMAND
          default commands parameters
static java.lang.String DEFAULT_USER2_COMMAND
          default commands parameters
static java.lang.String DVIPS
          static field defining an external "dvips" command, and also used by ActionLocalizer
static java.lang.String DVIVIEWER
          static field defining an external "xdvi" (or similar) command, and also used by ActionLocalizer
static java.lang.String GHOSTVIEW
          static field defining an external "gv" (or similar) command, and also used by ActionLocalizer
static boolean isGUI
           
static java.lang.String KEY_BITMAP_CREATION
          key used to fetch command parameters from a Properties object
static java.lang.String KEY_DVIPS
          key used to fetch command parameters from a Properties object
static java.lang.String KEY_DVIVIEWER
          key used to fetch command parameters from a Properties object
static java.lang.String KEY_GHOSTVIEW
          key used to fetch command parameters from a Properties object
static java.lang.String KEY_LATEX
          key used to fetch command parameters from a Properties object
static java.lang.String KEY_USER1
          key used to fetch command parameters from a Properties object
static java.lang.String KEY_USER2
          key used to fetch command parameters from a Properties object
static java.lang.String LATEX
          static field defining an external "latex" command, and also used by ActionLocalizer
static java.lang.String USER1
          static field defining an external user command, and also used by ActionLocalizer
static java.lang.String USER2
          static field defining an external user command, and also used by ActionLocalizer
 
Fields inherited from class java.lang.Thread
MAX_PRIORITY, MIN_PRIORITY, NORM_PRIORITY
 
Constructor Summary
RunExternalCommand(Drawing drawing, ContentType contentType, java.lang.String commandToRun)
           
RunExternalCommand(Drawing drawing, ContentType contentType, java.lang.String cmdLine, boolean isWriteTmpTeXfile)
          Mostly for debugging purpose, or when used outside the jpicedt.ui package (since then JPicEdt.preferences are no longer available).
 
Method Summary
static void cleanTmpDir()
          Delete files created by JPicEdt or programms called by JPicEdt (LaTeX, dvips,...).
static AbstractCustomizer createCustomizer(java.util.Properties preferences)
           
static void createTmpFile()
          Create a new tmp file if it doesn't exit yet
static java.lang.String getAddonDir()
          Return the add-ons directory w/o trailing "/"
static java.io.File getTmpFile()
           
static java.lang.String getTmpFilePrefix()
           
static java.lang.String getTmpPath()
           
 void run()
          run an external process as a thread (overloading Thread.run() method) we then pipe the process std output to a JTextArea
 
Methods inherited from class java.lang.Thread
activeCount, checkAccess, countStackFrames, currentThread, destroy, dumpStack, enumerate, getAllStackTraces, getContextClassLoader, getDefaultUncaughtExceptionHandler, getId, getName, getPriority, getStackTrace, getState, getThreadGroup, getUncaughtExceptionHandler, holdsLock, interrupt, interrupted, isAlive, isDaemon, isInterrupted, join, join, join, resume, setContextClassLoader, setDaemon, setDefaultUncaughtExceptionHandler, setName, setPriority, setUncaughtExceptionHandler, sleep, sleep, start, stop, stop, suspend, toString, yield
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

LATEX

public static final java.lang.String LATEX
static field defining an external "latex" command, and also used by ActionLocalizer

See Also:
Constant Field Values

DVIVIEWER

public static final java.lang.String DVIVIEWER
static field defining an external "xdvi" (or similar) command, and also used by ActionLocalizer

See Also:
Constant Field Values

DVIPS

public static final java.lang.String DVIPS
static field defining an external "dvips" command, and also used by ActionLocalizer

See Also:
Constant Field Values

GHOSTVIEW

public static final java.lang.String GHOSTVIEW
static field defining an external "gv" (or similar) command, and also used by ActionLocalizer

See Also:
Constant Field Values

USER1

public static final java.lang.String USER1
static field defining an external user command, and also used by ActionLocalizer

See Also:
Constant Field Values

USER2

public static final java.lang.String USER2
static field defining an external user command, and also used by ActionLocalizer

See Also:
Constant Field Values

BITMAP_CREATION

public static final java.lang.String BITMAP_CREATION
static field defining an external bitmap creation command, and also used by ActionLocalizer

See Also:
Constant Field Values

KEY_LATEX

public static final java.lang.String KEY_LATEX
key used to fetch command parameters from a Properties object

See Also:
Constant Field Values

KEY_DVIVIEWER

public static final java.lang.String KEY_DVIVIEWER
key used to fetch command parameters from a Properties object

See Also:
Constant Field Values

KEY_DVIPS

public static final java.lang.String KEY_DVIPS
key used to fetch command parameters from a Properties object

See Also:
Constant Field Values

KEY_GHOSTVIEW

public static final java.lang.String KEY_GHOSTVIEW
key used to fetch command parameters from a Properties object

See Also:
Constant Field Values

KEY_USER1

public static final java.lang.String KEY_USER1
key used to fetch command parameters from a Properties object

See Also:
Constant Field Values

KEY_USER2

public static final java.lang.String KEY_USER2
key used to fetch command parameters from a Properties object

See Also:
Constant Field Values

KEY_BITMAP_CREATION

public static final java.lang.String KEY_BITMAP_CREATION
key used to fetch command parameters from a Properties object

See Also:
Constant Field Values

DEFAULT_LATEX_COMMAND

public static final java.lang.String DEFAULT_LATEX_COMMAND
default commands parameters

See Also:
Constant Field Values

DEFAULT_DVI_COMMAND

public static final java.lang.String DEFAULT_DVI_COMMAND
default commands parameters

See Also:
Constant Field Values

DEFAULT_DVIPS_COMMAND

public static final java.lang.String DEFAULT_DVIPS_COMMAND
default commands parameters

See Also:
Constant Field Values

DEFAULT_GS_COMMAND

public static final java.lang.String DEFAULT_GS_COMMAND
default commands parameters

See Also:
Constant Field Values

DEFAULT_USER1_COMMAND

public static final java.lang.String DEFAULT_USER1_COMMAND
default commands parameters

See Also:
Constant Field Values

DEFAULT_USER2_COMMAND

public static final java.lang.String DEFAULT_USER2_COMMAND
default commands parameters

See Also:
Constant Field Values

DEFAULT_BITMAP_CREATION_COMMAND

public static final java.lang.String DEFAULT_BITMAP_CREATION_COMMAND
default commands parameters

See Also:
Constant Field Values

isGUI

public static boolean isGUI
Constructor Detail

RunExternalCommand

public RunExternalCommand(Drawing drawing,
                          ContentType contentType,
                          java.lang.String commandToRun)
Parameters:
drawing - The target document upon which the command will acts
contentType - the content-type used to format the document
commandToRun - one of the predefined constant fields (e.g. LATEX, DVIVIEWER, DVIPS or GHOSTVIEW)
Since:
jPicEdt 1.2

RunExternalCommand

public RunExternalCommand(Drawing drawing,
                          ContentType contentType,
                          java.lang.String cmdLine,
                          boolean isWriteTmpTeXfile)
Mostly for debugging purpose, or when used outside the jpicedt.ui package (since then JPicEdt.preferences are no longer available).

Parameters:
drawing - The target document upon which the command will acts
contentType - the content-type used to format the document
cmdLine - a string containing the command to be executed (e.g. "ext_prod.sh {p} latex {f}")
Since:
jPicEdt 1.4pre5
Method Detail

getTmpFile

public static java.io.File getTmpFile()

getTmpPath

public static java.lang.String getTmpPath()

getTmpFilePrefix

public static java.lang.String getTmpFilePrefix()

run

public void run()
run an external process as a thread (overloading Thread.run() method) we then pipe the process std output to a JTextArea

Specified by:
run in interface java.lang.Runnable
Overrides:
run in class java.lang.Thread
Since:
PicEdt 1.2

cleanTmpDir

public static void cleanTmpDir()
Delete files created by JPicEdt or programms called by JPicEdt (LaTeX, dvips,...).


getAddonDir

public static java.lang.String getAddonDir()
Return the add-ons directory w/o trailing "/"


createTmpFile

public static void createTmpFile()
                          throws java.io.IOException
Create a new tmp file if it doesn't exit yet

Throws:
java.io.IOException

createCustomizer

public static AbstractCustomizer createCustomizer(java.util.Properties preferences)
Returns:
an AbstractCustomizer suited for editing Properties related to external commands

http://www.jpicedt.org

Submit a bug : syd@jpicedt.org