This extension point allows new output formats to be supported in presentation engine. The plugin registry uses this extension point registration to discover all supported output formats.
root element for the emitters extension
a fully qualified identifier of the target extension point
an optional identifier of the extension instance
an optional name of the extension instance
an emitter that exports one or more output formats
an optional identifier of the emitter extension
the java class that implements the <code>IContentEmitter</code> interface
The output format that the emitter supports
The icon path of the emitter
The MIME type for the supported output format
The supported image formats
Pagination of output.
<br>When "page-break-pagination" is set, pagination is based on page break configuration.It is the default value of pagination.
<br>When "no-pagination" is set, content in the report is output as they are in one page.
<br>When "paper-size-pagination" is set, pagination is created based on contents size.
Used to determine whether format is shown in UI
Represents if the emitter needs to output query result set.
allows a developer to define emitter for a report item. Used mainly for extended item, but can also be used for standard report items.
the name of the report item that the emitterClass supports. For example, "chart" for chart extension item
the emitter class that supports this type of report item for a specific format
an optional identifier of the report item emitter extension
2.2.0
The following is a sample usage of the emitterSet extension point:
<p>
<pre>
<extension
point="org.eclipse.birt.report.engine.emitterSet"
name = "Engine Emitters">
<emitter
format="HTML"
id="org.eclipse.birt.report.engine.emitter.html"
class="org.eclipse.birt.report.engine.emitter.html.HTMLReportEmitter">
<reportItem name="chart"
id="org.eclipse.birt.report.engine.emitter.chart.html"
class="org.eclipse.birt.report.engine.emitter.html.HTMLChartEmitter">
</reportItem>
</emitter>
<emitter
format="FO"
mimeType="text/html"
pagination="no-page"
id="org.eclipse.birt.report.engine.emitter.fo"
class="org.eclipse.birt.report.engine.emitter.html.FOReportEmitter">
<reportItem name="chart"
id="org.eclipse.birt.report.engine.emitter.chart.fo"
Class="org.eclipse.birt.report.engine.emitter.html.FOChartEmitter"/>
</emitter>
<emitter
mimeType="application/pdf"
id="org.eclipse.birt.report.engine.emitter.pdf"
class="org.eclipse.birt.report.engine.emitter.html.FOPReportEmitter">
<reportItem name="chart"
id="org.eclipse.birt.report.engine.emitter.chart.pdf"
emitterClass="org.eclipse.birt.report.engine.emitter.html.FOChartEmitter"/>
</emitter>
</extension>
</pre>
<p>
Notice that in this example, the same class is used for both PDF and FO format. BIRT currently uses FO to generate both FO and PDF output.
The value of the class attribute for the emitter element must be the fully qualified name of a class that implement <code>org.eclipse.birt.engine.emitter.IContentEmitter</code>.<p>
The value of the emitterClass attribute for the reportItem element must be a fully qualified name of a class that implements <code>org.eclipse.birt.engine.extension.IReportItemEmitter</code>.
<code>org.eclipse.birt.report.engine.emitter.html.HTMLReportEmitter</code> ---- An HTML emitter that supports report rendering to HTML format.
<code>org.eclipse.birt.report.engine.layout.impl.ReportLayoutEngine</code> ---- An emitter that supports report rendering to PDF format.
Copyright (c) 2005 Actuate Corporation. All rights reserved. This program and
the accompanying materials are made available under the terms of the Eclipse
Public License v1.0 which accompanies this distribution, and is available at
http://www.eclipse.org/legal/epl-v10.html<br><br>
Contributors: Actuate Corporation - initial API and implementation