AIPathSuite提供的功能允许检查和操作路径,AIPathfinderSuite提供了对路径执行操作的功能，这些功能将各种效果应用于选定的路径图

Table of Contents generated with DocToc

AIPathSuite

此套件提供的功能允许您检查和操作路径，这些路径是art类型的对象kPathArt。

路径的形状由一个或多个路径段定义。路径的每一个段对应于一个锚点，它是在选择路径时显示的手柄。路径上的锚点数或段数包括每端的两个。段由AIPathSegment结构定义。段索引号从零开始。路径可以有一个锚点。

段的入点和出点定义点p处的曲线的切线。中间点不用于开放路径的初始段和最终段。段可以是角点或平滑点。对于一个角落，进出点可以在任何地方。要形成一条直线，请将每个端点的入点和出点放在它们的p点上。

路径可以是关闭的或打开的。如果路径是打开的，则仅由其段定义。如果它已关闭，Illustrator将在第一个和最后一个锚点之间绘制一个段，该段使用最后一个段的out切线和第一个段的切线。

一些路径也用作指南。在所有其他方面，它们是具有相同内容和属性的路径。绘制属性与通过路径样式的路径相关联。见AIPathStyleSuite。

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

注册声明

//xxxSuites.h
#include "Suites.hpp"
#include "AIArtConverter.h"
extern	"C" AIPathSuite*	 sAIPath;

//xxxSuites.cpp
extern "C"{
 AIPathSuite* sAIPath=NULL;
}

ImportSuite gImportSuites[] = {
    IMPORT_TEXT_SUITES
    kAIPathSuite,kAIPathSuiteVersion,&sAIPath,
        nil, 0, nil
      };

方法

AIAPI AIErr（* GetPathSegmentCount）（AIArtHandle path，ai :: int16 * count）
获取路径上的锚点数，包括每端的两个锚点。
AIAPI AIErr（* SetPathSegmentCount）（AIArtHandle path，ai :: int16 count）
从段中删除段或将段附加到路径末尾。
AIAPI AIErr（* GetPathSegments）（AIArtHandle path，ai :: int16 segNumber，ai :: int16 count，AIPathSegment segments []）
从路径中检索一组段。
AIAPI AIErr（* SetPathSegments）（AIArtHandle path，ai :: int16 segNumber，ai :: int16 count，const AIPathSegment segments []）
添加或更新路径中的段。
AIAPI AIErr（* InsertPathSegments）（AIArtHandle path，ai :: int16 segNumber，ai :: int16 count，const AIPathSegment segments []）
将段插入路径。
AIAPI AIErr（* DeletePathSegments）（AIArtHandle path，ai :: int16 segNumber，ai :: int16 count）
从路径中删除段。
AIAPI AIErr（* GetPathClosed）（AIArtHandle path，AIBoolean *closed）
报告路径是否已关闭。
AIAPI AIErr（* SetPathClosed）（AIArtHandle path，AIBoolean closed）
打开或关闭路径。
AIAPI AIErr（* GetPathGuide）（AIArtHandle path，AIBoolean * isGuide）
报告路径是否用作指南。
AIAPI AIErr（* SetPathGuide）（AIArtHandle path，AIBoolean isGuide）
设置是否将路径用作指南。
AIAPI AIErr（* GetPathSegmentSelected）（AIArtHandle path，ai :: int16 segNumber，ai :: int16 *selected）
报告是否选择了路径段的任何部分。
AIAPI AIErr（* SetPathSegmentSelected）（选择AIArtHandle path，ai :: int16 segNumber，ai :: int16 selected）
设置段的选择状态。
AIAPI AIErr（* ReversePathSegments）（AIArtHandle path）
反转路径中段的顺序。
AIAPI AIErr（* GetPathArea）（AIArtHandle path，AIReal *area）
计算路径的面积。
AIAPI AIErr（* GetPathLength）（AIArtHandle path，AIReal *length，AIReal flatness）
计算以点为单位测量的路径周长。
AIAPI AIErr（* GetPathBezier）（AIArtHandle path，ai :: int16 segNumber，AIRealBezier * bezier）
计算路径段的贝塞尔曲线值。
AIAPI AIErr（* PathHasLength）（AIArtHandle path，AIBoolean * hasLength）
报告路径是否有长度。
AIAPI AIErr（* GetPathIsClip）（AIArtHandle path，AIBoolean * isClip）
报告路径是否为剪切路径。
AIAPI AIErr（* GetPathAllSegmentsSelected）（AIArtHandle path，选择AIBoolean *）
报告是否选择了路径的所有段。
AIAPI AIErr（* GetKeySegment）（AIArtHandle * path，ai :: int16 * segmentNumber）
检索关键锚点的路径对象和段号（即，其他锚点对齐的那个）。
AIAPI AIErr（* CancelKeySegment）（void）
AIAPI AIBoolean（* IsPath9SliceSplitter）（AIArtHandle path）
报告路径是否为9切片分割器; 也就是说，该指南定义了将艺术板分成9个区域的线。
AIAPI AIErr（* SetKeySegment）（AIArtHandle path，ai :: int16 segmentNumber）
设置艺术对象的关键锚点。
AIAPI AIErr（* MeasureSegments）（AIArtHandle path，ai :: int16 startSeg，ai :: int16 count，AIReal pieceLengths []，AIReal accumulationLengths []）
测量路径段的长度。
AIAPI AIErr（* LengthFractionToBezierPos）（AIArtHandle path，AIReal lengthFraction，ai :: int16＆segIndex，AIReal＆bezierT，const AIReal pieceLengths []，const AIReal accumulationLengths []）
计算作为沿路径的路径长度的给定分数的点的段索引和参数贝塞尔t值。
AIAPI AIErr（* BezierPosToLengthFraction）（AIArtHandle path，ai :: int16 segIndex，AIReal bezierT，AIReal＆lengthFraction，const AIReal pieceLengths []，const AIReal accumulationLengths []）
计算对应于沿路径的位置的总路径长度的分数，该路径表示为段索引，并且将参数贝塞尔t值表示到该段中。
AIAPI AIErr（* BezierPosToAnchoredPos）（AIArtHandle path，ai :: int16 segIndex，AIReal t，AIReal * segLength，AIReal * segLengthFraction）
从参数贝塞尔曲线t值转换为线段长度的一部分。
AIAPI AIErr（* PerpendicularsAtBezierT）（AIArtHandle path，ai :: int16 segIndex，AIReal t，AIReal leftDistance，AIReal rightDistance，AIRealPoint＆pointOnPath，AIRealPoint * leftPoint，AIRealPoint * rightPoint）
计算与表示为段索引和参数贝塞尔t值的位置处的路径垂直（正常）的线段的端点

