AndroBlackPool

Setelah kemarin kita membahas tentang pola matematika pada KLWP sekarang kita akan membahas bagaimana mengkondisikan formula, Conditional dalam KLWP merupakan suatu bentuk formula yang apabila suatu kondisi terpenuhi maka tugas akan di jalankan, apabila tidak maka menjalankan tugas yang lain, dalam KLWP Conditional di tulis dalam sintax $if(operand, then, else)$, contoh:

• $if(1<2, ya, tidak)$
• $if(df(s)%2=0, Hallo, Apakabar)$

• $if(bi(level)<20, Low Batt, if(bi(level)>=20&bi(level)<80, Masih Aman, if(bi(level)>=80, Battery Full)))$

• $if(bi(level)<20, Low Batt)$
  $if(bi(level)<=20&bi(level)<80, Masih Aman)$
  $if(bi(level)>=80, Battery Full)$

Penulisan "else" atau perintah kedua bersifat optional, jika tidak di tuliskan maka akan di kembalikan ke value default, ada beberapa boolean operator yang dapat digunakan pada Conditional ini, diantaranya : 

Operator	Keterangan
>	Lebih dari
<	Kurang dari
=	Sama dengan
<=	Kurang dari sama dengan
>=	Lebih dari sama dengan
!=	bukan sama dengan
&	dan
|	atau

Pola matematika juga dapat di terapkan pada Formula KLWP baik itu dalam pengkondisian $if(format, then, else)$, atau perhitungan secara mutlak, misalkan dalam formula kita menulisakn sebuah perhitungan seperti :

Pola matematika pada KLWP hampir sama dengan pola yang ada pada bahasa pemrograman.

Operand : nilai asal, baik itu angka atau sintax formula
Operator : intruksi yang di berikan berupa simbol seperti penambahan dan pengurangan

Math Utilities

Salah satu kelebihan dari KLWP yaitu memiliki formula yang berfungsi membuat warna dari kode ARGB atau AHSV, bagi yang hobi menggabar tentu sudah tidak asing lagi dengan sebutan itu, dengan adanya formula ini kita bisa memadukan dengan formula lain supaya berubah dengan sendirinya, misalkan merubah warna background sesuai cover art music yang kita mainkan, atau merubah warna secara perlahan dengan mengkombinasikan formula detik atau yang lain.

Bitmap Pallet Extracts Color

keterangan:

• Mode : command atau perintah sintax (lihat pada contoh)

• Bitmap : image yang di pakai misalkan dari cover art, bitmap global, resource dari http atau full path dari file gambar

• Default : warna default yang dipakai apabila bitmap tidak ditemukan

Color Editor, memanipulasi Warna ARGB 

Keterangan :

• Color: code warna ARGB atau RGB

• Filter : filter color (alpha, saturation, luminance, gradient end color dan seterusnya)

• Amount : value dari filter mulai dari 0 sampai 100

Color Maker

Keterangan:

• A : alpha value (optional, 0 (full transparent) sampai 255 (full opaque), default 255)

• R / H : Red (0-255), Hue (0-360)

• G / S : Green (0-255), Saturation (0-100)

• B / V : Blue (0-255), Value (0-100)

KLWP memiliki beberapa Tags BBCode dan sintax Text converter yang dapat di gunakan untuk memodifikasi text yang kita buat menjadi lebih menarik seperti bold, italic warna text, crop dan sebagainya.

• I : italic (text miring)
• A : text size
• B : bold (tebal)

Text Converter

