Описание команды


imgtz

Создание нескольких изображений из строк списка.

imgtz=List||Path, ||NameFormat, ||imgtxt<>, ||edging<>, ||factorimg<>, ||posimg<>, ||framewh<>, ||quality<>, ||cntr<>, ||Dialogs, ||upd<>, ||progres<>

Параметры:

1-й обязательный параметр.
ListСписок строк (данных) для создания графических изображений. Может принимать следующие значения:
  FileTXT - путь к текстовому файлу из строк которого будут созданы изображения.
  $GLOBALNAME - массив из содержимого ячеек будут созданы изображения. см. Дополнение №23.
  $var_s... - информация глобальных переменных созданных в команде exect.
  <info> - информация параметра см. Дополнение №10.
2-й обязательный параметр.
PathПуть. Параметр Path//Mode, где:
  Path - путь, где будут создаваться изображения.
  Mode:
    1 - добавлять счётчик при совпадении имён.
    2 - заменять при совпадении имён.
Дополнительные параметры:
Name
Format
Условия. Параметр Name|Format, где:
  Name - имя создаваемого изображения, возможные варианты:
  • Имя изображения.
  • GLOBALNAME<> - информация переданная глобальными переменными см. Дополнение №23.
  • [info] или <info> - информация параметра см. Дополнение №10.
  • $fname - имя берётся из ключа FormatName в TCIMG.ini в секции [TextImage],
    где можно настроить формат даты: YYYYMMDDHHNNSS
    Знаки разделителей не имеют значения, главное порядок, где:
      YYYY - все четыре цифры года.
      MM - месяц от 01 до 12.
      DD - день месяца от 01 до 31.
      HH - часы в 24-часовом формате от 00 до 23.
      NN - минуты от 00 до 59.
      SS - секунды от 00 до 59.
  Format - тип создаваемого изображения. Поддерживаются BMP, GIF, JPG (JPEG), PNG и TIF (TIFF) (по умолчанию JPG).
imgtxt<>Настройки изображения. Параметр imgtxt<Color|BkColor|Size|Style|FontName|Left|Top|Right|Bottom> , где:
  Color - цвет шрифта, возможны варианты:
    • RGB цвет.
    • ARGB цвет.
    • # - случайный RGB цвет.
    • $ - случайный ARGB цвет.
    • @ - прозрачный цвет (для png, bmp, ...).
    • ?String - строка RGB/ARGB цветов, прописанных через разделитель + или строка переданная через глобальные переменные $GLOBALNAME (при этом цвета будут вставляться поочерёдно по кругу).
  BkColor - цвет фона, возможны варианты:
    • RGB цвет.
    • ARGB цвет.
    • # - случайный RGB цвет.
    • $ - случайный ARGB цвет.
    • @ - прозрачный цвет (для png, bmp, ...).
    • ?String - строка RGB/ARGB цветов, прописанных через разделитель + или строка переданная через глобальные переменные $GLOBALNAME (при этом цвета будут вставляться поочерёдно по кругу).
    • градиентный фон Color1,Color2,Flag,Correction , где:
      Color1 - RGB цвет №1, # - случайный цвет, @ - прозрачный цвет (для png, bmp, ...).
      Color2 - RGB цвет №2, # - случайный цвет, @ - прозрачный цвет (для png, bmp, ...).
      Flag - режим градиента:
        0 - горизонтальный градиент (по умолчанию).
        1 - вертикальный градиент.
        2 - диагональный прямой градиент.
        3 - диагональный обратный градиент.
      Correction - гамма коррекция:
        0 - отключена (по умолчанию).
        1 - включена.
      При градиентном фоне могут использоваться так же параметры factorimg<>, posimg<>, framewh<>.
  Size - размер шрифта.
  Style - стиль шрифта. Может быть комбинацией следующих значений:
    0 - Нормальный.
    1 - Жирный.
    2 - Курсив.
    4 - Подчёркнутый.
    8 - Зачёркнутый.
  FontName - имя шрифта.
  Left - отступ слева в пикселях.
  Top - отступ сверху в пикселях.
  Right - отступ справа в пикселях.
  Bottom - отступ снизу в пикселях.
