User manual MATLAB MATLAB REPORT GENERATOR 3

[. . . ] MATLAB® Report GeneratorTM 3 User's Guide How to Contact The MathWorks Web Newsgroup www. mathworks. com/contact_TS. html Technical Support www. mathworks. com comp. soft-sys. matlab suggest@mathworks. com bugs@mathworks. com doc@mathworks. com service@mathworks. com info@mathworks. com Product enhancement suggestions Bug reports Documentation error reports Order status, license renewals, passcodes Sales, pricing, and general information 508-647-7000 (Phone) 508-647-7001 (Fax) The MathWorks, Inc. 3 Apple Hill Drive Natick, MA 01760-2098 For contact information about worldwide offices, see the MathWorks Web site. MATLAB® Report GeneratorTM User's Guide © COPYRIGHT 1999­2010 by The MathWorks, Inc. The software described in this document is furnished under a license agreement. The software may be used or copied only under the terms of the license agreement. [. . . ] Each of these attribute sets is a pagination style data item for PDF stylesheets. You can edit a particular attribute in the set by selecting it in the Outline pane on the left. For an example of modifying font size and other properties of a PDF report, see "Changing Font Size, Page Orientation, and Paper Type of a Generated Report" on page 6-34. 6-27 6 Creating Custom Stylesheets Examples In this section. . . "Numbering Pages in a Report" on page 6-28 "Adding Graphics to Headers in PDF Reports" on page 6-29 "Changing Font Size, Page Orientation, and Paper Type of a Generated Report" on page 6-34 "Editing Font Size as a Derived Value in XML" on page 6-37 Numbering Pages in a Report This example shows how to edit a stylesheet cell to number the upper-right side of all pages in the generated report. 1 Define a basic stylesheet cell in the Header Content cell group with a condition of right. a Open a PDF stylesheet in the Report Explorer. b Double-click Header Content (under Pagination and General Styles) in the Options pane in the middle. c Click Position - Right in the Properties pane on the right. 2 Set the header content to the current page number by selecting Page number from the Append template selection list. 6-28 Examples 3 Click Append. Adding Graphics to Headers in PDF Reports This example shows how to include an image in the center of the header of each page in a PDF report, excluding the report's title page and the first page of each chapter. You must know the size of the image so that you can allow enough room for it in the header. This example uses the sample_logo. bmp image, which is shown here. 6-29 6 Creating Custom Stylesheets Note PDF reports support only bitmap (. bmp ) and jpeg (. jpg ) images. To include this image file in the center of each header in the body of a PDF report: 1 Open mfile-report. rpt by entering the following at the MATLAB command prompt: setedit mfile-report 2 Create a custom stylesheet. a Select Tools > Edit Stylesheet in the menu bar of the Report Explorer. e Save the stylesheet as logo_stylesheet. rgs in a folder on your MATLAB path. 3 Open the cell group for editing. a Scroll through the Options pane on the left to the Pagination and General Styles folder. b Double-click Header Content in the Options pane. c Click Body page ­ Center from the list of cells in the Properties pane on the right. The Properties pane appears as shown. 6-30 Examples d Delete the text in the Value (XML) field. e Select Graphic from the Append template selection list and click Append. The Properties pane on the right shows the XML code that tells the File Converter to include the graphic. 6-31 6 Creating Custom Stylesheets 4 By default, the name of the graphic is logo. bmp. Change all instances of this name to sample_logo. bmp in the Value (XML) field. 5 Save the stylesheet. 6 Make sure that the amount of room available in the header is large enough to accommodate the image file. a In the Options pane in the middle, double-click Region Before Extent, which is in the Pagination and General Styles folder. 6-32 Examples b By default the value for the height of the header is 0. 4 inch. b In the selection lists under the Report Format and Stylesheet area of the Properties pane on the right: · Specify Acrobat (PDF) for File format · Specify Logo stylesheet for PDF. c Click Report on the toolbar to generate the report. 6-33 6 Creating Custom Stylesheets Changing Font Size, Page Orientation, and Paper Type of a Generated Report This example shows how to: · Generate an XML source file without converting it to a supported report format · Make section headers in a report larger · Change the report page orientation to landscape · Change the report paper type to A4 Create a custom stylesheet by editing an existing stylesheet to change the appearance of the wsvar-report report, which is provided with the MATLAB Report Generator software. 1 Generate a source file for the report. a Open the report by entering the following command in the MATLAB Command Window: setedit wsvar-report b In the Report Format and Stylesheet area of the Properties pane, change the format to DocBook (no transform). c Check the If report already exists, increment to prevent overwriting check box. d Select File > Report to generate the report. The report-generation process creates an XML source file in the MATLAB Editor. 2 Convert the report to PDF format. a Select Tools > Convert Source File from the Report Explorer menu bar to open the File Converter. b From the Source file selection list, enter wsvar-report0. xml. [. . . ] When specifying the name of the report template, omit the . rpt file name extension. · [report1, report2, . . . ] = report (rptfile1, rptfile2, . . . ) returns the names of the generated reports. If the MATLAB Report Generator software cannot generate a given report, its returned name is empty. The report command also accepts the following flags, which set options for the report during the report-generation process. [. . . ]