LuaTeX provides a very interesting facility called “callbacks”. A callback is a Lua function that you provide and which LuaTeX will call at certain times during the course of processing your document. LuaTeX defines a number of callback opportunities which are detailed in the LuaTeX Reference Manual. <\/p>\n
To use callbacks you have to provide the Lua function and then register it with LuaTeX so that it knows to call your function at the appropriate time. You can provide callbacks for many purposes such as reading input files, processing input buffers, hooking into line breaking, page building and so forth. <\/p>\n
Callbacks are an exceptionally<\/em> powerful concept and they open the door to very sophisticated document processing solutions. For example, you can hook into the internal node lists and process them to achieve special effects. Here is a very simple and short “plain TeX” example of hooking into LuaTeX’s To quote the LuaTeX Reference Manual <\/p>\n post_linebreak_filter<\/strong>: This callback is called just after LuaTEX has converted a list of nodes into a stack of \\hboxes.<\/p><\/blockquote>\n In the following example, just after LuaTeX has processed the vbox, and broken the paragraph into lines, it calls a Lua function called The output is a 5-page PDF: the first four pages are the individual lines in the typeset paragraph and the final page is the vbox. <\/p>\npost_linebreak_filter<\/code> (and, in addition, playing with setting the page size). <\/p>\nlinelist<\/code> which simply ships out each line in the paragraph. Also, and not part of the callback, a copy of the vbox is output on the last page, setting the page size to be that of the vbox.<\/p>\n\r\n\\pdfoutput=1\r\n\\hoffset-1in\r\n\\voffset-1in\r\n\\nopagenumbers\r\n\\directlua{\r\nlinelist=function(head)\r\nlocal boxer=200\r\nfor line in node.traverse_id('hlist',head) do\r\n tex.setbox(boxer, node.copy(line))\r\n tex.box[boxer].height= tex.box[boxer].height+65536 %add 65536sp = 1pt to avoid clipping\r\n tex.box[boxer].depth= tex.box[boxer].depth+65536 %add 65536sp = 1pt to avoid clipping\r\n tex.shipout(boxer)\r\nend\r\nreturn head\r\nend\r\ncallback.register("post_linebreak_filter",linelist)\r\n}\r\n\r\n\\setbox1000=\\vbox{\\hsize=50mm Let us examine the structure of a list of hboxes in a vbox because\r\nit is an instructive thing to do.}\r\n\\pdfpagewidth=\\wd1000\r\n\\vsize=\\ht1000\r\n\\advance\\vsize by 65536 sp\r\n\\pdfpageheight=\\vsize\r\n\\box1000\r\n\\bye\r\n<\/pre>\nThe output<\/h2>\n