This .NET class wraps the AcPlPlotEngine ObjectARX class.
Applications use an PlotEngine interface to plot one or more documents to a device or a file, to collect plot information for a background plot, or to preview the plot of a single page. Engine instances are returned by methods on the PlotFactory class. Only one engine object can exist at a time, so applications should create engine instances just before they are needed, operate on them, and destroy them (by calling destroy()) as soon as they are no longer needed.
Engines have a notion of state, and they move between states via nested begin and end calls. The state levels are as follows:
None (initial) -> plot -> document -> page -> graphics
For example, applications move from the default state to the plot state by calling BeginPlot(), and exit the plot state by calling EndPlot(). The pairs must be properly nested. For example, EndPlot() will return an error if called when the current state is document.
A plot can contain multiple documents (BeginDocument()/EndDocument() pairs), and a document can contain multiple pages (BeginPage()/EndPage() pairs) as long as the pages are document compatible.
Before plotting a particular page (layout), the layout must be current in the AutoCAD editor, and if it is a paper space layout, the paper space viewport must be the active viewport.
If the plot engine is for preview, only one document and page should be called per plot. If the plot engine is for packaging a background plot to a file, only one document should be called per plot.
Autodesk.AutoCAD.PlottingServices.PlotEngine
Public sealed Class PlotEngine Inherits DisposableWrapper
public sealed class PlotEngine : DisposableWrapper;
Comments? |