AIPathSegment

Contents Suites Classes Class Index Member Index
AIPathSegment Struct Reference
Defines a path segment. More…

#include <AIPath.h>

List of all members.

Public Attributes
AIRealPoint p
AIRealPoint in
AIRealPoint out
AIBoolean corner

使用实例

//SetPathSegmentCount
long curCount=10;//定义环面点数
AIArtHandle artGroup = NULL;
sAIArt->GetFirstArtOfLayer(PolygonLayer, &artGroup);
AIArtHandle art = NULL;
sAIArt->NewArt(kPathArt, kPlaceInsideOnTop, artGroup, &art);
sAIPath->SetPathSegmentCount(art, (short)curCount);
AIPathSegment *segment = new AIPathSegment[curCount];
AIRealPoint *AIPoint = new AIRealPoint[curCount];
...
//赋值操作
for (int i = 0; i < curCount; i++)
{
    segment[i].p.h = AIPoint[i].h;
    segment[i].p.v = AIPoint[i].v;
    segment[i].in = segment[i].out = segment[i].p;
    segment[i].corner = true;
}
//SetPathSegments
sAIPath->SetPathSegments(art, 0, curCount, segment);
delete[] segment;
delete[] AIPoint;
//SetPathClosed
sAIPath->SetPathClosed(art, 1);
arts.push_back(art);

AIPathfinderSuite

该套件提供了对路径（类型的艺术对象kPathArt）执行操作的功能，这些功能将各种效果应用于选定的路径图。
这些操作与“路径查找器”调板和“效果”菜单中的操作相对应。
附加功能允许操作复合形状，可以应用效果的插件组。见AIPluginGroupSuite。在复合形状组中，绘制组中的底部对象，然后根据交互模式（AIShapeMode）由其上方的下一个对象进行修改。可以将每个后续对象添加到图形中，从图形中减去，相交或从图形中排除。

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

注册声明

//xxxSuites.h
#include "Suites.hpp"
#include "AIPathfinder.h"
extern  "C" AIPathfinderSuite*          sAIPathfinder;

//xxxSuites.cpp
extern "C"{
 AIPathfinderSuite*  sAIPathfinder=NULL;
}

ImportSuite gImportSuites[] = {
    IMPORT_TEXT_SUITES
    kAIPathfinderSuite,kAIPathfinderSuiteVersion,&sAIPathfinder,
        nil, 0, nil
      };

方法

