shengpo / cascadePlayer

cascadePlayer 架構是以 Processing + mpe library + mappingtools library 為基礎開發，支援多個 cascadePlayer 同步播放，全螢幕播放及 projection mapping 校正，並允許使用者依照需求做擴充及修改

cascadePlayer

cascadePlayer 架構是以 Processing + mpe library + mappingtools library 為基礎開發，支援多個 cascadePlayer 同步播放，全螢幕播放及 projection mapping 校正，並允許使用者依照需求做擴充及修改

測試影片

• 動畫繪圖 http://youtu.be/UDGGvhfAw3U 同步結果OK
• 載入影片 http://youtu.be/8-xDG7PdlGA 同步結果有待改進

使用須知

這是一個架構、框架，提供簡易基本的全螢幕播放、projection mapping 校正、參數設定、以及多個 cascadePlayer 同步播放的 client-server 架構
影像內容需由使用者透過制定 ImageSource class，以及 implements <ImageSourceInterface> 來完成
使用者甚至可以自訂自己的設定檔 (如：mpe.ini, player.ini)，以及修改對應的 loadingSetting()
因此，此架構給予使用者很大的彈性來完成最終屬於使用者自己的 cascadePlayer

資料夾說明

• code_template
  • cascadePlayer 的架構程式，使用者由此進行改造
• code_example
  • 以 cascadePlayer 架構程式為基礎的範例，供使用者參考
• dependency
  • cascadePlayer 用到的 mpe library (bigscreens version) 及 mpaaingtools library (0.0.3 version)
• mpe_server
  • mpe (Most-Pixel-Ever) framework 的 server 程式 (bigscreens version)

測試及開發環境

• Processing 2.0.2

TODO

• ImageSource能夠做mask (利用GLSL)

已知問題與解法

• 多個影片同步播放(即多個 cascadePlayer 同步影片播放)仍有些微不同步的問題(切換場時比較明顯)，但目前為可接受範圍
  • 解法 1：影片的切換場不要太多次，或是切換場的銜接不要做的太明顯
  • 解法 2：採用硬體規格較好的電腦，例如：較高速的 CPU 及獨立顯示卡
• 目前使用 Processing 2.0+ 在 Linux 上將 sketch 輸出成 application 時，遇到輸出的 core.jar 檔內容不完整的問題。(不知道 windows 跟 mac 是否有相同問題)
  • 這會造成無法順利載入某些 class 而使得 application 無法順利運作 (但若直接在 PDE 運行 skecth 則無此問題)
  • 解法：使用 Processing 2.0+ 自帶的 core.jar 檔覆蓋掉輸出的 application 的 core.jar 檔即可
  • 註解 1：Processing 2.0+ 自帶的 core.jar 檔位於 {path-to-processing}/core/library/core.jar
  • 註解 2：輸出的 application 的 core.jar 檔位於 {path-to-current-sketch}/application.linux64/lib/core.jar (以 Linux 64-bit 為例)

Dependency

• Most-Pixel-Ever library (bigscreens version) https://github.com/shiffman/Most-Pixels-Ever-Processing/tree/bigscreens
• mappingtools library (version 0.0.3) http://www.iact.umontreal.ca/mappingtools/

說明

• 需搭配 mpe server 使用
• 每個 cascadePlayer 都是 mpe client
• 請先了解 mpe (Most-Pixel-Ever library 的運作原理)
  • https://github.com/shiffman/Most-Pixels-Ever-Processing/wiki/How-This-Works
  • http://www.chris3000.com/portfolio/most-pixels-ever/
• mappingtools library 預設支援以下按鍵功能：
  • 按鍵 c ： 顯示/隱藏控制點
  • 按鍵 d ： reset 控制點為預設值
  • 按鍵 s ： 將控制點位置記錄下來，在 sketch 所在位置儲存成 presets.txt 檔
  • 按鍵 p ： 載入先前所儲存的控制點位置( presets.txt 檔)
• 目前支援四邊形(Quad)、貝茲曲面形(Bezier)、自由面(free)的 projection mapping 的投影校正
• cascadePlayer 每次只能使用一種 projection mapping 模式 (Quad, Bezier, or free)，且每個模式只會存在一個實體 (instance)，不會同時存在多個。
  • 例如：不能在每個 cascadePlayer 中使用兩個以上的四邊形(Quad) mapping
  • 註解：若有特殊需求，請自行修改 WarpManager class
• 每次開啟 cascadePlayer 均自動載入之前的 projection mapping 設定檔 (presets.txt)

使用方法

• 設定檔皆放在 setting 資料夾 (data資料夾下)

  • mpe.ini 為 mpe 相關的參數設定
  • player.ini 為 cascadePlayer 相關的參數設定

• mpe server 用法

  • 先開啟終端機 (terminal)
  • 切換至 mpe server (mpeServer.jar) 所在位置的資料夾
  • 執行指令: java -jar mpeServer.jar -debug1 -framerate30 -screens2
  • 參數說明：
    • debug1 表示開啟 debug 資訊(sever端送出及接收的所有訊息)
    • debug0 表示不開啟 debug 資訊
    • framerate30 表示 server 端運行的 frame rate 為30，也就是說所有的 mpe client (cascadePlayer) 的 frame rate 都是30。30這個數值可依需求更改。
    • screens2 表示有2個 mpe client (cascadePlayer)，2這個數值可依實際情況更改。
  • 可參考：https://github.com/shiffman/Most-Pixels-Ever-Processing/wiki/Processing-Tutorial

• mpe server "必須"先啟動後，再啟動每個 cascadePlayer (此為 bigscreens version 的限制)

• 手動設定 projection mapping 參數

  • 按鍵 c ： 顯示/隱藏控制點
  • 按鍵 d ： reset 控制點為預設值
  • 按鍵 s ： 將控制點位置記錄下來，在 sketch 所在位置儲存成 presets.txt 檔
  • 按鍵 p ： 載入先前所儲存的控制點位置( presets.txt 檔)

License

CC BY-SA 3.0