Тип плагинов: Простой экспорт в файл

[vdemidov]

Почему простой, а потому, что программа сама будет скармливать тайлы в том порядке в котором захочет, то есть склейку в растр скорее всего через такой экспорт сделать не получится, а вот копирование тайлов в какой-нибудь контейнер - запросто.
Интерфейс приблизительно такой:

Код: Выделить всё

  ISimpleTileProcessor = interface
    procedure ProcessTile(APos: Tpoint; Azoom: byte; ALonLatRect: TDoubleRect; ATileSize: Cardinal; ATileBuf: Pointer);
  end;
  IExportSimpleToFile = interface
    function GetSupportedContentTypes: WideString;
    function GetFileFilters: WideString;
    function GetFileExtDefault: WideString;
    function StartExport(ASourceContentType: WideString; AFileName: WideString): ISimpleTileProcessor;
  end;


Тоесть SAS.Планета сама будет перебирать тайлы по выделению, и скармливать плагину, порядок и наличие всех тайлов не гарантируется.
PS: Добавил работу с типом содержимого тайлов.
Функция GetSupportedContentTypes возвращает список поддерживаемых плагинов типов исходных данных приблизительно в таком виде:
"image/jpeg"; "image/png"; "image/gif"; "application/vnd.google-earth.kml+xml"
Если возвращается пустая строка, значит плагин ничего не поддерживает и в списке ни для одного из источников показываться не будет.
Функция StartExport получает тип данных экспортируемого пользователем источника.
PPS: Добавил методы для получения инфы для диалога открытия файла.
GetFileExtDefault - должен возвращать расширение файла по-умолчанию.
GetFileFilters - строка с поддерживаемыми фильтрами для имен файлов. Что-то такое:
SuperIndex (*.inx)|*.inx|All files (*.*)|*.*

[DJ VK]

Попробую на примере простейшего архиватора.
http://www.codeproject.com/KB/files/zip_utils.aspx
потом можно будет экспериментировать с другими архиваторами

GetSupportedContentTypes возвращает список поддерживаемых плагинов типов исходных данных приблизительно в таком виде: "image/jpeg"; "image/png"; "image/gif"; "application/vnd.google-earth.kml+xml"

Как конкретно должна выглядить строка при поддержке всех типов (кавычки, разделители)?

function GetFileFilters: WideString;
function GetFileExtDefault: WideString;
- с этим все ясно. обычные настройки для SaveDialog

В целом процесс архивации примерно следующий
HZIP hz = CreateZip("simple1.zip",0);
ZipAdd(hz,"znsimple.bmp", "simple.bmp");
ZipAdd(hz,"znsimple.txt", "simple.txt");
CloseZip(hz);

Значит мы архив 1) открываем 2)скармливаем файлы 3)закрываем

procedure ProcessTile(APos: Tpoint; Azoom: byte; ALonLatRect: TDoubleRect; ATileSize: Cardinal; ATileBuf: Pointer);
function StartExport(ASourceContentType: WideString; AFileName: WideString): ISimpleTileProcessor;
это наверное где то тут.
вопросы такие
А) Как мы узнаем имя архива и путь от программы?
Б) как мы узнаем что процесс завершен?
В) Где мы имеем имена файлов для архивации? здесь я вижу только буфер и координаты

Если вопросы покажутся немного детским - скажу так, классы писать не очень люблю, но с ними все понятно, а интерфейсы вообще никогда не писал. С трудом представляю где у них конструкторы-деструкторы и в какие моменты времени что вызывается.

И это, SDK или чтото подобное есть? Ну или просто пример кода
Вставить SaveDialog, парочку edit\combobox я могу, но интересно как эти интерфейсы инициализируются в программе и происходит их вызов.

Возможно придется столкнуться с ситуацией когда формируется список файлов для архивации а потом в конце идет сама архивация. не требуется ли при этом какая индикация от плагина о том что он делает? примерно то же видно при штатном архивировании в программе - пробегает список файлов и прогресс бар надолго замирает....

И еще одна опция для эксппорта полезная - удаление файлов после экспорта. сейчас при архивации недоступна. а хочется.

[vdemidov]

GetSupportedContentTypes возвращает список поддерживаемых плагинов типов исходных данных приблизительно в таком виде: "image/jpeg"; "image/png"; "image/gif"; "application/vnd.google-earth.kml+xml"Как конкретно должна выглядить строка при поддержке всех типов (кавычки, разделители)?

Ну, например, "image/*" для любых картинок, и "*" вообще для всего подряд. Думаю так нормально будет.

А) Как мы узнаем имя архива и путь от программы?

Имя архива передается вторым параметром в функции StartExport

Б) как мы узнаем что процесс завершен?

Вызов деструктора для объекта с интерфейсом ISimpleTileProcessor

В) Где мы имеем имена файлов для архивации? здесь я вижу только буфер и координаты

Сами придумываем, какие больше нравятся. Теоретически исходные данные могут вообще в базе данных храниться.
Кстати именно поэтому ваш процесс типа ZipAdd(hz,"znsimple.txt", "simple.txt"); некатит, ибо файлов на диске у вас нет, только область в памяти.

Если вопросы покажутся немного детским - скажу так, классы писать не очень люблю, но с ними все понятно, а интерфейсы вообще никогда не писал. С трудом представляю где у них конструкторы-деструкторы и в какие моменты времени что вызывается.

Все нормально. Нормальные вопросы. Просто интерфейсы никто не пишет и конструкторов у них нету. Просто класс может реализовывать какой-то интерфейс. А уж в классе все конструкторы-деструкторы вызываются стандартно. Единственная особенность, что класс в делфи желательно наследовать от TInterfacedObject и нельзя вызывать Free вручную, только обнулением ссылки на интерфейс.

