<?xml version="1.0" encoding="UTF-8"?>

<sample>

  <name>landscape</name>
  <title>Landscape Sample</title>
  <description>Shows how reports can be generated and printed in "Landscape" page format.</description>

  <mainFeature ref="landscape"/>
  
  <!-- landscape -->
  
  <feature name="landscape" title="Creating Landscape Orientation Report Templates">
    <description>
How to create landscape orientation reports.
    </description>
    <since>0.1.0</since>
    <content>
This feature is used when a report should be visualized or printed in the <code>Landscape</code> page layout. 
A page is considered to be in a <code>Landscape</code> orientation when its width and height appear as interchanged.
<br/>
In order to manage its pages layout, the <code>&lt;jasperReport /&gt;</code> element contains the <code>orientation</code> attribute.
<br/>
Values allowed for this attribute are:
<ul>
<li><code>Portrait</code></li>
<li><code>Landscape</code></li>
</ul>
By default, in JasperReports pages are visualized as <code>Portrait</code>. The <code>orientation</code> being an attribute at report level, its value applies to all pages in the generated document. 
<br/>
Below is a code snippet showing how to set in a report the <code>Landscape</code> orientation:
<pre><![CDATA[
<jasperReport
		xmlns="http://jasperreports.sourceforge.net/jasperreports"
		xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
		xsi:schemaLocation="http://jasperreports.sourceforge.net/jasperreports http://jasperreports.sourceforge.net/xsd/jasperreport.xsd"
		name="LandscapeReport" pageWidth="842" pageHeight="595" orientation="Landscape" columnWidth="842" leftMargin="0" rightMargin="0" topMargin="0" bottomMargin="0">
]]></pre>
Here one can observe that <code>pageWidth</code> and <code>pageHeight</code> values were interchanged and the <code>orientation</code> attribute takes the <code>Landscape</code> value.
<br/>
<br/>
In order to figure out more on page orientation behavior, just test this sample by running from the command line the <code>ant test view</code> command. 
It will generate all supported document types containing the sample report in the /build/reports directory, and then the generated report will be open with JasperReports internal viewer.
    </content>
  </feature>

</sample>
