SWC-библиотека - это библиотека классов с закрытым исходным кодом, которая хранится в файлах с расширением .swc. Также .swc-файлы используются для хранения отдельных компонентов, которые используются во Flash IDE.
Файлы с расширением .swc являются .zip-файлами, упакованными с помощью формата PKZIP. Внутри архива находится .swf-файл с классами, и catalogue.xml c описанием классов. Также в архив могут быть включены дополнительный файлы: картинки, .css-файлы и другие. Подробнее о формате .swc-файлов смотрите на Adobe.
SWC-библиотеки в основном используются в коммерческих проектах. Пользоваться ими легко (об этом ниже), а вот компилировать свои немного сложнее. В данной статье я рассмотрю компиляцию .swc-библиотек, на основе FlashDevelop.
Как компилировать .swc-библиотеку во FlashDevelop.
Подготовим среду разработки.
1. Компилировать .swc-файлы мы будем с использованием Flex Ant Tasks. Подробнее об этом смотрите в справке.
Для этого нам необходимо установить java-утилиту Apache Ant, которую можно скачать на официальном сайте: http://ant.apache.org/. Утилита распространяется в архиве, поэтому инсталлировать её нужно самостоятельно. Распакуйте корневую папку архива в любой каталог на локальном диске, желательно в "Program Files". Например, у меня - это "C:\Program Files\Apache\ant\1.7.1".
2. Перейдем к настройке FlashDevelop. В верхнем меню выбираем пункт "Tools", далее "Custom Arguments".
В появившемся окне внесем два пользовательских аргумента "FlexSDKDir" и "AntDir", в значениях которых пропишем пути соответственно. У меня получилось следующее:
Эти два аргумента нужны для нового типа проекта, который мы сейчас добавим.
Для этого скачиваем архив шаблонов проекта. Полученный архив нужно распаковать в директорию "Projects", которая находится в папке с установленным FlashDevelop. Например, у меня - это "C:\Program Files\FlashDevelop\Projects". Теперь после рестарта FlashDevelop,
в проектах у вас появится новый тип проекта "AS3 SWC Builder".
Попробуем что-нибудь скомпилировать.
Создаем новый проект типа "AS3 SWC Builder". В окне "Project" увидим следующее содержимое проекта:
bin - директория, в которой будет находится скомпилированный.swc-файл.
build - здесь, находятся файлы с настройками компиляции.
src - из этой папки будут браться классы, которые мы будем зашивать в нашу .swc-библиотеку.
build.bat - файл который запускает сборку (компиляцию) библиотеки.
Перенесем в директорию "src" необходимые нам .as-файлы. Например, мои:
Теперь перейдем к настройкам. Откроем файл compc-config.xml, который находится в папке "build", и в нем в теге , пропишем классы которые хотим включить в библиотеку.
Запускаем build.bat (нажатием F5), и в директории "bin" появится .swc-библиотека с классами, которые мы включили в неё.
Единственный вопрос остался у меня, на который я так и не нашел ответ: "Что за посторонний класс появляется при сборке .swc-файла?"
Может быть кто-то из читателей мне подскажет.
Дополнительная информация.
Возможно не всегда удобно использовать директорию "src", для хранения исходных классов. Вы можете изменить директорию с исходными классами в файле build.xml в свойстве output.dir
Использовать .swc-библиотеку в AS3-проекте достаточно легко. Необходимо перенести .swc-файл в директорию "lib", нажать на файле правой кнопкой и в "Add To Library" поставить галочку.
Теперь вы можете использовать классы библиотеки, также как и классы, которые находятся в директории "src".
Работая над отладкой AS3-приложения, мы обычно заливаем обновленный .swf-файл на сервер, и идем проверять исчезла ли, только что исправленная, ошибка. Обнаруживаем, что не исчезла. Вспоминаем про кеш браузера, чистим его. Проверяем снова. Опять не исчезла. Думаем как же так получилось... Всё таки приходим к мнению, что кеш не сбросился, и повторяем всё снова...
А как бы было неплохо, показывать билд или дату компиляции .swf-файла.
Оказывается такое возможно благодаря трудам Igor Costa и Paul Sivtsov. Можно узнать дату компиляции внутри .swf-файла.
Компилирую .swf-файл при помощи Flex SDK в результирующий файл записывается некоторая информация. Во Flash IDE, такого не происходит. После полной загрузки .swf-файла, внутри родительского класса можно прочитать байты. А дальше, использую класс flash.utils.ByteArray, можно вытащить те самые данные которые записываются Flex SDK. В них можно найти и дату компиляции.
Для корректной работы в браузерах (исходный класс, взятый с сайта Igor Costa, работал только в дебаг-плеере), я немного изменил класс:
package org.igorcosta.hacks
{
import flash.display.DisplayObject;
import flash.display.LoaderInfo;
import flash.utils.ByteArray;
import flash.utils.Endian;
/**
* Direct reading of SWF file
* Distributed under the new BSD License
* @author Paul Sivtsov - ad@ad.by
*/publicclass SWF
{
/////////////////////////////////////////////// Reference to the parent classprivatevar root:DisplayObject;
///////////////////////////////////////////////// Constructor
function SWF (root:DisplayObject)
{
this.root = root;
}
///////////////////////////////////////////////// Returns compilation date of current modulepublic function readCompilationDate(serialNumber: ByteArray = null): Date
{
const compilationDate: Date = new Date;
const DATETIME_OFFSET: uint = 18;
//if (serialNumber == null)
serialNumber = readSerialNumber();
///* example of filled SWF_SERIALNUMBER structure
struct SWF_SERIALNUMBER
{
UI32 Id; // "3"
UI32 Edition; // "6"
// "flex_sdk_4.0.0.3342"
UI8 Major; // "4."
UI8 Minor; // "0."
UI32 BuildL; // "0."
UI32 BuildH; // "3342"
UI32 TimestampL;
UI32 TimestampH;
};
*///// the SWF_SERIALNUMBER structure exists in FLEX swfs only, not FLASHif (serialNumber == null)
returnnull;
//// date stored as uint64
serialNumber.position = DATETIME_OFFSET;
serialNumber.endian = Endian.LITTLE_ENDIAN;
compilationDate.time = serialNumber.readUnsignedInt() + serialNumber.readUnsignedInt() * (uint.MAX_VALUE + 1);
//return compilationDate;
}
/////////////////////////////////////////////////////////////////////////////// Returns contents of Adobe SerialNumber SWF tagpublic function readSerialNumber(): ByteArray
{
const TAG_SERIAL_NUMBER: uint = 0x29;
return findAndReadTagBody(TAG_SERIAL_NUMBER);
}
/////////////////////////////////////////////////////////////////////////////// Returns the tag body if it is possiblepublic function findAndReadTagBody(theTagCode: uint): ByteArray
{
// getting direst access to unpacked SWF file//const src: ByteArray = LoaderInfo.getLoaderInfoByDefinition(SWF).bytes;const src: ByteArray = root.loaderInfo.bytes;
///*
SWF File Header
Field Type Offset Comment
----- ---- ------ -------
Signature UI8 0 Signature byte: “F” indicates uncompressed, “C” indicates compressed (SWF 6 and later only)
Signature UI8 1 Signature byte always “W”
Signature UI8 2 Signature byte always “S”
Version UI8 3 Single byte file version (for example, 0x06 for SWF 6)
FileLength UI32 4 Length of entire file in bytes
FrameSize RECT 8 Frame size in twips
FrameRate UI16 8+RECT Frame delay in 8.8 fixed number of frames per second
FrameCount UI16 10+RECT Total number of frames in file
*///// skip AVM2 SWF header// skip Signature, Version & FileLength
src.position = 8;
// skip FrameSizeconst RECT_UB_LENGTH:uint = 5;
const RECT_SB_LENGTH:uint = src.readUnsignedByte() >> (8 - RECT_UB_LENGTH);
const RECT_LENGTH: uint = Math.ceil((RECT_UB_LENGTH + RECT_SB_LENGTH * 4) / 8);
src.position += (RECT_LENGTH - 1);
// skip FrameRate & FrameCount
src.position += 4;
//while (src.bytesAvailable > 0)
with (readTag(src, theTagCode))
{
if (tagCode == theTagCode)
return tagBody;
}
//returnnull;
}
/////////////////////////////////////////////////////////////////////////////// Returns tag from current read positionprivate function readTag(src: ByteArray, theTagCode: uint): Object
{
src.endian = Endian.LITTLE_ENDIAN;
//const tagCodeAndLength: uint = src.readUnsignedShort();
const tagCode: uint = tagCodeAndLength >> 6;
const tagLength: uint = function(): uint {
const MAX_SHORT_TAG_LENGTH: uint = 0x3F;
const shortLength:uint = tagCodeAndLength & MAX_SHORT_TAG_LENGTH;
return (shortLength == MAX_SHORT_TAG_LENGTH) ? src.readUnsignedInt() : shortLength;
}();
//const tagBody: ByteArray = new ByteArray;
if (tagLength > 0)
src.readBytes(tagBody, 0, tagLength);
//return {
tagCode: tagCode,
tagBody: tagBody
};
}
}
}
var swf:SWF = new SWF (root); // @param root ссылка на родительский класс приложения.
trace("Complilation Date = " + swf.readCompilationDate().toString());
Об этом я уже заикался, рассказывая вам о работе с библиотекой во FlashDevelop. Так вот, вставка Embed, обрамленная квадратными скобками - это и есть Flex Metadata Tag, который сообщает компилятору (Flex SDK) о том, что нужно вставить указанный объект.
Кроме тега Embed, есть еще много чего интересного. Найти полный список тегов можно в справочнике по Flex или здесь. Большинство из них используется при разработке Flex-проектов, поэтому при разработке AS3-проекта они нам не понадобятся, кроме SWF и Embed. Embed я уже описывал, теперь о SWF.
[SWF]
Этот тег отвечает за публикацию результирующего .swf-файла. Теперь не нужно лазить в настройки публикации проекта, можно всё настроить прямо в коде.
Атрибуты тега SWF (опишу только те, которыми реально можно пользоваться):
width - Ширина
height - Высота
scriptRecursionLimit - Ограничения времени рекурсий сценария
Сегодня мы рассмотрим, как правильно перевести экранную меру длины (пиксели) в общепринятую (дюймы).
Сколько пикселей в одном дюйме?
Количество пикселей в дюйме зависит от монитора, а именно от разрешения экрана. На разных разрешениях будут разные значения. Попробуем разобраться.
Для преобразования используется простая пропорция:
Что такое INCHES и PIXEL понятно, а вот что такое DPI?
DPI (Dots per inch) - Количество точек на линейный дюйм.
Где взять значение DPI?
Значение DPI в ActionScript 3.0 хранится в свойстве screenDPI в статическом классе flash.system.Capabilities.
Чтобы не хранить формулу в памяти, я написал небольшой класс для перевода дюймов в пиксели, и наоборот. Если есть необходимость переводить пиксели в какую-то другую меру длины (миллиметры, сантиметры, метры и т.д.), достаточно сначала перевести в дюймы, потом полученные дюймы в необходимую величину.
Часто бывает необходимо, чтобы линии на графике были не в виде ломаной кривой, как показано выше, а в виде сглаженной.
Сглаживание ломанной кривой
В этом посте я не буду затрагивать ActionScript, я только опишу принцип решения задачи.
1. Для начала, нарисуем по заданным точкам кривую.
2. Для каждой точки (кроме первой и последней) добавим вспомогательные точки на отрезках соединяющих текущую точку с предыдущей и следующей. Расстояние до вспомогательных точек должно быть одинаковым, и быть равным 25% минимального отрезка (между отрезками до точки и от неё).
3. Теперь вспомогательные точки нужно, соединить квадратичной кривой Безье, используя в качестве опорной, точку со значением. В этом нам поможет метод curveTo() экземпляра класса flash.display.Graphics
4. Добавим настройку уровня сглаживания.
Вроде получилось, но...
Как сделать так, чтобы сглаженная кривая проходила через точки со значениями?
Этот вопрос мучает меня второй день. Ответ я пока не нашел. Может быть вы что-то подскажете. Куда копать?
Работая над расширяемостью своего проекта, пришел к выводу, что придется подгружать данные только в момент, когда это необходимо. Возник вопрос:
А можно ли добраться до классов, внутри загруженного .swf-файла?
Оказалось, что можно. При помощи метода applicationDomain.getDefinition() можно получить ссылку на класс внутри content.loaderInfo у экземпляра типа flash.display.Loader.
Для примера, я создал файл library.swf с зажитым в него классом Circle.
На событие Event.COMPLETE о полной загрузке library.swf в loader, вызывем следующую функцию:
Решил на выходных написать статью о развитии языка программирования ActionScript 3.0. Оказалось, что всё уже за меня написано :)
В “Справочнике по языку ActionScript 3.0 и его компонентам” есть целый раздел “История объектно-ориентированного программирования на языке ActionScript” с примерами и все подробностями.
Столкнулся на работе с графами. Необходимо было найти кратчайший путь в заданном графе между двумя вершинами. Для решения задачи решил использовать алгоритм Дейкстры.
Алгоритм Дейкстры - алгоритм находит кратчайшее расстояние от одной из вершин графа до всех остальных. Алгоритм работает только для графов без рёбер отрицательного веса. Назван в честь изобретателя Эдсгера Дейкстры.
Поискал в гугле. Нашел вот этот вариант реализации алгоритма на Action Script. Казалось бы задача решена, но, при попытке скомпилировать пример, посыпались ошибки. Разбираться было некогда, пришлось писать самому :)
var vertex1:Vertex = new Vertex("v1");
var vertex2:Vertex = new Vertex("v2");
var vertex3:Vertex = new Vertex("v3");
var vertex4:Vertex = new Vertex("v4");
var vertex5:Vertex = new Vertex("v5");
...
Свяжем некоторые вершины, с указанием расстояния между ними.
var edge1:Edge = new Edge(vertex1, vertex3, 50);
var edge2:Edge = new Edge(vertex3, vertex4, 75);
var edge3:Edge = new Edge(vertex3, vertex5, 25)
...
Еще в далеком 2004 году в Macromedia Flash MX на стартовой странице появился новый тип создаваемого файла - "Flash JavaScript File" (Далее "JSFL").
Для истории :)
Так что же это такое?
JSFL - это язык программирования сценариев для среды разработки Flash-приложений Macromedia Flash MX. (Теперь уже Adobe Flash CS4). Т.е. все команды, которые нам доступны при работе с .fla-файлами, мы можем собирать в сценарии и выполнять их автоматом. Например: создавать документы, редактировать их, компилировать и многое другое.
Для чего это нужно?
А нужно это для автоматизации процесса разработки Flash-приложений.
Например, при разработке очередного приложения в библиотеке документа накопилось 100 символов. В какой-то момент стало необходимо в 50-ти добавить постфикс "_img" в идентификаторе символа. Чтобы не делать это вручную, перебирая каждый символ, мы можем написать небольшой скрипт на JSFL, который всё это сделает за нас.
Попробуем в действии.
Создаем новый Flash Javascrip File. Открывается редактор кода.
JSFL основан на JavaScript и похож на ActionScript (Оба эти языка основаны на одном стандарте ECMAScript). Плюс ко всему, в левой части окна имеется подробный список классов с описанием методов и свойств.
Для примера, я написал скрипт, который бежит по библиотекам всех открытых документов, и в каждом символе типа "MovieClip" пронумеровывает слои и задает им цвета.
var LOCKED = true;
var TITLE = "_layer_"
var NORMAL_COLOR = 0xCCCCCC;
var GUIDE_COLOR = 0x66CCFF;
var GUIDED_COLOR = 0x3399FF;
var MASK_COLOR = 0x66FF00;
var MASKED_COLOR = 0x66CC00;
var FOLDER_COLOR = 0x666666;
//
var arr, doc, len, lib, chi, ite, cen, tim, lay, den, obj, str;
//
arr = fl.documents;
if (arr && arr.length)
{
len = arr.length;
for (var i = 0; i < len; i++)
{
doc = arr[i];
if (doc)
{
lib = doc.library;
if (lib)
{
chi = lib.items;
if (chi)
{
cen = chi.length;
for (var j = 0; j < cen; j++)
{
ite = chi[j];
if (ite)
{
if (ite.itemType == "movie clip")
{
lib.editItem(ite.name);
tim = fl.getDocumentDOM().getTimeline();
if (tim)
{
lay = tim.layers;
if (lay)
{
den = lay.length;
for (var a = 0; a < den; a++)
{
obj = lay[a];
if (obj)
{
obj.name = TITLE + (a + 1);
obj.locked = LOCKED;
//
str = obj.layerType;
//
if (str == "normal") obj.color = NORMAL_COLOR;
if (str == "guide") obj.color = GUIDE_COLOR;
if (str == "guided") obj.color = GUIDED_COLOR;
if (str == "mask") obj.color = MASK_COLOR;
if (str == "masked") obj.color = MASKED_COLOR;
if (str == "folder") obj.color = FOLDER_COLOR;
}
}
}
}
}
}
}
}
}
}
}
}
Для выполнения скрипта нужно нажать кнопку "Run Script"
И еще.
Начиная с Macromedia Flash 8 в верхнем меню появилась вкладка "Commands" (Где были команды в Macromedia Flash MX, к сожалению не помню).
Теперь полюбившийся JSFL-сценарий мы можем вызывать оттуда. Для этого необходимо переместить в директорию "Commands" нужный нам .jsfl-файл скрипта.
Расположение этой папки различается для разных систем. Windows 2000 или Windows XP: загрузочный диск\Documents and Settings\<пользователь>\Local Settings\Application Data\Adobe\Flash CS4\<язык>\Configuration\Commands. Mac OS® X: диск Macintosh/Users/<имя_пользователя>/Library/Application Support/Adobe/Flash CS4/<язык>/Configuration/Commands.
А также.
Создавать сценарии можно и не прибегая к программированию на JSFL.
Откройте окно "History" (CTRL+F10).
Оказывается, все наши действия сами записываются по пунктам в один сценарий на языке JSFL. Для того, чтобы сохранить его, необходимо выделить несколько пунктов и нажать кнопку "Save selected steps as a Command".
Сообщения
