region.html

这个是java的quicktime for java 的详细使用文档

<HR>

<A NAME="setEmpty()"><!-- --></A><H3>
setEmpty</H3>
<PRE>
public void <B>setEmpty</B>()</PRE>
<DL>
<DD>Resets the mathematical structure to the rectangle (0,0,0,0). 
 Destroys the previous mathematical structure of the implicit region.
 <BR><BR><b>QuickDraw::SetEmptyRgn</b><BR><DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="setRect(int, int, int, int)"><!-- --></A><H3>
setRect</H3>
<PRE>
public void <B>setRect</B>(int&nbsp;x,
                    int&nbsp;y,
                    int&nbsp;width,
                    int&nbsp;height)</PRE>
<DL>
<DD>Resets the mathematical structure to the specified coordinates and sizes.
 Destroys the previous mathematical structure of the implicit region.
 May reset the structure to the rectangle(0,0,0,0), if bad parameters.
 <BR><BR><b>QuickDraw::SetRectRgn</b><BR>
 <BR><BR><b>QuickDraw::MacSetRectRgn</b><BR><DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>x</CODE> - the specified leftmost position.<DD><CODE>y</CODE> - the specified topmost position.<DD><CODE>width</CODE> - the specified width.<DD><CODE>height</CODE> - the specified height.</DL>
</DD>
</DL>
<HR>

<A NAME="offset(int, int)"><!-- --></A><H3>
offset</H3>
<PRE>
public void <B>offset</B>(int&nbsp;dh,
                   int&nbsp;dv)</PRE>
<DL>
<DD>Moves the region horizontally and vertically by adding the respective parameters to all of the region.
 <BR><BR><b>QuickDraw::OffsetRgn</b><BR>
 <BR><BR><b>QuickDraw::MacOffsetRgn</b><BR><DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>dh</CODE> - the specified horizontal offset.<DD><CODE>dv</CODE> - the specified vertical offset.</DL>
</DD>
</DL>
<HR>

<A NAME="inset(int, int)"><!-- --></A><H3>
inset</H3>
<PRE>
public void <B>inset</B>(int&nbsp;dh,
                  int&nbsp;dv)</PRE>
<DL>
<DD>Moves all points on the region boundary horizontally and vertically by adding the respective parameters to those points.
 <BR><BR><b>QuickDraw::InsetRgn</b><BR><DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>dh</CODE> - the specified horizontal inset.<DD><CODE>dv</CODE> - the specified vertical inset.</DL>
</DD>
</DL>
<HR>

<A NAME="sect(quicktime.qd.Region)"><!-- --></A><H3>
sect</H3>
<PRE>
public <A HREF="../../quicktime/qd/Region.html">Region</A> <B>sect</B>(<A HREF="../../quicktime/qd/Region.html">Region</A>&nbsp;regionB)
            throws <A HREF="../../quicktime/QTException.html">QTException</A></PRE>
<DL>
<DD>Calculates the intersection of two regions and creates a new region representing that structure.
 May return an empty region if no intersection or one of the regions is empty.
 <BR><BR><b>QuickDraw::SectRgn</b><BR><DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>regionB</CODE> - the specified intersecting region.<DT><B>Returns:</B><DD>The region of intersection.</DL>
</DD>
</DL>
<HR>

<A NAME="sect(quicktime.qd.QDRect)"><!-- --></A><H3>
sect</H3>
<PRE>
public <A HREF="../../quicktime/qd/Region.html">Region</A> <B>sect</B>(<A HREF="../../quicktime/qd/QDRect.html">QDRect</A>&nbsp;r)
            throws <A HREF="../../quicktime/QTException.html">QTException</A></PRE>
<DL>
<DD>Calculates the intersection of this region and the incoming QDRect
  and creates a new region representing that structure.
 May return an empty region if no intersection or one of the regions is empty.
 <BR><BR><b>QuickDraw::SectRgn</b><BR><DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>r</CODE> - the specified intersecting rect.<DT><B>Returns:</B><DD>The region of intersection.</DL>
</DD>
</DL>
<HR>

<A NAME="union(quicktime.qd.Region)"><!-- --></A><H3>
union</H3>
<PRE>
public <A HREF="../../quicktime/qd/Region.html">Region</A> <B>union</B>(<A HREF="../../quicktime/qd/Region.html">Region</A>&nbsp;regionB)
             throws <A HREF="../../quicktime/QTException.html">QTException</A></PRE>
<DL>
<DD>Calculates the union of two regions and creates a new region representing that structure.
 May return an empty region if both regions are empty.
 <BR><BR><b>QuickDraw::UnionRgn</b><BR>
 <BR><BR><b>QuickDraw::MacUnionRgn</b><BR><DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>regionB</CODE> - the specified region to union with.<DT><B>Returns:</B><DD>The region of union.</DL>
</DD>
</DL>
<HR>

<A NAME="union(quicktime.qd.QDRect)"><!-- --></A><H3>
union</H3>
<PRE>
public <A HREF="../../quicktime/qd/Region.html">Region</A> <B>union</B>(<A HREF="../../quicktime/qd/QDRect.html">QDRect</A>&nbsp;rect)
             throws <A HREF="../../quicktime/QTException.html">QTException</A></PRE>
