#include <CSprite.h>

Inheritance diagram for CSprite:

Public Member Functions
	CSprite (IPMUnknown *boss)

virtual	~CSprite ()

virtual bool16	CreateSprite (IGraphicsContext gc, UIDList itemList, const PMPoint &startPt, bool16 bDrawItemList)

virtual void	DestroySprite (IGraphicsContext *gc)

virtual bool16	Show (IGraphicsContext gc, const PMPoint &where, int32 flags, PMMatrix xForm)

virtual bool16	Scroll (IGraphicsContext gc, const PMPoint &delta, int32 flags, PMMatrix xForm)

virtual void	Erase (IGraphicsContext gc, const PMPoint &where, int32 flags, PMMatrix xForm)

virtual void	Hide (IGraphicsContext gc, bool16 bForceRedraw, PMMatrix extraXform)

virtual void	InvalidateBBox ()

virtual void	DisableShapes (IGraphicsContext *gc, bool16 disable)

virtual SysRect	GetDeviceBounds (IGraphicsContext gc, int32 flags, PMMatrix xForm)

virtual bool16	ValidSprite () const

virtual bool16	NeedsUpdate (const PMPoint &where, int32 flags) const

Protected Member Functions
virtual void	DisableHandleShapes (IGraphicsContext *gc, bool16 disable)

virtual PMRect	GetShapeDeviceBounds (IGraphicsContext *gc, int32 flags)

virtual PMRect	GetHandleDeviceBounds (IGraphicsContext gc, int32 flags, PMMatrix xForm)

virtual PMRect	GetTrackerBounds (IGraphicsContext *gc, int32 flags)

virtual PMRect	GetSelectionBounds (IGraphicsContext *gc)

virtual void	DrawTrackerExtra (IGraphicsContext *gc, int32 flags)

virtual void	ShowFirstTime (IGraphicsContext gc, const PMPoint &where, int32 flags, PMMatrix xForm)

virtual void	ShowSprite (IGraphicsContext gc, const PMPoint &where, int32 flags, PMMatrix xForm)

virtual void	ScrollSprite (IGraphicsContext gc, const PMPoint &delta, int32 flags, PMMatrix xForm)

virtual void	ShowLowMemory (IGraphicsContext gc, const PMPoint &where, int32 flags, PMMatrix xForm)

virtual void	ShowLowMemoryFirstTime (IGraphicsContext gc, const PMPoint &where, int32 flags, PMMatrix xForm)

virtual void	ScrollLowMemory (IGraphicsContext gc, const PMPoint &delta, int32 flags, PMMatrix xForm)

virtual void	HideSprite (IGraphicsContext gc, bool16 bForceRedraw, PMMatrix extraXform)

virtual void	HideLowMemory (IGraphicsContext gc, bool16 bForceRedraw, PMMatrix extraXform)

virtual void	EraseAndRedrawShapes (IGraphicsContext gc, const PMPoint &where, int32 flags, PMMatrix xForm)

virtual void	SetHiliteColor (UID layerUID)

virtual void	DrawShapes (IGraphicsContext *gc, SysRgn clipRgn=nil, bool16 bDisable=kFalse)

virtual void	DrawSelection (IGraphicsContext *gc)

virtual void	DrawSpriteShapes (IGraphicsContext *gc, int32 flags)

virtual void	DrawSpriteHandles (IGraphicsContext gc, int32 flags, PMMatrix xForm)

virtual void	CreateTrackerPaths (IGraphicsContext *gc)

virtual void	CreateHandlePaths (IGraphicsContext *gc, bool16 bDoDirectionHandles=kTrue)

virtual void	ClipToView (IGraphicsContext gc, SysRect bounds)

virtual void	ClipToView (IGraphicsContext *gc, PMRect &bounds)

virtual PMRect	GetStandOffBBox (IShape pShape, IGraphicsContext gc, int32 flags, const PMRect &bBox)

virtual int32	GetDrawFlags () const

virtual bool16	UseDisplayList (int32 flags)

