📄 swcompositor.html
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Frameset//EN""http://www.w3.org/TR/REC-html40/frameset.dtd"><!--NewPage--><HTML><HEAD><!-- Generated by javadoc on Mon Jul 15 11:49:46 PDT 2002 --><TITLE>: Class SWCompositor</TITLE><LINK REL ="stylesheet" TYPE="text/css" HREF="../../../stylesheet.css" TITLE="Style"></HEAD><BODY BGCOLOR="white"><!-- ========== START OF NAVBAR ========== --><A NAME="navbar_top"><!-- --></A><TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0"><TR><TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1"><A NAME="navbar_top_firstrow"><!-- --></A><TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3"> <TR ALIGN="center" VALIGN="top"> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD> <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/SWCompositor.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD> </TR></TABLE></TD><TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM></EM></TD></TR><TR><TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> <A HREF="../../../quicktime/app/anim/Compositor.html"><B>PREV CLASS</B></A> <A HREF="../../../quicktime/app/anim/SWController.html"><B>NEXT CLASS</B></A></FONT></TD><TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> <A HREF="../../../index.html" TARGET="_top"><B>FRAMES</B></A> <A HREF="SWCompositor.html" TARGET="_top"><B>NO FRAMES</B></A></FONT></TD></TR><TR><TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> SUMMARY: INNER | <A HREF="#field_summary">FIELD</A> | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD><TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">DETAIL: <A HREF="#field_detail">FIELD</A> | <A HREF="#constructor_detail">CONSTR</A> | <A HREF="#method_detail">METHOD</A></FONT></TD></TR></TABLE><!-- =========== END OF NAVBAR =========== --><HR><!-- ======== START OF CLASS DATA ======== --><H2><FONT SIZE="-1">quicktime.app.anim</FONT><BR>Class SWCompositor</H2><PRE>java.lang.Object | +--<A HREF="../../../quicktime/app/spaces/SimpleSpace.html">quicktime.app.spaces.SimpleSpace</A> | +--<B>quicktime.app.anim.SWCompositor</B></PRE><DL><DT><B>All Implemented Interfaces:</B> <DD><A HREF="../../../quicktime/app/spaces/Collection.html">Collection</A>, <A HREF="../../../quicktime/app/image/Compositable.html">Compositable</A>, <A HREF="../../../quicktime/app/display/Drawable.html">Drawable</A>, <A HREF="../../../quicktime/app/display/DrawingNotifier.html">DrawingNotifier</A>, <A HREF="../../../quicktime/app/spaces/DynamicCollection.html">DynamicCollection</A>, <A HREF="../../../quicktime/app/image/DynamicImage.html">DynamicImage</A>, <A HREF="../../../quicktime/app/image/ImageSpec.html">ImageSpec</A>, <A HREF="../../../quicktime/app/spaces/Listener.html">Listener</A>, <A HREF="../../../quicktime/app/display/QTDisplaySpace.html">QTDisplaySpace</A>, <A HREF="../../../quicktime/app/display/QTDrawable.html">QTDrawable</A>, <A HREF="../../../quicktime/app/spaces/Space.html">Space</A>, <A HREF="../../../quicktime/app/time/Ticklish.html">Ticklish</A>, <A HREF="../../../quicktime/app/image/Transformable.html">Transformable</A></DD></DL><DL><DT><B>Direct Known Subclasses:</B> <DD><A HREF="../../../quicktime/app/anim/Compositor.html">Compositor</A></DD></DL><HR><DL><DT>public abstract class <B>SWCompositor</B><DT>extends <A HREF="../../../quicktime/app/spaces/SimpleSpace.html">SimpleSpace</A><DT>implements <A HREF="../../../quicktime/app/display/QTDisplaySpace.html">QTDisplaySpace</A>, <A HREF="../../../quicktime/app/image/DynamicImage.html">DynamicImage</A>, <A HREF="../../../quicktime/app/display/DrawingNotifier.html">DrawingNotifier</A></DL><P>SWCompositor provides the capability to composit a complex image together of disparate image sources and then treat the result as a single image which is presented to the user. <P> It uses the QuickTime SpriteWorld internally to perform the compositing tasks. Thus all of the actual drawing of the members of a SWCompositor is handled through the interaction between the SpriteWorld and Sprite classes of quicktime. <P> The SpriteWorld itself is wrapped by the SWCompositor class, and to represent the Sprite class it uses the TwoDSprite. The TwoDSprite is a presenter - it presents image information and the presenation of the image information within the context of the SWCompositor's SpriteWorld is determined by the matrix, graphics mode, layer and visibility of the TwoDSprite's Sprite object. <P> To create a Sprite you need a valid SpriteWorld. To create a SpriteWorld you need a valid QDGraphics destination. Depending on whether a SWCompositor is visible or not you may or may not have a valid destination QDGraphics. The interaction between the SWCompositor and its TwoDSprite presenters handles the saving and creating of SpriteWorlds and their Sprites - the application does not need to deal specifically with this issue. <P> The SWCompositor has been designed without the requirement that its members be TwoDSprites. It maybe more convenient for an application to add members of a Compositor that are a source of image data and have the addMember method deal with the mechanics of creating the TwoDSprite presenter. Thus there are also methods that must be defined by the subclass for getting a member's TwoDSprite, and getting a TwoDSprite's member. This is important to understand for the following reason. Once a member has been added to a SWCompositor, it is the presenter within the SWCompositor itself (the TwoDSprite) that must be interacted with to effect the display characteristics of the member in the SWCompositor. Whilst a subclass may provide the capability to create the TwoDSprite presenter with display characteristics like Matrix and GraphicsMode, once the member is added altering the member's display characteristics directly may or may not effect the display characteristics of the member in the SWCompositor. Thus an application is better to always interact with the member's TwoDSprite presenter. <P> After a member is added to the SWCompositor the subclass should call the postProcessAdd (and remove in the case of a removeMember call). This call will look at the member that is being added and will perform two services. If the new member is an instance of the Notifier class then the SWCompositor registers the Notifer with the TwoDSprite presenter as the NotifyListener. That way a Sprite who presents image data that is not available at the time the member is added can still prepare itself for displaying an image when its Notifier notifies the TwoDSprite that its image data is valid. If the new member is an instance of DynamicImage, then this method will also call that member's addedToCompositor method to allow this new member to establish the invalidation mechanism it uses. Explicit invalidation is required for the SpriteWorld to redraw a Sprite that presents image data that is changing (such as a Movie) when nothing about the Sprite's presentation has changed. <P> The subclass defines completely the storage mechanism and protocols of its members.<P><DL><DT><B>See Also: </B><DD><A HREF="../../../quicktime/std/anim/SpriteWorld.html"><CODE>SpriteWorld</CODE></A>, <A HREF="../../../quicktime/std/anim/Sprite.html"><CODE>Sprite</CODE></A>, <A HREF="../../../quicktime/app/anim/TwoDSprite.html"><CODE>TwoDSprite</CODE></A>, <CODE>quicktime.app.display.Compositor</CODE></DL><HR><P><!-- ======== INNER CLASS SUMMARY ======== --><!-- =========== FIELD SUMMARY =========== --><A NAME="field_summary"><!-- --></A><TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%"><TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"><TD COLSPAN=2><FONT SIZE="+2"><B>Field Summary</B></FONT></TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE> int</CODE></FONT></TD><TD><CODE><B><A HREF="../../../quicktime/app/anim/SWCompositor.html#hitTestFlag">hitTestFlag</A></B></CODE><BR> default hit test is only to test on the visible pixels of a sprite</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE> int</CODE></FONT></TD><TD><CODE><B><A HREF="../../../quicktime/app/anim/SWCompositor.html#taskFlag">taskFlag</A></B></CODE><BR> This flag is used when the task method is called.</TD></TR></TABLE> <A NAME="fields_inherited_from_class_quicktime.app.spaces.SimpleSpace"><!-- --></A><TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%"><TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor"><TD><B>Fields inherited from class quicktime.app.spaces.<A HREF="../../../quicktime/app/spaces/SimpleSpace.html">SimpleSpace</A></B></TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD><CODE><A HREF="../../../quicktime/app/spaces/SimpleSpace.html#containedSpaces">containedSpaces</A>, <A HREF="../../../quicktime/app/spaces/SimpleSpace.html#controllersVec">controllersVec</A>, <A HREF="../../../quicktime/app/spaces/SimpleSpace.html#ticklers">ticklers</A>, <A HREF="../../../quicktime/app/spaces/SimpleSpace.html#timer">timer</A></CODE></TD></TR></TABLE> <A NAME="fields_inherited_from_class_quicktime.app.time.Ticklish"><!-- --></A><TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%"><TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor"><TD><B>Fields inherited from interface quicktime.app.time.<A HREF="../../../quicktime/app/time/Ticklish.html">Ticklish</A></B></TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD><CODE><A HREF="../../../quicktime/app/time/Ticklish.html#kScale">kScale</A></CODE></TD></TR></TABLE> <!-- ======== CONSTRUCTOR SUMMARY ======== --><A NAME="constructor_summary"><!-- --></A><TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%"><TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"><TD COLSPAN=2><FONT SIZE="+2"><B>Constructor Summary</B></FONT></TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE>protected </CODE></FONT></TD><TD><CODE><B><A HREF="../../../quicktime/app/anim/SWCompositor.html#SWCompositor(quicktime.qd.QDGraphics, quicktime.qd.QDColor, quicktime.qd.QDGraphics, int, int, quicktime.app.spaces.Protocol)">SWCompositor</A></B>(<A HREF="../../../quicktime/qd/QDGraphics.html">QDGraphics</A> spriteGWorld, <A HREF="../../../quicktime/qd/QDColor.html">QDColor</A> backgroundColor, <A HREF="../../../quicktime/qd/QDGraphics.html">QDGraphics</A> background, int scale, int period, <A HREF="../../../quicktime/app/spaces/Protocol.html">Protocol</A> defaultProtocol)</CODE><BR> Used by subclasses to construct a SWCompositor.</TD></TR></TABLE> <!-- ========== METHOD SUMMARY =========== --><A NAME="method_summary"><!-- --></A><TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%"><TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"><TD COLSPAN=2><FONT SIZE="+2"><B>Method Summary</B></FONT></TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE> void</CODE></FONT></TD><TD><CODE><B><A HREF="../../../quicktime/app/anim/SWCompositor.html#addDrawingListener(quicktime.app.display.DrawingListener)">addDrawingListener</A></B>(<A HREF="../../../quicktime/app/display/DrawingListener.html">DrawingListener</A> listener)</CODE><BR> Registers an object as a listener of the Compositor.</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE> <A HREF="../../../quicktime/app/actions/Invalidator.html">Invalidator</A></CODE></FONT></TD><TD><CODE><B><A HREF="../../../quicktime/app/anim/SWCompositor.html#addedToCompositor(quicktime.app.anim.SWCompositor, quicktime.app.anim.TwoDSprite)">addedToCompositor</A></B>(<A HREF="../../../quicktime/app/anim/SWCompositor.html">SWCompositor</A> c, <A HREF="../../../quicktime/app/anim/TwoDSprite.html">TwoDSprite</A> s)</CODE><BR> Returns an object that invalidates a sprite.</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE>protected void</CODE></FONT></TD><TD><CODE><B><A HREF="../../../quicktime/app/anim/SWCompositor.html#createMembers()">createMembers</A></B>()</CODE><BR> This method is called after the Compositor has been added to a valid QDGraphics and the sprites can be added to the spriteworld.</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE> <A HREF="../../../quicktime/qd/Region.html">Region</A></CODE></FONT></TD><TD><CODE><B><A HREF="../../../quicktime/app/anim/SWCompositor.html#getClip()">getClip</A></B>()</CODE><BR> Returns the current clipping region used by the sprite world</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor">⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -