ການຂຽນສະຄຣິບດ້ວຍ Lua on darktable user manual

ພາບລວມ

Mon, 01 Jan 0001 00:00:00 +0000

ສະຄຣິບ Lua ສາມາດໃຊ້ເພື່ອກຳນົດການກະທຳໃຫ້ darktable ດຳເນີນການເມື່ອມີເຫດການໃດໜຶ່ງເກີດຂຶ້ນ. ຕົວຢ່າງໜຶ່ງອາດຈະແມ່ນການເອີ້ນໃຊ້ແອັບພລິເຄຊັນພາຍນອກໃນລະຫວ່າງການສົ່ງອອກໄຟລ໌ ເພື່ອນຳໃຊ້ຂັ້ນຕອນການປະມວນຜົນເພີ່ມເຕີມພາຍນອກ darktable.

Lua ແມ່ນໂຄງການອິດສະຫຼະທີ່ສ້າງຂຶ້ນໃນປີ 1993, ໃຫ້ບໍລິການພາສາສະຄຣິບທີ່ມີປະສິດທິພາບ, ໄວ, ເບົາບາງ ແລະ ສາມາດຝັງເຂົ້າໃນໂປຣແກຣມອື່ນໄດ້. Lua ຖືກນຳໃຊ້ຢ່າງກວ້າງຂວາງໂດຍແອັບພລິເຄຊັນໂອເພນຊອດຫຼາຍອັນ, ໃນໂປຣແກຣມທາງການຄ້າ ແລະ ສຳລັບການຂຽນເກມ. darktable ໃຊ້ Lua ເວີຊັນ 5.4. ການອະທິບາຍຫຼັກການ ແລະ ໄວຍາກອນຂອງ Lua ແມ່ນຢູ່ນອກຂອບເຂດຂອງຄູ່ມືນີ້. ສຳລັບການແນະນຳຢ່າງລະອຽດ ໃຫ້ເບິ່ງທີ່ ຄູ່ມືອ້າງອີງ Lua.

darktable ມາພ້ອມກັບ ສະຄຣິບຈຳນວນໜຶ່ງ. ຕົວຈັດການຫຼັກສຳລັບສະຄຣິບແມ່ນຕົວຈັດການສະຄຣິບ (ເບິ່ງ ຫຼັກການພື້ນຖານ).

ສ່ວນຕໍ່ໄປນີ້ຈະໃຫ້ການແນະນຳສັ້ນໆກ່ຽວກັບວິທີການໃຊ້ສະຄຣິບ Lua ພາຍໃນ darktable. ເອກະສານປະກອບທີ່ສົມບູນກ່ຽວກັບການຂຽນສະຄຣິບ Lua ໃນ darktable ສາມາດເບິ່ງໄດ້ທີ່ darktable lua documentation.

ສະຄຣິບຂອງ darktable

Mon, 01 Jan 0001 00:00:00 +0000

🔗ຕັ້ງແຕ່ເວີຊັນ 5.6 ເປັນຕົ້ນໄປ

ຊຸດສະຄຣິບຕ່າງໆແມ່ນລວມມາພ້ອມກັບ darktable ແລ້ວ. ພວກມັນສາມາດປິດໃຊ້ງານໄດ້ໃນ ການຕັ້ງຄ່າ > lua.

ເລີ່ມຕັ້ງແຕ່ darktable 5.6, lua-scripts ຈະຖືກລວມເຂົ້າໃນເວີຊັນທີ່ປ່ອຍອອກມາ, ດັ່ງນັ້ນຈຶ່ງບໍ່ຈຳເປັນຕ້ອງຕິດຕັ້ງແຍກຕ່າງຫາກອີກຕໍ່ໄປ.

ເບິ່ງ ຫຼັກການພື້ນຖານ ສຳລັບຄຳອະທິບາຍກ່ຽວກັບວິທີທີ່ darktable ໂຫຼດສະຄຣິບ Lua.

ເອກະສານປະກອບສຳລັບສະຄຣິບຂອງ darktable ມີໃຫ້ເບິ່ງໃນ lua docs.

🔗ກ່ອນເວີຊັນ 5.6

ກ່ອນເວີຊັນ 5.6, ສະຄຣິບບໍ່ໄດ້ຖືກລວມມານຳ ແລະ ຕ້ອງຕິດຕັ້ງໂດຍໃຊ້ຄຳແນະນຳຕໍ່ໄປນີ້.

🔗ດາວໂຫຼດ ແລະ ຕິດຕັ້ງ

ຊຸດສະຄຣິບຕ່າງໆມີໃຫ້ໃນ lua-scripts repository. ອັນນີ້ຍັງລວມເຖິງຕົວຈັດການສະຄຣິບ ເຊິ່ງຊ່ວຍໃຫ້ການເປີດ ຫຼື ປິດສະຄຣິບແຕ່ລະອັນຜ່ານ GUI ເຮັດໄດ້ງ່າຍຂຶ້ນ. ເອກະສານປະກອບສຳລັບສະຄຣິບ lua ເຫຼົ່ານີ້ແມ່ນລວມຢູ່ໃນ lua docs.