void	AddInvalidOffscreenBounds (IControlView iView, PMRect invalidBounds)

void	AddInvalidLayoutBounds (IControlView iView, PMRect invalidBounds)

void	DrawSmartGuides (IGraphicsContext gc, const PBPMPoint where, const PMMatrix xForm)

Static Protected Member Functions
static void	DrawCenterX (IGraphicsPort *gPort, const PBPMPoint &center)

Protected Attributes
PMMatrix	fXformFromLastShow

SysRect	fLastBounds

ColorArray	fRGBColorValue

PMPoint	fStartPoint

PMPoint	fCurrentPoint

SysPoint	fLastMouseLoc

IControlView *	fControlView

UIDList *	fItemList

IDVOffscreenPortData *	fBackgroundVP

IDVOffscreenPortData *	fForegroundVP

IDataBase *	fDataBase

int32	fDrawFlags

bool16	fValidDeviceBounds

bool16	fFirstTime

bool16	fValidSprite

bool16	fLowMemory

bool16	fIsFrontView

bool16	fDrawItemList

bool16	fIsPathSelection

bool16	fHandlesDisabled

bool16	fDoRevealAllImageData

bool16	fSmartGuidesDrawn

bool16	fDrawSmartGuides

Additional Inherited Members
Public Types inherited from ISprite
enum	{ kDefaultIID = IID_ISPRITE }

Detailed Description

CSprite is an implementation of ISprite used by trackers to update the screen while tracking. For example, when resizing a page item, a resize tracker will create a sprite. The sprite represents the page item that is being resized and is called by the tracker to "Show" every time the mouse is moved. Sprites can draw in wire frame mode or in "patient user" mode. When in wire frame mode, the original page item continues to draw unchanged while an outline of the page item is dynamically updated to show the effect of the change made by the tracker. In patient-user mode, the layout is continually redrawn to show the full effect of the change made by the tracker, as if the user released the mouse after each step.

Constructor & Destructor Documentation

CSprite::CSprite ( IPMUnknown * boss )

Constructor

virtual CSprite::~CSprite ( )

virtual

Destructor

Member Function Documentation

void CSprite::AddInvalidLayoutBounds	(	IControlView *	iView,
		PMRect *	invalidBounds
	)

protected

Called when we are setting up our offscreens to obtain any additional area to be updated. Only used in offscreen mode (i.e., not in low memory mode).

Parameters

iView	- IN: Used to obtain pending invals for the offscreen.
invalidBounds	- OUT: Pending invals for the provided view are unioned with invalidBounds.

void CSprite::AddInvalidOffscreenBounds	(	IControlView *	iView,
		PMRect *	invalidBounds
	)

protected

Called when we are setting up our offscreens to obtain pending invals for the offscreen. Only used in offscreen mode (i.e., not in low memory mode).

Parameters

iView	- IN: Used to obtain offscreen's pending inval areas.
invalidBounds	- OUT: Pending invals for the provided offscreen are unioned with invalidBounds.

virtual void CSprite::ClipToView	(	IGraphicsContext *	gc,
		SysRect *	bounds
	)

protectedvirtual

Given a rectangle, clip it to the view referenced by the provided IGraphicsContext.

Parameters

gc	- IN: A pointer to the IGraphicsContext representing the device to which the sprite draws.
bounds	- IN/OUT: The rectangle to intersect with the view bounds.

virtual void CSprite::ClipToView	(	IGraphicsContext *	gc,
		PMRect &	bounds
	)

protectedvirtual

Given a rectangle, clip it to the view referenced by the provided IGraphicsContext.

Parameters

gc	- IN: A pointer to the IGraphicsContext representing the device to which the sprite draws.
bounds	- IN/OUT: The rectangle to intersect with the view bounds.

virtual void CSprite::CreateHandlePaths	(	IGraphicsContext *	gc,
		bool16	bDoDirectionHandles = `kTrue`
	)

protectedvirtual

Helpers to draw the handles and paths

