VisPy 中文文檔：基礎內容

01-31

VisPy 是一個高性能互動式 2D/3D 數據可視化庫，通過 OpenGL 庫來對目前的圖形處理單元（GPU）的計算性能進行充分利用，用於超大規模數據集的顯示。

更多信息可以參考 Home - VisPy.

vispy.use(app=None, gl=None)Vispy - VisPy

設置 VisPy 的使用選項，指定使用的應用後端和 GL 後端。

參數: app : str 字元串類型

選擇應用程序使用的後端（不區分大小寫）標準後端包括： PyQt4: 使用 Qt 控制項工具鏈，通過 PyQt4。 PyQt5: 使用 Qt 控制項工具鏈，通過 PyQt5。 PySide: 使用 Qt 控制項工具鏈，通過 PySide。 PyGlet: 使用 Pyglet 後端。 Glfw: 使用 Glfw 後端（繼承了 Glut）。在 Linux 系統上比較廣泛。 SDL2: 使用 SDL v2 後端。附加的後端： * ipynb_vnc: 在 IPython notebook 中進行渲染，通過 VNC 連接（實驗階段不穩定）

gl : str 字元串類型

選擇應用程序使用的 GL 後端（不區分大小寫），有如下選項： gl2: 使用 Vispy 的桌面 OpenGL API。 pyopengl2: 使用 PyOpenGL 的桌面 OpenGL API，總體都是測試狀態 es2: （計劃中尚未實現）在 Windows 上通過 Angle來使用真正的 OpenGL ES 2.0 。ES 2.0 的可用性主要在 Windows 上，因為要基於 DirectX。 gl+: 使用你操作系統上的完整的 OpenGL 函數（通過 PyOpenGL）。

更多信息參考：

vispy.app.use_app, vispy.gloo.gl.use_gl

特別注意

如果設置了 app 選項，那麼就調用了 vispy.app.use_app() 。如果設置了 gl 選項，那麼就調用了 vispy.gloo.use_gl() 。

如果設置了某個應用程序後端的名字，而這個後端又不能載入，就會拋出一個錯誤了。

如果沒有給出後端名字， VisPy 輝縣檢查一下對應的 GUI 工具鏈，檢查一下每個已經導入的後端，然後嘗試使用第一個。如果不成功， VisPy 會嘗試使用配置文件中的默認後端。如果還是不成功，VisPy 就會一個接一個按照預設的順序來嘗試每一個後端。

vispy.sys_info(fname=None, overwrite=False)Vispy - VisPy

獲取相關的系統信息和調試信息

參數：fname : str 字元串類型| None

輸出信息的文件名，用 None 來簡化輸出。

overwrite : bool 布爾值

如果為 True，則覆蓋文件（如果文件已經存在的話）

返回值：out : str 字元串類型

以一個字元串的方式返回系統信息。

vispy.set_log_level(verbose, match=None, return_old=False)Vispy - VisPy

設定日誌級別的一個函數，便於開發中的調試。

參數： verbose : bool 布爾值, str 字元串, int 整形, 或者 None

這個是控制輸出信息的冗餘複雜程度。如果是用字元串，可以是 DEBUG，INFO，WARNING，ERROR 或者 CRITICAL。要注意這些只是為了方便，傳入日誌的時候，DEBUG等等都是同等對待的。如果用布爾值， True 的效果就跟用字元串 INFO 一樣，而 False 就相當於字元串 WARNING。

match : str 字元串或者 None

這裡是提供要去匹配的字元串。只有包含了通過正則表達式對比後匹配該match字元串的子串才會被顯示出（當然還要符合剛剛設置的 verbose level）。

return_old : bool 布爾值

如果為 True，則返回舊的冗餘度和舊的匹配字元串。

更多信息參考：

vispy.util.use_log_level

特別注意

如果 verbose==debug，那麼 VisPy 方法發送日誌消息時會返回每一個日誌消息，這對於調試很有用處。如果 verbose==debug 或者 match 匹配字元串設置為 None，這就可能會增加一些額外的性能開銷。所以除非性能問題不太重要，其他情況下不建議使用這些選項。

vispy.test(label=full, extra_arg_string=, coverage=False)Vispy - VisPy

測試 VisPy 的工具

參數： label : str 字元串類型

可以是full， unit，nobackend，extra， lineendings， flake， docs這些字元串其中的一個，也可以是後端名，比如 qt等等。

extra_arg_string : str 字元串類型

傳遞給 pytest 的額外的參數。

coverage : bool 布爾值

如果為 True，則收集覆蓋率數據。（譯者註：這個我沒弄明白，等以後試試。）