Kwik Exporter - UXP

Main panel

When Kwik Exporter appears, please Open a folder of psd files, and Select a book folder of Solar2D project.

  • Photoshop Files > Open

    • Reset check box

      when it is checked, Open button will show a folder select dilaog

    • list of psd

      you can dobule-click to open it.

      drag to change the order of psd files.

      select psd files to be published

  • Solar2D Project > Select Book

    • Reset check bok

    • Show Folder

      it will open book folder in Finder(Mac), a permission dialog appears for the first time.

  • Publish

    the input box, you can set the index numbers of psd files to be published.

    ex. 0-1, 5, 7

    • all checkbox

      it will set index numbers like “0-x”

    • Load Simulator (Mac only)

  • Active Document

    • Validate Names

      layer names are checked, and the following logic to rename it.

      • Replaces multiple whitespace characters with underscores.
      • Romanizes the string.
      • Removes any non-alphanumeric characters, replacing them with underscores.
      • Truncates the string to a maximum length of 16 characters.
      • Prefixes an underscore to numeric strings.
      function validate (str){
        let test = str.replace(/\s+/g, '_')
        test = r.romanize(test);
        test = test.replace(/[^A-Z a-z0-9]/ , '_')
        test = test.slice(0, 16)
        test = isNaN(test)?test:"_" + test
        ...
    • Export Code

      it publishes .lua of each layer. updated files are in App/book/components/page/layers folder.

      class attributes in page/index.lua are merged(preserved) but if you add manually a layer entry in index.lua, it will be lost.

    • Export Images

      • (option) holding Shift key, it will only publish images of selected layers in active document
    • Layer Groups

      The default behavior is that Layer group is published as one merged png, if you want to have each image of members of a layer group, use Unmerge.

      • Unmerge

        select a layer group in Layer panel, and click Unmerge button. It will create a folder with the same name in App/book/assets/images/book folder. This means each image of membes of a layer group available when you publish.

      • Cancel

        Unmerge is cancelled.

      • Refresh

        when you manually create foldes in App/book/assets/images/page folder. You can use Refresh button to see those folder’s names, and you can manuplate ( delete them ) with Cancel button.

https://github.com/RoneoOrg/hugo-shortcode-roneo-collection/tree/main/layouts/shortcodes

History

The history panel shows the recenet photoshop folder.

double click it to change it. The list of photoshop files are updated in the main panel

Settings

You can set the default project folder in the setting

  • Select Folder

    Select a project folder which contains your photoshop files and a solar2D project folder.

  • Show Folder

    it opens a project folder in Finder(mac), File Explorer (Windows)


Tips

  • press shift key

    it only exports one single layer selected while Export images in Active Document

  • layer names with starting “-” (hyphen) are ignored when exporting code & images

TODO memo

  • see compic_simple.md in kwik4

     //checks for group positioning (layer name will start with -)  OR layers to not be rendered (also starts with -)
        if (myLName.substr(0,1) == "-") {
          pageRenders._renderGroupHyphen(myLName, i, sel, myi, tabLayers, String(model.docNum), backLayer);

    pageRenders/groupHyphen.jsx outputs the meta info comic page from layer group