<DL>
<DD>Calculates the union of this region and the incoming rect,
 and creates a new region representing that structure.
 May return an empty region if both regions are empty.
 <BR><BR><b>QuickDraw::UnionRgn</b><BR><DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>rect</CODE> - the specified rect to union with.<DT><B>Returns:</B><DD>The region of union.</DL>
</DD>
</DL>
<HR>

<A NAME="diff(quicktime.qd.Region)"><!-- --></A><H3>
diff</H3>
<PRE>
public <A HREF="../../quicktime/qd/Region.html">Region</A> <B>diff</B>(<A HREF="../../quicktime/qd/Region.html">Region</A>&nbsp;regionB)
            throws <A HREF="../../quicktime/QTException.html">QTException</A></PRE>
<DL>
<DD>Calculates the subtracts the specified explicit region from the implicit region and creates a new region representing that structure.
 May return an empty region if the implicit region is empty.
 <BR><BR><b>QuickDraw::DiffRgn</b><BR><DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>regionB</CODE> - the specified region to find difference with.<DT><B>Returns:</B><DD>The region of difference.</DL>
</DD>
</DL>
<HR>

<A NAME="xor(quicktime.qd.Region)"><!-- --></A><H3>
xor</H3>
<PRE>
public <A HREF="../../quicktime/qd/Region.html">Region</A> <B>xor</B>(<A HREF="../../quicktime/qd/Region.html">Region</A>&nbsp;regionB)
           throws <A HREF="../../quicktime/QTException.html">QTException</A></PRE>
<DL>
<DD>Calculates the difference between the union and intersection of two regions and creates a new region representing that structure.
 May return an empty region if both regions are coincident.
 <BR><BR><b>QuickDraw::XorRgn</b><BR>
 <BR><BR><b>QuickDraw::MacXorRgn</b><BR><DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>regionB</CODE> - the specified region to xor with.<DT><B>Returns:</B><DD>The region of exclusively or.</DL>
</DD>
</DL>
<HR>

<A NAME="rectIn(quicktime.qd.QDRect)"><!-- --></A><H3>
rectIn</H3>
<PRE>
public boolean <B>rectIn</B>(<A HREF="../../quicktime/qd/QDRect.html">QDRect</A>&nbsp;srcRect)</PRE>
<DL>
<DD>Checks whether the specified rectangle intersects the region.
 <BR><BR><b>QuickDraw::RectInRgn</b><BR><DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>srcRect</CODE> - the specified source rectangle<DT><B>Returns:</B><DD>True if at least one bit of the rectangle is contained by the region, false otherwise.</DL>
</DD>
</DL>
<HR>

<A NAME="equalRgn(quicktime.qd.Region)"><!-- --></A><H3>
equalRgn</H3>
<PRE>
public boolean <B>equalRgn</B>(<A HREF="../../quicktime/qd/Region.html">Region</A>&nbsp;rgn)</PRE>
<DL>
<DD>Compares two regions for sizes, shapes, and locations.
 <BR><BR><b>QuickDraw::EqualRgn</b><BR>
 <BR><BR><b>QuickDraw::MacEqualRgn</b><BR><DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>obj</CODE> - the specified comparision region<DT><B>Returns:</B><DD>true if both regions' sizes, shapes, and locations are identical, false otherwise.</DL>
</DD>
</DL>
<HR>

<A NAME="empty()"><!-- --></A><H3>
empty</H3>
<PRE>
public boolean <B>empty</B>()</PRE>
<DL>
<DD>Determines whether a region is empty or not.
 <BR><BR><b>QuickDraw::EmptyRgn</b><BR><DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Returns:</B><DD>True if region is empty, false otherwise.</DL>
</DD>
</DL>
<HR>

<A NAME="map(quicktime.qd.QDRect, quicktime.qd.QDRect)"><!-- --></A><H3>
map</H3>
<PRE>
public void <B>map</B>(<A HREF="../../quicktime/qd/QDRect.html">QDRect</A>&nbsp;srcRect,
                <A HREF="../../quicktime/qd/QDRect.html">QDRect</A>&nbsp;dstRect)</PRE>
<DL>
<DD>Takes the implicit region with one rectangle, maps and scales it to another rectangle.
 <BR><BR><b>QuickDraw::MapRgn</b><BR><DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>srcRect</CODE> - the specified source rectangle<DD><CODE>dstRect</CODE> - the specified destination rectangle</DL>
</DD>
</DL>
<HR>

<A NAME="pointIn(quicktime.qd.QDPoint)"><!-- --></A><H3>
pointIn</H3>
<PRE>
public boolean <B>pointIn</B>(<A HREF="../../quicktime/qd/QDPoint.html">QDPoint</A>&nbsp;pt)</PRE>
<DL>
<DD>Checks whether the pixel below and to the right of the point is within the region.
 <BR><BR><b>QuickDraw::PtInRgn</b><BR><DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>pt</CODE> - the specified point.<DT><B>Returns:</B><DD>True if pt is contained by the region, false otherwise.</DL>
</DD>
</DL>
<HR>