fgl_report_setRenderingHints

Syntax

fgl_report_setRenderingHints(
   values om.SaxAttributes )

values - Attribute set containing the key/value pairs.

Rendering hints

Table 1. Rendering hints
Rendering hint	Purpose
`fglAutoformatTemplateURL`, `fglAutoformatLogoURL`, `fglAutoformatOrganizationName` `fglAutoformatSelectionText`, `fglAutoformatKeyText`, `fglAutoformatPrintingInformationText`, `fglAutoformatNumberOfFormColunms` `fglAutoformatNumberOfFormColunms`	Set values for custom generic reports. For more information, go to Create a custom generic report for simple list or form list.
`grvRenderToBitmap` `grvUseEmbeddedFontMetrics` `svgTextLengthAdjust`	Optimize for GRV printing. For more information, go to Optimize the rendering process.
`pdfPreventPageRotation`	Backward compatibility: when set to `TRUE`, report pages do not rotate in PDF output, mimicking the behavior prior to Genero Studio 4.00. For more information, go to Rotating PDF report pages. Note: This rendering hint may be removed in a future release without warning.
`pdfUseIText`	Used to generate a PDF output. This rendering hint causes the Genero Report Engine to generate the PDF output with the iText library. This is typically used when encountering an issue with the PDF output, for example the PDF file is too large, or there is a rendering issue. Note: This rendering hint may be removed in a future release without warning.
`processXMPOrientation`	Determine the orientation of an Image Box. Set to `FALSE` for backward compatibility with older versions of Genero Studio. For more information, go to Configuring XMP metadata processing for images. Note: This rendering hint may be removed in a future release without warning.
`processXMPResolution`	Determine the resolution of an Image Box. For more information, go to Configuring XMP metadata processing for images.
`psOptimize` and `psOptimizeUseDictionary`	Optimize for Postscript printing. For more information, go to Optimize the rendering process.
`pxmlCacheImages`	Disable image caching. For more information, go to Optimize the rendering process.
`pxmlChartStyle`	Specify style and color options for business graphs. Set to `classic` for backward compatibility with older versions of Genero Studio. For more information, go to Specifying classic or default style. Note: This rendering hint may be removed in a future release without warning.
`pxmlColorizePadding`	Backward compatibility: when set to `FALSE`, the padding of an object uses the background color of the parent object, mimicking the behavior for padding an object prior to Genero Studio 3.20. For more information, go to GRW 3.20 upgrade guide. Note: This rendering hint may be removed in a future release without warning.
`pxmlEncodePDF417BackwardCompatible`, `pxmlEncodeQRCodeBackwardCompatible`, `pxmlEncodeDataMatrixBackwardCompatible`.	Revert the pdf-417, data-matrix and data-matrix barcodes to the encoding and ECI support of versions before Genero Report Writer 5.00. For more information, go to Bar Codes.
`pxmlPreferredCharset`	Specify the preferred charset for data-matrix bar codes with the purpose of making scanners with limited ECI support work. When specified, this character set is used for any character in `codeValue` that can be encoded by it. Without specifying a value, the encoder automatically chooses the character sets that lead to minimal encoding for the input. However, many scanners do not support all encodings and several do not support multiple encodings. For example, when `codeValue` contains characters that cannot be encoded in ISO-8859-1, specifying UFT-8 as the preferred charset produces symbols with only one ECI since UTF-8 can encode all Unicode characters. Possible charset values include: Big5 EUC-KR GB2132 IBM437 ISO-8859-1 ISO-8859-13 ISO-8859-15 ISO-8859-16 ISO-8859-2 ISO-8859-3 ISO-8859-4 ISO-8859-5 ISO-8859-6 ISO-8859-7 ISO-8859-8 ISO-8859-9 Shift_JIS US-ASCII UTF-16BE UTF-8 windows-1250 windows-1251 windows-1252 windows-1256 For more information, go to data-matrix.
`pxmlSplitDocument`	Splits a large PDF, RTF, or Excel™ report into smaller files. For more information, go to Split a report into smaller files.
`xlsUse310SizingMechanism`, `xlsAlignmentIgnoringMethod`	Configure the sizing and alignment of rows and columns in Excel reports to mimic the behavior prior to Genero Report Writer 3.20. Excel rendering in Genero Report Writer 3.20 produces a larger number of rows and columns than previous versions. This provides a better WYSIWYG rendering of the document, but can corrupt the vertical alignment when pages are merged into a single sheet. Therefore, you may want to revert to Genero Report Writer 3.10 behavior. `xlsUse310SizingMechanism` is `FALSE` by default. When set to `TRUE`, the column width and row height for Excel reports are computed as in Genero Report Writer 3.10 and earlier. `xlsAlignmentIgnoringMethod` is `1` by default. When set to `0`, rows and columns are aligned as in Genero Report Writer 3.10 and earlier. To render your Excel reports as closely as possible to Genero Report Writer 3.10: `DEFINE renderingHints om.SaxAttributes LET renderingHints=om.SaxAttributes.create() CALL renderingHints.addAttribute("xlsUse310SizingMechanism",TRUE) CALL renderingHints.addAttribute("xlsAlignmentIgnoringMethod",0) CALL fgl_report_setRenderingHints(renderingHints)` Note: This rendering hint may be removed in a future release without warning.

Example

This sample code sets the svgTextLengthAdjust and grvUseEmbeddedFontMetrics hints:

DEFINE renderingHints om.SaxAttributes
LET renderingHints=om.SaxAttributes.create()
CALL renderingHints.addAttribute("svgTextLengthAdjust","SpacingAndGlyphs")
CALL renderingHints.addAttribute("grvUseEmbeddedFontMetrics","true")

CALL fgl_report_setRenderingHints(renderingHints)

For an example of Genero code using a reporting function, see Using report output functions. This example may not use the specific function discussed in this topic, however it provides details on where you would place this (and other) report output functions.