Parameters

gc	- IN: The IGraphicsContext.
bDoDirectionHandles	- IN: Include the control handles for each point?

Reimplemented in NoHandleSprite.

virtual bool16 CSprite::CreateSprite	(	IGraphicsContext *	gc,
		UIDList *	itemList,
		const PMPoint &	startPt,
		bool16	bDrawItemList
	)

virtual

Create sprite.

Parameters

gc	- IN: A pointer to the IGraphicsContext representing the device that the sprite will draw to.
itemList	- IN: The uidlist indicates those items that the sprite is rendering. It uses those items to compute the offscreen bounding box. If drawItemList is kTrue then the sprite will draw the items in the uid list during show. If itemList is nil that means the sprite should draw its own paths (if any) and ignore the item list related drawing. The path creation trackers use a nil item list because the actual page item isn't created until the end of dynamics.
startPt	- IN: start point.
bDrawItems	- IN: tells the sprite whether or not to draw the uid items during show. Set to kFalse only if the sprite implementation has another way that it draws the updated paths/shapes (such as spline editting).

Returns: returns kFalse if low memory. In that case, the sprite might do nothing or use XOR in ISprite::Show(). If returns kTrue the sprite succeed in creating offscreens.

Implements ISprite.

virtual void CSprite::CreateTrackerPaths ( IGraphicsContext * gc )

protectedvirtual

Override CreateTrackerPaths to do something special such as the reference line in the rotate sprite. CSprite's implementation walks/draws the path stored in the IPathGeometry of the sprite's boss and then draws the handle vectors.

Parameters

gc	- IN: The IGraphicsContext.

Reimplemented in NoHandleSprite.

virtual void CSprite::DestroySprite ( IGraphicsContext * gc )

virtual

Releases references to offscreens and cleans up.

Parameters

gc	- IN: A pointer to the IGraphicsContext representing the device to which the sprite draws. Used to issue an draw invalidations or screen redraws that may be necessary as part of the cleanup process.

Implements ISprite.

virtual void CSprite::DisableHandleShapes	(	IGraphicsContext *	gc,
		bool16	disable
	)

protectedvirtual

Obsolete.

virtual void CSprite::DisableShapes	(	IGraphicsContext *	gc,
		bool16	disable
	)

virtual

If called, this will disable the shapes in the uidlist from drawing in the background offscreen. This is different than the bDrawItems flag in CreateSprite. DisableShapes specifically affects only the items drawing during the creation of the background.

Parameters

gc	- IN: A pointer to the IGraphicsContext representing the device to which the sprite draws. Necessary to obtain the IDrawMgr for the port in order to tell the IDrawMgr to Disable the shape.
disable	- IN: kTrue to disable the drawing of the shape. kFalse to enable the drawing.

Implements ISprite.

static void CSprite::DrawCenterX	(	IGraphicsPort *	gPort,
		const PBPMPoint &	center
	)

staticprotected

Draws dragging a wire frame sprite, a small X is drawn in XOr mode at the center of each page item.

Parameters

gPort	- IN: The port to draw into.
center	- IN: Where, in pasteboard coordinates, to draw the X.

virtual void CSprite::DrawSelection ( IGraphicsContext * gc )

protectedvirtual

Draw any selection highlighting.

Parameters

gc	- IN: A pointer to the IGraphicsContext to draw into.

virtual void CSprite::DrawShapes	(	IGraphicsContext *	gc,
		SysRgn	clipRgn = `nil`,
		bool16	bDisable = `kFalse`
	)

protectedvirtual

Draw the shapes intersecting the union of the clipRgn and any pending invalidation areas for the view represented by the provided GraphicsContext.

Parameters

gc	- IN: A pointer to the IGraphicsContext to draw into.
clipRgn	- IN: May be nil. Actually represents any additional area to update. This region gets unioned with any pending invalidations for the view represented by the gc.
bDisable	- IN: indicates whether to allow the sprite uid list objects to draw or not.

