Backend construction

When the sources are parsed their data are represented in the stream where they can be processed to produce the final document(s). It is strongly recommended to do this by using the backend class shipped with the converter framework. In a first step, we have to make an object of this class. It is immediately configured, right by the constructor call.

    # build a backend
  
    my $backend=new PerlPoint::Backend(
                                       name    => 'pp2sdf',
                                       display =>   DISPLAY_ALL
                                                  + (exists $options{noinfo} ? DISPLAY_NOINFO : 0)
                                                  + (exists $options{nowarn} ? DISPLAY_NOWARN : 0),
                                       trace   =>   TRACE_NOTHING
                                                  + ((exists $options{trace} and $options{trace} & 32) ? TRACE_BACKEND : 0),
                                       vispro  => 1,
                                      );

Names and behaviour of these constructor options are mostly known from call of the parsers run() method.

name

a description used to identify the backend.

display

used to pass the display settings. Please copy this code.

trace

used to pass the trace settings. Please copy this code.

vispro

if set to a true value, the backend will display runtime informations.

Note: because backend processing does not consume stream data, it is possible to use more than one backend at a time, but there are still side effects. This may be improved by future framework versions.