ເພື່ອໃຊ້ສະຄຣິບທີ່ມີຢູ່ເຫຼົ່ານີ້ໃນເວີຊັນກ່ອນ 5.6, ພວກມັນຕ້ອງຖືກຕິດຕັ້ງໃນ darktable. ໃນກໍລະນີສ່ວນໃຫຍ່ ສາມາດເຮັດໄດ້ຜ່ານ GUI ຂອງ darktable, ແຕ່ກໍຂຶ້ນກັບລະບົບປະຕິບັດການ ແລະ ວິທີການຕິດຕັ້ງທີ່ທ່ານເລືອກ.

ບໍ່ວ່າຈະເປັນກໍລະນີໃດ, ຄວນເປີດ darktable ຢ່າງໜ້ອຍໜຶ່ງຄັ້ງເພື່ອສ້າງໂຟນເດີຕ່າງໆຂອງມັນ. ໂຟນເດີກຳນົດຄ່າສຳລັບການຕິດຕັ້ງສ່ວນໃຫຍ່ແມ່ນມີລາຍຊື່ຢູ່ໃນໜ້າ ໂຟນເດີກຳນົດຄ່າ.

ເອກະສານປະກອບສຳລັບສະຄຣິບຂອງ darktable ມີໃຫ້ເບິ່ງໃນ lua docs.

Linux Package, AppImage ແລະ Flatpak

ຫຼັກການພື້ນຖານ

Mon, 01 Jan 0001 00:00:00 +0000

ສະຄຣິບສາມາດລົງທະບຽນ callbacks ເພື່ອດຳເນີນການເມື່ອມີເຫດການຕ່າງໆຂອງ darktable ເກີດຂຶ້ນ. ກົນໄກ callback ນີ້ແມ່ນວິທີຫຼັກໃນການກະຕຸ້ນການເຮັດວຽກຂອງ lua.

ຕົວຈັດການຫຼັກສຳລັບສະຄຣິບ lua ແມ່ນ ຕົວຈັດການສະຄຣິບ (script manager), ເຊິ່ງຈະສ້າງໂມດູນອັດຖະປະໂຫຍດ scripts ໃນແຜງແສງ ແລະ ໂຫຼດສະຄຣິບທີ່ມາພ້ອມກັບ darktable.

ສະຄຣິບ Lua ສາມາດປິດໃຊ້ງານໄດ້ໃນ ການຕັ້ງຄ່າ/ຕົວເລືອກ lua.

🔗ວິທີທີ່ darktable ໂຫຼດສະຄຣິບ (ແລະ ຕົວຈັດການສະຄຣິບ)

darktable ຈັດການສອງສະຖານທີ່ແຕກຕ່າງກັນ: ໄຟລ໌ທີ່ຖືກ ປະມວນຜົນ ເປັນລະຫັດ Lua, ແລະ ໂຟນເດີທີ່ຖືກ ສະແກນ ເພື່ອຫາສະຄຣິບ:

ປະມວນຜົນຕອນເລີ່ມຕົ້ນ:
- $DARKTABLE/share/darktable/luarc: ຖືກປະມວນຜົນໂດຍ darktable ເອງ. ນີ້ແມ່ນຈຸດເລີ່ມຕົ້ນທີ່ເປີດຕົວຈັດການສະຄຣິບ. ມັນໃຊ້ສຳລັບຈຸດປະສົງພາຍໃນເທົ່ານັ້ນ ແລະ ບໍ່ຄວນແກ້ໄຂ. $DARKTABLE ແມ່ນໂຟນເດີທີ່ຕິດຕັ້ງໂປຣແກຣມ.
- [ໂຟນເດີກຳນົດຄ່າ]/luarc: ຖືກປະມວນຜົນໂດຍຕົວຈັດການສະຄຣິບ, ຖ້າມີ. ນີ້ແມ່ນວິທີໜຶ່ງໃນການໃຊ້ສະຄຣິບຂອງທ່ານເອງ (ເບິ່ງຂ້າງລຸ່ມ).
ສະແກນຫາສະຄຣິບ .lua (ເຊິ່ງຈະປາກົດໃນໂມດູນສະຄຣິບ):
- $DARKTABLE/share/darktable/lua-scripts/: ສະຄຣິບທີ່ມາພ້ອມກັບ darktable.
- [ໂຟນເດີກຳນົດຄ່າ]/lua/[folder]: ສະຄຣິບຂອງທ່ານເອງ (ເບິ່ງຂ້າງລຸ່ມ).

ໂຟນເດີກຳນົດຄ່າ ຈະແຕກຕ່າງກັນໄປຕາມລະບົບປະຕິບັດການຂອງທ່ານ.

ດັ່ງນັ້ນ ທ່ານສາມາດ ເພີ່ມສະຄຣິບຂອງທ່ານເອງ ໄດ້ດັ່ງນີ້:

ຕົວຢ່າງ lua ແບບງ່າຍໆ

Mon, 01 Jan 0001 00:00:00 +0000

ເລີ່ມຕົ້ນດ້ວຍຕົວຢ່າງງ່າຍໆ ທີ່ຈະພິມລະຫັດບາງຢ່າງລົງໃນຄອນໂຊນ. ສ້າງໄຟລ໌ທີ່ມີຊື່ວ່າ luarc ໃນ ໂຟນເດີກຳນົດຄ່າ ຂອງ darktable ແລະ ເພີ່ມແຖວຕໍ່ໄປນີ້ໃສ່:

print("ສະບາຍດີຊາວໂລກ !")

ເປີດ darktable ຈາກຄອນໂຊນ ແລ້ວທ່ານຈະເຫັນປະໂຫຍກ “Hello World !” ພິມອອກມາ. ມັນອາດຈະເບິ່ງຄືບໍ່ມີຫຍັງພິເສດ ແຕ່ມັນຄືການເລີ່ມຕົ້ນ.

ໃນຂັ້ນຕອນນີ້, ຍັງບໍ່ມີຫຍັງທີ່ເປັນສະເພາະຂອງ darktable ໃນສະຄຣິບ. ພວກເຮົາພຽງແຕ່ໃຊ້ຟັງຊັນ print ມາດຕະຖານຂອງ Lua ເພື່ອພິມຂໍ້ຄວາມ. ນັ້ນກໍດີຢູ່, ແຕ່ພວກເຮົາສາມາດເຮັດໄດ້ດີກວ່ານັ້ນ. ເພື່ອເຂົ້າເຖິງ API ຂອງ darktable, ທຳອິດທ່ານຕ້ອງ require ມັນ ແລະ ເພີ່ມຄ່າທີ່ສົ່ງກັບມາໄວ້ໃນຕົວປ່ຽນ. ເມື່ອເຮັດແລ້ວ ທ່ານສາມາດເຂົ້າເຖິງ API ຂອງ darktable ຜ່ານຟີວຍ່ອຍຂອງຕົວປ່ຽນນັ້ນ. ທັງໝົດນີ້ມີລາຍລະອຽດຢູ່ໃນຄູ່ມືອ້າງອີງ Lua API ຂອງ darktable.

local darktable = require "darktable"
darktable.print_error("ສະບາຍດີຊາວໂລກ !")

ລອງໃຊ້ສະຄຣິບແລ້ວ… ບໍ່ມີຫຍັງເກີດຂຶ້ນ. ຟັງຊັນ darktable.print_error ກໍຄືກັບ print ແຕ່ຈະພິມຂໍ້ຄວາມກໍຕໍ່ເມື່ອທ່ານເປີດໃຊ້ lua traces ໂດຍການສັ່ງ darktable ດ້ວຍ “darktable -d lua” ໃນຄຳສັ່ງຄອນໂຊນ. ນີ້ແມ່ນວິທີທີ່ແນະນຳໃນການເຮັດ traces ໃນສະຄຣິບ lua ຂອງ darktable.

ການພິມລາຍຊື່ຮູບພາບທີ່ມີປ້າຍສີ

Mon, 01 Jan 0001 00:00:00 +0000

ຕົວຢ່າງທຳອິດໄດ້ສະແດງໃຫ້ເຫັນພື້ນຖານຂອງ lua ແລະ ຊ່ວຍໃຫ້ພວກເຮົາກວດສອບວ່າທຸກຢ່າງເຮັດວຽກໄດ້ດີ. ບາດນີ້ມາລອງເຮັດສິ່ງທີ່ຊັບຊ້ອນກວ່ານັ້ນໜ້ອຍໜຶ່ງ. ມາລອງພິມລາຍຊື່ຮູບພາບທີ່ມີປ້າຍສີ “ແດງ” ຕິດຢູ່. ແຕ່ກ່ອນອື່ນໝົດ, ຮູບພາບແມ່ນຫຍັງ?

local darktable = require "darktable"
local debug = require "darktable.debug"
print(darktable.debug.dump(darktable.database[1]))

ການໃຊ້ລະຫັດຂ້າງເທິງຈະໃຫ້ຜົນລັດອອກມາຫຼາຍຫຼາຍ. ພວກເຮົາຈະມາເບິ່ງມັນໃນອີກຈັກໜ້ອຍ, ແຕ່ກ່ອນອື່ນມາເບິ່ງທີ່ຕົວລະຫັດກ່ອນ.

ພວກເຮົາຮູ້ຈັກ require darktable ແລ້ວ. ໃນທີ່ນີ້, ພວກເຮົາຕ້ອງ require darktable.debug ແຍກຕ່າງຫາກ ເຊິ່ງເປັນສ່ວນເສີມຂອງ API ທີ່ໃຫ້ຟັງຊັນຊ່ວຍເຫຼືອໃນການແກ້ໄຂຈຸດບົກພ່ອງ (debug) ຂອງສະຄຣິບ lua.

darktable.database ແມ່ນຕາຕະລາງທີ່ API ຈັດຫາໃຫ້ ເຊິ່ງປະກອບດ້ວຍຮູບພາບທັງໝົດໃນຖານຂໍ້ມູນ library. ແຕ່ລະລາຍການໃນຖານຂໍ້ມູນແມ່ນວັດຖຸຮູບພາບ (image object). ວັດຖຸຮູບພາບແມ່ນວັດຖຸທີ່ຊັບຊ້ອນ ເຊິ່ງຊ່ວຍໃຫ້ທ່ານຈັດການຮູບພາບຂອງທ່ານໄດ້ໃນຫຼາຍວິທີ (ທັງໝົດມີລາຍລະອຽດໃນສ່ວນ types_dt_lua_image_t ຂອງຄູ່ມື API). ເພື່ອສະແດງຮູບພາບຂອງພວກເຮົາ, ພວກເຮົາໃຊ້ darktable.debug.dump ເຊິ່ງເປັນຟັງຊັນທີ່ຈະຮັບຄ່າໃດກໍໄດ້ເປັນພາຣາມິເຕີ ແລະ ສະແດງເນື້ອໃນຂອງມັນອອກມາທັງໝົດ. ເນື່ອງຈາກຮູບພາບເປັນວັດຖຸທີ່ຊັບຊ້ອນ ແລະ ອ້າງອີງເຖິງວັດຖຸອື່ນໆ, ຜົນລັດທີ່ໄດ້ຈຶ່ງມີຂະໜາດໃຫຍ່ຫຼາຍ. ຂ້າງລຸ່ມນີ້ແມ່ນຕົວຢ່າງຂອງຜົນລັດທີ່ຖືກຕັດໃຫ້ສັ້ນລົງ.

toplevel (ຂໍ້ມູນຜູ້ໃຊ້,dt_lua_image_t) : /images/100.JPG
   publisher (ຂໍ້ຄວາມ) : ""
   path (ຂໍ້ຄວາມ) : "/images"
   move (ຟັງຊັນ)
   exif_aperture (ຕົວເລກ) : 2.7999999523163
   rights (ຂໍ້ຄວາມ) : ""
   make_group_leader (ຟັງຊັນ)
   exif_crop (ຕົວເລກ) : 0
   duplicate_index (ຕົວເລກ) : 0
   is_raw (ບູລີນ) : false
   exif_iso (ຕົວເລກ) : 200
   is_ldr (ບູລີນ) : true
   rating (ຕົວເລກ) : 1
   description (ຂໍ້ຄວາມ) : ""
   red (ບູລີນ) : false
   get_tags (ຟັງຊັນ)
   duplicate (ຟັງຊັນ)
   creator (ຂໍ້ຄວາມ) : ""
   latitude (ຫວ່າງເປົ່າ)
   blue (ບູລີນ) : false
   exif_datetime_taken (ຂໍ້ຄວາມ) : "2014:04:27 14:10:27"
   exif_maker (ຂໍ້ຄວາມ) : "Panasonic"
   drop_cache (ຟັງຊັນ)
   title (ຂໍ້ຄວາມ) : ""
   reset (ຟັງຊັນ)
   create_style (ຟັງຊັນ)
   apply_style (ຟັງຊັນ)
   film (ຂໍ້ມູນຜູ້ໃຊ້,dt_lua_film_t) : /images
      1 (ຂໍ້ມູນຜູ້ໃຊ້,dt_lua_image_t): .toplevel
      [......]
   exif_exposure (ຕົວເລກ) : 0.0062500000931323
   exif_lens (ຂໍ້ຄວາມ) : ""
   detach_tag (ຟັງຊັນ): toplevel.film.2.detach_tag
   exif_focal_length (ຕົວເລກ) : 4.5
   get_group_members (ຟັງຊັນ): toplevel.film.2.get_group_members
   id (ຕົວເລກ) : 1
   group_with (ຟັງຊັນ): toplevel.film.2.group_with
   delete (ຟັງຊັນ): toplevel.film.2.delete
   purple (ບູລີນ) : false
   is_hdr (ບູລີນ) : false
   exif_model (ຂໍ້ຄວາມ) : "DMC-FZ200"
   green (ບູລີນ) : false
   yellow (ບູລີນ) : false
   longitude (ຫວ່າງເປົ່າ)
   filename (ຂໍ້ຄວາມ) : "100.JPG"
   width (ຕົວເລກ) : 945
   attach_tag (ຟັງຊັນ): toplevel.film.2.attach_tag
   exif_focus_distance (ຕົວເລກ) : 0
   height (ຕົວເລກ) : 648
   local_copy (ບູລີນ) : false
   copy (ຟັງຊັນ): toplevel.film.2.copy
   group_leader (ຂໍ້ມູນຜູ້ໃຊ້,dt_lua_image_t): .toplevel