void CSprite::DrawSmartGuides	(	IGraphicsContext *	gc,
		const PBPMPoint	where,
		const PMMatrix *	xForm
	)

protected

Draw smart alignment guides.

Parameters

gc	- IN: A pointer to the IGraphicsContext representing the device to which the sprite draws.
xForm	- IN: The matrix represents the transformation that is passed into all the IHandleShapes in the item list (See CreateSprite). The matrix is a pasteboard relative transformation.

virtual void CSprite::DrawSpriteHandles	(	IGraphicsContext *	gc,
		int32	flags,
		PMMatrix *	xForm
	)

protectedvirtual

Calls DrawCenterX in XOr mode for each of the items in the itemList passed into CreateSprite.

Parameters

gc	- IN: A pointer to the IGraphicsContext representing the device to which the sprite draws.
flags	- IN: flags are IShape::flags.

See Also: IShape.h

Parameters

xForm - IN: The matrix represents the transformation that is passed into all the IHandleShapes in the item list (See CreateSprite). The matrix is a pasteboard relative transformation.

Reimplemented in NoHandleSprite.

virtual void CSprite::DrawSpriteShapes	(	IGraphicsContext *	gc,
		int32	flags
	)

protectedvirtual

Draws the itemList passed into CreateSprite to the provided gc, using the IShape::flags

Parameters

gc	- IN: A pointer to the IGraphicsContext to draw into.
flags	- IN: flags are IShape::flags.

See Also: IShape.h

virtual void CSprite::DrawTrackerExtra	(	IGraphicsContext *	gc,
		int32	flags
	)

protectedvirtual

Draws the dynamic part of the changes when not in patient-user mode. Draws the paths in xor mode.

Parameters

gc	- IN: A pointer to the IGraphicsContext representing the device to which the sprite draws.
flags	- IN: flags are IShape::flags.

See Also: IShape.h

virtual void CSprite::Erase	(	IGraphicsContext *	gc,
		const PMPoint &	where,
		int32	flags,
		PMMatrix *	xForm
	)

virtual

For the case when the sprite fails to create an offscreen, you can still use it for dynamics. But to do so requires the user to call erase so the old drawing is cleaned up. Erase should be called with the previous position. i.e., if the object is moving call show, then erase, then move the object, then show, then erase, then move the object, then show, etc. Of course erase should only be called immediately before moving the object (and only if the object is to move). flags are IShape::flags

Parameters

gc	- IN: A pointer to the IGraphicsContext representing the device to which the sprite draws.
where	- IN: Obsolete. Not used.
flags	- IN: flags are IShape::flags.

See Also: IShape.h

Parameters

xForm - IN: The matrix represents the transformation that is passed into all the IHandleShapes in the item list (See CreateSprite). The matrix is a pasteboard relative transformation.

Implements ISprite.

virtual void CSprite::EraseAndRedrawShapes	(	IGraphicsContext *	gc,
		const PMPoint &	where,
		int32	flags,
		PMMatrix *	xForm
	)

protectedvirtual

In the provided gc, erases and redraws the update area defined by GetDeviceBounds.

Parameters

gc	- IN: A pointer to the IGraphicsContext representing the device to which the sprite draws.
where	- IN: Obsolete. Not used.
flags	- IN: flags are IShape::flags.

See Also: IShape.h

Parameters

xForm - IN: The matrix represents the transformation that is passed into all the IHandleShapes in the item list (See CreateSprite). The matrix is a pasteboard relative transformation.

virtual SysRect CSprite::GetDeviceBounds	(	IGraphicsContext *	gc,
		int32	flags,
		PMMatrix *	xForm
	)

virtual

Gets device bounds

Parameters

gc	- IN: A pointer to the IGraphicsContext representing the device to which the sprite draws.
flags	- IN: flags are IShape::flags.

See Also: IShape.h

Parameters

xForm - IN: The matrix represents the transformation that is passed into all the IHandleShapes in the item list (See CreateSprite). The matrix is a pasteboard relative transformation.

