ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzalu_5.4.0.1/rzaluprtgr.htm

94 lines
5.1 KiB
HTML

<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en-US" xml:lang="en-us">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="dc.language" scheme="rfc1766" content="en-us" />
<!-- All rights reserved. Licensed Materials Property of IBM -->
<!-- US Government Users Restricted Rights -->
<!-- Use, duplication or disclosure restricted by -->
<!-- GSA ADP Schedule Contract with IBM Corp. -->
<meta name="dc.date" scheme="iso8601" content="2005-09-06" />
<meta name="copyright" content="(C) Copyright IBM Corporation 1998, 2006" />
<meta name="security" content="public" />
<meta name="Robots" content="index,follow"/>
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
<title>Print a graphic with other output</title>
<link rel="stylesheet" type="text/css" href="ibmidwb.css" />
<link rel="stylesheet" type="text/css" href="ic.css" />
</head>
<body>
<a id="Top_Of_Page" name="Top_Of_Page"></a><!-- Java sync-link -->
<script language = "Javascript" src = "../rzahg/synch.js" type="text/javascript"></script>
<a name="rzaluprtgr"></a>
<h4 id="rzaluprtgr">Print a graphic with other output</h4>
<p>The command word #$@INCLGRPH allows a user to include a
graphic anywhere in the data printed by high-level languages.</p>
<p>To include graphics with other program output, a special control record
is used. The format for this control record is: </p>
<pre class="xmp">#$@INCLGRPH filename,x,y,w,l</pre>
<a name="wq241"></a>
<div class="notelisttitle" id="wq241">Notes:</div>
<ol type="1">
<li>There must be only one space between the command word and the parameters.</li>
<li>All five parameters must be specified. A default value (the default values
are included in the list below) for parameters x, y, w, and l can be obtained
by omitting any value. For example, a valid control record with defaults
for parameters x, y, and l would look like:
<pre class="xmp">#$@INCLGRPH filename,,,9.5,</pre></li>
<li>The #$@INCLGRPH control record should be in a print record
by itself, because any other data along with it might be considered as parameters.</li>
<li>Parameters should immediately follow one another, separated by commas,
using no blanks.</li>
<li>The characters INCLGRPH must be all uppercase.</li>
<li>The #$@INCLGRPH control record must begin in the first
column.</li>
<li>The #$@INCLGRPH control word is used with characters from
code page 500. For example, in code page 500, @ is hex '7B', $ is
hex '5B', and @ is hex '7C'. Other code pages might use other characters
in the #$@INCLGRPH control record. You will need to change
the characters depending on the code page being used.</li>
</ol>
<p>The parameters are defined below. Parameters <tt class="xph">x, y, w,</tt> and <tt class="xph">l</tt> define the area on the page where the graphics file will be printed.
Parameters <tt class="xph">x</tt> and <tt class="xph">y</tt> define the upper-left corner of
the graphics area, and parameters <tt class="xph">w</tt> and <tt class="xph">l</tt> define the
size of the graphics area. </p>
<dl>
<dt class="bold">filename</dt>
<dd>The name of the graph object file to be included. If the file has more
than one member, the last member is used. The library containing the file
must be in your library list.
</dd>
<dt class="bold">x</dt>
<dd>The distance, in inches, from the left edge of the page to the left
edge of the graphics area on the page. The default is 0.
</dd>
<dt class="bold">y</dt>
<dd>The distance, in inches, from the top of the page to the top edge of
the graphics area on the page. The default is 0.
</dd>
<dt class="bold">w</dt>
<dd>The width of the graphics area, in inches. The default is the width
of the current page you are using.
</dd>
<dt class="bold">l</dt>
<dd>The length of the graphics area, in inches. The default is the length
of the current page you are using.
</dd>
</dl>
<p>Parameters <tt class="xph">x, y, w,</tt> and <tt class="xph">l</tt> can be specified in decimal
form in any combination of xx.xx, where <tt class="xph">x</tt> is any number from 0
through 9. The specified value cannot be more than 45.50 and, if a 0 value
is specified, the result is the default value for that parameter.</p>
<p>If there are any errors found in the control record or an error occurs
while processing the graphics file, the control record is printed as normal
text data. The graphics file to be used must be in a format acceptable to
the printer. For IPDS&trade; devices, this format is level DR/2 of the Graphic
Object Content Architecture (GOCA). See the manual <cite>Graphic Object Content Architecture</cite> , SC31-6804, for more information about GOCA.</p>
<a id="Bot_Of_Page" name="Bot_Of_Page"></a>
</body>
</html>