.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.6. .TH KLATEXFORMULA "1" "August 2018" "klatexformula 4.0.0" "User Commands" .SH NAME klatexformula \- GUI and CLI to generate images from LaTeX formulas .SH SYNOPSIS .B klatexformula [\fI\,OPTIONS\/\fR] [\fI\,filename1 \/\fR[...]] .SH DESCRIPTION KLatexFormula by Philippe Faist .PP An easy\-to\-use graphical application and command\-line interface for generating images from LaTeX equations. .SS "Execution Modes:" .IP klatexformula [filename1 [...]] .IP Opens klatexformula Graphical User Interface (GUI) .IP klatexformula [OPTIONS] .IP Performs actions required by [OPTIONS], and exits .IP klatexformula \fB\-\-interactive\fR [OPTIONS] [filename1 [...]] .IP Opens the GUI and performs actions required by [OPTIONS] .IP If additional filename arguments are passed to the command line, they are interpreted as library files to load into the library (only in interactive mode). .SH OPTIONS .HP \fB\-I\fR, \fB\-\-interactive\fR .IP Runs KLatexFormula in interactive mode with a full\-featured graphical user interface. This option is on by default, except if \fB\-\-input\fR or \fB\-\-latexinput\fR is given. .HP \fB\-i\fR, \fB\-\-input\fR .IP Specifies a file to read latex input from. .HP \fB\-l\fR, \fB\-\-latexinput\fR .IP Specifies the LaTeX code of an equation to render. .HP \fB\-P\fR, \fB\-\-paste\-clipboard\fR .HP \fB\-S\fR, \fB\-\-paste\-selection\fR .IP Specifies that the LaTeX code should be pasted from the system clipboard or current mouse selection. Works only in interactive mode. .HP \fB\-n\fR, \fB\-\-noeval\fR .IP Do not evaluate the LaTeX equation given, leave it to the user to click on the "Evaluate" button. This option may only be used in interactive mode. .HP \fB\-B\fR, \fB\-\-base64arg\fR .IP Specifies that the argument to the option immediately following this one is encoded in base64. For example: .IP klatexformula \fB\-\-base64arg\fR \fB\-\-latexinput=\fR"YV4yK2JeMj1jXjI=" .IP will use the latex code "a^2+b^2=c^2". This option can be specified more than once on the command line, each time indicating that the argument to the immediately next option is encoded in base64. This option can be useful when scripting, to avoid the nuisance of having to escape latex code from the shell. .HP \fB\-o\fR, \fB\-\-output\fR .IP Specifies to write the output image (obtained from equation given by \fB\-\-input\fR or \fB\-\-latexinput\fR) to or standard output. .HP \fB\-F\fR, \fB\-\-format\fR .IP Specifies the format the output should be written in. By default, the format is guessed from file name extension and defaults to PNG. .HP \fB\-f\fR, \fB\-\-fgcolor\fR <'#xxxxxx'> .IP Specifies a color (in web #RRGGBB hex format) to use for foreground color. Don't forget to escape the '#' to prevent the shell from interpreting it as a comment. .HP \fB\-b\fR, \fB\-\-bgcolor\fR <\-|'#xxxxxx'> .IP Specifies a color (in web #RRGGBB hex format, or '\-' for transparent) to use as background color (defaults to transparent) .HP \fB\-X\fR, \fB\-\-dpi\fR .IP Use N dots per inch (DPI) when converting latex output to image. Defaults to 1200 (high\-resolution image). .HP \fB\-m\fR, \fB\-\-mathmode\fR .IP Specifies which LaTeX math mode to use, if any. The argument to this option is any string containing "...", which will be replaced by the equation itself. Defaults to "\e[ ... \e]" .HP \fB\-p\fR, \fB\-\-preamble\fR .IP Any LaTeX code that will be inserted before \ebegin{document}. Useful for including custom packages with \eusepackage{...}. .HP \fB\-s\fR, \fB\-\-userscript\fR .IP Call a specific user script when running the backend. See the documentation in libklfbackend for more information. The script must understand and respond to the "\-\-scriptinfo" option. .HP \fB\-\-want\-pdf\fR [] .IP If set, then PDF is also internally generated. This setting should be detected automatically but you may adjust it if klatexformula guesses wrong. .HP \fB\-\-want\-svg\fR [] .IP If set, then SVG is also internally generated (via gs, note: not always available). This setting should be detected automatically but you may adjust it if klatexformula guesses wrong. .HP \fB\-q\fR, \fB\-\-quiet\fR [] .IP Disable console output of warnings and errors. .HP \fB\-\-redirect\-debug\fR .IP Redirects debugging output to the given . If the file name does not end with .klfdebug, this suffix is automatically appended to the file name. If the file exists, it is silently overwritten. .HP \fB\-d\fR, \fB\-\-daemonize\fR .IP Run a separate, detached, klatexformula process and return immediately. All other options, like \fB\-\-latexinput\fR, may still be given. They will be forwared to the daemon process. .HP \fB\-\-skip\-plugins\fR .IP Obsolete. Since Klatexformula 4, no plugin system is available and plugins are never loaded. .HP \fB\-\-calcepsbbox\fR [] .IP Correct the bounding box of the output for characters that don't report a complete or incorrect bounding box. (On by default.) .HP \fB\-\-nocalcepsbbox\fR [] .IP Same as \fB\-\-calcepsbbox=\fR .HP \fB\-\-outlinefonts\fR [] .IP Convert embedded fonts in EPS and PDF to vector outlines (previously, gs pswrite device with option \fB\-dNOCACHE\fR; more recently, gs ps2write with \fB\-dNoOutputFonts\fR). Useful for exporting to eg. Inkscape or Adobe Illustrator. .HP \fB\-\-nooutlinefonts\fR [] .IP Same as \fB\-\-outlinefonts=\fR .HP \fB\-\-lborderoffset\fR .HP \fB\-\-tborderoffset\fR .HP \fB\-\-rborderoffset\fR .HP \fB\-\-bborderoffset\fR .IP Include a margin of N postscript points on left, top, right, or bottom margin respectively. .HP \fB\-\-tempdir\fR .IP Specify the directory in which KLatexFormula will write temporary files. Defaults to a system\-specific temporary directory like "/tmp/". .HP \fB\-\-latex\fR .HP \fB\-\-dvips\fR .HP \fB\-\-gs\fR .HP \fB\-\-epstopdf\fR .IP [OBSOLETE: EPSTOPDF NO LONGER USED] Specifiy the executable for latex, dvips, gs or epstopdf. By default, they are searched for in $PATH and in common system directories. .HP \fB\-Q\fR, \fB\-\-qtoption\fR .IP Specify a Qt\-specific option. For example, to launch KLatexFormula in Plastique GUI style, use .IP klatexformula \fB\-\-qtoption=\fR"\-style=Plastique" .IP Note that if begins with a '\-', then it must be appended to the long '\-\-qtoption=' syntax with the equal sign. .HP \fB\-h\fR, \fB\-\-help\fR [] .IP Display this help text and exit. If a file name is provided, the help message is appended to that file. If the argument is "&", then the help message is printed in file descriptor N. (Reminder: N=1 for standard output 'stdout', N=2 for standard error output 'stderr') .HP \fB\-V\fR, \fB\-\-version\fR [][:] .IP Display KLatexFormula version information and exit. The optional output argument is handled as with \fB\-\-help\fR, however it may also contain a version string format preceded by a colon where %k, and %q and %% are respectively replaced by klatexformula version, Qt version and a literal %. .SH EXAMPLES .IP Create an image named filename.png from the equation 'a^2+b^2=c^2': .IP klatexformula \-\-latexinput 'a^2+b^2=c^2' \-\-output filename.png .IP Open klatexformula window with equation 'f(x)=\-2\e,x', but don't evaluate it: .IP klatexformula \-I \-\-latexinput='f(x)=\-2\e,x' \-\-noeval .IP Open klatexformula window and return immediately to shell command: .IP klatexformula \-I \-\-daemonize .IP Print help message, but to standard output instead of standard error output: .IP klatexformula \-\-help='&1' .SS "Notes:" .IP When run in interactive mode, the newly evaluated equation is appended to KLatexFormula's history. .IP When not run in interactive mode, no X11 server is needed. .IP Please report any bugs and malfunctions to the author. .PP More information is available on http://klatexformula.sourceforge.net/. .PP Have a lot of fun!