Returns: Returns the bounds used by the sprite. The bounds includes everything the sprite would draw during show given the same flags and matrix. For CSprite, this bounds is the union of GetShapeDeviceBounds, GetHandleDeviceBounds and GetTrackerBounds, all clipped to the view.

Implements ISprite.

virtual int32 CSprite::GetDrawFlags ( ) const

protectedvirtual

Returns the draw flags to use when when calling DrawMgr::Draw. For standard sprites this value is cached during CreateSprite. However, some sprites (TextOffscreen) may need to calculate the draw flags more often than that

virtual PMRect CSprite::GetHandleDeviceBounds	(	IGraphicsContext *	gc,
		int32	flags,
		PMMatrix *	xForm
	)

protectedvirtual

Gets handle device bounds

Parameters

gc	- IN: A pointer to the IGraphicsContext representing the device to which the sprite draws.
flags	- IN: flags are IShape::flags.

See Also: IShape.h

Parameters

xForm - IN: The matrix represents the transformation that is passed into all the IHandleShapes in the item list (See CreateSprite). The matrix is a pasteboard relative transformation.

Returns: Returns the union of the IHandleShape::GetPaintedBBox of each of the items in the itemList passed to CreateSprite.

virtual PMRect CSprite::GetSelectionBounds ( IGraphicsContext * gc )

protectedvirtual

Gets selection bounds

Parameters

gc	- IN: A pointer to the IGraphicsContext representing the device to which the sprite draws. Used to obtain the view that is passed into the GetSelectionRgn call.

Returns: Returns bounds of the current selection. Bounds are obtained by asking the ISelectionManager for the ISelectionDataSuite and then computing the bounds on its GetSelectionRgn.

virtual PMRect CSprite::GetShapeDeviceBounds	(	IGraphicsContext *	gc,
		int32	flags
	)

protectedvirtual

Gets shape device bounds

Parameters

gc	- IN: A pointer to the IGraphicsContext representing the device to which the sprite draws.
flags	- IN: flags are IShape::flags.

See Also: IShape.h

Returns: Returns the union of the IShape::GetPaintedBBox of each of the items in the itemList passed to CreateSprite.

virtual PMRect CSprite::GetStandOffBBox	(	IShape *	pShape,
		IGraphicsContext *	gc,
		int32	flags,
		const PMRect &	bBox
	)

protectedvirtual

Gets standOff bounding box

Parameters

pShape	- IN: The page item whose text wrap we are interested in.
gc	- IN: A pointer to the IGraphicsContext representing the device to which the sprite draws.
flags	- IN: flags are IShape::flags.

See Also: IShape.h

Parameters

bBox	- IN: The rect to return if there is no text wrap.

Returns: If the provided page item has a text wrap, return the wrap's bounding box in the coordinates of the provided IGraphicsContext (i.e. in screen coordinates). Otherwise, return the provided bBox.

virtual PMRect CSprite::GetTrackerBounds	(	IGraphicsContext *	gc,
		int32	flags
	)

protectedvirtual

Allows the tracker to dynamically change the update area used by the sprite.

Parameters

gc	- IN: A pointer to the IGraphicsContext representing the device to which the sprite draws.
flags	- IN: flags are IShape::flags.

See Also: IShape.h

Returns: If the boss containing this sprite has an IPathGeometry, then grab that IPathGeometry and return its GetCtrlPointsBoundingBox.

Reimplemented in NoHandleSprite.

virtual void CSprite::Hide	(	IGraphicsContext *	gc,
		bool16	bForceRedraw,
		PMMatrix *	extraXform
	)

virtual

Removes any sprite-related extra drawing. Restores the screen to reflect what is in the spread. This function is somewhat implementation dependent. For instance, in path creation it may be used to update with the newly created segment, or for rotation getting rid of the tracker line

Parameters

gc	- IN: A pointer to the IGraphicsContext representing the device to which the sprite draws.
bForceRedraw	- IN: Whether or not to force the gc to redraw before returning.
extraXform	- IN: The matrix represents the transformation that is passed into all the IHandleShapes in the item list (See CreateSprite). The matrix is a pasteboard relative transformation.

