Documentos de Académico
Documentos de Profesional
Documentos de Cultura
Ai 2015 Development Esp
Ai 2015 Development Esp
EMPEZAR CON
ADOBE ILLUSTRATOR CC
2015
DESARROLLO
Machine Translated by Google
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
Terminología y convenciones. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Explorando la documentación. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Visores de documentos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Creación de un complemento. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 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
Filtro de trazo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Filtro de trazos discontinuos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Filtro de trazo ondulado. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Transformar botones. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Tutorial . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Filtro giratorio. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Webter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
3
Machine Translated by Google
Contenido 4
Plantilla Xcode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Construya el proyecto. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
proyecto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
Agregar un objetivo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Construya el proyecto. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
Machine Translated by Google
Prefacio
El SDK de Illustrator CC 2015 está disponible para su descarga desde:
http://www.adobe.com/devnet/illustrator/
1. Configure su máquina para el desarrollo. Siga las instrucciones en "Configuración de su plataforma de desarrollo" en la página 6.
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.
ÿ <VS> indica la ubicación de instalación de Microsoft Visual Studio 2013 (también conocido como VC++ 11.0). La
ubicación real depende de la instalación; el valor predeterminado es C:\Archivos de programa\Microsoft Visual
Studio 11.0/.
5
Machine Translated by Google
Componente de plataforma
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 2015 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:
Explorando el SDK
El SDK contiene documentación y ejemplos de código para ayudarlo a desarrollar sus propios complementos de Illustrator CC 2015 y a
migrar complementos de versiones anteriores.
Machine Translated by Google
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 2015. Está dirigido
Programador 2015 a todos los desarrolladores y es el recurso recomendado para los desarrolladores de complementos
Guía después de leer este documento.
adobe illustratorcc Describe cómo actualizar el código del complemento CC 2014 SDK para Illustrator CC 2015; está
Guía de portabilidad 2015 dirigido a desarrolladores con complementos preexistentes. Enumera nuevas funciones y cambios
en la API desde la versión anterior.
Uso del texto de Adobe Describe cómo configurar su complemento para utilizar la API del motor de texto de Adobe,
Motor proporcionada con el SDK de Illustrator CC 2015. 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.
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.
ÿ 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.
Asesor de API Informa sobre las diferencias de clase, estructura y archivo entre la API incluida en CC 2014 SDK y
CC 2015SDK. 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 2015.
Visores de documentos
ÿ Para ver la documentación basada en PDF, necesita Adobe Reader o Adobe Acrobat.
ÿ 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/).
Rasgo
Acción X X
Puerto AGM X
Anotador X X
Formato de archivo X
Filtrar X X
Efecto X
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
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 2015.
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.
ÿ 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:
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 2015.
Para depurar una muestra (o su propio complemento), consulte “Depuración de complementos” en la página 22.
Machine Translated by Google
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.
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
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++.
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.
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
MenúReproducir
Agrega el elemento de menú Ventana > SDK > Menú Reproducir, con un submenú.
ÿ 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ú.
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.
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
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
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 2015. 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.
ÿ 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 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 de solicitud (se proporcionan solicitudes para los valores de los parámetros)
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.
ÿ 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.
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 ganchos que necesita de
fragmento para ejecutar
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
TrazoFiltro
Este ejemplo demuestra cómo usar AIBeautifulStrokesSuite, que se agregó en Illustrator CS5. La funcionalidad Beautiful
Strokes:
ÿ 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.
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.
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):
ÿ 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
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:
ÿ 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.
ÿ 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.
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
botones de transformación
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
para programadores de Adobe Illustrator CC 2015.
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.
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
Complementos de depuración
Esta sección resume cómo depurar su complemento en Visual Studio 2013 y Xcode 6.2.
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.
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 2015\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.
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.
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
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.
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.
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 2015. La ruta a la instalación predeterminada
la ubicación es:
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 2015 Uso de las plantillas de proyectos de complementos 25
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.
ÿ 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.
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
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 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.
Introducción al desarrollo de Adobe Illustrator CC 2015 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:
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.
8. En el panel Tipos de proyecto del cuadro de diálogo Nuevo proyecto, seleccione Visual C++ > IllustratorPlugin.
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).
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:
Introducción al desarrollo de Adobe Illustrator CC 2015 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.
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.
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.
1. En el Explorador de soluciones, haga clic con el botón derecho en la carpeta Archivos de origen.
#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) {
&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 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.
1. En el Explorador de soluciones, haga clic con el botón derecho en la carpeta Archivos de recursos.
7. Justo antes de la línea que contiene #ifdef APSTUDIO_INVOKED, inserte este código:
// 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.
2. En el cuadro de diálogo Páginas de propiedades del proyecto, expanda el filtro Propiedades de configuración.
..\..\illustratorapi\ate;..\common\includes;..\..\illustratorapi\adm; ..\..\illustratorapi\illustrator\legacy;..\..
\illustratorapi\illustrator; ..\..\illustratorapi\pica_sp
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.
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 2015. 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
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.
3. En el Asistente de nuevo proyecto, elija Otro > Proyecto vacío como plantilla y haga clic en Siguiente.
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.
1. Haga clic con el botón derecho en la carpeta Fuente y elija Nuevo archivo.
Machine Translated by Google
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.
#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;
}
Machine Translated by Google
extern "C" ASAPI ASErr PluginMain(char* llamante, char* selector, void* mensaje) {
}
error de retorno;
}
1. En el panel de carpetas, haga clic con el botón derecho en la carpeta Fuente y elija Agregar archivos a "HelloWorld".
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.
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
Ajuste Valor
3. Elija Agregar configuración de compilación > Agregar configuración definida por el usuario e ingrese una configuración
denominada "AI_CONFIGURATION".
5. Haga clic en Agregar fase de construcción y elija "Agregar recursos de carbono de construcción".
construir el proyecto
1. Elija Producto > Editar esquema y seleccione "Depurar" como configuración de compilación.
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 muestras” en la página 9. Para probar el complemento, inicie Illustrator CC 2015. 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.