====== Print Layout Editor ======

Use this tool to define a print layout template. When printing a map, select a template from the list.

===== The Editor Window =====

{{print_layout_window.gif?500&nolink}}

This window shows the paper printable area, and tools to place components on a layout. Most components have editable properties. Bottom right shows the location and size of a selected component and the current viewing scale.

A page layout is created for a specific paper size. All parameters are saved as a layout file with extension *.opl

==== The File Menu ====

TODO Add file menu image

| {{action_new.gif?20x20&nolink}} New Template | Clear all and create a new empty template |
| {{action_open.gif?20x20&nolink}} Open Template... | Open an existing template: select template file from your file system. |
| {{action_recentfiles.gif?20x20&nolink}} Recent Templates | Opens a template you recently worked on |
| {{action_save.gif?20x20&nolink}} Save Template | Save your current template. |
| {{action_save_as.gif?20x20&nolink}} Save Template As... | Save your current template in a different file. |
| {{action_close.gif?20x20&nolink}} Close Template | Clear the template without saving. Does not clear template name. |
| {{action_page_setup.gif?20x20&nolink}} Page Setup... | Presents the Resource Browser to open a Dataset by adding it to the current Workspace. |
| {{action_exit.gif?20x20&nolink}} Exit | Close Print Layout template editor. |

==== Page Setup ====

Use this standard settings window to define the paper size and orientation for your template. It is advised to do this first, before creating your layout. Paper size and orientation are stored in the template so that Orbit recognizes the templates that fit a chosen printer device.

Also, do set the margins correct according to your target printing device. When printing, Orbit GIS refers to the margins set here to determine the page layout. This may differ from the margins required by your printing device.

{{page_setup.gif?366x422&nolink}}

===== How to create a Print Layout template =====

A template is a combination of a page, margins and components. Each component can have properties. You can create, move and edit component properties.

The toolbar shows file buttons, margin buttons and component editing buttons :

| {{zoom_out.gif?20x20&nolink}} Zoom | Zoom in and out by a single click |
| {{margins_show.gif?20x20&nolink}} Show Margins | On/Off : Shows the Margins as set in the Page Setup in a blue dashed line, and the bounds of each component as a blue solid line. |
| {{margins_limit.gif?20x20&nolink}} Limit to Margins | On/Off : Limits the positioning of components to the margins. You cannot move components outside. |
| {{menu_properties.gif?20x20&nolink}} Show Properties | Pops up the properties panel |
| {{action_copy.gif?20x20&nolink}} Copy | Copies the component |
| {{action_delete.gif?20x20&nolink}} Delete | Removes the component. There is no UNDO function available ! |
| {{nudge_left.gif?20x20&nolink}} Nudge tools | Moves the component a single pixel in either direction. |
| {{action_help.gif?20x20&nolink}} Help | Opens these help files |

Components are created by clicking on the component icon ion the right hand toolbar or selecting it fm the components menu. A new component is placed the center of the page. You can drag and move it around, resize and edit its properties. Use the right-click menu for options.

===== Print Layout Template Components =====

The vertical toolbar at the left shows the components to place on the layout.

| {{menu_compass.gif?20x20&nolink}}Compass Rose | Component to place a North Arrow |
| {{menu_image.gif?20x20&nolink}} Image | Component to place any Image |
| {{menu_legend.gif?20x20&nolink}} Legend | Component to place the Legend of the map |
| {{menu_legend_overview.gif?20x20&nolink}} Legend Overview | Component to place the Legend of the Overview map |
| {{menu_line.gif?20x20&nolink}} Line | Component to place a Line |
| {{menu_map.gif?20x20&nolink}} Map | Component to place a Map View |
| {{menu_map_overview.gif?20x20&nolink}} Map Overview | Component to place an Overview Map |
| {{menu_runtime.gif?20x20&nolink}} Runtime Parameter | Component to place an at runtime defined value |
| {{menu_text.gif?20x20&nolink}} Text | Component to place any Text |
| {{menu_scalebar.gif?20x20&nolink}} Scalebar | Component to place a Scalebar |

==== General Tips ====

On a Layout there can only be ONE MAP and ONE LEGEND component. Use the other components to complete your layout.

Set the properties of each component as you desire. Make sure that, when referring to an Image file, the image file must reside in the same directory as the template file.

To be recognised by Orbit GIS, place your template file in the 'templates' folder within your Orbit GIS installation.