ai组件开发（六）--AIArtSuite

AIArtSuite

此套件允许您访问和修改Illustrator文档中的图稿。

它提供了创建和删除对象，重新排列对象以及获取和设置对象信息的功能。您可以使用这些函数来导航图形对象树，以及获得或修改有关图形对象的一般信息，例如它们的边界或锁定状态。

Art套件是实现大多数插件的基础。Illustrator文档由一个由a引用的图形对象的集合组成AIArtHandle。这是指向文档图稿数据库中图形对象的不透明指针。通过Art suite的访问器功能访问这些字段。

艺术对象可以表示单个实体，诸如路径，文本块或放置的图像，或一组对象，诸如路径的集合。艺术类型标识符（AIArtType）表示艺术品的类型。

使用SPBasicSuite::AcquireSuite()常量kAIArtSuite和使用获取此套件kAIArtVersion。

注册声明

//xxxSuites.h
#include "Suites.hpp"
#include "AIArtConverter.h"
extern  "C" AAIArtSuite*	sAIArt ;

//xxxSuites.cpp
extern "C"{
AIArtSuite*	sAIArt = NULL;
}

ImportSuite gImportSuites[] = {
    IMPORT_TEXT_SUITES
    kAIArtSuite, kAIArtSuiteVersion, &sAIArt,
        nil, 0, nil
      };

方法

• AIAPI AIErr（* NewArt）（ai :: int16类型，ai :: int16 paintOrder，AIArtHandle prep，AIArtHandle * newArt）
  创建一个新的Art对象。
• AIAPI AIErr（* DisposeArt）（AIArtHandle Art）
  从文档中删除Art对象。
• AIAPI AIErr（* ReorderArt）（AIArtHandle thisArt，ai :: int16 paintOrder，AIArtHandle prep）
  更改Art对象的绘制顺序，或将路径移入或移出复合路径或组。
• AIAPI AIErr（* DuplicateArt）（AIArtHandle thisArt，ai :: int16 paintOrder，AIArtHandle prep，AIArtHandle * newArt）
  使用深层复制复制Art对象（组和复合路径的子项也是重复的）。
• AIAPI AIErr（* GetFirstArtOfLayer）（AILayerHandle图层，AIArtHandle *Art）
  获得图层中的第一个Art对象，该图层包含该图层中的所有Art。
• AIAPI AIErr（* GetLayerOfArt）（AIArtHandle art，AILayerHandle *layer）
  获得Art对象的父图层（如果有）。
• AIAPI AIErr（* GetArtType）（AIArtHandle art，short * type）
  获得Art对象的类型。
• AIAPI AIErr（* GetArtUserAttr）（AIArtHandle art，ai :: int32 whichAttr，ai :: int32 * attr）
  获得Art对象的用户属性; 也就是说，标志显示它是被选中，隐藏还是被锁定。
• AIAPI AIErr（* SetArtUserAttr）（AIArtHandle art，ai :: int32 whichAttr，ai :: int32 attr）
  设置对象的用户属性; 也就是说，标志显示它是被选中，隐藏还是被锁定。
• AIAPI AIErr（* GetArtParent）（AIArtHandle art，AIArtHandle *parent）
  获得Art对象的父组。
• AIAPI AIErr（* GetArtFirstChild）（AIArtHandle art，AIArtHandle *child）
  获得组对象的第一个子对象。
• AIAPI AIErr（* GetArtSibling）（AIArtHandle art，AIArtHandle *sibling）
  获得同一组中的下一个对象。
• AIAPI AIErr（* GetArtPriorSibling）（AIArtHandle art，AIArtHandle *sibling）
  获得同一组中的上一个对象。
• AIAPI AIErr（* GetArtBounds）（AIArtHandle art，AIRealRect * bounds）
  获得Art对象的包围矩形。
• AIAPI AIErr（* SetArtBounds）（AIArtHandle art&#