from pypylon import pylon
with pylon.InstantCamera(pylon.FirstFound) as camera:
grab_result = camera.GrabOne(5000)
pylon.DisplayImage(1, grab_result)pypylon
Basler 機器視覺硬體的官方 Python 包裝器
pypylon 是 pylon Software Suite 的 Python 介面，可將 Basler 機器視覺元件與 Python 整合。作為 Basler 官方產品，您可直接獲得 Basler 專家的可靠支援。Python 可為您提供最大的開發彈性，而得益於 pypylon 的開源程式碼，您還可依據自身需求進行客製化調整。
pip install pypylon可靠性與技術支援
pypylon 維持 100% 開源，並由我們負責開發、提供及技術支援輕鬆入門 pypylon
超過 50 個程式碼範例，搭配完整文件與入門指南，讓您輕鬆開始使用。pypylon 提供完整功能
pylon SDK 的所有功能皆可在 pypylon 中使用，包括相機設定與影像處理。快速從原型開發邁向穩健的解決方案
透過 Python 與 pypylon，您可以輕鬆將創意轉化為強大的解決方案，同時兼具 pylon SDK 的穩定性與速度。
pypylon 文件與教學
在 Basler 文件中，您可以找到有關安裝、使用方式及使用 Basler 機器視覺硬體進行基礎程式設計範例的實用資訊。
pypylon 讓您比以往更輕鬆地開始使用 Basler 產品。只要您會使用 Python，僅需幾行程式碼即可擷取第一張影像，無需使用 C++，也不必另外建置新的工具鏈。由於兩者皆以相同的 pylon 技術為基礎，因此可快速測試解決方案，之後再可靠地部署至正式生產環境。
這就是 pypylon 值得使用的原因
Python 是全球最廣泛使用的程式語言之一，不僅容易學習、語法簡潔，更擁有全球規模最大的開源生態系之一，涵蓋影像處理、資料分析及測試自動化等領域。
pypylon 將這些優勢與 Basler pylon Software Suite 的強大功能相結合：無論是 Python 初學者或資深開發人員，都能建立原型與影像處理功能，並測試 Basler 相機，無需建置複雜的開發環境。這有助於加速評估流程、提升生產力並降低專案成本。
from pypylon import pylon
with pylon.InstantCamera(pylon.FirstFound) as camera:
print("Using device:", camera.DeviceInfo.ModelName)
camera.Width.TrySetToMaximum()
camera.StartGrabbingMax(100)
while camera.IsGrabbing():
with camera.RetrieveResult(
5000, pylon.TimeoutHandling_ThrowException
) as grab_result:
if grab_result.GrabSucceeded():
with grab_result.GetFirstImageDataComponent() as image_data_component:
img = image_data_component.Array
print(f"SizeX: {image_data_component.Width};"
f"SizeY: {image_data_component.Height}; "
f"Gray value of first pixel: {img[0, 0]}")幾分鐘內即可取得第一張影像
pypylon API 專為 Python 開發人員而設計，並非將 C++ 包裝器轉譯而來，而是採用符合 Python 使用習慣的語法、清楚易懂的方法名稱，並完整支援 IDE 自動完成。無需複雜的開發環境，只要幾行程式碼，即可連接相機、設定參數，並開始串流擷取第一批影像。儘管語法簡潔，仍可使用 pylon C++ SDK 的完整功能，從基本影像擷取到多相機配置、事件及 Chunk Data 皆涵蓋其中。
在我們的網路研討會中，將說明如何使用 pypylon。
pypylon 與 vTools 相輔相成！
pylon vTools 用於高性能影像處理，透過 pypylon 介面使用 Python 即可充分利用，縮短開發時間。另一優勢為可以在 pylon Viewer 中建立影像處理程序，並根據即時影像精確調適，將所需的一切靈活整合到應用程式中。
前往 pylon vToolspypylon 實際應用
從生產現場的品質檢測到研究實驗室，從初期原型到可投入生產的應用，只要需要結合 Python 廣為人知的靈活性與工業影像處理，都能運用 pypylon。
pypylon 相關詳情
進一步了解我們的產品和應用。我們詳盡的資料說明所有重要細節。
FAQ：pypylon 常見問題
pypylon 涵蓋 pylon C++ SDK 提供的完整功能，並由 Basler 官方開發與支援。不僅適合快速原型開發，也可用於正式生產應用。
是。pypylon 可同時控制多台相機，包括個別設定、同步，以及透過多執行緒進行平行影像擷取。
pypylon 支援所有常見的 Basler 相機介面，包括 GigE Vision 和 USB3 Vision。完整的相容裝置清單請參閱產品使用手冊。
pypylon 支援 Windows、Linux 和 macOS，因此可靈活應用於各種開發與生產環境，從本機 Windows 工作站到 Linux 嵌入式系統皆適用。
Windows 64 位元、
Linux x86_64 和 Linux ARM 64 位元、
macOS Intel/ARM 64 位元
API 維持相容。pypylon 現在由 Basler 官方負責維護、測試與發布，並提供技術支援——建議升級至最新版本。
版本相容性一覽
自 pypylon 26.1.0 起，其版本號與 pylon Camera Software Suite 保持一致，新版本將每月同步發布。
pypylon 版本 | pylon Camera Software Suite | 日期 |
年.月 | 年.月 | 每月 |
|---|---|---|
26.05 | 26.05 | May 2026 |
26.01 | 26.01 | January 2026 |
4.2.0 | 8.1.0 | June 2025 |
4.0.0 | 7.5 | July 2024 |
3.0.0 | 7.4 | November 2023 |
*此表格並未列出所有內容。完整的版本資訊請參閱產品使用手冊文件。
重要說明：
自 pypylon 4.0.0 起：支援 Basler 3D 相機（例如 Basler ToF Camera）及 CXP-12
自 pypylon 3.0.0 起：支援 pylon vTools
支援的 Python 版本：目前最高支援至 Python 3.13，並透過 ABI3 wheels 向下相容至 Python 3.9
可以。pypylon 採用 BSD 授權條款，完全開源，可不受限制地用於商業專案。
使用 pip install pypylon 完成安裝後，可透過 InstantCamera 物件存取相機。Open() 方法會建立連線，並可使用 GrabOne()、StartGrabbing() 及 RetrieveResult() 擷取單張影像。前往入門指南
是。pypylon 採用 BSD 授權條款，並可於 GitHub 上取得。包裝器本身為開源軟體，但以 pylon Software Suite 為基礎，後者可另行安裝。