ຢ່າງທີ່ພວກເຮົາເຫັນ, ຮູບພາບໜຶ່ງມີຟີວຈຳນວນຫຼາຍທີ່ໃຫ້ຂໍ້ມູນທຸກປະເພດກ່ຽວກັບມັນ. ໃນທີ່ນີ້, ພວກເຮົາສົນໃຈປ້າຍສີ “ແດງ”. ຟີວນີ້ເປັນຄ່າ boolean (ຈິງ/ບໍ່ຈິງ), ແລະ ເອກະສານບອກວ່າພວກເຮົາສາມາດຂຽນຄ່າລົງໄປໄດ້. ຕອນນີ້ພວກເຮົາພຽງແຕ່ຕ້ອງຊອກຫາຮູບທັງໝົດທີ່ມີຟີວນີ້ ແລະ ພິມພວກມັນອອກມາ:

ການເພີ່ມປຸ່ມລັດແບບງ່າຍໆ

Mon, 01 Jan 0001 00:00:00 +0000

ຜ່ານມາ, ສະຄຣິບທັງໝົດຂອງພວກເຮົາເຮັດວຽກໃນລະຫວ່າງການເລີ່ມຕົ້ນລະບົບເທົ່ານັ້ນ. ອັນນີ້ມີປະໂຫຍດຈຳກັດ ແລະ ບໍ່ຊ່ວຍໃຫ້ພວກເຮົາຕອບສະໜອງຕໍ່ການກະທຳຕົວຈິງຂອງຜູ້ໃຊ້ໄດ້. ເພື່ອເຮັດສິ່ງທີ່ກ້າວໜ້າກວ່ານັ້ນ ພວກເຮົາຕ້ອງລົງທະບຽນຟັງຊັນທີ່ຈະຖືກເອີ້ນໃຊ້ເມື່ອມີເຫດການໃດໜຶ່ງເກີດຂຶ້ນ. ເຫດການທີ່ພົບເລື້ອຍທີ່ສຸດແມ່ນປຸ່ມລັດແປ້ນພິມ.

darktable = require "darktable"

local function hello_shortcut(event, shortcut)
darktable.print("ສະບາຍດີ, ຂ້ອຍຫາກໍ່ໄດ້ຮັບ '"..event..
       "' ພ້ອມກັບພາຣາມິເຕີ '"..shortcut.."'")
end

darktable.register_event("hello shortcut",
       "shortcut",hello_shortcut,
       "ຄຳສັ່ງລັດທີ່ສະແດງພາຣາມິເຕີຂອງມັນ")

ຕອນນີ້ໃຫ້ເປີດ darktable, ໄປທີ່ “ການຕັ້ງຄ່າ > ປຸ່ມລັດ > lua > A shortcut that prints its parameters”, ກຳນົດປຸ່ມລັດແລ້ວທົດລອງໃຊ້. ທ່ານຄວນຈະເຫັນຂໍ້ຄວາມປາກົດຂຶ້ນເທິງໜ້າຈໍ.

ມາເບິ່ງລະຫັດຢ່າງລະອຽດ. ທຳອິດພວກເຮົາກຳນົດຟັງຊັນທີ່ຮັບພາຣາມິເຕີຂໍ້ຄວາມສອງອັນ. ອັນທຳອິດແມ່ນປະເພດຂອງເຫດການທີ່ຖືກກະຕຸ້ນ (“shortcut”) ແລະ ອັນທີສອງແມ່ນຊື່ຂອງປຸ່ມລັດ (“A shortcut that prints its parameters”). ຕົວຟັງຊັນເອງຈະເອີ້ນໃຊ້ darktable.print, ເຊິ່ງຈະພິມຂໍ້ຄວາມທັບຊ້ອນໃນໜ້າຕ່າງຫຼັກ.

ເມື່ອກຳນົດຟັງຊັນນັ້ນແລ້ວ, ພວກເຮົາຈະລົງທະບຽນມັນເປັນ shortcut callback. ເພື່ອເຮັດສິ່ງນັ້ນ ພວກເຮົາຈະເອີ້ນໃຊ້ darktable.register_event ເຊິ່ງເປັນຟັງຊັນທົ່ວໄປສຳລັບເຫດການທຸກປະເພດ. ພວກເຮົາບອກມັນວ່າກຳລັງລົງທະບຽນເຫດການປະເພດ “shortcut” ດ້ວຍຊື່ “hello shortcut”, ຈາກນັ້ນກຳນົດ callback ທີ່ຈະເອີ້ນໃຊ້ ແລະ ສຸດທ້າຍແມ່ນກຳນົດຂໍ້ຄວາມທີ່ຈະໃຊ້ອະທິບາຍປຸ່ມລັດໃນໜ້າຕ່າງການຕັ້ງຄ່າ.

ການສົ່ງອອກຮູບພາບດ້ວຍ lua

Mon, 01 Jan 0001 00:00:00 +0000

ຜ່ານມາພວກເຮົາໄດ້ຮຽນຮູ້ການໃຊ້ lua ເພື່ອປັບ darktable ໃຫ້ເຂົ້າກັບຂັ້ນຕອນການເຮັດວຽກຂອງພວກເຮົາ. ບາດນີ້ມາເບິ່ງວິທີການໃຊ້ lua ເພື່ອສົ່ງອອກຮູບພາບໄປຍັງບໍລິການອອນລາຍໄດ້ຢ່າງງ່າຍດາຍ. ຫາກທ່ານສາມາດອັບໂຫຼດຮູບພາບໄປຍັງບໍລິການໃດໜຶ່ງຜ່ານຄຳສັ່ງຄອນໂຊນ ທ່ານກໍສາມາດໃຊ້ lua ເພື່ອລວມສິ່ງນີ້ເຂົ້າໃນອິນເຕີເຟດຜູ້ໃຊ້ຂອງ darktable ໄດ້.

ໃນຕົວຢ່າງຕໍ່ໄປນີ້ ພວກເຮົາຈະໃຊ້ lua ເພື່ອສົ່ງອອກຜ່ານ scp. ປະເພດບ່ອນເກັບຂໍ້ມູນໃໝ່ຈະປາກົດໃນ UI ຂອງ darktable ເຊິ່ງຈະສົ່ງອອກຮູບພາບໄປຍັງປາຍທາງທີ່ຢູ່ໄກ ຜ່ານກົນໄກການຄັດລອກໃນ ssh.

darktable = require "darktable"

darktable.preferences.register("scp_export","export_path",
  "string","ເສັ້ນທາງ SCP ເປົ້າໝາຍ",
  "ເສັ້ນທາງເຕັມທີ່ຈະສຳເນົາໄປ. ສາມາດລວມເອົາຊື່ຜູ້ໃຊ້ ແລະ ຊື່ໂຮສ໌ (hostname)","")

darktable.register_storage("scp_export","ສົ່ງອອກຜ່ານ scp",
  function( storage, image, format, filename,
     number, total, high_quality, extra_data)
    if not darktable.control.execute("scp "..filename.." "..
      darktable.preferences.read("scp_export",
         "export_path","string")) then
      darktable.print_error("scp ຫຼົ້ມເຫຼວສຳລັບ "..tostring(image))
    end
end)

darktable.preferences.register ຈະເພີ່ມການຕັ້ງຄ່າໃໝ່ເຂົ້າໃນເມນູການຕັ້ງຄ່າຂອງ darktable, scp_export ແລະ export_path ຊ່ວຍໃຫ້ພວກເຮົາລະບຸການຕັ້ງຄ່າຂອງພວກເຮົາໄດ້ຢ່າງຊັດເຈນ. ຟີວເຫຼົ່ານີ້ຈະຖືກນຳມາໃຊ້ຄືນເມື່ອພວກເຮົາອ່ານຄ່າຂອງການຕັ້ງຄ່ານັ້ນ. ຟີວ string ບອກ lua engine ວ່າການຕັ້ງຄ່ານີ້ເປັນຂໍ້ຄວາມ. ມັນຍັງສາມາດເປັນຕົວເລກຖ້ວນ, ຊື່ໄຟລ໌ ຫຼື ປະເພດໃດກໍໄດ້ທີ່ລະບຸໄວ້ໃນຄູ່ມື API ທີ່ກ່ຽວກັບ types_lua_pref_type. ຈາກນັ້ນພວກເຮົາມີປ້າຍຊື່ສຳລັບການຕັ້ງຄ່າໃນເມນູການຕັ້ງຄ່າ, ຄຳແນະນຳ (tooltip) ເມື່ອວາງເມົາສ໌ເທິງຄ່ານັ້ນ ແລະ ຄ່າເລີ່ມຕົ້ນ.

ການສ້າງອົງປະກອບອິນເຕີເຟດຜູ້ໃຊ້

Mon, 01 Jan 0001 00:00:00 +0000

ຕົວຢ່າງກ່ອນໜ້ານີ້ຂອງພວກເຮົາຍັງມີຂໍ້ຈຳກັດ. ໂດຍສະເພາະການໃຊ້ການຕັ້ງຄ່າສຳລັບເສັ້ນທາງການສົ່ງອອກນັ້ນບໍ່ສະດວກປານໃດ. ພວກເຮົາສາມາດເຮັດໃຫ້ດີກວ່ານັ້ນໄດ້ໂດຍການເພີ່ມອົງປະກອບເຂົ້າໃນອິນເຕີເຟດຜູ້ໃຊ້ໃນໜ້າຕ່າງການສົ່ງອອກ.

ອົງປະກອບ UI ຖືກສ້າງຂຶ້ນຜ່ານຟັງຊັນ darktable.new_widget. ຟັງຊັນນີ້ຮັບຄ່າປະເພດຂອງ widget ເປັນພາຣາມິເຕີ ແລະ ສົ່ງຄືນວັດຖຸໃໝ່ທີ່ກົງກັບ widget ນັ້ນ. ຈາກນັ້ນທ່ານສາມາດຕັ້ງຄ່າຟີວຕ່າງໆໃນ widget ນັ້ນເພື່ອຕັ້ງຄ່າພາຣາມິເຕີຂອງມັນ. ທ່ານຈະໃຊ້ວັດຖຸນັ້ນເປັນພາຣາມິເຕີໃຫ້ກັບຟັງຊັນຕ່າງໆທີ່ຈະເພີ່ມມັນເຂົ້າໃນ UI ຂອງ darktable. ຕົວຢ່າງງ່າຍໆຕໍ່ໄປນີ້ຈະເພີ່ມ lib ໃນມຸມມອງແຜງແສງພ້ອມກັບປ້າຍຂໍ້ຄວາມງ່າຍໆ:

darktable = require "darktable"

local my_label = darktable.new_widget("label")
my_label.label = "Hello, world !"

darktable.register_lib("test","test",false,false,{
    [darktable.gui.views.lighttable] = {"DT_UI_CONTAINER_PANEL_LEFT_CENTER",20},
  },my_label)

ມີເຕັກນິກທາງໄວຍາກອນທີ່ຊ່ວຍໃຫ້ລະຫັດອົງປະກອບ UI ອ່ານ ແລະ ຂຽນໄດ້ງ່າຍຂຶ້ນ. ທ່ານສາມາດເອີ້ນວັດຖຸເຫຼົ່ານີ້ເປັນຟັງຊັນໂດຍໃຊ້ຕາຕະລາງຂອງຄ່າ key ເປັນອາກິວເມນ. ອັນນີ້ຊ່ວຍໃຫ້ຕົວຢ່າງຕໍ່ໄປນີ້ເຮັດວຽກໄດ້. ມັນສ້າງ widget ທີ່ເປັນຕົວບັນຈຸ (container) ພ້ອມກັບ widget ຍ່ອຍສອງອັນ: ປ້າຍຂໍ້ຄວາມ ແລະ ຊ່ອງປ້ອນຂໍ້ຄວາມ.

local my_widget = darktable.new_widget("box"){
  orientation = "horizontal",
  darktable.new_widget("label"){ label = "ທີ່ນີ້ => " },
  darktable.new_widget("entry"){ tooltip = "ກະລຸນາປ້ອນຂໍ້ຄວາມໃສ່ບ່ອນນີ້" }
}

ຕອນນີ້ພວກເຮົາຮູ້ແລ້ວ, ມາປັບປຸງສະຄຣິບຂອງພວກເຮົາອີກໜ້ອຍໜຶ່ງ.

ການແບ່ງປັນສະຄຣິບ

Mon, 01 Jan 0001 00:00:00 +0000

ຜ່ານມາ, ລະຫັດ lua ທັງໝົດຂອງພວກເຮົາແມ່ນຢູ່ໃນ luarc. ນັ້ນແມ່ນວິທີທີ່ດີໃນການພັດທະນາສະຄຣິບ ແຕ່ບໍ່ຄ່ອຍສະດວກໃນການແຈກຢາຍ. ພວກເຮົາຕ້ອງເຮັດໃຫ້ມັນເປັນໂມດູນ lua ທີ່ຖືກຕ້ອງ. ເພື່ອເຮັດສິ່ງນັ້ນ, ພວກເຮົາຈະບັນທຶກລະຫັດໄວ້ໃນໄຟລ໌ແຍກຕ່າງຫາກ (ໃນທີ່ນີ້ແມ່ນ scp-storage.lua):

--[[
SCP STORAGE
a simple storage to export images via scp

AUTHOR
Jérémy Rosen (jeremy.rosen@enst-bretagne.fr)

INSTALLATION
* copy this file in $CONFIGDIR/lua/
* add the following line in the file $CONFIGDIR/luarc
  require "scp-storage"

USAGE
* select "Export via SCP" in the storage selection menu
* set the target directory 
* export your images

LICENSE
GPLv2

]]

darktable = require "darktable"
dtutils = require "lib/dtutils"

dtutils.check_min_api_version("7.0.0", ...)

local scp_path = darktable.new_widget("entry"){
  tooltip = "Complete path to copy to. Can include user and hostname",
  text = "",
  reset_callback = function(self) self.text = "" end
}

darktable.register_storage("scp_export","Export via scp",
  function( storage, image, format, filename,
     number, total, high_quality, extra_data)
    if not darktable.control.execute("scp "..filename.." "..
      scp_path.text
    ) then
      darktable.print_error("scp failed for "..tostring(image))
    end
  end,
  nil, --finalize
  nil, --supported
  nil, --initialize
  darktable.new_widget("box") {
    orientation = "horizontal",
    darktable.new_widget("label"){ label = "target SCP PATH " },
    scp_path,
})

