CAD开发者社区 › 首页 ›AutoCAD开发文档› AutoCAD 2023 开发者帮助 › 查看内容

AutoCAD 2023 开发者帮助

使用绘图 API

2024-5-18 19:00| 发布者: admin| 查看: 275| 评论: 0|原作者: admin|来自: AutoCAD

使用绘图 API

应用程序可以选择使用绘图 API 配置时间功能和/或绘图时间功能。它们还可以包括多页文档、打印到文件、错误处理和覆盖默认打印进度对话框的规定。

注意：

每当通过绘图 API 访问绘图引擎时，如果 BACKGROUNDPLOT 系统变量设置为 0，系统将在前台绘制，如果 BACKGROUNDPLOT 系统变量设置为 1、2 或 3，则系统将在后台绘制。

使用基本配置时和绘图时 API

获取布局的 ID，并在编辑器中使其处于活动状态。（在步骤 7 中调用时，布局必须处于活动状态。beginPage()
创建一个对象并在其上设置布局 ID。AcPlPlotInfo
实现 UI 以创建对象（可选）。AcDbPlotSettings
使用向对象传递指向绘图设置对象（如果有）的指针。AcPlPlotInfoAcPlPlotInfo::setOverrideSettings()
调用绘图信息对象。AcPlPlotInfoValidator::validate()
这将验证替代是否与布局设置兼容。例如，图纸空间和模型空间设置是互斥的，指定的设备必须存在。
使用或创建对象。AcPlPlotEngineAcPlPlotFactory::createPreviewEngine()AcPlPlotFactory::createPublishEngine()
在引擎上调用以下函数：
beginPlot()
beginDocument()
beginPage()
beginGenerateGraphics()
endGenerateGraphics()
endPage()
endDocument()
endPlot()

以下代码演示了 API 和默认打印进度对话框的基本用法，绘图进度对话框中对此进行了进一步讨论。

AcPlPlotEngine* pEngine = NULL;
if(Acad::eOk==AcPlPlotFactory::createPublishEngine(pEngine))
{
    // Here is the progress dialog for the current plot process...
    AcPlPlotProgressDialog *pPlotProgDlg=acplCreatePlotProgressDialog(
        acedGetAcadFrame()->m_hWnd,false,1);
    pPlotProgDlg->setPlotMsgString(
        AcPlPlotProgressDialog::PlotMSGIndex::kDialogTitle,
        "Plot API Progress");
    pPlotProgDlg->setPlotMsgString(
        AcPlPlotProgressDialog::PlotMSGIndex::kCancelJobBtnMsg,
        "Cancel Job");
    pPlotProgDlg->setPlotMsgString(
        AcPlPlotProgressDialog::PlotMSGIndex::kCancelSheetBtnMsg,
        "Cancel Sheet");
    pPlotProgDlg->setPlotMsgString(
        AcPlPlotProgressDialog::PlotMSGIndex::kSheetSetProgressCaption,
        "Job Progress");
    pPlotProgDlg->setPlotMsgString(
        AcPlPlotProgressDialog::PlotMSGIndex::kSheetProgressCaption,
        "Sheet Progress");
    pPlotProgDlg->setPlotProgressRange(0,100);
    pPlotProgDlg->onBeginPlot();
    pPlotProgDlg->setIsVisible(true);
    es = pEngine->beginPlot(pPlotProgDlg);
    AcPlPlotPageInfo pageInfo;
    // Used to describe how the plot is to be made.
    AcPlPlotInfo plotInfo; 
    // First, set the layout to the specified layout 
    // (which is the current layout in this sample).
    plotInfo.setLayout(layoutId);// This is required.
    // Now, override the layout settings with the plot settings 
    // we have been populating.
    plotInfo.setOverrideSettings(pPlotSettings);
    // We need to validate these settings.
    AcPlPlotInfoValidator validator;
    validator.setMediaMatchingPolicy(
        AcPlPlotInfoValidator::MatchingPolicy::kMatchEnabled);
    es = validator.validate(plotInfo);
    // Begin document.  The version we call is dependent 
    // on the plot-to-file status.
    const char *szDocName=acDocManager->curDocument()->fileName();
    if(m_bPlotToFile)
        es = pEngine->beginDocument(plotInfo, szDocName, 
            NULL, 1, true, m_csFilename);
    else
        es = pEngine->beginDocument(plotInfo, szDocName);
    // Follow through sending commands to the engine, 
    // and notifications to the progress dialog.
    pPlotProgDlg->onBeginSheet();
    pPlotProgDlg->setSheetProgressRange(0, 100);
    pPlotProgDlg->setSheetProgressPos(0);
    es = pEngine->beginPage(pageInfo, plotInfo, true);
    es = pEngine->beginGenerateGraphics();
    es = pEngine->endGenerateGraphics();
    es = pEngine->endPage();
    pPlotProgDlg->setSheetProgressPos(100);
    pPlotProgDlg->onEndSheet();
    pPlotProgDlg->setPlotProgressPos(100);
    es = pEngine->endDocument();
    es = pEngine->endPlot();
    // Destroy the engine 
    pEngine->destroy();
    pEngine = NULL;
    // and the progress dialog.
    pPlotProgDlg->destroy();
else
    // Ensure the engine is not already busy...
    AfxMessageBox("Plot Engine is Busy...");
}