Welcome to TXP page.

General.- In what follows you will find the README file --a shorter version will be included in the distribution package-- and we encourage you to really read it. We will explain all the details of the routine and how to use it with all its possibilities. Afterwards you can download the small packaged distribution where quite a lot of very small programs, scripts and macros constitute the totality of TXP. (The download place is at the bottom of this page, if you don't want to wait anymore.)

Policy.- This software is free software under the conditions of the GPL license. Apart from that, anyone can do what he/she wants with the routines included in the package, with the sole condition to mention the origin if he/she modifies something and use it in a public way. The mention must be in this terms: First public version created by J.J.Arribas & S.Muelas (August 2000)


In the next lines we will explain how to use the package TXP to obtain the most of it. We begin by listing all the possibilities offered by this macro-routine:

Those are the principals caractheristics of TXP (and it is surprising to be abble to do so many things with a so short routine: around 20 lines).
(If someone is in a hurry, please go directly to the next paragraph...) Now, when writting these lines, a test has been made with a circle. Here is the "result". Althought a little bit too big, this is an interesting shot. If looked in detail someone could think that certain characters are not in the right place. Lets look at the letter "e" in the word "momuments", almost at the end of the paragraph (at right under the theoretical middle line). Well this "e" seems to be "down_its_right_place", almost charging all its weight over the poor "m" before it. But this is not true. It is just an optical effect as will be seen. And care must be taken when speaking about precision using a computer screen. If in doubt, the printer doesn't deceive. So, let's look at this "e" closer. O.k. (this is a small shot). Now we see our letter in reality. This poor "e" doesn't approach specially the strong "m". A similar approach can be made for the word "upon" head_down at left in the upper corner (appxt. at ten o'clock). Well, what is doing this crazy "o". She is jumping out of the line!....no, not exactly. Lets look once more closer. So...the "o" is well placed....but now, in this last shot it seems that the "u" in its round part, is just touching the line and usually, round letters goes a little bit under the line, as it is clear with the letters "o" and "e". Perhaps a mistake of TXP?. Another shot lets see that the "u" is placed in the correct place. Look at it. Quite impressive, isn't it?.

Now let's know how are controlled all this possibilities of TXP. Everything is done in the program principal, the one who calls the macro, so this last doesn't need to be retouched.
To call TXP we need to add nine parameters that will include all the information needed by the macro. Let's explain what this parameters are for:

Now let's write a couple of lines about the program principal. This program can be any standard one written using metapost. If it is wanted to introduce a call to the macro-routine TXP there are some lines that must be introduced. The "skeleton" needed is included in the file "call_txp.mp" in the distribution package. Here are the lines to input:
  1. input txp;
  2. color loc; string ss; path a;
  3. scalet:=1; scafig:=1; hy:=0; tt:=0; sep:=0; loc:=black; lin=0;
  4. defaultfont:= (Font used if different from standard cm. For example regular roman palatino:) "pplr8r";
  5. ss:= (String to write, for example:) "Writting_on_the_path is amusing and easy...";
  6. a= (The path:) z1.. controls z2 and z3..z4;
  7. (Here any modifications to the default values, for example:) scalet:=1.24; hy:= -2.8; tt:= 28; sep:= 0.3; loc:= red; lin= 0.1;
  8. txp(ss,a,scalet,scafig,hy,tt,sep,loc,lin);
And that's all. The call to the macro can be repeated as many times as wanted maintaining or changing the parameters, path and string.

Finally, it must be said something about fonts and how to use it and create new data-font. In the distribution there are included the datafont files for Times, Palatino, Helvetica, ZapChancery and TeX Computer Modern. There are also included a short routine written in AWK (five lines long) called "gentyp.awk". The way of proceeding is as follows:

Now that all the tools are "on the table" let's do the work. Those are the steps:

  1. Once in the working directory, it must be written: tftopl pplb8r.tfm pplb8r.pl. RETURN
  2. Then: awk -f gentyp.awk pplb8r.pl. RETURN
  3. Then: cp fontdat fpplb8r. RETURN
Finally, the file "fpplb8r" has been created. This is the file where all the information about the fonts needed by TXP is included. Once a file of this kind has been created, it can remain without changes as long as the Adobe Fonts are not changed....

The last step in the process is to input the file fpplb8r in the "program.mp" used. In the distribution a program called "example.mp" will permit to try and understand most of the features.

Once done this last step everything is ready to begin writing beautiful logos or strange messages. It must be noted that it is possible (and simple) to write, for example, on a circle some paragraph with a type and a size of font and then in the inner surface of the circle something on a right line with another size and family of fonts. This is a matter of personal choice.
Another possible and simple thing is to modify the TXP macro, for example to change the color of every character or to scale them only vertically or horizontally...It has not been given as standard because the number of parameters must remain in a reasonable amount. But looking at the source, it can be understood how simple it is. We plan to increment the capabilities of our macro if we are able to maintain it simple, what was our first goal.

Have a lot of fun !

Download TXP package.