[Pyzzle-users] CVS update new text module.

SourceForge Headquarters 1320 Columbia Street Suite 310 San Diego, CA 92101 +1 (858) 422-6466

<html>
<head>
</head>
<body>
Hello, 
 
I've added the requested text module, its still a little messy but I'm quite
happy with the way it works. I've added a new directory to the cvs &nbsp;repositary
so make sure you update with the -d switch as below. 
 
[andy@the_box pyzzle-cvs]$ cvs update -d 
 
So what are you waiting for get downloading, but dont forget to backup you
code files. (-: 
 
Ok its the easyiest to use addition yet so lets get started: 
 
1st off all the text stuff is contained in the following directory: pyzzle-cvs/data/text/ 
Because text is more data then code its included here and not in the main
directory. Open that new textdata.py file in the text directory. 
You will imeadiently notice there is a new text class similar to the ambient
sound class. Its dead easy here is one: 
 
text2.text() # just defining text2 
... 
text2.name = 'text2' 
text2.string = 'You should have received a copy of the GNU General Public
License\ 
along with Pyzzle; if not, write to the Free Software\ 
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA&nbsp; 02111-1307&nbsp; USA' 
text2.fontFile = 'SNIDELY_.TTF' 
text2.rect = (0, 0, 300, 300) 
text2.colour = (200,0,0) 
text2.size = 14 
text2.justification = 1 
 
[textNo].name &nbsp;&lt;- Give the text element a name, (Not in use yet) 
 
[textNo].string &lt;- This is the text strings you want to display over the
slide. Standard python string formatting or unicode formatting is &nbsp;used,
see the python docs for more info about std. formatting. 
 
[textNo].fontFile &lt;- Just the truetype font file you want the text to
be displayed in. Note pyzzle only takes .ttf fonts and be carefull not to
copy a copyrighted file. I dont want to get in trouble with adobe.(; 
 
[textNo].rect &nbsp;&lt;- This is the rect* that will containing and position
the font. As with most of pyzzles rects its position is relative to the topleft
corner of the slide. There is no current checking if the rect is on th slide,
so be careful with it. Note if a word of text is too long for the rect or
if there is too much text for the rect then Pyzzle will exit. Also text is
auto wrapped in the rect, hats off to David Clark of pygame for that code. 
 
[textNo].colour &lt;- is just the RGB value for the text colour. Range 0-255. 
 
[textNo].size &lt;- is just the size of the text. 
 
[textNo].justification &lt;- is the justification for the text. Here are
the different types: 
&nbsp;0 left-justified 
&nbsp;1 horizontally centered 
&nbsp;2 right-justified 
 
Ok this is all good, but how do you display the text? Well thats the simpilest
part. for node.navtype there is a new element called 'text' 
heres the example node view1_3 the view behind where you start in Gloom: 
 
view1_3.navtype = ['LandR', 'text'] 
view1_3.file = ('castleroom1-3.jpg') 
view1_3.navdata = view1_2,view1_4 
view1_3.text = [text3] 
 
so view1_3.text = [text3] just tell pyzzle which text class to display. Simple.
If you want to know how I change the text ramdomly then just has a look in
slidechange.py. 
 
Ok that it. Currently there are no realtime functions for text, like the
image ones. I dont know how useful they would be but I anyone wants them
it would be pretty simple to write them. Also note all the text is anti-aliased
pygame anti-aliasing is really good, but not quite upto pro graphics packages. 
 
Other news for Pyzzle is that pygame OSX support is rocking allong, which
is exelent news for Pyzzle and Pygame. So if anyone knows anyone with a OSX
box have a chat to them about Pyzzle. When pygames osx support becomes official
I will write a more official email requesting people to test pyzzle with
OSX. So get them interested in the mean time. 
 
Have fun with the new text class. 
Andy 
 
 
* For those who do not know what a rect is &nbsp;then its just pygames way of
representating a rectange container. It works like: 
somerect = (leftPos , topPos , width , height
 ) 
Note for Pyzzle leftPos and topPos are usually relative to
the topleft corner of the slide. 
Easy. (-; 
</body>
</html>