Adobe Extending Flash Professional CS5 - Manual (Page 195)

173 EXTENDING FLASH PROFESSIONAL
drawingLayer object
Last updated 5/2/2011
Parameters
persistentDraw A Boolean value (optional). If set to true , it indicates that the drawing in the last frame remains on
the Stage until a new beginDraw() or beginFrame() call is made. (In this context, frame refers to where you start and
end drawing; it does not refer to timeline frames.) For example, when users draw a rectangle, they can preview the
outline of the shape while dragging the mouse. If you want that preview shape to remain after the user releases the
mouse button, set persistentDraw to
true .
Returns
Nothing.
Description
Method; puts Flash in drawing mode. Drawing mode is used for temporary drawing while the mouse button is pressed.
You typically use this method only when creating extensible tools.
Example
The following example puts Flash in drawing mode:
fl.drawingLayer.beginDraw();
drawingLayer.beginFrame()
Availability
Flash MX 2004.
Usage
drawingLayer.beginFrame()
Parameters
None.
Returns
Nothing.
Description
Method; erases what was previously drawn using the drawingLayer and prepares for more drawing commands. Should
be called after
drawingLayer.beginDraw() . Everything drawn between drawingLayer.beginFrame() and an
drawingLayer.endFrame() remains on the Stage until you call the next beginFrame() and endFrame() . (In this
context, frame refers to where you start and end drawing; it does not refer to timeline frames.) You typically use this
method only when creating extensible tools. See
drawingLayer.beginDraw() .
drawingLayer.cubicCurveTo()
Availability
Flash MX 2004.