Machine Translated by Google

ADOBE® ILLUSTRATOR® CC 2017

EMPEZAR CON
ADOBE ILLUSTRATOR CC
2017
DESARROLLO
Machine Translated by Google

ÿ 2016 Adobe Systems Incorporado. Reservados todos los derechos.

Introducción al desarrollo de Adobe Illustrator CC 2017

Nota técnica #10501

Si esta guía se distribuye con software que incluye un acuerdo de usuario final, esta guía, así como el software que se describe en
ella, se proporciona bajo licencia y solo se puede usar o copiar de acuerdo con los términos de dicha licencia.
Salvo que lo permita dicha licencia, ninguna parte de esta guía puede reproducirse, almacenarse en un sistema de recuperación o
transmitirse de ninguna forma ni por ningún medio, ya sea electrónico, mecánico, de grabación o de otro tipo, sin el permiso previo por
escrito de Adobe. Sistemas Incorporados. Tenga en cuenta que el contenido de esta guía está protegido por la ley de derechos de autor incluso
si no se distribuye con software que incluye un acuerdo de licencia de usuario final.

El contenido de esta guía se proporciona únicamente con fines informativos, está sujeto a cambios sin previo aviso y no debe interpretarse
como un compromiso por parte de Adobe Systems Incorporated. Adobe Systems Incorporated no asume ninguna responsabilidad por los
errores o inexactitudes que puedan aparecer en el contenido informativo incluido en esta guía.

Recuerde que las ilustraciones o imágenes existentes que desee incluir en su proyecto pueden estar protegidas por la ley de derechos de
autor. La incorporación no autorizada de dicho material a su nuevo trabajo podría ser una violación de los derechos del propietario de los
derechos de autor. Asegúrese de obtener los permisos necesarios del propietario de los derechos de autor.

Las referencias a nombres de empresas en plantillas de muestra son solo para fines de demostración y no pretenden hacer referencia a
ninguna organización real.

Adobe, el logotipo de Adobe, Creative Cloud e Illustrator son marcas comerciales registradas o marcas comerciales de Adobe Systems
Incorporated en los Estados Unidos y/o en otros países. Microsoft y Windows son marcas comerciales registradas o marcas comerciales de
Microsoft Corporation en los Estados Unidos y/o en otros países. Apple, Mac OS y Macintosh son marcas comerciales de Apple Computer,
Incorporated, registradas en los Estados Unidos y otros países. Todas las demás marcas comerciales son propiedad de sus respectivos dueños.

Adobe Systems Incorporated, 345 Park Avenue, San José, California 95110, EE. UU. Aviso para los usuarios finales del gobierno de EE. UU.
El Software y la Documentación son "Artículos comerciales", tal como se define ese término en 48 CFR §2.101, que consisten en
"Software informático comercial" y "Documentación de software informático comercial", tal como se utilizan dichos términos en 48 CFR
§12.212 o 48 CFR § 227.7202, según corresponda. De conformidad con 48 CFR §12.212 o 48 CFR §§227.7202-1 a 227.7202-4, según
corresponda, el Software informático comercial y la Documentación del software informático comercial se otorgan con licencia a los usuarios
finales del gobierno de EE. UU. (a) solo como Artículos comerciales y (b) con solo los derechos que se otorgan a todos los demás usuarios
finales de conformidad con los términos y condiciones del presente. Derechos no publicados reservados bajo las leyes de derechos de autor de
los Estados Unidos. Adobe Systems Incorporated, 345 Park Avenue, San José, CA 95110-2704, EE. UU. Para nosotros
Usuarios finales del gobierno, Adobe acepta cumplir con todas las leyes de igualdad de oportunidades aplicables, incluidas, si corresponde, las
disposiciones de la Orden ejecutiva 11246, modificada, la Sección 402 de la Ley de asistencia para el reajuste de los veteranos de la era de
Vietnam de 1974 (38 USC 4212) y la Sección 503 de la Ley de Rehabilitación de 1973, según enmendada, y las reglamentaciones en 41 CFR
Partes 60-1 a 60-60, 60-250 y 60-741. La cláusula de acción afirmativa y los reglamentos contenidos en la oración anterior se incorporarán por
referencia.
Machine Translated by Google

Contenido

Prefacio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Uso de este documento. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Terminología y convenciones. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Configuración de su plataforma de desarrollo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Explorando el SDK ...............................................................6

Explorando la documentación. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Visores de documentos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Explorando las muestras. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Creación de un complemento. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Construyendo y ejecutando las muestras. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Guía de muestras. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
anotador . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

DibujarArte. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Panel Vacío. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

FreeGrid. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

LiveDropShadow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Objetos marcados. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

MenúReproducir. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Herramienta multiflecha. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Mensaje de guión. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Snippet Runner. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . dieciséis

Ejecutar y probar fragmentos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Explorando la API usando fragmentos de código. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

Filtro de trazo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Filtro de trazos discontinuos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Filtro de trazo ondulado. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Formato de archivo de texto. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Transformar botones. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Tutorial . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Filtro giratorio. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

Webter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

Complementos de depuración. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
.

Depuración de un complemento en Visual Studio. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

3
Machine Translated by Google

Contenido 4

Depuración de un complemento en Xcode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 Adición

de Illustrator al grupo de ejecutables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 Configuración del
formato de información de depuración . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 Formateo de
los datos del programa para el depurador. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 Problemas al
recorrer el código en el depurador de Xcode. . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

Uso de las plantillas de proyectos de complementos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

Plantilla Visual C++. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

Plantilla Xcode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

Creación de un complemento en Windows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

Crear un nuevo proyecto. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

Agregar un archivo fuente. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

Agregar un archivo de recursos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Configure los ajustes del proyecto. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

Construya el proyecto. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

Creación de un complemento en Mac OS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

Crear un nuevo proyecto. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

Agregar un objetivo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

Agregar un archivo fuente. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

Agregar dependencias del proyecto. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

Agregar un archivo de recursos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

Configure los ajustes del proyecto. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

Construya el proyecto. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
Machine Translated by Google

Primeros pasos con Adobe Illustrator CC 2017

Desarrollo
Este documento describe cómo comenzar a desarrollar complementos para Adobe® Illustrator® CC 2017, utilizando el kit de
desarrollo de software (SDK). El público objetivo de este documento son los desarrolladores que necesitan desarrollar complementos
para Illustrator.

Prefacio
El SDK de Illustrator CC 2017 está disponible para su descarga desde:

http://www.adobe.com/devnet/illustrator/

Usando este documento

Para comenzar a desarrollar complementos para Illustrator, siga estos pasos:

1. Configure su máquina para el desarrollo. Siga las instrucciones en "Configuración de su plataforma de desarrollo" en la página 6.

2. Explore la documentación; consulte “Exploración de la documentación” en la página 7.

3. Explorar, compilar y ejecutar las muestras; consulte “Exploración de las muestras” en la página 8.

4. Continúe explorando la API utilizando fragmentos de código; consulte "Exploración de la API mediante fragmentos de código" en
página 17.

5. Escriba un nuevo complemento utilizando las plantillas de proyecto de complemento del SDK suministradas; consulte “Uso de las plantillas de proyectos
de complementos” en la página 25.

6. Escriba un complemento "HelloWorld" desde cero para aprender a configurar su entorno de desarrollo;
consulte “Creación de un complemento” en la página 9.

Terminología y convenciones
ÿ <SDK> hace referencia a la carpeta raíz del SDK instalado localmente. La ubicación real de la raíz depende de la
instalación y sistema operativo.

ÿ <AI> se refiere a la ubicación instalada de Illustrator CC 2017. La ubicación real depende de la

instalación y sistema operativo.