edging<>Обработка края текста. Параметр edging<Number> , где Number:
  0 - без дополнительной обработки (по умолчанию).
  1 - дополнительная обработка края текста в сторону фона.
  2 - дополнительная обработка края фона в сторону текста.
При различных наложениях цвета друг на друга (в основном ARGB) возможно появление незапланированного цвета окантовки текста.
Параметр позволяет убрать такого рода неточности, оставляя в изображении только 2 цвета (фона и текста), убирая все остальные.
Процедура эта не быстрая, при большом тексте обработка может занять несколько минут.
factorimg<>Смещение градиента. Параметр factorimg<Factor1,Factor2,Factor3,Factor4>, позволяет смещать градиент, где: Factor1, Factor2, Factor3 и Factor4 - числа, указывающие процент от конечного цвета и должны быть в диапазоне от 0.0 до 1.0.
По умолчанию factorimg<0.0,0.4,0.6,1.0>
posimg<>Смешивание цветов градиента. Параметр posimg<Pos1,Pos2,Pos3,Pos4>, позволяет смешивать цвета градиента, где: Pos1, Pos2, Pos3 и Pos4 - числа, указывающие процент смешивания и должны быть в диапазоне от 0.0 до 1.0.
По умолчанию posimg<0.0,0.3,0.7,1.0>
framewh<>Рамка. Параметр framewh<Color|Frame|Indent>, позволяет создавать рамку, где:
  Color - фон для рамки, возможны варианты:
    • RGB цвет (FF0000).
    • # - случайный цвет.
    • @ - прозрачный цвет (для png, bmp, ...).
    • FileIMG - полный путь к изображению, который будет являться фоном.
  Frame - ширина рамки в пикселях.
  Indent - отступ в пикселях между изображениями.
quality<>Качество JPG, JPEG изображения. Параметр quality<Number>, где Number - процентное соотношение качества, может быть в диапазоне от 1 до 100.
cntr<>Счётчик.
  Описание
Параметр cntr<Begin(+/-Delimeter)(:Dropping)|Step|Numbers|Optional>, где:
  Begin - начальное число.
    Если за числом следует символ:
    + , то счётчик будет начинаться относительно номера в конце базового имени объекта в заданном каталоге
    - , то первое имя будет без счётчика; за символом может быть прописан разделитель Delimeter
    : , то счётчик будет сброшен через заданное число шагов Dropping
  Step - шаг счётчика.
  Numbers - количество цифр в счётчике.
  Optional [необязательный] - для каждой папки разный счётчик (для файлов).
Для переименования каждого типа файлов своим счётчиком добавляется параметр ||ext<>||[double]
DialogsДиалоги. см. Дополнение №18
  Описание
Различные параметры диалогов.
  [input] - диалог ввода информации в InputBox.
  [richinput] - диалог ввода информации в RichInputBox.
  [combo] - диалог выбора информации в ComboBox.
  [group] - диалог выбора информации в GroupBox.
  [check] - диалог выбора информации в CheckBox.
  [edits] - диалог выбора информации в EditBox.
  [sfold] - выбор каталога.
  [zfold] - выбор каталогов.
  [sopen] - выбор файла для открытия.
  [ssave] - выбор файла для сохранения.
  [sicon] - диалог просмотра и выбора значка.
  [msgbx] - окно сообщения MsgBox.
  [updwn] - диалог выбора числовой информации UpDown.
  [image] - диалог выбора изображения.
  [elect] - диалог выбора файлов и папок.
...и другие диалоги.
upd<>Обновление панели.
  Описание
Параметр upd<Number>, где Number - значение обновления панели(ей) Total Commander:
  1 - обновить активную панель.
  2 - обновить обе панели, вернуться в активную.
  3 - обновить другую панель, вернуться в активную.
  4 - обновить активную панель, перейти в другую.
  5 - обновить другую панель, остаться в другой.
  6 - обновить обе панели, остаться в другой.
  7 - не обновлять (по умолчанию, т.е. если параметр не прописан, то панели не обновляются).