darktable ຈະຊອກຫາສະຄຣິບ (ຕາມກົດເກົານປົກກະຕິຂອງ lua) ໃນໂຟນເດີມາດຕະຖານ ບວກກັບ $CONFIGDIR/lua/*.lua. ດັ່ງນັ້ນ ສະຄຣິບຂອງພວກເຮົາສາມາດເອີ້ນໃຊ້ໄດ້ງ່າຍໆໂດຍການເພີ່ມ require "scp-storage" ໃນໄຟລ໌ luarc. ໝາຍເຫດເພີ່ມເຕີມບາງຢ່າງ…

ການເອີ້ນໃຊ້ lua ຈາກ dbus

Mon, 01 Jan 0001 00:00:00 +0000

ທ່ານສາມາດສົ່ງຄຳສັ່ງ lua ໄປຍັງ darktable ຜ່ານອິນເຕີເຟດ DBus ຂອງມັນໄດ້. ເມທອດ org.darktable.service.Remote.Lua ຮັບພາຣາມິເຕີຂໍ້ຄວາມດຽວ ເຊິ່ງຈະຖືກຕີຄວາມໝາຍເປັນຄຳສັ່ງ lua. ຄຳສັ່ງຈະຖືກປະມວນຜົນໃນບໍລິບົດ lua ປັດຈຸບັນ ແລະ ຄວນສົ່ງຄືນເປັນ nil ຫຼື ຂໍ້ຄວາມ. ຜົນລັດຈະຖືກສົ່ງກັບຄືນເປັນຜົນຂອງເມທອດ DBus.

ຫາກການເອີ້ນໃຊ້ Lua ເກີດຂໍ້ຜິດພາດ, ເມທອດ DBus ຈະສົ່ງຄືນຂໍ້ຜິດພາດ org.darktable.Error.LuaError ພ້ອມກັບຂໍ້ຄວາມຂໍ້ຜິດພາດຂອງ lua ທີ່ຕິດມາກັບຂໍ້ຜິດພາດ DBus ນັ້ນ.

ການໃຊ້ darktable ຈາກສະຄຣິບ lua

Mon, 01 Jan 0001 00:00:00 +0000

ຄຳເຕືອນ: ຄຸນສົມບັດນີ້ຍັງຢູ່ໃນຂັ້ນຕອນທົດລອງ. ເປັນທີ່ຊາບກັນດີວ່າບາງອົງປະກອບຍັງບໍ່ທັນເຮັດວຽກໃນໂໝດ library. ແນະນຳໃຫ້ມີການທົດສອບຢ່າງລະມັດລະວັງ.

ອິນເຕີເຟດ lua ຊ່ວຍໃຫ້ທ່ານສາມາດໃຊ້ darktable ຈາກສະຄຣິບ lua ໃດກໍໄດ້. ອັນນີ້ຈະໂຫຼດ darktable ເປັນ library ແລະ ໃຫ້ບໍລິການ lua API ສ່ວນໃຫຍ່ (darktable ຖືກກຳນົດຄ່າແບບ headless, ດັ່ງນັ້ນຟັງຊັນທີ່ກ່ຽວກັບອິນເຕີເຟດຜູ້ໃຊ້ຈຶ່ງບໍ່ມີໃຫ້ໃຊ້).

ຕົວຢ່າງ: ໂປຣແກຣມຕໍ່ໄປນີ້ຈະພິມລາຍຊື່ຮູບພາບທັງໝົດໃນ library ຂອງທ່ານ:

#!/usr/bin/env lua
package = require "package"
package.cpath=package.cpath..";./lib/darktable/lib?.so"

dt = require("darktable")(
"--library", "./library.db",
"--datadir", "./share/darktable",
"--moduledir", "./lib/darktable",
"--configdir", "./configdir",
"--cachedir","cachedir",
"--g-fatal-warnings")

require("darktable.debug")

for k,v in ipairs(dt.database) do
   print(tostring(v))
end

ສັງເກດແຖບທີສາມທີ່ຊີ້ໄປຍັງຕຳແໜ່ງຂອງໄຟລ໌ libdarktable.so.

ນອກຈາກນັ້ນ, ໝາຍເຫດວ່າການເອີ້ນໃຊ້ require ຈະສົ່ງຄືນຟັງຊັນທີ່ເອີ້ນໃຊ້ໄດ້ພຽງຄັ້ງດຽວ ແລະ ຊ່ວຍໃຫ້ທ່ານຕັ້ງພາຣາມິເຕີຄຳສັ່ງຂອງ darktable ໄດ້. ພາຣາມິເຕີ :memory: ສຳລັບ --library ມີປະໂຫຍດໃນກໍລະນີທີ່ທ່ານບໍ່ຕ້ອງການເຮັດວຽກກັບ library ສ່ວນຕົວຂອງທ່ານ.

lua API

Mon, 01 Jan 0001 00:00:00 +0000

Lua API ຂອງ darktable ແມ່ນມີການບັນທຶກໄວ້ໃນຄູ່ມືສະເພາະຂອງມັນເອງ ເຊິ່ງມີລາຍລະອຽດຂອງໂຄງສ້າງຂໍ້ມູນ ແລະ ຟັງຊັນທັງໝົດ. ທ່ານສາມາດດາວໂຫຼດຄູ່ມື API ໄດ້ຈາກ ທີ່ນີ້.