И это, SDK или чтото подобное есть? Ну или просто пример кода

Есть, но я не хочу заранее его публиковать, так как продолжаю менять названия и структуру классов, файлов, интерфейсов.

Вставить SaveDialog, парочку edit\combobox я могу, но интересно как эти интерфейсы инициализируются в программе и происходит их вызов.

В плагине не должно быть никакого UI. Максимум выдача месседж бокса. Никакого SaveDialog из плагина вызывать нельзя.

Возможно придется столкнуться с ситуацией когда формируется список файлов для архивации а потом в конце идет сама архивация. не требуется ли при этом какая индикация от плагина о том что он делает? примерно то же видно при штатном архивировании в программе - пробегает список файлов и прогресс бар надолго замирает....

Для этого типа плагинов такого быть неможет, потому что нельзя построить список исходных файлов так как файлов то исходных и нет.

И еще одна опция для эксппорта полезная - удаление файлов после экспорта. сейчас при архивации недоступна. а хочется.

Удаление есть отдельной операцией. Экспорт особенно при помощи плагина удалять ничего не должен.

[zed]

vdemidov
А можно заготовку/пример модуля? С примером класса и пояснениями в какой момент времени какая функция вызывается и что она должна сделать?
Я так понимаю, StartExport - инициализация экспорта, а ProcessTile будет циклически вызываться для каждого тайла? Причём, ProcessTile - это ещё один класс, по уничтожению которого мы должны завершить наш экспорт (сохранить/уничтожить всё что надо)?

[vdemidov]

А можно заготовку/пример модуля? С примером класса и пояснениями в какой момент времени какая функция вызывается и что она должна сделать?

Ну примеров и SDK, пока готовых нет. Почему я уже описал выше.

Я так понимаю, StartExport - инициализация экспорта, а ProcessTile будет циклически вызываться для каждого тайла? Причём, ProcessTile - это ещё один класс, по уничтожению которого мы должны завершить наш экспорт (сохранить/уничтожить всё что надо)?

Да все правильно. В StrartExport нужно создать новый объект с интерфейсом ISimpleTileProcessor, который должен быть готов сразу принимать данные.
ProcessTile будет циклически вызываться для каждого тайла, попдающего под заданные пользователем условия. Порядок тайлов никак не гарантируется. Может вообще разные зумы в рендомном порядке давать.
Как только все будет экспортировано, ссылка на объект будет освобождена и он сможет удалить себя закрыв файлы и тд.
Еще раз напоминаю, что крайне нежелательно выдавать что-то пользователю через GUI из плагина, так как он будет вызван в совершенно отдельном потоке. В очень далекой перспективе, может быть, даже в отдельном скрытом процессе-песочнице.

[DJ VK]

GUi использоваться будет не в плагине а в программе для проверки его.
независимость плагина от программы конечно необходима и крайне удобна. но плагин должен получать всю информацию для него полезную.
Но вот объясни мне - если я архивирую кеш, имеющий четкую структуру в программе зачем мне придумывать свою структуру хранения - свои имена файлов, папки. Ведь в программе разделили копирование и экспорт. Может и плагины разделить? на те что работают непосредственно с картинками и те что работают именно с файлами кэша? При этом не требуется модифицировать сами изображения - просто файл копируется, переименовывается, вкладывается в однофайловый гигантский кеш или пихается в архив. - это на уровне файловой системы уже.

[zed]

Так, в нашем случае плагин - dll? Где она должна лежать, с какой версией SAS сможет работать и какую функцию должна экспортировать?
Что-то вроде:

Код: Выделить всё

function GetIExportSimpleToFile: IExportSimpleToFile;

[DJ VK]

скорее всего исходный код плагина просто встраивается в программу, нигде о dll не сказано

[vdemidov]

GUi использоваться будет не в плагине а в программе для проверки его.

Не понял о чем ты.

независимость плагина от программы конечно необходима и крайне удобна. но плагин должен получать всю информацию для него полезную.

Плагину не нужно получать информации больше чем ему положено. А то сегодня он захочет узнать имя файла с тайлом, а завтра решит реализовать и функцию удаления этого файла после экспорта.

Но вот объясни мне - если я архивирую кеш, имеющий четкую структуру в программе зачем мне придумывать свою структуру хранения - свои имена файлов, папки.

А если именно у этой карты нет этой самой четкой структуры? Если это, уже сегодня возможный, доступ к кэшу ГЕ?

Ведь в программе разделили копирование и экспорт. Может и плагины разделить? на те что работают непосредственно с картинками и те что работают именно с файлами кэша?

Уже разделил. И те что работают с файлами признал бесперспективным направлением, не стоящим времени на реализацию.

[vdemidov]

Так, в нашем случае плагин - dll? Где она должна лежать, с какой версией SAS сможет работать и какую функцию должна экспортировать?

А почитать viewtopic.php?f=47&t=1113 слабо?

Что-то вроде:

Код: Выделить всё

function GetIExportSimpleToFile: IExportSimpleToFile;

Ну на текущем этапе, для тестирования можешь реализовать именно так. Чуть позже будет SDK, в котором нужно будет вписать только пару строк и ссылки на свои юниты. Обещаю, что сделать плагин из таких классов, когда их сможет использовать SAS.Планета, будет очень просто.

скорее всего исходный код плагина просто встраивается в программу, нигде о dll не сказано

Можно и встраивать, можно и dll. Просто если без dll, то использовать это можно будет чуть раньше, чем dll. Так как встроить пару юнитов будет гораздо проще, чем допилить движок плагинный и выпустить PluginSDK