// Do not edit directly!
// This file was generated by camel-quarkus-maven-plugin:update-extension-doc-page
[id="extensions-fop"]
= FOP
:linkattrs:
:cq-artifact-id: camel-quarkus-fop
:cq-native-supported: true
:cq-status: Stable
:cq-status-deprecation: Stable
:cq-description: Render messages into PDF and other output formats supported by Apache FOP.
:cq-deprecated: false
:cq-jvm-since: 1.1.0
:cq-native-since: 1.2.0

ifeval::[{doc-show-badges} == true]
[.badges]
[.badge-key]##JVM since##[.badge-supported]##1.1.0## [.badge-key]##Native since##[.badge-supported]##1.2.0##
endif::[]

Render messages into PDF and other output formats supported by Apache FOP.

[id="extensions-fop-whats-inside"]
== What's inside

* xref:{cq-camel-components}::fop-component.adoc[FOP component], URI syntax: `fop:outputType`

Please refer to the above link for usage and configuration details.

[id="extensions-fop-maven-coordinates"]
== Maven coordinates

https://{link-quarkus-code-generator}/?extension-search=camel-quarkus-fop[Create a new project with this extension on {link-quarkus-code-generator}, window="_blank"]

Or add the coordinates to your existing project:

[source,xml]
----
<dependency>
    <groupId>org.apache.camel.quarkus</groupId>
    <artifactId>camel-quarkus-fop</artifactId>
</dependency>
----
ifeval::[{doc-show-user-guide-link} == true]
Check the xref:user-guide/index.adoc[User guide] for more information about writing Camel Quarkus applications.
endif::[]

[id="extensions-fop-camel-quarkus-limitations"]
== Camel Quarkus limitations

While you can use any of the available output types in JVM mode, only PDF output type is supported
in native mode. PDF output type in native mode has several limitations:

* Default sRGB color space is always disabled because of https://github.com/oracle/graal/issues/2850[Graal VM issue #2850]
and `disable-srgb-colorspace` https://xmlgraphics.apache.org/fop/2.1/configuration.html[FOP configuration property] is
ignored.

* If custom fonts are used, font cache has to be disabled because of https://github.com/oracle/graal/issues/460[Graal VM issue #460].
Please set the https://xmlgraphics.apache.org/fop/2.1/configuration.html[FOP configuration property] `use-cache` to `false`.

NOTE: Native build for module *camel-quarkus-fop* is affected by the link:https://github.com/apache/camel-quarkus/issues/5244[Fop native failures due to pdfbox 3 upgrade #5244], native profile is not working and disabled until the issue is fixed.

Please file an https://github.com/apache/camel-quarkus/issues/new[issue] if you are missing some specific output format
in native mode.

