World: r3wp

or a graphic ( how do you include jpgs? )

apply translation 10 10 [ ... translated stuff here ...]  ... no 
more translated outside block...

if I always use 0x0 .. then I can just translate to where I want

you can think of the ] as a "reset" if you wish

so outside the [ ] .. you're back at 0x0 ?

exactly. the transformations are only in effect inside the block.

they are "local"

ahh... well, I just assumed it was like PS and View

so how to include a JPG?

let me check the syntax for the image command...

image x y w h load %file.jpg

i don't yet have a way to include the JPG data directly, i use the 
loaded image. this means that the image gets in the pdf without compression.

and all measurements are in mm ?

yes, unless you set transformations to use different units.

can we use points instead then?

72 points to an inch

i think one point is 0.35 mm, so     apply scaling 0.35 0.35 [...points 
inside here...]      should work

ok, great

(if you need greater precision, you can probably find the exact conversion 
factor on google)

so 

for i 1 100 10 [
	apply transformation i i [
		image i i w h load %file.jpg		
	]
]

would work?

transformation
 = ?

translation?

translation :)

if so yes, but maybe you want 0 0 for the image origin?

oh yeah ...

the x and y for images are there so that you don't have to use a 
translation each time :)

the other way it moves faster off the page

I think Nick has enough to start the tutorial :)

The question for tomorrow is .. how to get a block of text fully 
justified with microkerning

simplest form (default values used for everything):

textbox [
    "This is an example"
]

that does both left and right justification?

yes, that is the default.

(you'll need a longer string to see it of course :)

do you have a hyphenation dictionary?

no, you have to handle that.

so does it just wrap on words?

yes.

you can define hyphenation points with --

eg.: "This is an ex" -- "am" -- "ple"

so if you have a dictionary, you can preprocess your text and just 
output that.

hyphens have a slight penalty so the engine will try to avoid them 
unless necessary. it also tries to avoid more than one in a row.

kerning?

it is automatic.

you can add manual kerning with the kern command

eg. "abc" kern 1 "def"

so if text flow is automatic ... how do you know if the text overlows 
the box provided?

or, how does one flow text from one page to the next ?

what you can do is create a stream of text, and then flow it across 
multiple text boxes, or multiple pages.

eg ?

for example, see the text that starts at page 4 in the test.pdf file?