Implements ISprite.

virtual void CSprite::HideLowMemory	(	IGraphicsContext *	gc,
		bool16	bForceRedraw,
		PMMatrix *	extraXform
	)

protectedvirtual

Called by Hide to do all the work when in a low memory state and offscreens cannot be used.

Parameters

gc	- IN: A pointer to the IGraphicsContext representing the device to which the sprite draws.
bForceRedraw	- IN: Whether or not to force the gc to redraw before returning.
extraXform	- IN: The matrix represents the transformation that is passed into all the IHandleShapes in the item list (See CreateSprite). The matrix is a pasteboard relative transformation.

virtual void CSprite::HideSprite	(	IGraphicsContext *	gc,
		bool16	bForceRedraw,
		PMMatrix *	extraXform
	)

protectedvirtual

Called by Hide to do all the work when not in a low memory state.

Parameters

gc	- IN: A pointer to the IGraphicsContext representing the device to which the sprite draws.
bForceRedraw	- IN: Whether or not to force the gc to redraw before returning.
extraXform	- IN: The matrix represents the transformation that is passed into all the IHandleShapes in the item list (See CreateSprite). The matrix is a pasteboard relative transformation.

virtual void CSprite::InvalidateBBox ( )

virtual

Tells the sprite that the objects bbox has changed and to recalculate the cached version in the sprite.

Implements ISprite.

virtual bool16 CSprite::NeedsUpdate	(	const PMPoint &	where,
		int32	flags
	)		const

inlinevirtual

Returns kTrue when sprite needs to update, kFalse otherwise.

Implements ISprite.

virtual bool16 CSprite::Scroll	(	IGraphicsContext *	gc,
		const PMPoint &	delta,
		int32	flags,
		PMMatrix *	xForm
	)

virtual

Scroll the sprite. In general, this recreates the background and repaints.

Parameters

gc	- IN: A pointer to the IGraphicsContext representing the device to which the sprite draws.
delta	- IN: The amount to scroll.
flags	- IN: flags are IShape::flags.

See Also: IShape.h

Parameters

xForm - IN: The matrix represents the transformation that is passed into all the IHandleShapes in the item list (See CreateSprite). The matrix is a pasteboard relative transformation.

Returns: kFalse means the sprite is in low memory and that it drew the objects directly to gc.

Implements ISprite.

virtual void CSprite::ScrollLowMemory	(	IGraphicsContext *	gc,
		const PMPoint &	delta,
		int32	flags,
		PMMatrix *	xForm
	)

protectedvirtual

Called by Scroll when in a low memory situation and offscreens cannot be used.

Parameters

gc	- IN: A pointer to the IGraphicsContext representing the device to which the sprite draws.
delta	- IN: The amount to scroll.
flags	- IN: flags are IShape::flags.

See Also: IShape.h

Parameters

xForm - IN: The matrix represents the transformation that is passed into all the IHandleShapes in the item list (See CreateSprite). The matrix is a pasteboard relative transformation.

virtual void CSprite::ScrollSprite	(	IGraphicsContext *	gc,
		const PMPoint &	delta,
		int32	flags,
		PMMatrix *	xForm
	)

protectedvirtual

Called by Scroll when we are not in a low memory situation. When in a low memory situation, Scroll will call ScrollLowMemory.

Parameters

gc	- IN: A pointer to the IGraphicsContext representing the device to which the sprite draws.
delta	- IN: The amount to scroll.
flags	- IN: flags are IShape::flags.

See Also: IShape.h

Parameters

xForm - IN: The matrix represents the transformation that is passed into all the IHandleShapes in the item list (See CreateSprite). The matrix is a pasteboard relative transformation.

virtual void CSprite::SetHiliteColor ( UID layerUID )

protectedvirtual

Override this method if the client wants a different tracker hilite color.

Parameters