ÿ <VS> indica la ubicación de instalación de Microsoft Visual Studio 2015 (también conocido como VC++ 14.0). La
ubicación real depende de la instalación; el valor predeterminado es C:\Archivos de programa\Microsoft Visual
Studio 15.0/.

5
Machine Translated by Google

Introducción al desarrollo de Adobe Illustrator CC 2017 Configuración de su plataforma de desarrollo 6

Configuración de su plataforma de desarrollo

1. Comprueba que tu plataforma cumple con los requisitos básicos:

Componente de plataforma

ventanas Windows 7 con Service Pack 1 o superior

estudio visual 2015 El desarrollo de complementos de Illustrator CC 2017

Visual C++ 14 en Windows requiere Visual C++, un componente de Visual
Studio 2013. Si tiene las ediciones Professional o Standard de
Visual Studio 2013, debe instalar los componentes de Visual
C++.

Mac OS Mac OS 10.10 o superior

Xcode 7.3 Xcode se puede descargar desde

http://developer.apple.com/tools/download/
LLVM Clang
(com.apple.compilers.llvm.clang.1_0)
Base del SDK de Apple: 10.11
Objetivo de implementación de Apple OS X: 10.10

2. Descargue el SDK de Illustrator CC 2017 para su plataforma desde:

http://www.adobe.com/devnet/illustrator/

ÿ En Windows, extraiga el contenido del archivo zip descargado en la ubicación que elija.

ÿ En Mac OS, monte el archivo de imagen de disco descargado (DMG) como un nuevo volumen y copie la carpeta SDK de Illustrator
CC 2017 en la ubicación que elija.

3. Para obtener instrucciones detalladas sobre cómo configurar el entorno de desarrollo para la creación de complementos, consulte:

ÿ “Creación de un complemento en Windows” en la página 28

ÿ “Creación de un complemento en Mac OS” en la página 32

Explorando el SDK
El SDK contiene documentación y ejemplos de código para ayudarlo a desarrollar sus propios complementos de Illustrator CC 2017 y a
migrar complementos de versiones anteriores.
Machine Translated by Google

Introducción al desarrollo de Adobe Illustrator CC 2017 Explorando el SDK 7

Explorando la documentación
Los siguientes documentos se incluyen con el SDK:

Título Descripción

adobe illustratorcc Describe los conceptos básicos del desarrollo de complementos para Illustrator CC 2017. Está dirigido
Programador 2017 a todos los desarrolladores y es el recurso recomendado para los desarrolladores de complementos
Guía después de leer este documento.

Este documento se encuentra en el archivo <SDK>/docs/guides/programmers-guide.pdf

adobe illustratorcc Describe cómo actualizar el código del complemento CC 2015 SDK para Illustrator CC 2017; está
Guía de portabilidad 2017 dirigido a desarrolladores con complementos preexistentes. Enumera nuevas funciones y cambios
en la API desde la versión anterior.

Este documento se encuentra en el archivo <SDK>/docs/guides/porting-guide.pdf.

Uso del texto de Adobe Describe cómo configurar su complemento para usar la API del motor de texto de Adobe,
Motor proporcionada con el SDK de Illustrator CC 2017. Describe los procedimientos para crear, editar,
eliminar, diseñar e iterar texto, con referencias al código de muestra y la referencia de la API.

Este documento se encuentra

en el archivo <SDK>/docs/guides/using-adobe-text-engine.pdf.

Referencia de la API Proporciona documentación de referencia para las suites, clases, estructuras, funciones, variables y
constantes disponibles en la API. Es un recurso clave para todos los desarrolladores.

Este documento se proporciona en dos formatos:

ÿ <SDK>/docs/references/index.chm : este archivo HTML compilado permite realizar

búsquedas de texto en el contenido.

ÿ Para ver el contenido en Windows, haga doble clic en el icono del archivo index.chm en
el Explorador de Windows para abrir la página de inicio.

ÿ Para ver los contenidos en un Macintosh, necesita un visor CHM; ver

Visores de documentos.

ÿ <SDK>/docs/references/sdkdocs.tar.gz : este archivo contiene la API

Referencia en formato HTML. Este formato no admite búsquedas de texto, pero ofrece la
posibilidad de ver archivos HTML individuales si se desea. Para ver el contenido, primero
descomprima el archivo, luego abra index.html en su navegador.

Asesor de API Informa sobre las diferencias de clase, estructura y archivo entre la API incluida en CC 2015 SDK y
CC 2017SDK. Está dirigido a todos los desarrolladores que utilizan la API, pero es más útil para los
desarrolladores que actualizan el código del complemento para Illustrator CC 2017.

Este documento se encuentra

en el archivo <SDK>/docs/references/apiadvisor-ai20-vs-ai21.html.
Machine Translated by Google

Introducción al desarrollo de Adobe Illustrator CC 2017 Explorando el SDK 8

Visores de documentos

ÿ Para ver la documentación basada en PDF, necesita Adobe Reader o Adobe Acrobat.

ÿ Para ver la documentación basada en HTML, necesita un navegador web.