AIAPI AIErr（* DoUniteEffect）（AIPathfinderData *data，AIFilterMessage *message）
对选定的艺术应用Unite效果。
AIAPI AIErr（* DoIntersectEffect）（AIPathfinderData * data，AIFilterMessage * message）
将相交效果应用于选定的art。
AIAPI AIErr（* DoExcludeEffect）（AIPathfinderData *data，AIFilterMessage *message）
对所选art应用排除效果。
AIAPI AIErr（* DoBackMinusFrontEffect）（AIPathfinderData * data，AIFilterMessage * message）
对选定的art应用前后减去效果。
AIAPI AIErr（* DoFrontMinusBackEffect）（AIPathfinderData *data，AIFilterMessage *message）
对选定的art应用前后减去效果。
AIAPI AIErr（* DoDivideEffect）（AIPathfinderData *data，AIFilterMessage *message）
对所选art应用分割效果。
AIAPI AIErr（* DoOutlineEffect）（AIPathfinderData * data，AIFilterMessage * message）
将轮廓效果应用于选定的art。
AIAPI AIErr（* DoTrimEffect）（AIPathfinderData *data，AIFilterMessage *message）
对所选art应用修剪效果。
AIAPI AIErr（* DoMergeEffect）（AIPathfinderData *data，AIFilterMessage *message）
对选定的art应用合并效果。
AIAPI AIErr（* DoCropEffect）（AIPathfinderData *data，AIFilterMessage *message）
将裁剪效果应用于选定的art。
AIAPI AIErr（* DoHardEffect）（AIPathfinderData *data，AIFilterMessage *message）
对选定的art应用硬效果。
AIAPI AIErr（* DoSoftEffect）（AIPathfinderData *data，AIFilterMessage *message）
对选定的art应用柔和效果。
AIAPI AIErr（* DoTrapEffect）（AIPathfinderData *data，AIFilterMessage *message）
对选定的art应用陷印效果。
AIAPI AIErr（* GetHardEffectParameters）（AIPathfinderData *data，AIFilterMessage *message）
获得硬效果路径查找器操作的参数。
AIAPI AIErr（* GetSoftEffectParameters）（AIPathfinderData *data，AIFilterMessage *message）
获得Soft效果路径查找器操作的参数。
AIAPI AIErr（* GetTrapEffectParameters）（AIPathfinderData * data，AIFilterMessage * message）
获得陷阱效果路径查找器操作的参数。
AIAPI AIErr（* GetGlobalOptions）（AIPathfinderData *data，AIFilterMessage *message）
获得“路径查找器”和“效果”操作的全局选项。
AIAPI AIShapeMode（* GetShapeMode）（AIArtHandle art）
获得art插件组对象的复合形状模式。
AIAPI AIErr（* SetShapeMode）（AIArtHandle art，AIShapeMode mode）
设置art插件组对象的复合形状模式。
AIAPI AIErr（* NewCompoundShape）（ai :: int16 paintOrder，AIArtHandle prep，AIArtHandle * newArt）
在当前文档的art树的绘制顺序中的指定位置创建新的空复合形状。
AIAPI AIErr（* IsCompoundShape）（AIArtHandle art，AIBoolean * isCompoundShape）
报告art品是否为复合形状。
AIAPI AIErr（* FlattenArt）（AIArtHandle * inOutArt）
通过将Unite效果应用于每个组件art对象，将形状扩展为单个路径或复合路径。

使用实例

//arts已定义好的art对象数组
list<AIArtHandle>::iterator artIT = arts.begin();
	if (artCount > 1){		
		AIArtHandle* artArr = (AIArtHandle *)(malloc(sizeof(AIArtHandle)*artCount));
		for (int i = 0; i < artCount; i++){
			artArr[i] = *artIT;
			artIT++;
		}
		AIFilterMessage message;
		AIPathfinderData findData;
		findData.fSelectedArt = artArr;
		findData.fSelectedArtCount = artCount;
		AIOptions option;
		option.ipmPrecision = 100;
		option.flags = kExtractUnpaintedArtwork;
		option.removeRedundantPoints = 1;
		findData.options = option;
		//应用排除效果
		sAIPathfinder->DoExcludeEffect(&findData, &message);
		delete[] artArr;
	}

AI组件开发（一）–注记旋转矩阵
 AI组件开发（二）–AIRealMathSuite
AI组件开发（三）–AIArtboardSuite
AI组件开发（四）–AIDocumentSuite
AI组件开发（五）–AILayerSuite
AI组件开发（六）–AIArtSuite
AI组件开发（七）–AIPathSuite&&AIPathfinderSuite
AI组件开发（八）–AIArtStyleSuite

AI组件开发（七）--AIPathSuite&&AIPathfinderSuite

2019-03-25
AI组件开发

AI组件开发（七）--AIPathSuite&&AIPathfinderSuite

AIPathSuite

注册声明

方法

AIPathSegment

使用实例

AIPathfinderSuite

注册声明

方法

相关类，结构体，指针

AIPathfinderData

AIOptions

AIParameters

AIMixParameters

AITrapParameters

AIFilterMessage

SPMessageData

AIFilterHandle

PlatformFilterParameters

使用实例

相关文章