layerUID - IN: The UID of the layer whose layer color to use for hilighting.

virtual bool16 CSprite::Show	(	IGraphicsContext *	gc,
		const PMPoint &	where,
		int32	flags,
		PMMatrix *	xForm
	)

virtual

Show the sprite.

Parameters

gc	- IN: A pointer to the IGraphicsContext representing the device to which the sprite draws.
where	- IN: Obsolete. Not used.
flags	- IN: flags are IShape::flags.

See Also: IShape.h

Parameters

xForm - IN: The matrix represents the transformation that is passed into all the IHandleShapes in the item list (See CreateSprite). The matrix is a pasteboard relative transformation.

Returns: kFalse means the sprite is in low memory and that it drew the objects directly to gc.

Implements ISprite.

virtual void CSprite::ShowFirstTime	(	IGraphicsContext *	gc,
		const PMPoint &	where,
		int32	flags,
		PMMatrix *	xForm
	)

protectedvirtual

The first time that Show is called, ShowFirstTime will be called to set up its offscreens.

Parameters

gc	- IN: A pointer to the IGraphicsContext representing the device to which the sprite draws.
where	- IN: Obsolete. Not used.
flags	- IN: flags are IShape::flags.

See Also: IShape.h

Parameters

xForm - IN: The matrix represents the transformation that is passed into all the IHandleShapes in the item list (See CreateSprite). The matrix is a pasteboard relative transformation.

virtual void CSprite::ShowLowMemory	(	IGraphicsContext *	gc,
		const PMPoint &	where,
		int32	flags,
		PMMatrix *	xForm
	)

protectedvirtual

Called by Show when in a low memory state. Draws in XOr mode.

Parameters

gc	- IN: A pointer to the IGraphicsContext representing the device to which the sprite draws.
where	- IN: Obsolete. Not used.
flags	- IN: flags are IShape::flags.

See Also: IShape.h

Parameters

xForm - IN: The matrix represents the transformation that is passed into all the IHandleShapes in the item list (See CreateSprite). The matrix is a pasteboard relative transformation.

virtual void CSprite::ShowLowMemoryFirstTime	(	IGraphicsContext *	gc,
		const PMPoint &	where,
		int32	flags,
		PMMatrix *	xForm
	)

protectedvirtual

Same as ShowLowMemory, except that it erases and redraws the gc first.

Parameters

gc	- IN: A pointer to the IGraphicsContext representing the device to which the sprite draws.
where	- IN: Obsolete. Not used.
flags	- IN: flags are IShape::flags.

See Also: IShape.h

Parameters

xForm - IN: The matrix represents the transformation that is passed into all the IHandleShapes in the item list (See CreateSprite). The matrix is a pasteboard relative transformation.

virtual void CSprite::ShowSprite	(	IGraphicsContext *	gc,
		const PMPoint &	where,
		int32	flags,
		PMMatrix *	xForm
	)

protectedvirtual

Show calls ShowSprite every time except the first time, where it calls ShowFirstTime. ShowSprite uses the offscreens set up by ShowFirstTime.

Parameters

gc	- IN: A pointer to the IGraphicsContext representing the device to which the sprite draws.
where	- IN: Obsolete. Not used.
flags	- IN: flags are IShape::flags.

See Also: IShape.h

Parameters

xForm - IN: The matrix represents the transformation that is passed into all the IHandleShapes in the item list (See CreateSprite). The matrix is a pasteboard relative transformation.

virtual bool16 CSprite::UseDisplayList ( int32 flags )

protectedvirtual

Obsolete. CSprite does not currently use display lists for drawing.

Parameters

flags - IN: flags are IShape::flags.

See Also: IShape.h

Returns: Returns whether to use a display list or not

Reimplemented in NoHandleSprite.

virtual bool16 CSprite::ValidSprite ( ) const

inlinevirtual

Returns whether the sprite has been initialized – that is, that CreateSprite has been called.

Implements ISprite.

Public Member Functions

Protected Member Functions

Static Protected Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation