X-Git-Url: https://sigrok.org/gitweb/?a=blobdiff_plain;f=output%2Foutput.c;h=a3e5dc790363c1377159eb03d44b29446c524952;hb=af51a7718eb22e9630107af814db6ae9f179a969;hp=d726ad934819f09829444b3f4036de781a5d75bb;hpb=393fb9cb18c5746d8567c9cf74b872804043345a;p=libsigrok.git diff --git a/output/output.c b/output/output.c index d726ad93..a3e5dc79 100644 --- a/output/output.c +++ b/output/output.c @@ -1,5 +1,5 @@ /* - * This file is part of the sigrok project. + * This file is part of the libsigrok project. * * Copyright (C) 2010-2012 Bert Vermeulen * @@ -31,6 +31,20 @@ * * Output file/data format handling. * + * libsigrok supports several output (file) formats, e.g. binary, VCD, + * gnuplot, and so on. It provides an output API that frontends can use. + * New output formats can be added/implemented in libsigrok without having + * to change the frontends at all. + * + * All output modules are fed data in a stream. Devices that can stream data + * into libsigrok live, instead of storing and then transferring the whole + * buffer, can thus generate output live. + * + * Output modules are responsible for allocating enough memory to store + * their own output, and passing a pointer to that memory (and length) of + * the allocated memory back to the caller. The caller is then expected to + * free this memory when finished with it. + * * @{ */ @@ -44,7 +58,6 @@ extern SR_PRIV struct sr_output_format output_ols; extern SR_PRIV struct sr_output_format output_gnuplot; extern SR_PRIV struct sr_output_format output_chronovu_la8; extern SR_PRIV struct sr_output_format output_csv; -extern SR_PRIV struct sr_output_format output_float; extern SR_PRIV struct sr_output_format output_analog; /* extern SR_PRIV struct sr_output_format output_analog_gnuplot; */ /* @endcond */ @@ -59,7 +72,6 @@ static struct sr_output_format *output_module_list[] = { &output_gnuplot, &output_chronovu_la8, &output_csv, - &output_float, &output_analog, /* &output_analog_gnuplot, */ NULL,