ÿ Para ver la documentación HTML compilada (CHM) en Mac OS, necesita un visor CHM. Dos de estos visores son
chmox (http://chmox.sourceforge.net/) y xCHM (http://sourceforge.net/projects/xchm/).

Explorando las muestras

Los ejemplos proporcionados muestran cómo implementar funciones clave del complemento de Illustrator, como herramientas, filtros,
menús y formatos de archivo. La siguiente tabla muestra qué funciones implementa cada ejemplo:

Anotador dibujararte Vacío

Panel FreeGrid LiveDropShadow Objetosmarcados MenúReproducir Herramienta
multiflecha comandos
secuencia
Mensaje
de SnippetRunner TrazoFiltro formato
archivo
texto
de TransformarBotones Tutorial GirarFiltro Webter

Rasgo

Acción X X

Puerto AGM X

Anotador X X

Formato de archivo X

Filtrar X X

Interfaz de usuario flexible/Flash X X X XXX XX X

Efecto X

Opción del menú X XXXXX XXXXX

Notificar X X X X

Panel X X X X X

Grupo de complementos X

secuencias de comandos
X

Sincronización de temas X XX

Temporizador X

Paleta de herramientas X X X X

Transformar X X
Machine Translated by Google

Introducción al desarrollo de Adobe Illustrator CC 2017 Explorando el SDK 9

Utilice esta tabla para identificar la muestra más adecuada como punto de partida para su propio complemento: la muestra que implemente la
mayoría de las funciones que requiere su complemento le brindará la mejor base para trabajar.

ÿ Para obtener una descripción más detallada de cada muestra, consulte la “Guía de muestras” en la página 10

ÿ Para obtener una descripción más detallada de estas funciones de complementos y lo que hacen, consulte "Tipos de complementos"
sección en la Guía del programador de Adobe Illustrator CC 2017.

Creación de un complemento

Los ejemplos de SDK se basan en las clases Plugin y Suites . La clase Plugin construye los requisitos básicos para un complemento de
Illustrator, utilizando la clase Suites para adquirir y lanzar las suites requeridas.

Para crear su propio complemento utilizando este marco:

ÿ Cree un nuevo proyecto y agregue Plugin.cpp y Suites.cpp a su nuevo proyecto desde

<SDK>/código de muestra/común/fuente/.

ÿ Cree una clase en su proyecto que sea una subclase de la clase Complemento . Esta clase debe implementar el
funcionalidad requerida del plug-in.

Para ver un ejemplo paso a paso de cómo configurar el entorno de desarrollo y crear un complemento básico, consulte:

ÿ “Creación de un complemento en Windows” en la página 28

ÿ “Creación de un complemento en Mac OS” en la página 32

Construyendo y ejecutando las muestras.

Para compilar todos los ejemplos, use los proyectos proporcionados en la carpeta <SDK>/samplecode/MasterProjects/ .
Después de compilar y vincular, los archivos binarios del complemento se pueden encontrar en la carpeta <SDK>/samplecode/Output/ .

Le recomendamos que utilice la preferencia Carpeta de complementos adicionales al desarrollar y depurar complementos. Establezca esta
preferencia en el cuadro de diálogo Preferencias > Complementos y disco de memoria virtual de la aplicación.

Para obtener una lista completa de las ubicaciones donde Illustrator busca complementos, consulte la Guía del programador de Adobe
Illustrator CC 2017.

Para depurar una muestra (o su propio complemento), consulte “Depuración de complementos” en la página 22.
Machine Translated by Google

Introducción al desarrollo de Adobe Illustrator CC 2017 Guía de muestras 10

Guía de muestras
En esta sección se describen las muestras individuales con más detalle.

Anotador

Utiliza AIAnnotatorSuite y AIAnnotatorDrawerSuite para anotar ilustraciones en el documento y actualizar las anotaciones a
medida que cambia la selección o la posición del cursor.

Agrega una herramienta a la barra de herramientas, usando este icono:

Cuando se selecciona la herramienta de anotación y el cursor está sobre un elemento en la mesa de trabajo, el elemento se
selecciona y aparece una anotación que muestra los límites del arte en el lado derecho del elemento de arte. Junto al cursor
aparece una anotación más pequeña que muestra la posición del cursor, que se actualiza a medida que el cursor se mueve dentro
del arte.

dibujararte

El ejemplo de DrawArt demuestra cómo usar AIDrawArtSuite para obtener imágenes de mapa de bits de vista previa para mostrarlas
en paneles de Flash. La muestra dibuja una muestra en un puerto AGM, recupera un mapa de bits de ese puerto y pasa el mapa de
bits a un panel Flash para mostrarlo como una imagen.

Esta muestra es una extensión de CS; para ejecutarlo, seleccione Ventana > Extensiones > DrawArt.
Machine Translated by Google

Introducción al desarrollo de Adobe Illustrator CC 2017 Guía de muestras 11

Panel Vacío
El ejemplo de EmptyPanel demuestra cómo usar componentes nativos de Windows o Mac OS en una barra o panel de control,
combinando controles nativos con barras y paneles creados con AIControlBarSuite y AIPanelSuite. La barra y el panel que crea
el ejemplo contienen controles que se implementan mediante componentes de ventana nativos.

En el panel, los controles nativos implementan una calculadora simple. En la barra de control, los valores de los controles nativos
están vinculados a las dimensiones del contenedor, lo que le permite cambiar el tamaño de la barra de control de forma dinámica.

Los ejemplos de Mac OS demuestran la carga de un archivo NIB o XIB nativo en un panel, de modo que pueda usar todas las
funciones estándar de Xcode Interface Builder y combinar Objective-C y C++.

Panel y barra de control con componentes nativos de Mac OS

Panel y barra de control usando componentes nativos de Windows

Machine Translated by Google

Introducción al desarrollo de Adobe Illustrator CC 2017 Guía de muestras 12

FreeGrid
El ejemplo de FreeGrid demuestra el uso de la API AIPerspectiveGridSuite y AIPerspectiveTransformSuite
para manipular Perspective Grid, una función que se agregó en CS5.
AIPerspectiveGridSuite le permite consultar y establecer parámetros de la cuadrícula de perspectiva definida actualmente en
un documento y convertir puntos entre los sistemas de coordenadas de ilustraciones y cuadrícula de perspectiva.
AIPerspectiveTransformSuite le permite proyectar o invertir puntos y objetos de arte de acuerdo con la Cuadrícula de perspectiva.

La extensión FreeGridUI proporciona una interfaz de usuario para el ejemplo de FreeGrid, que demuestra cómo crear una interfaz de usuario
para un complemento utilizando Creative Suite Extension Builder basado en Flash/Flex, que se recomienda como reemplazo de la solución
de interfaz de usuario de ADM en desuso.

Para usar este complemento, primero muestre la cuadrícula de perspectiva eligiendo Ver > Cuadrícula de perspectiva > Mostrar
cuadrícula o seleccionando la herramienta Cuadrícula de perspectiva en el panel Herramientas. Dibuje o seleccione un objeto de arte de
ruta en el plano activo, luego elija Ventana > SDK > FreeGrid.

El cuadro de diálogo resultante le permite realizar una de cuatro operaciones:

ÿ Traduzca la posición del objeto de arte especificando las compensaciones X e Y.

ÿ Escale el tamaño del objeto de arte especificando un porcentaje de zoom.

ÿ Gire el objeto de arte especificando un ángulo.

ÿ Mover el objeto de arte de un plano de perspectiva a otro.

Machine Translated by Google

Introducción al desarrollo de Adobe Illustrator CC 2017 Guía de muestras 13

LiveDropShadow
Utiliza la suite de grupos de complementos . Crea sombras paralelas "vivas" en los objetos; estos funcionan como el filtro DropShadow, excepto que la
sombra sigue cualquier edición del objeto.

Agrega el elemento de menú Objeto > SDK > Sombra paralela en vivo.

El primer objeto tiene una sombra paralela viva. Para demostrar la naturaleza "viva" de la sombra paralela, el segundo objeto muestra el resultado de
cambiar la forma del objeto usando la herramienta Filtro > Distorsionar y transformar > Fruncir y ensanchar.

Objetosmarcados
Implementa una forma de marcar diagramas con arte, para ayudar a diseñar libros durante la publicación. El complemento crea el arte usando una
herramienta en el grupo Anclaje en la paleta de herramientas. Cuando se selecciona la herramienta, hace clic en el documento para agregar un nuevo objeto
marcado. También puede ver y editar los detalles de estos objetos marcados desde el cuadro de diálogo Objetos marcados.

Agrega el elemento de menú Ventana > SDK > Objetos marcados, que abre este panel:

El complemento también agrega una herramienta en el grupo Herramienta Pluma en la paleta Herramientas, usando este icono:

Este es un ejemplo de un objeto creado por la herramienta Objeto marcado, un grupo que contiene dos elementos de arte que representan la cruz
y dos elementos de texto que representan la etiqueta y la identificación:
Machine Translated by Google

Introducción al desarrollo de Adobe Illustrator CC 2017 Guía de muestras 14

MenúReproducir

Demuestra cómo agregar y manipular elementos de menú.

Agrega el elemento de menú Ventana > SDK > Menú Reproducir, con un submenú.

El complemento demuestra estos tipos de manipulación de menús:

ÿ Resaltar elementos de menú cuando se seleccionan tipos de elementos particulares.

ÿ Resaltar elementos del menú cuando la capa de arte tiene un estado particular.

ÿ Cambiar el texto que muestra el elemento del menú cuando un elemento tiene un estado particular.

ÿ Permitir que un elemento del menú afecte la disponibilidad de otro elemento del menú.

ÿ Mostrar el marcador de selección específico de la plataforma para un elemento de tipo alternar.

Herramienta multiflecha

Demuestra cómo agregar varias herramientas a la paleta de herramientas, cambiar iconos y manejar el redibujado dinámico de las
modificaciones de herramientas.

Esta muestra crea su propio grupo de herramientas en la paleta de herramientas, con el icono de flecha seleccionado más recientemente
al frente del grupo. También muestra temas de interfaz de usuario, definiendo una versión clara y oscura del icono de la herramienta.

tema ligero tema oscuro

Una vez que se selecciona una de las herramientas de flecha, el usuario puede hacer clic y arrastrar en el documento para crear una
nueva ruta en forma de flecha. La herramienta Flecha de cabeza crea una flecha con la cabeza al final de la ruta; la herramienta Flecha
de cola, al comienzo de la ruta.

Este ejemplo demuestra cómo mostrar una anotación mientras se dibuja una ruta arrastrando el cursor. La anotación se activa con el botón
izquierdo del mouse y permanece activa mientras se mantiene presionado el botón.
Machine Translated by Google

Introducción al desarrollo de Adobe Illustrator CC 2017 Guía de muestras 15

Mensaje de secuencia de comandos

Demuestra cómo hacer que un complemento admita secuencias de comandos mediante la estructura AIScriptMessage . La
muestra incluye una extensión de Flash que llama al complemento programable a través de ActionScript.

Esta muestra también demuestra el uso de AIUIThemeSuite para detectar el tema de la interfaz de usuario de Illustrator y responder a
los cambios de tema cambiando el estilo de la extensión de forma dinámica.
Machine Translated by Google

Introducción al desarrollo de Adobe Illustrator CC 2017 Guía de muestras 16

SnippetRunner
Un fragmento de código en Illustrator es un archivo de origen, que contiene una clase, en el que puede crear prototipos
de llamadas a la API SDK de forma rápida y sencilla. El complemento SnippetRunner aloja y ejecuta fragmentos de código en
Illustrator CC 2017. Se proporciona un conjunto de fragmentos de código ilustrativos. También puede usar el marco para crear
sus propios fragmentos, lo que le permite explorar la API sin toda la sobrecarga de crear un complemento completo.

El marco que proporciona incluye lo siguiente:

ÿ Una interfaz de usuario que permite elegir y ejecutar fragmentos de código.

ÿ Un mecanismo de entrada de parámetros.

ÿ Un mecanismo de registro de salida.

ÿ Pruebas unitarias integradas de fragmentos, habilitadas a través del menú desplegable del panel.

Este complemento agrega el elemento de menú Ventana > SDK > SnippetRunner, que abre este panel:

ÿ Botón Ejecutar: ejecuta el fragmento de código seleccionado o la operación de fragmento de código.

ÿ Botones Guardar registro/Guardar registro: guarda o borra el registro.

ÿ Botón Prefs: permite al usuario especificar el modo de entrada de parámetros, alternar la prueba unitaria y configurar el
ruta a la carpeta de activos. Hay tres modos de entrada de parámetros disponibles:

ÿ Parámetros predeterminados (los parámetros se proporcionan en el código)

ÿ Parámetros de solicitud (se proporcionan solicitudes para los valores de los parámetros)

ÿ Parámetros CSV (los valores se proporcionan en una cadena CSV).

Machine Translated by Google

Introducción al desarrollo de Adobe Illustrator CC 2017 Guía de muestras 17

Ejecutar y probar fragmentos

Los fragmentos de código se pueden ejecutar o probar en unidades desde el nivel de operación, fragmento o categoría.

La carpeta assets/ contiene los archivos utilizados para las pruebas unitarias; también es la ubicación donde se guardan los documentos de
pruebas unitarias modificadas. Esta carpeta se configura la primera vez que se ejecuta un fragmento de código y permanece igual hasta que se
elimina la preferencia o se cambia la carpeta de activos a través de la opción Establecer carpeta de activos en el menú flotante del panel.

La carpeta assets/ debe estar ubicada en <SDK>/samplecode/CodeSnippets/examplefiles/. Esta carpeta contiene un archivo .ai y archivos
de imágenes compatibles que proporcionan el contexto necesario para varias operaciones de fragmentos.

ÿ Consulte la carpeta <SDK>/samplecode/CodeSnippets/ para ver la lista de fragmentos proporcionados con

SnippetRunner y consulte las breves descripciones de los fragmentos en la interfaz de usuario de SnippetRunner para obtener detalles
sobre lo que hace cada fragmento.

ÿ En particular, examine SnpTemplate, que proporciona un marco básico para nuevos fragmentos e instrucciones
sobre cómo adaptar la plantilla a las necesidades de los nuevos fragmentos.

Explorando la API usando fragmentos de código

El complemento SnippetRunner hace que sea rápido y fácil usar fragmentos de código para explorar la API. Es mucho más rápido y fácil
crear un fragmento de código, en lugar de un complemento completo.

Todo lo que tiene que hacer es agregar el archivo de fragmento de código de plantilla al archivo de proyecto de Xcode o Visual C++. El
archivo de plantilla, <SDK>/samplecode/codesnippets/SnpTemplate.cpp , contiene los ganchosfragmento
que necesita para ejecutar
de código cualquier
nuevo en SnippetRunner.

Siga las instrucciones del archivo de plantilla para crear y adaptar un nuevo fragmento de código a sus requisitos.
Tendrá que adquirir cualquier paquete que requiera su fragmento de código y que no se proporcione con SnippetRunner; simplemente
siga las instrucciones sobre dónde agregarlos.
Machine Translated by Google

Introducción al desarrollo de Adobe Illustrator CC 2017 Guía de muestras 18

TrazoFiltro
Este ejemplo demuestra cómo usar AIBeautifulStrokesSuite, que se agregó en Illustrator CS5. La funcionalidad Beautiful
Strokes:

ÿ Mejora la capacidad de aplicar puntas de flecha.

ÿ Mejora el comportamiento de los extremos de inglete, cambiando el límite de inglete predeterminado de 4 a 10.

ÿ Proporciona trazos de ancho variable, lo que le permite ajustar y modificar los anchos de trazo a lo largo de un
carrera.

ÿ Proporciona ajuste de guión para mejorar el control sobre los trazos discontinuos.

ÿ Le permite escalar los pinceles en función de la longitud de la ruta.

Esta muestra agrega dos filtros, el Filtro de trazo discontinuo para demostrar el ajuste del trazo y el Filtro de trazo
ondulado para demostrar los trazos de ancho variable.

Filtro de trazos discontinuos

Para invocar este filtro, seleccione un objeto de arte de ruta, luego elija Objeto > Filtros > Filtros adicionales > SDK
> Trazo discontinuo. El cuadro de diálogo resultante es similar a la parte central del Panel de trazo (Windows > Trazo):

ÿ "Trazo discontinuo" controla si el arte se dibuja con un trazo continuo o discontinuo.

ÿ "Ajustar guión" activa o desactiva el ajuste de guión.

ÿ Cuando el trazo es discontinuo, puede establecer un patrón de trazo específico especificando longitudes para un
secuencia de tres guiones y espacios.
Machine Translated by Google

Introducción al desarrollo de Adobe Illustrator CC 2017 Guía de muestras 19

Filtro de trazo ondulado

Para invocar este filtro, seleccione un objeto de arte de ruta, luego elija Objeto > Filtros > Filtros adicionales > SDK > Trazo ondulado. En el
diálogo resultante:

ÿ "Número" controla el número de segmentos de onda en el trazo.

ÿ Para n segmentos de onda, los anchos variables se establecen en n+1 puntos a lo largo de la trayectoria, alternando ancho 1 y
ancho 2.

ÿ El ancho 1 se usa primero, a menos que seleccione "Intercambiar ancho 1/2".

ÿ Si selecciona "Reemplazar", los parámetros de ancho antiguos se reemplazan por otros nuevos. De lo contrario, los nuevos
parámetros de ancho se agregan a los antiguos.

formato de archivo de texto

Muestra cómo agregar nuevos formatos de archivo a Illustrator. El complemento agrega el formato "Todo el texto como TEXTO" al cuadro de
diálogo Abrir y al cuadro de diálogo Guardar de Illustrator. También agrega el formato "Texto seleccionado como TEXTO" al cuadro de diálogo
Guardar de Illustrator.
Machine Translated by Google

Introducción al desarrollo de Adobe Illustrator CC 2017 Guía de muestras 20

TransformarBotones
Utiliza la suite AITransformArtSuite para crear una paleta que ejecuta transformaciones con un solo clic en objetos de arte.

Agrega el elemento de menú Ventana > SDK > Botones de transformación, que abre este panel:

Tutorial
Este complemento ilustra los conceptos básicos del desarrollo de complementos. Es la muestra utilizada en la sección "Tutorial" de la Guía
de programadores de Adobe Illustrator CC 2017.

Agrega el elemento de menú Objeto > Filtros > SDK > Tutorial, que abre este cuadro de diálogo modal:

Esta muestra crea un elemento de arte a partir de los parámetros ingresados. El cuadro de diálogo muestra valores predeterminados. La
muestra también define valores mínimos y máximos para cada elemento de datos.

Este arte se crea utilizando los valores predeterminados:

Machine Translated by Google

Introducción al desarrollo de Adobe Illustrator CC 2017 Guía de muestras 21

GirarFiltro
Demuestra cómo crear filtros y efectos en vivo que agregan elementos de menú y manipulan ilustraciones seleccionadas.
Esta muestra agrega elementos de menú a los menús Filter y Effect, implementando la funcionalidad de un filtro y un efecto.

Agrega los elementos de menú Objeto > Filtros > SDK > Giro y Efecto > SDK > Giro. Ambos elementos abren este cuadro de
diálogo:

El Filtro y el Efecto realizan el mismo cambio en el elemento seleccionado. El elemento seleccionado gira en un valor en radianes
calculado a partir del ángulo introducido. El cuadro de diálogo aparece con un valor predeterminado.

Webter
Manipula el diccionario para documentos y objetos de arte, utilizando AIDictionarySuite.

Agrega el elemento de menú Ventana > SDK > Webter, que abre este panel:
Machine Translated by Google

Introducción al desarrollo de Adobe Illustrator CC 2017 Complementos de depuración 22

Complementos de depuración

Esta sección resume cómo depurar su complemento en Visual Studio 2015 y Xcode 7.3.

Depuración de un complemento en Visual Studio

Para depurar su complemento en Visual Studio:

1. Asegúrese de que su complemento esté en una ubicación donde Illustrator pueda encontrarlo. Consulte “Creación y ejecución de los ejemplos”
en la página 9.

2. Abra su proyecto de complemento en Visual Studio.

3. Haga clic con el botón derecho en la carpeta del proyecto y seleccione Propiedades. En las propiedades de configuración, seleccione
Depuración.

Cambie el Comando para que apunte a su ejecutable de Illustrator. La ubicación predeterminada es: C:
\Program Files\Adobe\Adobe Illustrator CC 2017\Support Files\Contents\Windows\Illustrator.exe, o
para instalaciones de 64 bits, en C:\Program Files (x86)\.

4. Establezca un punto de interrupción en su código. Si está comenzando, puede establecer el punto de interrupción inicial en el
función de punto de entrada del complemento, PluginMain(). Para complementos que utilizan el marco de complemento (como
AnnotatorPlugin.cpp), puede establecer un punto de interrupción en StartupPlugin(), que se llama después de la inicialización.

5. Inicie la sesión de depuración mediante el menú Depurar > Iniciar depuración de Visual Studio.

6. Haga clic en Aceptar para comenzar a depurar su complemento en Illustrator.

Depuración de un complemento en Xcode

Para depurar su complemento en Xcode:

1. Asegúrese de que su complemento esté en una ubicación donde Illustrator pueda encontrarlo. Consulte “Creación y ejecución de los ejemplos”
en la página 9.

2. Abra su proyecto de complemento en Xcode.

3. Establezca un punto de interrupción en su código. Si está comenzando, puede establecer el punto de interrupción inicial en el
función de punto de entrada del complemento, PluginMain(). Para los complementos que utilizan el marco de complementos (como
Machine Translated by Google

Introducción al desarrollo de Adobe Illustrator CC 2017 Complementos de depuración 23

AnnotatorPlugin.cpp), puede establecer un punto de interrupción en StartupPlugin(), que se llama después

de la inicialización.

4. Agregue la aplicación Illustrator como ejecutable al proyecto Xcode de su complemento, para que Xcode pueda encontrar la aplicación Illustrator.
Consulte los detalles en “Adición de Illustrator al grupo de ejecutables” en la página 23.

5. Inicie la sesión de depuración usando el menú Ejecutable de depuración de Xcode.

Agregar Illustrator al grupo ejecutable

Para depurar un complemento de Illustrator desde un proyecto de Xcode, Xcode debe poder iniciar la aplicación de Illustrator. Xcode
mantiene esta información en el grupo Ejecutable de un proyecto.

Para definir el ejecutable para su proyecto:

1. Elija Producto > Editar esquema.

2. En el cuadro de diálogo Editar esquema, haga clic en Ejecutable y seleccione Otro en el menú desplegable.

3. En el explorador de archivos resultante, navegue por la aplicación Illustrator CC 2017. La ruta a la instalación predeterminada
la ubicación es:

/Aplicaciones/Adobe Illustrator CC 2017/Adobe Illustrator CC 2017.aplicación

4. Haga clic en Elegir.

Machine Translated by Google

Introducción al desarrollo de Adobe Illustrator CC 2017 Complementos de depuración 24

5. Aparece una ventana de información ejecutable, que resume el entorno ejecutable que acaba de crear.
Haga clic en Aceptar.

Si configura solo un ejecutable para el proyecto, se convierte en el ejecutable activo. cuando eliges
Build > Build And Debug, Xcode inicia la aplicación y muestra una ventana de depuración. Debe asegurarse de que
Illustrator cargue el complemento que desea depurar en el inicio; consulte “Creación y ejecución de las muestras” en
la página 9.

Si Illustrator ya se está ejecutando, puede utilizar Ejecutar > Adjuntar al proceso en Xcode para adjuntar el depurador
y el proyecto actual al proceso en ejecución, siempre que haya configurado previamente el ejecutable del proyecto
como Illustrator.
Machine Translated by Google

Introducción al desarrollo de Adobe Illustrator CC 2017 Uso de las plantillas de proyectos de complementos 25

Configuración del formato de información de depuración

Hay diferentes formatos disponibles para la información de depuración. Los complementos de Illustrator utilizan el formato DWARF (en
lugar del formato Stabs). Para especificar este formato, configure el "Formato de información de depuración"
(DEBUG_INFORMATION_FORMAT) configuración de compilación.

Xcode admite dos tipos de configuraciones DWARF:

ÿ La opción “DWARF” genera símbolos incrustados en el archivo de objeto .o .

ÿ La opción “DWARF con archivo dSYM” coloca los símbolos en un archivo .dSYM separado .

Para obtener más información sobre cómo elegir la opción DWARF adecuada para su complemento, consulte la
documentación de Xcode.

Formateo de datos de programa para el depurador

La vista de variables del depurador de Xcode muestra información sobre los valores de las variables para su programa. Una columna de
resumen proporciona información adicional sobre el contenido de una variable. Para editar un resumen de variables, haga doble clic en la
columna Resumen o seleccione Ejecutar > Vista de variables > Editar formato de resumen.

Cuando usa un depurador de Xcode para ver una variable que usa una estructura de datos compleja, es posible que haga clic para
expandir la variable de clase para ver el miembro que le interesa. Para simplificar, puede crear un formateador de datos para personalizar
cómo se muestran o resumen las variables en el depurador. Para obtener más información, consulte el capítulo sobre "Examen de datos e
información del programa" en:

http://developer.apple.com/documentation/DeveloperTools/Conceptual/XcodeUserGuide/Con
tiendas/Recursos/en.lproj/index.html

Problemas al recorrer el código en el depurador de Xcode

Si tiene problemas para recorrer paso a paso el código del complemento con los botones Pasar por encima o Pasar por dentro del depurador
de Xcode, asegúrese de estar usando la versión compatible de Xcode. Consulte “Configuración de su plataforma de desarrollo” en la página
6.

Si está pasando por encima de una llamada a la API de Illustrator y ve el mensaje "Fotograma anterior dentro de este marco (¿pila corrupta?)",
pruebe una de estas soluciones alternativas:

ÿ Utilice el botón Continuar del depurador de Xcode para reanudar la ejecución.

ÿ Utilice el comando "Continuar hasta aquí" del depurador de Xcode para ejecutar una línea de código posterior. El comando
"Continuar hasta aquí" está disponible al hacer clic con el botón derecho en la parte izquierda del panel del editor de código
en la ventana del depurador de Xcode.

ÿ Paso usando gdb en lugar del botón Paso por encima. Use el menú Depurar > Registro de la consola de Xcode para abrir la consola
del depurador y escriba paso en el indicador.

Uso de las plantillas de proyecto de complemento

Como punto de partida para crear su propio complemento, le recomendamos que utilice las plantillas proporcionadas, que le brindan un
nuevo proyecto con la misma configuración que los complementos de muestra. Las plantillas analizadas en esta sección se encuentran en la
carpeta <SDK>/samplecode/Templates/ .
Machine Translated by Google

Introducción al desarrollo de Adobe Illustrator CC 2017 Uso de las plantillas de proyectos de complementos 26

Para obtener instrucciones detalladas sobre cómo configurar el entorno de desarrollo para la creación de complementos, consulte:

ÿ “Creación de un complemento en Windows” en la página 28

ÿ “Creación de un complemento en Mac OS” en la página 32

Plantilla visual C++

Esta plantilla crea proyectos válidos tanto para Visual Studio como para Xcode. La carpeta de instalación predeterminada, indicada
aquí por <VS>, es C:\Program Files (x86)\Microsoft Visual Studio 10.0.

1. Salga de Visual Studio si se está ejecutando.

2. Copie IllustratorSDKdefault.vcxproj a <VS>\VC\VCWizards\.

3. Copie la carpeta <SDK>\samplecode\Templates\Win\IllustratorSDK\ en <VS>\VC\VCWizards\AppWiz\.

4. Copie el archivo IllustratorSDK.vsz en <VS>\VC\vcprojects\.

5. Cree una nueva carpeta <VS>\VC\vcprojects\IllustratorSDK\ y copie la carpeta

IllustratorSDK.vsdir en la nueva carpeta.

6. Inicie Visual Studio.

7. Elija Archivo > Nuevo > Proyecto.

8. En el panel Tipos de proyecto del cuadro de diálogo Nuevo proyecto, seleccione Visual C++ > IllustratorPlugin.

9. En el panel Plantillas, seleccione SDKProject.

10. Establezca el Nombre del proyecto a un nombre de su elección.

11. Establezca la ubicación del proyecto en la carpeta <SDK>\samplecode . (Si guarda en una ubicación diferente,
tendrá que actualizar las rutas relativas).

12. Asegúrese de que Crear directorio para la solución no esté marcado. (Si se selecciona esta opción, las rutas relativas se
debe actualizarse, ya que el archivo del proyecto no estará en el nivel superior).

13. Haga clic en Aceptar.

14. Genere el proyecto y cárguelo en Illustrator; consulte “Construir el proyecto” en la página 31.

Plantilla de código X

Además de la plantilla en sí, la carpeta Plantillas/Mac contiene una herramienta que puede usar para crear proyectos de Xcode a partir
de la plantilla. Para usarlo, abra un shell de comandos y escriba:

cd <SDK_root>/samplecode/Templates/Mac
create_project.sh <Nombre del proyecto>

Esta herramienta sigue los pasos que usaría para crear un proyecto a mano a partir de la plantilla:

1. Copie el proyecto "Template" de <SDK_root>/samplecode/Templates/Mac en su SampleCode

carpeta.

2. Abra el Proyecto Xcode dentro de su proyecto recién copiado.

Machine Translated by Google

Introducción al desarrollo de Adobe Illustrator CC 2017 Uso de las plantillas de proyectos de complementos 27

3. Use el comando Buscar para encontrar todas las instancias de “[PROJECT_NAME]” y reemplace todas las instancias con el nombre de su
proyecto.

4. Cambie el nombre de todos los archivos de origen de "Template*.*" a "project_name*.*"

Por ejemplo, cambie el nombre de TemplatePlugin.cpp a MyProjectPlugin.cpp.

5. En el panel de carpetas, expanda el elemento Destinos. Cambie el nombre del paquete "Plantilla" en esa sección a la
nombre de su proyecto (haga clic con el botón derecho en "Plantillas" y elija Cambiar nombre).

6. Haga doble clic en el proyecto en el panel de carpetas y seleccione la pestaña Generar. Use el cuadro de búsqueda para encontrar la cadena
"Plantilla", para reducir las opciones de construcción. Busque "Nombre del producto" en el elemento "Embalaje" y "NOMBRE DEL
PROYECTO" en el elemento Definido por el usuario. En ambos, cambie el valor de "Plantilla" al nombre de su proyecto.

7. Compile y ejecute Illustrator para ver su proyecto de trabajo.

Machine Translated by Google

Introducción al desarrollo de Adobe Illustrator CC 2017 Creación de un complemento en Windows 28

Creación de un complemento en Windows

Esta sección describe cómo escribir desde cero un complemento que amplíe Illustrator de una manera muy básica. Las instrucciones crean un
complemento HelloWorld para Illustrator, que muestra una alerta cuando Illustrator se inicia o se apaga.

ÿ Esta sección proporciona instrucciones para la plataforma Windows. Consulte también “Creación de un complemento en Mac OS”
en la página 32.

Crear un nuevo proyecto

1. Inicie Visual C++.

2. Elija Archivo > Nuevo > Proyecto...

3. En el cuadro de diálogo Nuevo proyecto, haga lo siguiente:

ÿ Expanda el filtro de Visual C++.

ÿ En la ventana Tipos de proyecto, resalte Win32.

ÿ En la ventana Plantillas, seleccione Proyecto Win32.

ÿ Establezca la propiedad Nombre del proyecto en HelloWorld.

ÿ Establezca la propiedad Ubicación del proyecto en <SDK>samplecode.

ÿ Anule la selección de Crear directorio para la solución.

ÿ Haga clic en Aceptar.

4. En el Asistente para aplicaciones Win 32, haga lo siguiente:

ÿ Seleccione Configuración de la aplicación.

ÿ En Tipo de aplicación, seleccione DLL.

ÿ En Opciones adicionales, seleccione Proyecto vacío.

ÿ Haga clic en Finalizar.

Agregar un archivo fuente

1. En el Explorador de soluciones, haga clic con el botón derecho en la carpeta Archivos de origen.

2. Elija Agregar > Nuevo elemento...

3. En el cuadro de diálogo Agregar nuevo elemento, haga lo siguiente:

ÿ Expanda el filtro de Visual C++.

ÿ Resalte Código y seleccione Archivo C++ (.cpp).

ÿ Establezca la propiedad Nombre del archivo en HelloWorld.cpp.

ÿ Haga clic en Agregar.

Machine Translated by Google

Introducción al desarrollo de Adobe Illustrator CC 2017 Creación de un complemento en Windows 29

4. Copie este código en el archivo fuente y guárdelo.

#include "IllustratorSDK.h"
// Dígale a Xcode que exporte los siguientes símbolos #si está definido
(__GNUC__) #pragma GCC visibilidad push (predeterminado) #endif //
Punto de entrada del complemento externo "C" ASAPI ASErr
PluginMain(char * llamador, char* selector, void* mensaje); // Dígale a
Xcode que vuelva a la visibilidad predeterminada para los símbolos
#si está definido (__GNUC__) #pragma GCC visibilidad pop #endif

externo "C"
{
AIUnicodeStringSuite* sAIUnicodeString = NULL;
SPBlocksSuite* sSPBlocks = NULL;
}

extern "C" ASAPI ASErr PluginMain(char* llamante, char* selector, void* mensaje) {

ASErr error = kNoErr;

SPBasicSuite* sSPBasic = ((SPMessageData*)mensaje)->básico; if (sSPBasic->IsEqual(caller,
kSPInterfaceCaller)) {
AIUserSuite *sAIUser = NULL; error =
sSPBasic->AcquireSuite(kAIUserSuite, kAIUserSuiteVersion, (const void**) &sAIUser); error = sSPBasic-
>AcquireSuite(kAIUnicodeStringSuite, kAIUnicodeStringSuiteVersion, (const void**) &sAIUnicodeString); error = sSPBasic-
>AcquireSuite(kSPBlocksSuite, kSPBlocksSuiteVersion, (const void**)

&sSPBbloques);
if(sSPBasic->IsEqual(selector, kSPInterfaceStartupSelector)){ sAIUser-
>MessageAlert(ai::UnicodeString("Hello World!"));
}
else if(sSPBasic->IsEqual(selector, kSPInterfaceShutdownSelector)){ sAIUser-
>MessageAlert(ai::UnicodeString("Goodbye World!"));

} error = sSPBasic->ReleaseSuite(kAIUserSuite, kAIUserSuiteVersion); error = sSPBasic-

>ReleaseSuite(kAIUnicodeStringSuite, kAIUnicodeStringSuiteVersion); }

error de retorno;
}

5. En el Explorador de soluciones, haga clic con el botón derecho en la carpeta Archivos de origen y elija Agregar > Elemento existente.

6. Navegue a la carpeta <SDK_root>\Illustratorapi\illustrator.

7. Seleccione el archivo IAIUnicodeString.cpp.

8. Haga clic en Agregar.

Agregar un archivo de recursos

1. En el Explorador de soluciones, haga clic con el botón derecho en la carpeta Archivos de recursos.

2. Elija Agregar > Nuevo elemento...

3. En el cuadro de diálogo Agregar nuevo elemento, haga lo siguiente:

Machine Translated by Google

Introducción al desarrollo de Adobe Illustrator CC 2017 Crear un complemento en Windows 30

ÿ Expanda el filtro de Visual C++.

ÿ Resalte Recurso y seleccione Archivo de recursos (.rc).

ÿ Establezca la propiedad Nombre del archivo en HelloWorld.rc.

ÿ Haga clic en Agregar.

4. Cierre la ventana Vista de recursos.

5. En el Explorador de soluciones, haga clic con el botón derecho en HelloWorld.rc.

6. Seleccione Ver código.

7. Justo antes de la línea que contiene #ifdef APSTUDIO_INVOKED, inserte este código:

#define kMySDKPluginName "HelloWorld" #define

PIPL_PLUGIN_NAME
kMySDKPluginName ///////////////////////////////////////// //////////////////////////////////// //

// PIPL //
#define
LC(a,b,c,d) #d, #c, #b, #a
16000 PiPL DESECHABLE
BEGIN
0x0001, /* Reservado (para Photoshop) */
0L, /* kCurrentPiPLVersion */
4L, /* Recuento de propiedades */
LC(A,D,B,E), /* ID de proveedor */
LC(k,i,n,d), /* clavepropiedad = PIKindProperty */
0L, /* ID de propiedad */
4L, /* propiedadLongitud */
LC(S,P,E,A), /* datos de propiedad */
LC(A,D,B,E), /* ID de proveedor */
LC(i,v,r,s), /* clavepropiedad = PISPVersionProperty */
0L, /* ID de propiedad */
4L, /* propiedadLongitud */
2L, /* datos de propiedad */
LC(A,D,B,E), /* ID de proveedor */
LC(w,x,8,6), /* clavepropiedad = PIWin32X86CodeProperty */
0L, /* ID de propiedad */
12L, /* propiedadLongitud */
"PluginMain\0\0", /* propertyData = Punto de entrada */
/* (Cadena C rellenada con palabra larga) */
LC(A,D,B,E), /* Clave de proveedor */
LC(p,i,n,m), /* propertyKey = PIPluginNameProperty */
0L, /* ID de propiedad */
12L, /* propiedadLongitud */
PIPL_PLUGIN_NAME "\0\0" /* propertyData = Nombre del complemento (rellenado a 4 bytes) */

FINAL

8. Guarde el archivo.

Configurar los ajustes del proyecto

1. Haga clic con el botón derecho en el nombre del proyecto en el Explorador de soluciones y seleccione Propiedades para abrir las Páginas de propiedades.
diálogo.
Machine Translated by Google

Introducción al desarrollo de Adobe Illustrator CC 2017 Crear un complemento en Windows 31

2. En el cuadro de diálogo Páginas de propiedades del proyecto, expanda el filtro Propiedades de configuración.

3. Expanda el filtro C/C++.

4. Elija Propiedades de configuración > C/C++ > General.

5. En el campo Directorios de inclusión adicionales, ingrese lo siguiente:

..\..\illustratorapi\ate;..\common\includes;..\..\illustratorapi\adm; ..\..\illustratorapi\illustrator\legacy;..\..
\illustratorapi\illustrator; ..\..\illustratorapi\pica_sp

6. Elija Propiedades de configuración > C/C++ > Generación de código.

7. Establezca la Biblioteca de tiempo de ejecución en Depuración de subprocesos múltiples (/MTd).

8. Establezca Alineación de miembros de estructura en 8 bytes (/Zp8).

9. Expanda el filtro Vinculador.

10. Elija Propiedades de configuración > Enlazador > General.

11. Establezca el archivo de salida en ..\output\win\debug\HelloWorld.aip

12. Elija Propiedades de configuración > Enlazador > Entrada.

13. Establezca el Archivo de definición de módulo en ..\common\win\PluginMain.def

14. Haga clic en Aplicar y luego en Aceptar.

construir el proyecto
1. Los ajustes que hemos elegido son para una configuración de depuración, así que asegúrese de que Depurar esté seleccionado en el
la lista desplegable.

2. Cree el proyecto eligiendo Build > Build HelloWorld.

3. Solucione cualquier error de compilación. Consulte “Depuración de complementos” en la página 22.

Después de compilar y vincular, el archivo binario del complemento se encuentra en la siguiente ubicación:

<SDK>\código de muestra\salida\ganar\depurar\

Debe asegurarse de que el binario del complemento esté en una ubicación en la que Illustrator haya buscado complementos para cargar;
consulte “Creación y ejecución de las muestras” en la página 9.

Para probar el complemento, inicie Illustrator CC 2017. Durante el inicio, aparece una alerta que muestra un breve saludo.
Una vez que se haya iniciado la aplicación, el nombre de su complemento debe aparecer en el cuadro de diálogo Ayuda > Información del sistema....
Durante el apagado, aparece una alerta que muestra otro mensaje corto.
Machine Translated by Google

Introducción al desarrollo de Adobe Illustrator CC 2017 Creación de un complemento en Mac OS 32

Creación de un complemento en Mac OS

Esta sección describe cómo escribir desde cero un complemento que amplíe Illustrator de una manera muy básica. Las instrucciones crean
un complemento HelloWorld para Illustrator, que muestra una alerta cuando Illustrator se inicia o se apaga.

ÿ Esta sección proporciona instrucciones para la plataforma Mac OS. Consulte también "Creación de un complemento en Windows"
en la página 28.

Crear un nuevo proyecto

1. Inicie Xcode.

2. Elija Archivo > Nuevo > Nuevo proyecto.

3. En el Asistente de nuevo proyecto, elija Otro > Proyecto vacío como plantilla y haga clic en Siguiente.

4. Establezca el Nombre del proyecto en HelloWorld.

5. Establezca el directorio del proyecto en <SDK>/samplecode.

6. Haga clic en Crear.

7. En el menú principal, seleccione Nuevo grupo.

Machine Translated by Google

Introducción al desarrollo de Adobe Illustrator CC 2017 Creación de un complemento en Mac OS 33

8. Asigne el nombre Fuente al nuevo grupo.

9. Agregue otro grupo nuevo, denominado Recursos.

Agregar un objetivo

1. Haga clic en el proyecto para mostrar la página del proyecto y elija Agregar destino.

2. En New Target Assistant, seleccione Mac OS X > Framework & Library > Bundle como plantilla y
haga clic en Siguiente.

3. Establezca el Nombre del producto en HelloWorld y haga clic en Finalizar para volver a la página del proyecto.

4. En la página del proyecto, seleccione la pestaña Configuración de compilación.

5. Busque la configuración de extensión de contenedor y configúrela en "aip".

Agregar un archivo fuente

1. Haga clic con el botón derecho en la carpeta Fuente y elija Nuevo archivo.
Machine Translated by Google

Introducción al desarrollo de Adobe Illustrator CC 2017 Creación de un complemento en Mac OS 34

2. Elija Mac OS X > C y C++ > Archivo de clase C++ como plantilla.

3. Nombre el nuevo archivo HelloWorld. Esto crea los archivos HelloWorld.cpp y HelloWorld.h; Eliminar
HolaMundo.h.

4. Abra el archivo HelloWorld.cpp, copie el siguiente código y guárdelo:

#include "IllustratorSDK.h"
// Dile a Xcode que exporte los siguientes símbolos #si está
definido(__GNUC__) #pragma GCC visibilidad push(predeterminado)
#endif

// Punto de entrada del

complemento externo "C" ASAPI ASErr PluginMain(char * llamante, char* selector, void* mensaje);
// Dígale a Xcode que vuelva a la visibilidad predeterminada para los símbolos #si está
definido (__GNUC__) #pragma GCC visibilidad pop #endif

externo "C"
{
AIUnicodeStringSuite* sAIUnicodeString = NULL;
SPBlocksSuite* sSPBlocks = NULL;
}
Machine Translated by Google

Introducción al desarrollo de Adobe Illustrator CC 2017 Creación de un complemento en Mac OS 35

extern "C" ASAPI ASErr PluginMain(char* llamante, char* selector, void* mensaje) {

ASErr error = kNoErr;

SPBasicSuite* sSPBasic = ((SPMessageData*)mensaje)->básico; if (sSPBasic->IsEqual(caller,
kSPInterfaceCaller)) {
AIUserSuite *sAIUser = NULL; error =
sSPBasic->AcquireSuite(kAIUserSuite, kAIUserSuiteVersion, (const
vacío**) &sAIUser);
error = sSPBasic->AcquireSuite(kAIUnicodeStringSuite,
kAIUnicodeStringSuiteVersion, (const void**) &sAIUnicodeString); error = sSPBasic-
>AcquireSuite(kSPBlocksSuite, kSPBlocksSuiteVersion, (const
vacío**) &sSPBlocks);
if(sSPBasic->IsEqual(selector, kSPInterfaceStartupSelector)){ sAIUser-
>MessageAlert(ai::UnicodeString("Hello World!"));
}
else if(sSPBasic->IsEqual(selector, kSPInterfaceShutdownSelector)){ sAIUser-
>MessageAlert(ai::UnicodeString("Goodbye World!"));

} error = sSPBasic->ReleaseSuite(kAIUserSuite, kAIUserSuiteVersion); error = sSPBasic-

>ReleaseSuite(kAIUnicodeStringSuite, kAIUnicodeStringSuiteVersion);

}
error de retorno;
}

Agregar dependencias del proyecto

1. En el panel de carpetas, haga clic con el botón derecho en la carpeta Fuente y elija Agregar archivos a "HelloWorld".

2. Navegue a la carpeta <SDK_root>\Illustratorapi\illustrator.

3. Seleccione el archivo IAIUnicodeString.cpp.

4. Haga clic en Agregar.

Agregar un archivo de recursos

1. En Carpetas, haga clic con el botón derecho en la carpeta Recursos y elija Nuevo archivo.

2. En Mac OS X > Otro, elija Vacío como plantilla y haga clic en Siguiente.

3. Establezca el nombre de archivo en HelloWorld.r.

4. Seleccione el objetivo y haga clic en Crear.

5. Copie lo siguiente en el nuevo archivo de recursos:

#define PIPL_PLUGIN_NAME "HelloWorld" #incluye

"Plugin.r"

Configurar los ajustes del proyecto

1. En Carpetas, haga clic en el proyecto para mostrar la página del proyecto y seleccione la pestaña Configuración de compilación.
Machine Translated by Google

Introducción al desarrollo de Adobe Illustrator CC 2017 Creación de un complemento en Mac OS 36

2. Establezca los siguientes valores:

Ajuste Valor

SDK base Mac OS X 10.11

Arquitectura Intel de 64 bits

Compilador para C/C++/Objetivo C com.apple.compilers.llvm.clang.1_0

Crear ruta de productos ./../salida/mac/$(AI_CONFIGURACIÓN)

Ruta de productos de compilación por configuración

Ruta de archivos de compilación intermedia .

Rutas de búsqueda de encabezado ../common/** ../../

illustratorapi/**
/Desarrolladores/Encabezados/FlatCocoa/**

Archivo Info.plist ../common/mac/Info.plist

Archivo de prefijo de preprocesador Info.plist ../común/incluye/SDKDef.h

Encabezado de prefijo > Depurar ./../common/includes/IllustratorSDKdebug.pch

Encabezado de prefijo > Liberar

./../common/includes/IllustratorSDKrelease.pch

Destino de implementación OS X 10.10

Dialecto del lenguaje C Predeterminado del compilador

Dialecto del lenguaje C++

Biblioteca estándar de C++

Forzar la generación de información del paquete Sí

Preprocesar archivo Info.plist Sí

3. Elija Agregar configuración de compilación > Agregar configuración definida por el usuario e ingrese una configuración
denominada "AI_CONFIGURATION".

Expanda su definición y establezca el valor Debug en "debug" y el valor Release en "release":

4. En Objetivos a la izquierda, seleccione el objetivo HelloWorld y vaya a la pestaña Fases de construcción.

Machine Translated by Google

Introducción al desarrollo de Adobe Illustrator CC 2017 Creación de un complemento en Mac OS 37

5. Haga clic en Agregar fase de construcción y elija "Agregar recursos de carbono de construcción".

6. Haga clic en "+" y elija HelloWorld.r como el nuevo recurso.

construir el proyecto

1. Elija Producto > Editar esquema y seleccione "Depurar" como configuración de compilación.

2. Cree el proyecto eligiendo Producto > Generar.

3. Solucione cualquier error de compilación. Consulte “Depuración de complementos” en la página 22.

Después de compilar y vincular, el archivo binario del complemento se encuentra en la siguiente ubicación:

<SDK>/código de muestra/salida/mac/debug/

Debe asegurarse de que el binario del complemento esté en una ubicación en la que Illustrator haya buscado complementos para cargar; consulte
“Creación y ejecución de los ejemplos” en la página 9. Para probar el complemento, inicie Illustrator CC 2017. Durante el inicio, aparece una alerta
que muestra un breve saludo. Una vez que se haya iniciado la aplicación, el nombre de su complemento debe aparecer en el cuadro de diálogo Ayuda
> Información del sistema.... Durante el apagado, aparece una alerta que muestra otro mensaje corto.