1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 2<html> 3 4<head> 5<META http-equiv="Content-Type" content="text/html; charset=windows-1252"> 6<META name="GENERATOR" content="Microsoft FrontPage 5.0"> 7<META http-equiv="Content-Style-Type" content="text/css"> 8<LINK rel="stylesheet" type="text/css" href="../../CSS/revolution.css"> 9<title>GXSetDispCopySrc</title> 10</head> 11 12<body> 13 14<h1 align="left">GXSetDispCopySrc</h1> 15 16 17<h2>C Specification</h2> 18 19<dl> 20 <dd><PRE><CODE>#include <revolution/gx.h></CODE></PRE></dd> 21 <dd><pre><CODE>void GXSetDispCopySrc( 22 u16 left, 23 u16 top, 24 u16 wd, 25 u16 ht );</CODE></pre></dd> 26</dl> 27 28<h2>Arguments</h2> 29<TABLE border="1" cellpadding="3" cellspacing="0.1"> 30 <tr> 31<TD width="120" bgcolor="#ffffe8"><em><strong><CODE>left</CODE></strong></em></TD> 32<TD width="520">The left most source pixel to copy, in multiples of two pixels.</TD> 33 </tr> 34 <tr> 35<TD width="120" bgcolor="#ffffe8"><em><strong><CODE>top</CODE></strong></em></TD> 36<TD width="520">The top most source line to copy, in multiples of two lines.</TD> 37 </tr> 38 <tr> 39<TD width="120" bgcolor="#ffffe8"><em><strong><CODE>wd</CODE></strong></em></TD> 40<TD width="520">width in pixels to copy. in multiples of two pixels.</TD> 41 </tr> 42 <tr> 43<TD width="120" bgcolor="#ffffe8"><em><strong><CODE>ht</CODE></strong></em></TD> 44<TD width="520">height in lines to copy. in multiples of two lines.</TD> 45 </tr> 46</TABLE> 47<h2>Return Values</h2> 48 49<p>None.</p> 50<H2>Description</H2> 51<P>This function sets the source parameters for the embedded frame buffer (EFB) to external frame buffer (XFB) copy operation. Copying occurs normally, after frame or field rendering.</P> 52<P><CODE><EM><STRONG>left</STRONG></EM></CODE> and <CODE><EM><STRONG>top</STRONG></EM></CODE> indicate the location of the pixel within EFB to start copying. <CODE><EM><STRONG>wd</STRONG></EM></CODE> and <CODE><EM><STRONG>ht</STRONG></EM></CODE> specify the width and height of the region to be copied.</P> 53<P>Normally these parameters use the <A href="RenderMode.html"><CODE>render mode</CODE></A> at that time.</P> 54<P><CODE>GXRenderModeObj* rmode = &GXNtsc240IntAa;</CODE></P> 55<P><CODE>GXSetDispCopySrc( 0,<BR> 0,<BR> rmode->fbWidth,<BR> rmode->efbHeight );</CODE></P> 56 57 58<h2>See Also</h2> 59<P><A href="RenderMode.html">Render Modes</A></P> 60<p><a href="GXCopyDisp.html">GXCopyDisp</a></p> 61<H2>Revision History</H2> 62<P>2006/03/01 Initial version.</P> 63<hr> 64<P>CONFIDENTIAL</p> 65</BODY> 66</HTML>