From e0c6872cf40896c7be36b11dcc744620f10adf1d Mon Sep 17 00:00:00 2001 From: Norbert Preining Date: Mon, 2 Sep 2019 13:46:59 +0900 Subject: Initial commit --- graphics/tpx/Readme.txt | 1316 +++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 1316 insertions(+) create mode 100644 graphics/tpx/Readme.txt (limited to 'graphics/tpx/Readme.txt') diff --git a/graphics/tpx/Readme.txt b/graphics/tpx/Readme.txt new file mode 100644 index 0000000000..b592b2b4c9 --- /dev/null +++ b/graphics/tpx/Readme.txt @@ -0,0 +1,1316 @@ + +Contents + ========================= + +<> + +<> + +<> + +<> + +<> + +<> + +<> + +<> + +<> + +<> + +<> + +<> + +<> + +<> + +<> + +<> + +<> + +<> + +<> + +<> + +<> + +About TpX drawing tool + ========================= + +TpX is a lightweight, easy-to-use graphical editor for Windows +platform for creation of drawings and inclusion them into LaTeX files +in publication-ready form. It can also be used as a stand-alone editor +for vector graphics. + +The output is a file (with extension .TpX) containing the drawing as +LaTeX code or as an \includegraphics link to an external file created +by the program. User can choose between several <>. +TpX saves its own data in TeX file comments so that the drawing could +be loaded into TpX and edited again. This internal TpX format is based +on XML and could be understood and edited easily. + +TpX can <> EMF/WMF pictures created by other Windows +applications, including many applications producing scientific graphs. +It also can import simple SVG pictures. In most cases the result is +nice, though sometimes imported picture needs some manual editing. So +TpX can be used as a EMF-to-any and SVG-to-any converter. + +TpX usage + ========================= + +TpX is a GUI program. So be prepared to use mouse, menus, etc. The +primary use of TpX is for smooth inclution of vector graphics into +LaTeX documents. + +TpX drawings are included in LaTeX files using \input command, like +\input{foo.TpX}. +It is necessary to use several LaTeX packages for TpX to be functional +(see <> and <>). One can start +from template document called Template.tex in TpX distribution. + +It is possible to keep TpX drawings in a subdirectory. The command in +LaTeX file would be +\input{mypics/foo.TpX} +if subdirectory name is mypics. Set IncludePath in TpX file to +mypics/. + +TpX can be used as a stand-alone editor for vector graphics without +targeting LaTeX. For example, some people use it to produce EMF +graphics for inclusion into popular office programs. It is possible to +create graphics in many export formats. However, note that TpX is not +able to embed fonts in most export formats. Moreover, one needs LaTeX +to produce nice-looking formulas. See <> for more +details. + +TpX can be used from command line without GUI. See <>. + +TpX output formats + ========================= + +TpX provides several output formats. Use "Picture properties" or +toolbar drop-down buttons to change the format. The format is chosen +separately for LaTeX and PdfLaTeX. + +Not all of the formats are ideal, so the choice needs thoughtful +consideration. EPS and PDF are TpX defaults for LaTeX/DVI and PdfLaTeX +respectively. Also recommended is PGF or TikZ. + +* LaTeX picture environment. This standard LaTeX environment is enhanced + by epic.sty and bez123.sty LaTeX packages. Both packages are + compatible with TeX/DVI and PdfLaTeX. The format is suitable for + simple drawings only, because complicated drawings take a long time + for TeX to process and can cause memory shortage. There are many + limitations. For example, curved lines can not be dashed or dotted. + Also, in general the result is of rather low quality. + +* Encapsulated Postscript (EPS). The most popular format for advanced + TeX graphics. EPS is saved as a separate file without text and is + inserted into TpX file using \includegraphics command from graphicx + LaTeX package. TpX surrounds \includegraphics command by picture + environment to put text over the picture. Can not be used with + PdfLaTeX. + +* PDF. Included in TpX in the same fashion as EPS. Can only be used with + PdfLaTeX, not LaTeX/DVI. + +* PDF from EPS. PDF is created from EPS using GhostScript. Set the path + to the program in <<"TpX Settings">>. (The format is called epstopdf + for historical reasons). + +* PGF. PGF code is kept in LaTeX pgfpicture environment similar to + picture environment. Requires pgf package. Compatible with both + LaTeX/DVI and PdfLaTeX. + +* TikZ. TikZ is similar to PGF (and is based upon it), but is more + readable. Requires tikz package. + +* PSTricks. PSTricks code is kept in TeX pspicture environment similar + to picture environment. Requires pstricks package. Not compatible with + PdfLaTeX. + +* Metapost. Graphic language similar to pstricks, but an external file + is created and an external MetaPost program is needed. Set the path to + the program in <<"TpX Settings">>. Compatible with both LaTeX/DVI and + PdfLaTeX. TeX is used to typeset text labels in MetaPost. This could + be turned off by setting MetaPostTeXText to 0. Use metapost.tex.inc + file to configure LaTeX preamble used in MetaPost files + (\documentclass command and \usepackage commands for needed packages). + +* Bitmap (PNG, BMP). Requires graphicx LaTeX package. Obviously, bitmap + is not vector graphics, so it is not scalable. TpX does not use LaTeX + to write text in bitmaps, so they can not incorporate LaTeX formulas. + PNG is compatible with both LaTeX/DVI and PdfLaTeX. Currently BMP is + not compatible with PdfLaTeX. Currently bitmaps are not compatible + with DVIPS and dvi2pdf; they are for DVI viewers only when used with + LaTeX. Thus, bitmaps are most useful with PdfLaTeX. + +* Enhanced Metafile (EMF). Can be used with LaTeX/DVI for preview (it is + converted to bitmap for this purpose). Not compatible with PdfLaTeX. + Recommended as <> only. + +* None. Set format to 'none' if you do not need output. + +All TeX packages used are available from CTAN [http://www.ctan.org/]. + +See also <> + +Export formats + ========================= + +To import TpX drawing into some other program, to embed fonts into +EPS/PDF or to publish drawing on the Web TpX export capabilities could +be used ("Save as.." in "File" menu). TpX can export to several +formats. Note that most export formats can not incorporate TeX fonts +and formulas (however, see below on "LaTeX EPS", and derived formats; +also note MetaPost which is LaTeX-aware). + +* EPS. Type 1 font (.pfb) could be embedded. Set the path to a font in + <<"TpX Settings">>. + +* PDF. Currently font embedding is not implemented, so only Latin + characters and Times are supported. + +* PDF from EPS. PDF is created from EPS using GhostScript. Set the path + to the program in <<"TpX Settings">>. + +* Scalable Vector Graphics (SVG). A promising Web vector graphics + format. Needs a viewer. Several popular vector graphics editors like + Corel Draw or Adobe Illustrator can read it. + +* Bitmap (PNG, BMP). PNG is more compact and could be viewed in most + modern Web browsers so it is recommended. + +* Enhanced Metafile (EMF). Standard Windows vector format. It can also + be copied to Windows clipboard and then pasted into some other program + (like MS Word, PowerPoint, Adobe Illustrator). + +* LaTeX EPS (latex-dvips). EPS produced by running latex and dvips on + TpX drawing. This format allows to include LaTeX formulas and embed + fonts so it is the format of choice for high-quality stand-alone + graphics. Attempt is made to ensure tight bounding box for the EPS. + +* PDF from LaTeX EPS (latex-dvips-gs-pdf). The same as "LaTeX EPS" with + additional run of GhostScript to produce PDF. + +* LaTeX custom (latex-dvips-gs-). The same as "LaTeX EPS" with + additional run of GhostScript to produce a custom image in a format + supported by GhostScript. This is a format of choice to produce high- + quality bitmaps with LaTeX formulas. Set GhostscriptCustomKeys to + change the device and resolution. + +* Metapost program. + +* Metapost EPS output (MPS). + +* LaTeX preview source. Parent LaTeX document and other files needed to + create a DVI/PS preview. This is useful for debugging purposes. + +* PdfLaTeX preview source. Parent pdfLaTeX document and other files + needed to create a PDF preview. + +See also <> + +Import + ========================= + +TpX can import Enhanced Metafile (EMF), though not 100% correctly. +Under Windows most reasonable programs, which produce graphs, can +either export them as EMF files, or copy to clipboard as EMF. To +capture EMF from clipboard, use "Tools">"Capture EMF". EMF can also be +just pasted from clipboard (though this is not recommended if physical +units must be preserved). TpX can also import old-style Windows +Metafiles (WMF). + +Another TpX import format is Scalable Vector Graphics (SVG) based on +open international standard created by W3C [http://www.w3.org/]. As +the format is very rich TpX can understand only some basic subset of +it. + +There is a possibility to use pstoedit utility to import EPS and PDF. +Set the path to the program in <<"TpX Settings">>. The utility could +be downloaded from http://pstoedit.com/. + +TpX primitives + ========================= + +Line (can include arrows) +Rectangle +Polyline +Polygon +Circle +Ellipse +Arc +Sector +Segment +Curve +Closed curve +Bezier path +Closed Bezier path +Text +Star +Symbol +<< Bitmap>> + +Bitmap objects + ========================= + +Bitmaps are included in TpX drawings as external files. TpX +understands JPEG, PNG and BMP images. Image files can be in the same +directory as the parent drawing or in a subdirectory. If inserted +bitmap is not in a subdirectory then "bitmaps" subdirectory is created +and the file is moved there. + +In order to include bitmap in a LaTeX document TpX has to convert it +to EPS. Set the path to converter program in <<"TpX Settings">> +(Bitmap2EpsPath). It is recommended to use sam2p utility which could +be downloaded from http://www.inf.bme.hu/~pts/sam2p/. It is also +possible to use the widespread bmeps utility. + +Bitmaps can not be used with 'tex' and 'metapost' output formats. + +LaTeX preamble + ========================= + +This is a sample preamble to include in parent LaTeX file. It uses +ifpdf package to switch between two different modes of running +PdfLaTeX. (Download ifpdf from CTAN [http://www.ctan.org/] if you do +not have one). Comment out unused packages or just delete the +corresponding commands. + +\documentclass[a4paper,10pt]{article} +\usepackage{color} +\usepackage{ifpdf} +\ifpdf %if using pdfLaTeX in PDF mode + \usepackage[pdftex]{graphicx} + \DeclareGraphicsExtensions{.pdf,.png,.jpg,.jpeg,.mps} + \usepackage{pgf} + \usepackage{tikz} +\else %if using LaTeX or pdfLaTeX in DVI mode + \usepackage{graphicx} + \DeclareGraphicsExtensions{.eps,.bmp} + \DeclareGraphicsRule{.emf}{bmp}{}{}% declare EMF filename extension + \DeclareGraphicsRule{.png}{bmp}{}{}% declare PNG filename extension + \usepackage{pgf} + \usepackage{tikz} + \usepackage{pstricks} +\fi +\usepackage{epic,bez123} +\usepackage{floatflt}% package for floatingfigure environment +\usepackage{wrapfig}% package for wrapfigure environment + + + +LaTeX figure environment + ========================= + +Possible options for LaTeX figure environment are: + +* no figure (user must surround the \input command for TpX drawing by + figure environment and supply the caption and label as usual) + +* standard LaTeX figure environment + +* floatingfigure from floatflt package + +* wrapfigure from wrapfig package + +Packages floatflt and wrapfig are available from CTAN +[http://www.ctan.org/]. Both implement floating figure. + +Using mouse for editing + ========================= + +TpX hot keys could be learned from the main menu. However, some +editing tasks could only be done with mouse. The list follows: + +* Click object: Select object (current selection would be lost) + +* Shift-click object: Add object to selection (current selection would + be maintained) + +* Double-click object: Edit object properties + +* Drag object: Move object + +* Drag control point: Move control point of selected object to reshape + it + +* Ctrl-drag object: Copy object and drag the copy + +* Ctrl-click object/control point: Add/delete control point of selected + object + +* Ctrl-Alt-click object: Break path, making graphical object disjoint + +* Wheel: Move viewport vertically + +* Shift-wheel: Move viewport horizontally + +* Ctrl-wheel: Zoom viewport + +* Alt-drag round control point of Bezier curve: Determines whether the + joint is kept smooth. + +TpX command line options + ========================= + +* -f, --file The name of input file (TpX, EMF, SVG, ...) + +* -i, --texinput The name of parent LaTeX document + +* -l, --texline The line number in parent LaTeX document + +* -o, --output The name of output file + +* -m, --format , The names of TpX <> The formats are tex, pgf, pstricks, eps, png, bmp, metapost, + emf, none for LaTeX/DVI and tex, pgf, pdf, png, metapost, epstopdf, + none for PdfLaTeX. + +* -x, --export The id of <>. The formats + are svg, emf, eps, png, bmp, pdf, metapost, mps, epstopdf, latexeps, + latexpdf, latexcustom, latexsrc, pdflatexsrc. + +-f option can be absent. Just run TpX as +TpX.exe . + +When output file is not specified with -o option, TpX chooses file +name automatically. + +When -i -l options are used the parent TeX file is scanned for +\input{.TpX} line. The line closest to specified line is +chosen. This is useful for calling TpX from LaTeX editor like WinEdt. +(See <> on how to use this with WinEdt.) + +In presence of -o and/or -x option TpX runs without GUI. + +Examples: + +TpX.exe foo.TpX +- open foo.TpX in TpX program, GUI + +TpX.exe foo.TpX -o +- refresh foo.TpX, no GUI + +TpX.exe foo.svg -x png +- import foo.svg and export it as png with name foo-export.png, no GUI + +TpX.exe foo.TpX -o foofoo.TpX -m pgf,png +- load foo.TpX and save it as foofoo.TpX using pgf and png output +formats, no GUI + +Preview + ========================= + +TpX drawing can be previewed in many formats. It can be previewed as a +part of LaTeX document (see <>) or as a stand- +alone image (see <>). + +Stand-alone image is just exported and opened in a default program +associated with the image extension. Note that the fonts are normally +not embedded and the result is not as nice as it is with LaTeX. So use +this for quick preview or for drawings without complex text or +formulas. + +Temporary LaTeX document is produced using one of the following +sequences: + +* LaTeX -> DVI + +* LaTeX -> DVI -> PS + +* PdfLaTeX -> PDF + +Make sure that the paths to the tools (LaTeX, PdfLaTeX, DVIPS) and +viewers needed are set in <<"TpX Settings">>. + +LaTeX preamble is taken from the preview.tex.inc file. This is +basically a \documentclass command. Current version of TpX adds the +packages it needs (graphicx, color, pstricks, pgf, tikz, epic, bez123, +floatflt, wrapfig) automatically. However, make sure that other +relevant packages are included in LaTeX preamble. For example, if you +use AMS fonts, put \usepackage[psamsfonts]{amssymb} to the preamble. +Do not forget to include language and encoding stuff as needed. For +example, + +\usepackage[english,russian]{babel} +\usepackage[cp1251]{inputenc} + +Program settings + ========================= + +Program settings can be changed in "TpX Settings" (in "Files" menu). +The settings are stored in TpX.ini. For the meaning of the settings +used to set initial properties for a new picture (like +PicScale_Default) see <>. + +* PicScale_Default: Default value of PicScale + +* Border_Default: Default value of Border + +* TeXFormat_Default: Default value of TeXFormat + +* PdfTeXFormat_Default: Default value of PdfTeXFormat + +* BitmapRes_Default: Default value of BitmapRes + +* PicMagnif_Default: Default value of PicMagnif + +* IncludePath_Default: Default value of IncludePath + +* LineWidth_Default: Default value of LineWidth + +* ArrowsSize_Default: Default value of ArrowsSize + +* StarsSize_Default: Default value of StarsSize + +* HatchingStep_Default: Default value of HatchingStep + +* HatchingLineWidth_Default: Default value of HatchingLineWidth + +* DottedSize_Default: Default value of DottedSize + +* DashSize_Default: Default value of DashSize + +* DefaultFontHeight_Default: Default value of DefaultFontHeight + +* FontName_Default: Default value of FontName + +* DefaultSymbolSize_Default: Default value of DefaultSymbolSize + +* ApproximationPrecision_Default: Default value of + ApproximationPrecision + +* TeXCenterFigure_Default: Default value of TeXCenterFigure + +* TeXFigure_Default: Default value of TeXFigure + +* FontSizeInTeX_Default: Default value of FontSizeInTeX + +* MetaPostTeXText_Default: Default value of MetaPostTeXText + +* LatexPath: Path to LaTeX (latex.exe) + +* PdfLatexPath: Path to PDFLaTeX (pdflatex.exe) + +* DviPsPath: Path to DVIPS (dvips.exe) + +* DviViewerPath: Path to DVI viewer (e.g. yap.exe). Leave this blank to + use the default viewer + +* PdfViewerPath: Path to PDF viewer (e.g. acrobat.exe). Leave this blank + to use the default viewer + +* PSViewerPath: Path to PostScript viewer (e.g. gsview32.exe). Leave + this blank to use the default viewer + +* SvgViewerPath: Path to SVG viewer (e.g. iexplore.exe). Leave this + blank to use the default viewer + +* PngViewerPath: Path to PNG viewer. Leave this blank to use the default + viewer + +* BmpViewerPath: Path to BMP viewer. Leave this blank to use the default + viewer + +* TextViewerPath: Path to text viewer (e.g. notepad.exe). Leave this + blank to use the default viewer + +* PostscriptPrinter: Postscript printer to create EPS files + +* PostscriptPrinterUseOffset: Use offset when creating EPS files + +* MetaPostPath: Path to MetaPost program (mpost.exe or mp.exe). Needed + for exporting to MetaPost EPS (.mps) + +* Font_pfb_Path: Path to Type 1 font (.pfb). Needed for embedding font + into EPS + +* PsToEditPath: Path to PsToEdit program (pstoedit.exe). Needed for + converting EPS to EMF or SVG (used for EPS import) + +* PsToEditFormat: Format for PsToEdit program for converting EPS to EMF + or SVG (used for EPS import). Format can be emf or one of the better + implementations (wemf, wemfc, wemfnss) which are available in + registered version of PsToEdit. For SVG set plot-svg (free version) or + svg (registered version) + +* GhostscriptPath: Path to Ghostscript program (gswin32c.exe). Needed + for EPS to PDF conversion, custom export (latexcustom) and previewing + PS and PDF files in Open dialog + +* GhostscriptCustomKeys: Ghostscript command line options used for + custom export (latexcustom). Example: -r300 -sDEVICE=png256. List of + possible devices taken literally from Ghostscript follows: bbox bit + bitcmyk bitrgb bj10e bj200 bjc600 bjc800 bmp16 bmp16m bmp256 bmp32b + bmpgray bmpmono bmpsep1 bmpsep8 cdeskjet cdj550 cdjcolor cdjmono + declj250 deskjet devicen display djet500 djet500c eps9high eps9mid + epson epsonc epswrite ibmpro ijs jetp3852 jpeg jpeggray laserjet lbp8 + lj250 ljet2p ljet3 ljet3d ljet4 ljet4d ljetplus m8510 mswindll + mswinpr2 necp6 nullpage pbm pbmraw pcx16 pcx24b pcx256 pcxcmyk pcxgray + pcxmono pdfwrite pgm pgmraw pgnm pgnmraw pj pjxl pjxl300 pkmraw png16 + png16m png256 pngalpha pnggray pngmono pnm pnmraw ppm ppmraw psdcmyk + psdrgb psmono pswrite pxlcolor pxlmono r4081 spotcmyk st800 stcolor + t4693d2 t4693d4 t4693d8 tek4696 tiff12nc tiff24nc tiff32nc tiffcrle + tiffg3 tiffg32d tiffg4 tiffgray tifflzw tiffpack tiffsep uniprint + +* Bitmap2EpsPath: Path to a program (like sam2p or bmeps) which converts + bitmaps to EPS files. (It is used for including bitmaps into output + graphics). + +* RecentFiles: List of recent files + +* ExtAssoc: Associate ".TpX" extension with TpX + +* ShowGrid: Show grid + +* GridOnTop: Grid on top + +* ShowCrossHair: Show crosshair + +* ShowRulers: Show rulers + +* ShowScrollBars: Show scroll bars + +* AreaSelectInside: Area select inside only + +* UseSnap: Snap to grid + +* UseAngularSnap: Angular snap (45 degrees) + +* Mainform.Left: Main window left side position + +* Mainform.Top: Main window top side position + +* Mainform.Width: Main window width + +* Mainform.Height: Main window height + +* Mainform.Maximized: Main window state + +Picture properties + ========================= + +Picture properties are stored inside .TpX file. Default values (which +are used for the new drawings) are taken from <<"TpX Settings">>. +(FontName is left empty which means the use of FontName_Default). + +* Caption: Text for LaTeX \caption + +* Comment: Information about the picture + +* Label: Id for LaTeX \label + +* PicScale: Picture scale (mm per unit), physical size of the logical + unit representing picture coordinates. (This unit is referred to as + "sp" in hints for other picture properties). Use PicScale to scale + picture without scaling line widths and other dimensions set in + physical units. + +* Border: Picture border (mm) + +* TeXFormat: Format for including picture in TeX (tex, pgf, pstricks, + eps, png, bmp, metapost, tikz, emf, none) + +* PdfTeXFormat: Format for including picture in PdfTeX (tex, pgf, pdf, + png, metapost, tikz, epstopdf, none) + +* BitmapRes: Bitmap resolution in pixels per meter. Use BitmapRes to set + resolution of exported PNG and BMP images). Conversion between pixels + per meter (PPM) and pixels per inch (PPI): 100 PPI = 3937 PPM 300 PPI + = 11811 PPM 600 PPI = 23622 PPM + +* PicMagnif: Picture physical size magnification factor. Use PicMagnif + to change the meaning of mm for quick rescaling of the picture + +* IncludePath: Path to add before \includegraphics file name (like + mypictures/) + +* LineWidth: Basic line width (mm). Line widths for the drawing are set + as fractions of this quantity + +* ArrowsSize: Arrows size (sp) + +* StarsSize: Stars size (sp) + +* HatchingStep: Hatching step (mm) + +* HatchingLineWidth: Hatching line width (fraction of LineWidth) + +* DottedSize: Dotted line step size (mm) + +* DashSize: Dashed line step size (mm) + +* DefaultFontHeight: Default font height (sp) + +* FontName: Font for text labels. Leave FontName empty to use + FontName_Default + +* DefaultSymbolSize: Default symbol size factor ("diameter", sp) + +* ApproximationPrecision: Precision of various approximations like + linearization of Bezier curves (mm) + +* MiterLimit: Miter limit. Used to cut off too long spike miter join + could have when the angle between two lines is sharp. If the ratio of + miter length (distance between the outer corner and the inner corner + of the miter) to line width is greater than miter limit, then bevel + join is used instead of miter join. Default value of miter limit is + 10. This option is not applicable to TeX-picture and PsTricks formats. + +* TeXCenterFigure: Center TeX figure by adding \centering before + picture/includegraphics + +* TeXFigure: TeX figure environment: none - no figure, figure - standard + {figure} environment, floatingfigure - {floatingfigure} from floatflt + package, wrapfigure - {wrapfigure} from wrapfig package + +* TeXFigurePlacement: The optional argument [placement] determines where + LaTeX will try to place your figure. There are four places where LaTeX + can possibly put a float: h (Here) - at the position in the text where + the figure environment appears t (Top) - at the top of a text page b + (Bottom) - at the bottom of a text page p (Page of floats) - on a + separate float page, which is a page containing no text, only floats + Putting ! as the first argument in the square brackets will encourage + LATEX to do what you say, even if the result's sub-optimal. Example: + htbp + + For wrapfigure placement is one of r, l, i, o, R, L, I, O, for right, + left, inside, outside, (here / FLOAT) + + The floatingfigure placement option may be either one of the + following: r, l, p, or v. The options all overrule any present package + option which may be in effect. The options have the following + functions: r Forces the current floating figure to be typeset to the + right in a paragraph l Forces the current floating figure to be + typeset to the left in a paragraph p Forces the current floating + figure to be typeset to the right in a paragraph if the page number is + odd, and to the left if even v Applies the package option to the + current figure, and if no package option is specified, it forces the + current floating figure to be typeset to the right in a paragraph if + the page number is odd, and to the left if even + +* TeXFigurePrologue: Text to put before float + +* TeXFigureEpilogue: Text to put after float + +* TeXPicPrologue: Text to put before picture/includegraphics + +* TeXPicEpilogue: Text to put after picture/includegraphics + +* FontSizeInTeX: Put font size information into LaTeX/MetaPost output + code. Set FontSizeInTeX to 0 to use the default font size of the + parent LaTeX document (or default font size of MetaPost drawing) + +* MetaPostTeXText: Use TeX text in MetaPost files + +Some painting details + ========================= + +Line join. Currently TpX uses only "miter line join" (not "bevel join" +or "round join"). + +Miter limit. Used to cut off too long spike miter join could have when +the angle between two lines is sharp. If the ratio of miter length +(distance between the outer corner and the inner corner of the miter) +to line width is greater than miter limit, then bevel join is used +instead of miter join. Default value of miter limit is 10. This option +is not applicable to LaTeX-picture and PsTricks formats. + +Line cap. Currently TpX uses only "butt" line caps. + +Fill rule. Currently TpX uses only "nonzero winding" fill rule (as +opposed to "even-odd" aka "alternate"). + +References: + +* Scalable Vector Graphics (SVG) Specification by W3C + http://www.w3.org/TR/SVG/ + +* PostScript Language Reference by Adobe Systems ("Red Book") + http://www.adobe.com/products/postscript/resources.html + +Lazarus version of TpX + ========================= + +Lazarus is a cross platform clone of Delphi based on open source Free +Pascal compiler. Lazarus version of TpX has some limitations. Some of +the major known ones are + +* Export of bitmap images (PNG, BMP) is not working (this feature needs + conversion of Graphics32 package to Lazarus) + +* Export of EMF images is not working + +* Import of WMF images is not working + +* No "Capture EMF" + +* "Image tool" is not working + +* Alignment of text labels is incorrect (correct alignment needs + additional information about font dimensions) + +Adding TpX to WinEdt menu + ========================= + +* Edit TpX_menu.dat, replacing Path_to_TpX by the actual path to TpX.exe + +* Start "Macros">"Execute Macro..." + +* Choose install_TpX.edt + +Default keyboard shortcut is Alt+P. You can change this in +"Options">"Menu Setup">"Tools">"TpX drawing tool" + +Typing Alt+P in a TeX document with included TpX drawings will run +TpX.exe and load a drawing into it. The drawing closest to the current +cursor position will be opened. The TpX file containing drawing need +not exist. + +WinEdt [http://www.winedt.com] is a powerful editor and shell for TeX +documents. + +Image tool + ========================= + +Image tool is an additional utility embedded into TpX program. It can +manipulate EMF images. A useful function is printing EMF images with +Postscript printer to get EPS file. EPS mode should be set for printer +for this to work. + +TpX modifications log file +========================================= + [+] Added, [-] Fixed, [*] Changed +========================================= + +========================================= +2008-12-07 TpX Version 1.5 +========================================= + +[-] Command line export to latexsrc and pdflatexsrc + did not add '.tex' extension to output file name. + +[-] A bug in undo for freehand lines. + +[-] Grouped objects lost their parent drawing (arrow-heads were + drawn incorrectly for objects in a group), + +[-] Table editor in the "Edit coordinates" window was too narrow + leading sometimes to disappearance of table columns. + +========================================= +2008-11-17 TpX Version 1.5 beta 2 +========================================= + +[-] Fixed problems with TeXLive. + +[-] There was a bug which caused TpX not to load the new + document properties at program start. + +[+] preview.tex.inc was simplified. TpX now adds the packages it + needs automatically. Unneeded packages are not added now + to preview document. + +[*] MetaPost output does not use \textcolor in TeX text anymore. + +[-] preserveAspectRatio='none' was not added when needed while + writing bitmap to SVG. + +[+] Freehand-drawn Bezier path is created with current properties + applied to it. + +========================================= +2008-11-09 TpX Version 1.5 beta +========================================= + +[+] Now it is possible to use the default font size of the parent + LaTeX document by setting FontSizeInTeX property to 0 + (\fontsize...\selectfont would not be added to LaTeX code). + +[-] PicMagnif was not taken into account when setting + font size in MetaPost + +[*] Lua module for generating TpX files (lTpX) + replaced the old Python module (TpXpy) + +[*] New version of TpX file format, version 5. Treatment + of dotted lines has changed incompatibly (see below). + +[*] Vertical alignment of text proved to be unreliable + and hard to be made compatible across devices. + All text labels are now baseline aligned. + +[+] More properties of graphical objects can be changed + using toolbar (for all selected objects at once): + arrow-heads, text labels, stars. + +[-] WinEdt command in 'TpX_menu.dat' fixed to work correctly in + "soft breaks" regime + +[+] Saving preview source + +[+] Picking up, applying and clearing properties of graphical objects + +[+] Improved SVG import + +[+] Store "Snap to grid" and "Angular snap" state + +[+] Store full window position including "maximized" state + +[+] Objects group/ungroup operations. + +[+] "Simplify Bezier" operation + +[+] Bitmap objects (sam2p utility is used to convert bitmaps to EPS + for inclusion into PostScript output) + +[+] Request for showing (as a temporary file) the actual source + (if drawing has changed) + +[-] Some objects did not show up on rubber canvas during drag / rotate + transformation operations + +[+] 'Grid on top' setting + +[+] Optionally remove crosshair + +[-*] Fix for Bezier paths with PSTricks output. Use \moveto + and \curveto instead of \psbezier + +[*] Use dimen=middle for circles and sectors in PSTricks + +[*] Set dashadjust=false in PSTricks for compatibility with other + output formats + +[*] Dots in dotted lines are now square (they where rectangular). + When loading old TpX files the width of dotted lines is + adjusted to make them somewhat more similar to the previous + appearance. + +[+*] Freehand Bezier curve instead of freehand polyline + +[+] "Delete small objects" operation + +[-] Fixed latexeps, latexpdf and latexcustom export for +pgf/tikz (images were too wide in some situations) + +========================================= +2007-08-04 TpX Version 1.4 +========================================= + +[*] Arrows in "Object properties" dialog only for + relevant objects + +[-] Incorrect \centering for TeXFigure=none + +========================================= +2007-07-07 TpX Version 1.4 beta + + TpX Lazarus 1.4 alpha 2 released +========================================= + +[*] TpX internals rewritten to a great extent. + More modular source code + +[+] Cross-platform variant of TpX implemented using Lazarus + +[*-] New version of TpX file format, version 4. The format for + storing ellipses changed (angle now is measured + counterclockwise, which is more logical). PicUnutLength + replaced by BitmapRes + +[+*] Output formats (LaTeX picture, PSTricks, PGF, TikZ, MetaPost) + use the same coordinates as TpX drawing. This is useful for + generating code + +[+] TikZ output format + +[-] "Save as" dialog did not use default extension + +[+] Local popup menu: Copy, Paste, Cut, + Delete, Duplicate, Object properties, + Convert to, Add point, Delete point, Break path + +[+] More stable "LaTeX EPS" + +[+*] Epstopdf perl script replaced by direct use of + GhostScript + +[+] Better grid and ruler divisions + +[*] Dotted lines in PSTricks output format are now similar to + dotted lines in other formats + +[+] Graphical objects alignment + +[+*] More accurate addition of point to path + +[+] Rectangles with rounded corners. (RX and RY + properties of a rectangle). + +[+] "Save as" now shows prompt when overwriting file + +[+] "Simplify polyline/polygon" operation + +[+] "Reverse points" operation + +[+] "Connect paths" operation + +[+] Breaking of paths with mouse (Ctrl+Alt+MouseClick) + +[+] Arrow-heads for arcs + +[*+] Better arrow-heads directions for curves + +[*+] Picture properties added to undo + +[+] HiResBoundingBox in EPS + +[+] Mouse drag on empty space starts area selection mode + +[+] Reverse points order in table editor + +[+] Freehand polyline draw + +[+] Drag-copy with Ctrl+Mouse + +[*] Convert to grayscale is applied to selection if any + or the whole drawing otherwise + +[-] Ellipse and rectangle duplication did not work + +========================================= +2006-05-22 TpX Version 1.3 released +========================================= + +========================================= +2006-04-06 TpX Version 1.3 beta 2 released +========================================= + +[+] New export format "LaTeX EPS" with tight bounding box + (using dvips) and derivatives (PDF using epstopdf, various + GhostScript formats) + +[+] Custom system fonts for graphical objects + (not applies to LaTeX output) + +[*] Simpler hot keys for graphical objects + +[+] Additional hot keys + +[-] A bug in saving of arrow-heads information to TpX file + +========================================= +2006-01-31 TpX Version 1.3 beta released +========================================= + +[*] New version of TpX file format, version 3. The format for + storing rectangles changed + +[-] \pgfsetmiterlimit fixed + +[+] Preview EPS/PDF files in 'Open' dialog + (if GhostscriptPath is set) + +[+] View source + +[*] Open and Import EMF/EPS dialogs merged + +[*] When TeXCenterFigure is 1 and TeXFigure is none then + the picture is surrounded by {center} environment + +[+] A new kind of graphical primitive, "symbol" + +[+] "Arrow-head size factor" property for arrow-heads + +[+] "Star size factor" property for stars + +[+] BezierPrecision setting + +[+] 4 new shapes for stars + +[+] Native import of simple SVG pictures + +[+] New LaTeX and PdfLaTeX output format, 'none' + +[-] ANSI-string text in EMF was incorrectly treated as Widestring + +[+] Many new styles of arrow-heads + +[+] Program now controls changes made to drawing (no more annoying + 'save drawing' dialog when there were no changes) + +[+] New command line options for running TpX without GUI + +========================================= +2005-08-08 TpX Version 1.2 released +========================================= + +[+] HatchingLineWidth option for drawing + +[-] Delay in refreshing Bezier path position when moving + control points + +[*] Conversion of graphical object to another graphical object + does not change its order + +[*] Use ifpdf to detect whether PdfTeX running in PDF mode + +========================================= +2005-07-20 TpX Version 1.2beta released +========================================= + +[+] Classical Bezier paths + +[+] Paste EMF/WMF from clipboard + +[+] Picture info + +[+] Edit coordinates of control points. Data could be copied and + pasted from another application + +[+] "Image tool" for metafiles. Includes EPS printing + +[+] TpXpy, Python module to generate TpX drawings + +[+] Buttons to change basic properties of several objects + +[+] PGF TeX format (suitable both for LaTeX and PdfLaTeX) + +[-] Incorrectness in PSTricks circles and segments + (line width was part of diameter) + +[+] Rotated text + +[*] New version of TpX format, v="2" + (needed to take into account new text height convention) + +[+] Text height convention changed. Now text height does not + include "internal leading" used for accents by Windows GDI + +[-] Filling of Bezier paths in PSTricks was done + incorrectly + +[+] Dropdown menus for TeX preview buttons to change + output format + +[+] Conversion of graphical objects (like ellipse to + spline, etc.) + +[-] PicScale ?? + +[-] Fill rule was inconsistent between formats. + Now TpX uses "nonzero winding" rule everywhere + (not "even-odd" aka "alternate" fill rule) + /See documentation on SVG, PS, PDF or Windows GDI + about fill rule/ + +[*] Moving control points of rectangle or ellipse without + changing direction of it's edges; more natural + moving control points of circular primitives + +[+] LaTeX->DVI->PS preview + +[+] Choose Windows font + +[+] PDF compression + +[+] Preserve text color when importing from EMF + +[+] Convert to grayscale + +========================================= +2005-02-27 TpX Version 1.1 released +========================================= + +[-] Incorrect drawing of polylines in bitmaps when + first and last points coincide + +[+] Miter limit for the whole picture. This could be used + to remove strange spikes at line joins. Visible at Plot3D.TpX + sample picture from TpX distribution + +[+] Antialiased text in bitmaps (PNG, BMP) + +[+] Import old Windows metafiles (WMF) + +========================================= +2005-02-11 TpX Version 1.1beta released +========================================= + +[+] ".TpX" extension could be associated with TpX + +[*+] SVGMagnif replaced by PicMagnif and applies to all formats, + not just SVG. Could be used to scale the whole drawing, + changing the meaning of millimeters (e.g. LineWidth, StarsSize) + +[-] Incorrect text alignment when importing EMF + +[-] Sometimes text was imported incorrectly from EMF + +[+] EPS and PDF import using PsToEdit + +[*] Use Windows temporary directory for temporary files + +[-] Arrow-heads were drawn somewhat inaccurately + +[+] "Recent files" menu + +[+] Preview LaTeX, PdfLaTeX + +[+] Preview EPS, PDF, SVG, PNG, BMP, EMF + +[+] EPS and PDF are surrounded by TeX picture environment + to produce consistent text labels. EPS and PDF are now defaults + for LaTeX and PdfLaTeX respectively + +[+] 10 additional star shapes (previously there was only one + shape - circle) + +[*] PicScale (scale in mm per world unit) instead of + PicWidth/PicHeight + +[-] Unstable algorithm was used for calculation closed splines + +[+] Scrollbars to move viewport + +[+] Mouse wheel: move and zoom viewport + +[+] Line (text) color, hatching color, fill color + +[-] Incorrect vertical text alignment in TeX-picture, PSTricks + and MetaPost formats + +[-] Incorrect font size in MetaPost format when using + btex...etex + +[*] TeX font size selection using \fontsize{}{}\selectfont + (TeX picture, PSTricks, MetaPost btex...etex) + +========================================= +2004-10-31 TpX Version 1.0.1 released +========================================= + +[+] PDF from EPS using epstopdf + +[+] Type 1 fonts in EPS + +[-] Incorrect help about WinEdt installation (edit TpX_menu.dat, + not install_TpX.edt) + +[-] Ini file location was not linked to exe file path + +[-] Error when running on Windows system with comma set as a + decimal point + +========================================= +2004-10-24 TpX Version 1.0 released +========================================= + + +Acknowledgements + ========================= + +Modules used in TpX: + + CADSYS 4.0 + Copyright (c) 2001 Piero Valagussa + pivalag[@@@]tin.it + + Graphics32 library + Copyright (c) 2000-2004 Alex Denisov and Contributors + http://graphics32.org + + PowerPdf library, ver 0.9 + Takeshi Kanno + http://www.est.hi-ho.ne.jp/takeshi_kanno/powerpdf/ + + XML library + Copyright (c) 2002 Ravil Batyrshin, Mikhail Vlasov (Aravil Software) + http://www.torry.net/vcl/internet/html/mvrbxmlparsers.zip + + PNG Component + Copyright (c) Gustavo Huffenbacher Daud, + http://pngdelphi.sourceforge.net + + HTML Help Kit for Delphi, + Copyright (c) 1999 The Helpware Group + http://www.helpware.net + + MD5 Message-Digest for Delphi + Copyright (c) 1997-1999 Medienagentur Fichtner & Meyer + Written by Matthias Fichtner + http://www.fichtner.net/delphi/md5.delphi.phtml + + StitchSAX 1.1 - Trivial SAX parser for Delphi + Copyright (c) 2002, Roman Poterin + poterin[@@@]mail.ru + + Paszlib + Copyright (c) 1998,1999,2000,2001 by Jacques Nomssi Nzali + http://www.nomssi.de/paszlib/paszlib.html + +Links + ========================= + +Some links to similar and related programs + + LaTeXDraw + http://latexdraw.sourceforge.net/ + + jPicEdt + http://www.jpicedt.org/ + + Xfig + http://www.xfig.org/ + + WinFIG + http://www.schmidt-web-berlin.de/winfig/ + + Metagraf + http://w3.mecanica.upm.es/metapost/metagraf.php + + Ipe + http://tclab.kaist.ac.kr/ipe/ + + JpgfDraw + http://theoval.cmp.uea.ac.uk/~nlct/jpgfdraw/index.html + + Mayura Draw + http://www.mayura.com/ + + Graphics Layout Engine + http://glx.sourceforge.net/ + + LaTeXPiX + http://www.beurden.cjb.net/latexpix.htm + + TeXCAD + http://homepage.sunrise.ch/mysunrise/gdm/texcad.htm + + TeXCad32 + http://www.gelbes-rechenbuch.de/Texcad32/Index_e.html + + ePiX + http://mathcs.holycross.edu/~ahwang/current/ePiX.html + + OLETeX Utility + http://oletex.sourceforge.net/ + + pstoedit + http://www.pstoedit.net/ + +------------------------------- +TpX 1.5 readme file +Generated 2008-12-07 15:14:54 -- cgit v1.2.3