progres<>Прогресс бар. Параметр progres<> - если указан, то при операции будет запущен прогресс бар.
Учитывается ключ MsBoxAtTheCompletion в TCIMG.ini в секции [Setting].

Примечания:

Может выглядеть следующим образом:





Команда имеет возможность передавать другим командам информацию через именные глобальные переменные. см. Дополнение №23

Имя переменнойОписание
GLOBALIMGTZмассив выходных данных: список путей созданных изображений.
GLOBALIMGTZ1массив выходных данных: список ширины созданных изображений.
GLOBALIMGTZ2массив выходных данных: список высоты созданных изображений.
GLOBALIMGTZ3массив выходных данных: список ширины и высоты созданных изображений (200x100).


Для подгрузки своих шрифтов можно воспользоваться командой fontx
Команда поддерживает только шрифты TTF

Аналог команды для одного объекта imgtx

См. также:

gifnn, gifcs, gifcn, clipi, exiff, exifs, iclip, imgcf, imgcg, imgcn, imgcr, imgff, imgfs, imggo, imght, imgjf, imgjs, imgnz, imgth, imgtx, imgup, imgvw, imgwh, picsf, picss, prevw, scren, sdesk, sdess, symxx

Примеры:
 Как создать кнопку?

aends=%P%N??-1||Chr(124)!!||&&(.)!!$1@CRLF||?F1 imgtz=$GLOBALAENDS||"%t"//1||imgtxt<0000A0|F0FFFF|14|3|Tahoma>||progres<>||upd<3> ;; в другой панели создать изображения символов содержимого текстового файла под курсором

aends=%P%N??-1||Chr(124)!!||&&(.)!!$1@CRLF||?F1 imgtz=$GLOBALAENDS||"%t"//1||name|png||imgtxt<0000A0|F0FFFF|14|3|Tahoma>||progres<>||upd<3> ;; в другой панели создать изображения символов содержимого текстового файла под курсором

global imgtz=%P%N||"%t"//1||imgtxt<0000A0|F0FFFF|14|3|Tahoma>||upd<3> GLOBALIMGTZ<a> GLOBALIMGTZ1<a> GLOBALIMGTZ2<a> GLOBALIMGTZ3<a> ;; в другой панели создать изображения строк содержимого текстового файла под курсором и получить результаты в глобальные переменные

global imgtz=cliplist||"%p"//1||imgtxt<0000A0|F0FFFF|14|3|Tahoma>||upd<3> GLOBALIMGTZ<a> GLOBALIMGTZ1<a> GLOBALIMGTZ2<a> GLOBALIMGTZ3<a> ;; в активной панели создать изображения строк содержимого буфера обмена и получить результаты в глобальные переменные

imgtz=%P%N||"%t"//1||imgtxt<0000A0|F0FFFF|14|3|Tahoma>||upd<3> ;; в другой панели создать изображения строк содержимого текстового файла под курсором

rends=x??-1||##rndm<3~?10|20> GLOBALRENDS<a> imgtz=$GLOBALRENDS||"%p"//1||img-cntr<1|1|2>|png||imgtxt<F9EFBE|02222C|14|0|Tahoma>||upd<1> ;; создать в активной панели изображения с текстом случайных данных (имена с заданным счётчиком)

rends=x??-1||##rndm<3~?10|20> imgtz=$GLOBALRENDS||"%p"//1||img-cntr<1|1|1>|png||imgtxt<?CD5C5C+FFD700+ADFF2F|@|18|1|Arial>||upd<1> ;; создать в активной панели изображения с текстом случайных данных (имена с заданным счётчиком) и поочерёдным цветов текста

rends=x??-1||##rndm<3~?10|20> sends=CD5C5C|FFD700|ADFF2F GLOBALSENDS<a> imgtz=$GLOBALRENDS||"%p"//1||img-cntr<1|1|1>|png||imgtxt<?$GLOBALSENDS[1]|@|18|1|Arial>||upd<1> ;; создать в активной панели изображения с текстом случайных данных (имена с заданным счётчиком) и поочерёдным цветов текста


© Аверин Андрей для Total Commander Image  Averin-And@yandex.ru