Setiap formula pada KLWP dapat disisipi dengan format penulisan tanggal [Date] yang dapat disesuaikan dengan keinginan kita, lihat sintax formula pada Tutorial sebelumnya, dengan ini kita dapat mengkondisikan waktu kejadian tertentu misalkan kemarin, besok, lusa, 3 jam yang lalu dan seterusnya.
Contoh:
$df(EEEE, a1d)$ menjadi nama hari besok.
$df("hh:mma", bi(fullempty)$ : waktu pengisian daya
$tf(0h0m0sa1d)$ : waktu menuju tengah malam
$ci(title, a0, a0d)$ : title event hari ini.

Note:

• Format penulisan tanggal bersifat Case Sensitive  
• Format tanggal tersebut dapat dikembalikan oleh beberapa fungsi lain atau anda bisa menggunakan text.
• Untuk text tanggal dapat menggunakan format penulisan seperti "1955y11M12d22h04m00s" untuk mengekspresikan tahun 1955, bulan 11, tanggal 12, pada jam 22:04:00 (semuanya bersifat opsional)
• Penulisan text tanggal juga bisa menggunakan a/r (add/remove) operator, misalkan "a12m3s", akan menambahkan 12 menit dan 3 detik dari waktu saat ini.

Formula pada KLWP adalah suatu kode atau sintax penulisan yang memiliki value tertentu, penulisan formula dapat diletakkan pada bagian manapun asalkan nilai return atau pengembaliannya sesuai dengan value aslinya kecuali isi dari text, misalkan jika formula diletakkan pada bagian color suatu module maka nilai return harus merupakan kode color, atau misalkan formula diletakkan pada size, width, atau hight maka nilai return dari formula harus merupakan angka mulai dari 0 - 1000.

Note :

• Penulisan Sintax Formula harus di apit dengan simbol dolar " $ ".
• Jika terdapat dua simbol dolar " $ " yang terletak diantara dua Sintax maka akan menghasilkan nilai sendiri-sendiri. 
• Jika terdapat satu simbol dolar " $ " yang terletak diantara dua Sintax maka nilai yang keluar hanya sintax yang berada sebelum simbol dolar sedangkan setelahnya hanya menjadi text biasa. 

• Pada deretan submenu editor terdapat kolom check box, centang salah satunya saja misal kita centang pada bagian Width
• Klik icon kalkulator yang ada di atas layar.
• Klik pada Width yang telah memiliki icon kalkulator.

• Globe : menuliskan variable Globe yang kita buat, lihat pada Tutorial sebelumnya
• Pallete : menampilkan collor pallet, berfungsi mencari code warna dengan cepat
• Star : merupakan bookmark dari formula-formula yang kita simpan, misalkan kita membuat formula yang rumit atau cukup panjang, dengan fasilitas ini kita tidak perlu repot-repot jika ingin menuliskan di tempat lain, caranya setelah kita menulis formula, klik pada icon star yang ada di atas layar kemudian beri label.

Note : setelah mengedit formula jangan lupa untuk menyimpan dengan mengklik tombol ok yang ada di atas layar.

Seperti yang telah dijelaskan pada tuturial yang lalu, tab navigasi pada KLWP berada di bawah screen, berfungsi menavigasi bagian-bagian editing dari module yang ada, table dari navigasi ini akan berubah-ubah sesuai dengan module dan penempatannya.

• Items : tabel ini berisi susunan module yang telah di tambahkan, misalkan kita tambahkan shape, Text atau yang lain maka module tersebut akan tersusun pada bagian table ini, perlu di ingat bahwa jumlah module yang bisa di tambahkan pada Root sangat terbatas, jadi pastikan jika membutuhkan banyak module untuk membuat desain, letakkan module-module tersebut pada group (akan kita jelaskan pada bagian lain)
• Bacground : table ini berguna menyeting latar belakang dari desain live wallpaper yang akan dibuat seperti menggunakn gambar atau warna solid.
• Layer : menyeting bagaimana layer di tampilkan misalkan ketika screen locked atau yang lain
• Position : seperti namanya table ini berguna menyeting posisi dari layer
• Global : table ini berisi variable-variable global yang kita buat sendiri
• Shortcut : table ini berisi shortcut aplikasi yang kita buat melalui action on touch agar dapat di akses dengan mudah.

Module

Global

• geser editor pada table global kemudaian klik icon " + " yang berada di atas layar.
• isi kolom Title dengan nama variable yang di inginkan, misal merah
• pada kolom Type  pilih color, kemudian klik ok.

• Klik kotak warna yang berada disebelah nama variable.
• set ke warna merah.

Cara menerapkan varible global pada module, misalkan kita memiliki tiga buah shape dengan nama shape 1 - 3.

• pertama klik pada shape 1
• karna kita menggunakan variable global color, geser ke table paint
• klik check box disebelah menu color.
• klik icon globe yang berada di atas layar
• kemudian klik icon globe yang ada di sebelah color
• pilih nama variable.
• lakukan langkah yang sama pada shape-shape berikutnya

Sekarang coba ganti warna variable global yang dipakai dengan warna hijau, ketiga shape akan berubah menjadi warna hijau.

Note : Jangan takut untuk mencoba, jika salah itu wajar, tinggal hapus dan ulangi lagi dari awal.

Group dalam KLWP adalah module yang berfungsi sebagai wadah untuk meletakkan module-module lain didalamnya, atau jika anda pernah mendengar tentang xml pada desain aplikasi android, group juga bisa diartikan sebagai layout.

Dalam mendesain preset KLWP penggunaan group sangat disarankan karena termasuk praktik yang baik, selain itu KLWP juga membatasi jumlah module yang bisa diletakkan pada Root, sedangkan animasi hanya bisa diterapkan pada module yang terletak tepat setelah Root, mengapa demikian? perlu diingat bahwa setiap animasi pada sebuah aplikasi baik itu live wallpaper ataupun yang lain akan mengkonsumsi ram, semakin banyak animasi maka akan semakin bayak ruang ram yang dibutuhkan, karena itu jika desain yang dibuat tidak membutuhkan animasi sebaiknya letakkan pada sebuah group.
Group dalam KLWP dibagi menjadi tiga bagian dan tentu saja memiliki fungsi yang berbeda.

Overlaps Group  

Sesuai dengan namanya, Overlaps group bersifat tumpang tindih atau menumpuk setiap module yang berada didalamnya atau bisa disebut relatif layout, lebar dari overlaps group tergantung dari setiap module baik itu panjang, lebar atau jarak (padding), kita buat contoh sederhana seperti gambar berikut.

Pada gambar diatas kita membuat contoh overlaps group dengan lima shape didalamnya, dengan nama Shape 0 - 4 caranya :

Stack Group

Stack group akan meletakkan setiap module yang ada didalamnya secara tersusun berjejer baik itu vertikal ataupun horizontal, untuk merubah jenis susunan module pada Stack Group, geser pada table Layer kemudian pilih Stacking.

Berbeda dari Overlaps Group, padding dari setiap module pada stack group berdasarkan batas terdekat misalkan module dengan module yang lain atau module dengan batas dari group itu sendiri, contoh kita buat stack group dengan tiga shape rectangle didalamnya, masing-masing dari shape kita ubah width : 160, height : 80, Bpadding : 30, maka akan tampak seperti gambar berikut.

Pada Stack group setiap module yang ditambahkan tidak akan pernah menimpa module yang lain, Contoh :

• Ubah stacking menjadi Center Horizontal
• pada setiap shape ubah Rpadding menjadi 25
• keluar dari Stack group, kemudian tambahkan Stack groub baru pada layer Root.
• Cut Stack group yang pertama dengan cara centang pada check box, klik pada icon three dots yang ada diatas layar kemudian pilih Cut.
• kita buka Stack group yang baru kemudian klik icon paste
• kemudian lakukan copy paste sebanyak 3x pada Stack group tersebut (lihat contoh shape pada Overlaps group)

Hasilnya akan seperti gambar di bawah ini.

Komponent merupakan Overlaps group spesial yang dapat di export secara terpisah, misalkan kita mempunya beberapa bagian desain seperti jam weather atau yang lain, dan kita tidak ingin membagikan semua, maka komponent merupakan wadah yang tepat, Komponent juga bisa disebut widget pada KLWP, seperti halnya preset, komponen juga memiliki variable global tersendiri.
Komponent juga dapat di Export dalam bentuk APK sepeerti preset. jadi kita bisa menggunakan komponent di beberapa Preset.
Menambahkan komponent sama dengan menambahkan module yang lain, hanya saja setelah menambahkan komponent kita akan dibawa pada halaman seperti ketika memilih preset.

Seperti contoh gambar di atas, KLWP juga memiliki Buil-in komponent yang bisa digunakan' atau jika memiliki komponent berupa nama_komponent.komp.zip, letakkan file tersebut pada /sdcard/Kustom/komponents.
Ketika memuat komponent yang telah jadi, kita tidak akan melihat module apapaun di dalamnya karna terkunci, jadi ketika ingin melihat atau mengedit, buka kunci komponent yang berada di atas layar, variable global pada komponent hanya bisa di akses oleh komponent itu sendiri.

Export Komponent
Cara mengexport komponent berbeda dengan mengeksport Preset, misalkan kita memiliki sebuah komponent yang siap dibagikan.

• Pastikan komponent tidak dalam keadaan terkunci
• Lihat deretan menu pada atas layar
• klik icon export yang berada disebelah icon gembok
• isi Title, Diskripsi dan yang lain kemudian klik Export

Letak komponent yang di export berada pada folder /sdcard/Kustom/komponents/ berupa nama.komp.zip