fgl_report_setRenderingHints

Specifies the hints to be used in the rendering process.

Syntax

fgl_report_setRenderingHints(
   values om.SaxAttributes )
  1. 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.
pxmlIgnoreImageBoxErrors When set to true, the rendered report ignores errors which occur when the ImageBox cannot load the specified image. The ImageBox is rendered with the specified size, but remains empty. When the rendering hint is set to true, the GRE_DEFAULT_IMAGE_URL environment variable is ignored.
When set to false, if the ImageBox cannot load the specified image, errors are shown in the Output. If a fallback image is specified with the GRE_DEFAULT_IMAGE_URL environment variable it is used within the ImageBox and presents the following warning within the Output;
WARN com.fourjs.report.layoutnode.ImageBox - ImageBox.com.fourjs.report.layoutnode.ImageBox: Failed to read image from url XXX.
If the image specified with the GRE_DEFAULT_IMAGE_URL envronment variable cannot load, a runtime error is raised in the Output.

For more information on the GRE_DEFAULT_IMAGE_URL environment variable , go to GRE_DEFAULT_IMAGE_URL.
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.