Template(Tmplt) & Customization

Kwik4では、新しいプロジェクトを作成した時に,'tmplt'フォルダーが作成されます。プロジェクトをパブリッシュした時に,Kwik4は、'build4'というフォルダにコードと画像などを出力します。

Kwik3のプロジェクトをKwik4で開き、Projects and Pages > Project Properties > Publish から、Update Tmpltをクリックすることで、tmpltフォルダが作成されます。

build4フォルダーは新しい構造を持っています.それぞれのphotoshopのレイヤーは一つのluaファイルにパブリッシュされます.例えば,HelloWorldレイヤーはcomponents/page01/Hello_World_image.luaにパブリッシュされます.

画像をパブリッシュ

Template File

kwikがどのようにluaファイルをパブリッシュするのか説明します.publishボタンを押した時,Kwikはそれぞれのレイヤーに関連付けられた情報をプロジェクトファイル(.kwk)から読み込み、画像とluaファイルを生成します.Kwik4はluaファイルをパブリッシュしている時に、テンプレートファイルを読み込みます.例えば,HelloWorld_image.luaは、テンプレートファイルであるlayerX_image.luaから作成されます。このときにHello_Worldレイヤーからの情報が埋め込まれたます。

layerX_image.lua は mustache のファイルです。 http://mustache.github.io/ , , にレイヤーからの数値や情報が埋め込まれます。

テンプレートファイルを目的に応じて変更することが可能です.例えば,layerX_image.luaにフィルターを追加するとしましょう.82-83行目では,filter.scatterがスケール2倍で設定されています。

フィルター scatterを使用した画像

ファイルのカスタマイズ

もしもあるコンポネントのtemplateファイルを変更した場合,該当するコンポネントが設定されているレイヤー全てに適用されます。全ての画像はlayerX_image.luaを使用します。全ての画像にはfilter.scatterを適用したくないでしょう。

Kwikによって生成される一つのluaファイルのみを変更したい場合,直接ファイルを変更してください。そうしてしまうと再度パブリッシュした時に変更した内容が上書きされてしまいまう。直接ファイルを変更する代わりに,'custom'フォルダーの下に同じ名前のカスタムファイルを挿入することができます.

例えば,もしHelloWorld_image.luaにフィルターを追加したい場合,kwikが生成したHelloWorld_image.luaをcustom/components/page01フォルダーにコピーすると,そのHelloWorld_image.luaを変更することが可能になります.再度パブリッシュすると,Kwikはcustomフォルダー配下のHelloWorld_image.luaのカスタムファイルを利用します。読み込みがカスタムファイルにリダイレクトされて、そのカスタムファイルを使用されます。

custom/components/page01/HelloWorld_image.luaが変更されました

build4の下にあるluaファイルはcustom/components/page01/HelloWorld_image.luaを使用します.Corona Simulatorはscatter filterを使用したHello Worldを表示します.

もしHello Worldレイヤーをphotoshop上で変更したい場合,Kwikはオリジナルのファイルをcomponents/page01/HelloWorld_image.luaに変更した結果を反映します。しかし,custom/components/page01/Hello_World_image.luaを上書きや変更することはありません。カスタムファイルに変更を反映するには、テキストエディタを使用して変更された部分をマージする必要があります、手動でおこなってください。

アップデート

tmpltは,kwikがluaファイルを生成する時に利用するluaファイルによって構成されるています。コードをカスタムするために,tmpltフォルダー内のファイルを変更することができます.Kwikがアップデートされたときに,tmpltフォルダーはProject Properties > Update tmpltからアップデートすることができます.古いtmpltフォルダーはアップデートされた時にバックアップされて残ります。

テンプレートのアップデート

GitHub

最新のtmpltはKwiksherのGitHubから入手可能です。gitを使用したい場合,以下のサイトからcloneしてください.

Samples

カスタムファイルの方法を利用したサンプルプロジェクトは、下記をご参照ください。

results matching ""

    No results matching ""