圖形學【免費下載鏈接】ezdxfPython interface to DXF項目地址https://gitcode.com/gh_mirrors/ez/ezdxf點擊查看免費下載本文以 ezdxf 官方教程 psp_viewports.rst 為骨架結合倉庫內示例腳本與源碼實現(xiàn)系統(tǒng)講解在圖紙空間Paperspace布局中創(chuàng)建和管理 VIEWPORT 視口的完整流程從頁面設置page_setup、視口添加與縮放比例計算到視口方向調整、圖層凍結與逐視口圖層屬性覆蓋。讀完本文你將掌握用 ezdxf 為 R2000 版本 DXF 文件制作多視口圖紙布局的完整實戰(zhàn)方案并能理解底層 DXF 數(shù)據(jù)的存儲原理。教程背景與核心示例腳本本教程基于示例腳本 viewports_in_paperspace.py 展開。該腳本會為 DXF R12 與 R2000 版本各生成一個圖紙文件其模型空間內容包含三個位于 WCS世界坐標系XY 平面內的平面幾何圖形一個紅色矩形、一個綠色圓、一個青色三角形均由 create_2d_modelspace_content 創(chuàng)建一個 20×20 網格、由正弦/余弦函數(shù)生成起伏曲面的 3D 網格由 create_3d_modelspace_content 創(chuàng)建高度為 3.0范圍 30×30。模型空間內容如下圖所示圖片路徑gfx/vp-tut-msp-content.png重要為什么建議使用 R2000 版本原教程給出了一個重要警告如果需要在圖紙空間布局中使用頁面尺寸請使用 DXF R2000 或更高版本因為 DXF R12 的頁面尺寸導出無法正常工作作者在 BricsCAD 中發(fā)現(xiàn) R12 導出的圖紙尺寸錯誤在 Autodesk DWG Trueview 中發(fā)現(xiàn)邊距錯誤且未找到原因也未修復。這是圖紙空間布局在 DXF 版本支持上的一個硬性邊界實戰(zhàn)中務必注意。頁面設置Page Setup定義紙張本身DXF 參考手冊中關于圖紙空間布局特性的文檔非常匱乏關于如何使用幾乎沒有任何實踐說明因此本教程中大部分信息是作者通過反復試錯總結出來的假設。Paperspace類的page_setup()方法定義了紙張本身的屬性。模型空間和圖紙空間的單位互不相關甚至可以使用不同的單位制英制、米制但為了簡單起見官方建議兩個空間使用相同的單位系統(tǒng)layout.page_setup(size(24, 18), margins(1, 1, 1, 1), unitsinch)page_setup 完整參數(shù)簽名從源碼 layout.py 可以看到page_setup()的完整簽名與默認值def page_setup( self, size: tuple[float, float] (297, 210), # 紙張尺寸 (寬, 高) margins: tuple[float, float, float, float] (0, 0, 0, 0), # (上, 右, 下, 左)注意是順時針順序 units: str mm, # mm 或 inch offset: tuple[float, float] (0, 0), # 繪圖原點偏移2D 點 rotation: int 0, # 旋轉取值 0-3 scale: Union[int, tuple[float, float]] 16, # 標準比例類型索引或 (分子, 分母) 元組 name: str ezdxf, # 紙張名稱前綴 device: str DWG to PDF.pc3, # 設備 .pc3 配置文件或系統(tǒng)打印機名 ) - None:各參數(shù)要點size定義旋轉模式 0 下紙張的整體尺寸。最佳實踐是先在橫向landscape模式下定義紙張范圍之后再通過rotate參數(shù)旋轉紙張。margins四元組順序為(top, right, bottom, left)順時針。內部會按unit_factor轉換為毫米存儲英寸換算系數(shù)為 25.4。units僅支持mm和inch大小寫不敏感源碼中units.startswith(inch)判定其他值會拋出DXFValueError。rotation取值表源碼與教程一致取值含義0不旋轉1逆時針旋轉 90 度2上下顛倒180 度3順時針旋轉 90 度源碼 layout.py 中會對rotation做校驗非 0-3 的值拋出DXFValueError(valid rotation values: 0-3)。scale反映圖紙空間paperspace中紙張單位與繪圖單位之間的關系?？梢詡髡麛?shù)0-32 范圍內的標準比例類型索引映射關系在const.STD_SCALES中也可以傳(分子, 分母)元組例如(1, 50)表示 1:50。教程建議保持默認 1:1并在圖紙空間中用與紙張尺寸相同的單位繪制線條和文字。注意分子或分母為 0 會拋出DXFValueError。page_setup 寫入了哪些 DXF 數(shù)據(jù)源碼顯示page_setup()會設置 PLOTSETTINGS 頭部的多項屬性并把紙張名稱規(guī)范化為{name}_({width:.2f}_x_{height:.2f}_{units})格式如ezdxf_(24.00_x_18.00_Inches)同時寫入plot_configuration_file、四邊*_margin、paper_width/paper_height統(tǒng)一換算為毫米、scale_numerator/scale_denominator、plot_paper_units0 表示 Inches1 表示 MM、plot_rotation、繪圖原點偏移等最后調用reset_paper_limits()、reset_extents()、reset_viewports()重置紙張極限、范圍和視口。更簡單的頁面設置Drawing.page_setup原教程作者在寫作過程中注意到更換打印機/繪圖儀和紙張尺寸會導致布局內容移位因為所有紙張尺寸都是在沒有邊距的情況下定義的也許最好把所有邊距設為零。為此作者在Drawing類上添加了輔助方法page_setup()并提供了示例 simple_page_setup.py 演示用法。Drawing.page_setup()位于 document.py簽名如下def page_setup( self, name: str Layout1, # 圖紙空間布局名稱 fmt: str ISO A3, # 紙張格式 landscapeTrue, # True 橫向False 縱向 ) - Paperspace:該方法要求 DXF R2000 或更新版本。fmt支持的紙張格式尺寸均為橫向度量值名稱單位寬高ISO A0mm1189841ISO A1mm841594ISO A2mm594420ISO A3mm420297ISO A4mm297210ANSI Ainch118.5ANSI Binch1711ANSI Cinch2217ANSI Dinch3422ANSI Einch4434ARCH Cinch2418ARCH Dinch3624ARCH Einch4836ARCH E1inch4230Letterinch118.5Legalinch148.5該布局使用紙張格式對應的單位作為繪圖單位無邊距、無偏移、圖紙空間比例為 1:1因此更換輸出設備非常容易至少在 BricsCAD 中如此。示例腳本中還提醒無邊距布局的繪圖空間是整個紙張但打印機/繪圖儀不會打印到紙張邊緣真實文件中應始終在紙張邊緣與內容之間保留安全空間且該安全空間的大小因設備而異、無法預知建議結合psp.dxf.paper_width和psp.dxf.paper_height自行設計。在圖紙空間中繪圖你可以像在任意布局空間一樣向圖紙空間添加 DXF 實體。坐標系原點(0, 0)位于畫布canvas的左下角畫布范圍等于紙張尺寸減去邊距。你可以繪制超出該范圍的內容但 CAD 應用程序可能不會打印這些內容。在 viewports_in_paperspace.py 中作者按此規(guī)則做了如下計算并繪制邊框layout: Paperspace doc.layout(Layout1) # Arch C 18 x 24 in width, height 24, 18 m 1 layout.page_setup(size(width, height), margins(m, m, m, m), unitsinch) # 畫布由紙張尺寸減去邊距定義 canvas_width width - 2 * m # 22 canvas_height height - 2 * m # 16 # 畫布左下角坐標為 0, 0關于 R12 的特殊處理示例腳本同時支持 R12 導出但 R12 走的是另一條路徑page_setup_r12()見 layout.py。該方法會先刪除所有已存在的視口然后通過頭部變量$PLIMMIN、$PLIMMAX、$PEXTMIN、$PEXTMAX設置打印范圍并縮放邊距與紙張尺寸源碼中有 TODO 注釋不知道如何在 R12 中設置 inch/mm 模式。同時注意DXF R12 只支持一個圖紙空間即一個布局任何布局名稱都返回同一個布局見 viewports_in_paperspace.py 的注釋。添加視口Adding ViewportsViewportDXF VIEWPORT實體是一個指向模型空間的窗口用于在圖紙空間中按任意縮放比例和旋轉角度顯示模型空間的內容。VIEWPORT 實體通過工廠方法Paperspace.add_viewport()添加。從源碼 layout.py 可以看到其完整簽名def add_viewport( self, center: UVec, # 視口在圖紙空間中的中心點 size: tuple[float, float], # 視口在圖紙空間中的 (寬, 高) view_center_point: UVec, # 要顯示的模型空間區(qū)域中心點 view_height: float, # 模型空間中要顯示的區(qū)域高度 status: int 2, # 視口狀態(tài)默認 2 dxfattribsNone, # 附加 DXF 屬性 ) - Viewport:關鍵點center定義視口在圖紙空間中的中心位置size定義 VIEWPORT 在圖紙空間中的寬度和高度要顯示的模型空間內容由view_center_point和view_height定義默認圖層為 VIEWPORTS源碼中attribs字典明確寫了layer: VIEWPORTS用于后續(xù)控制視口邊框顯隱status語義源碼注釋-1表示開啟但在屏幕外或因為$MAXACTVP計數(shù)超出而非激活0表示關閉任何大于 0 的值表示開啟且激活其中1是活動視口2是下一個以此類推dxf.id由get_next_viewport_id()自動分配從 2 開始遞增源碼 layout.py。添加視口后的圖紙空間布局如下圖所示圖片路徑gfx/vp-tut-psp-content.png縮放比例Scaling Factor由尺寸與視高的比值決定VIEWPORT 的縮放因子不是一個顯式的數(shù)值而是由size參數(shù)中的 VIEWPORT 高度與view_height參數(shù)的比值關系決定的。源碼 viewport.py 中的get_scale()方法印證了這一計算方式def get_scale(self) - float: Returns the scaling factor from modelspace to viewport. msp_height self.dxf.view_height if abs(msp_height) 1e-12: return 0.0 vp_height self.dxf.height return vp_height / msp_height # 視口高度 / 模型空間視高當兩個值相等時縮放比例為 1:1paperspace.add_viewport( center(14.5, 2.5), size(5, 5), view_center_point(12.5, 7.5), view_height5, )當view_height比 VIEWPORT 高度大 5 倍時縮放比例為 1:5paperspace.add_viewport( center(8.5, 2.5), size(5, 5), view_center_point(10, 5), view_height25, )原示例 viewports_in_paperspace.py 中還演示了更多比例組合view_height10、視口高5得到 1:2矩形視圖size(0.3, 0.15)、view_height7.5得到 1:50縮放比例 7.5 / 0.15 50并在每個視口下方用add_text()標注了比例文字形成規(guī)范的平面圖 局部放大圖圖紙布局。另外可參考 viewport.py 的get_aspect_ratio()返回width / height與 viewport.py 的get_modelspace_limits()返回模型空間中可見范圍的(min_x, min_y, max_x, max_y)這兩個輔助方法可用于進一步驗證視口覆蓋的模型空間區(qū)域。視口方向View Direction從俯視到任意視角VIEWPORT 的默認視角是俯視top down view即沿 Z 軸向下看但可以通過dxf命名空間中的view_target_point和view_direction_vector屬性更改為任意視角vp paperspace.add_viewport( center(16, 10), size(4, 4), view_center_point(0, 0), view_height30 ) vp.dxf.view_target_point (40, 40, 0) vp.dxf.view_direction_vector (-1, -1, 1)從源碼 viewport.py 的 DXF 屬性定義看view_direction_vector組碼 163D 點默認值為Z_AXIS即(0, 0, 1)對應俯視view_target_point組碼 173D 點默認值為NULLVEC(0, 0, 0)。get_view_direction()方法會返回歸一化的視角向量is_top_view屬性判斷是否仍為俯視與 Z 軸接近即為俯視見 viewport.py。示例中設置view_target_point(40, 40, 0)、view_direction_vector(-1, -1, 1)后視口將以斜向 45° 視角展示 3D 網格即Viewport to 3D Mesh視圖。注意get_transformation_matrix()模型空間到圖紙空間變換矩陣目前僅支持俯視視口見 viewport.py 注釋。視口邊框Viewport Frame用圖層控制顯隱VIEWPORT 的邊框線borderlines默認顯示在圖紙空間中但VIEWPORT 實體本身沒有控制邊框顯隱的屬性。邊框的可見性由分配給 VIEWPORT 實體的圖層控制——在 ezdxf 中默認圖層是 VIEWPORTS源碼見 layout.py 的layer: VIEWPORTS注釋use separated layer to turn off for plotting。關閉該圖層即可隱藏該圖層上所有 VIEWPORT 實體的邊框但圖層 VIEWPORTS 需要由庫的使用者自行創(chuàng)建vp_layer doc.layers.add(VIEWPORTS) vp_layer.off()示例 viewports_in_paperspace.py 中的寫法更穩(wěn)健先檢查圖層是否存在不存在才創(chuàng)建然后統(tǒng)一關閉if VIEWPORTS not in doc.layers: vp_layer doc.layers.add(VIEWPORTS) else: vp_layer doc.layers.get(VIEWPORTS) vp_layer.off()源碼注釋還指出VIEWPORT 圖層不是固定的可以通過add_viewport(..., dxfattribs{layer: MyViewportLayer})指定自定義視口圖層。凍結圖層Freeze Layers每個視口獨立控制可見性每個 VIEWPORT 可以有獨立的凍結圖層凍結的圖層在該視口內不可見。要凍結視口中的圖層只需把凍結圖層名稱以列表list-like 對象形式賦值給 VIEWPORT 實體的frozen_layers屬性vp.frozen_layers [Layer0, Layer1]從源碼 viewport.py 看frozen_layers是列表屬性并配套提供了更精細的操作方法freeze(layer_name)凍結指定圖層thaw(layer_name)解凍指定圖層is_frozen(layer_name)查詢指定圖層是否已凍結。圖層名比較通過validator.make_table_key()統(tǒng)一鍵化因此大小寫不敏感與所有表名規(guī)則一致。重要關于不存在的圖層名原教程特別提示AutoCAD 和 BricsCAD 不會因圖層名沒有對應的圖層表條目而崩潰且圖層名稱與所有表名一樣不區(qū)分大小寫。源碼 viewport.py 的post_load_hook印證了這一點讀取文件時凍結圖層以句柄形式存儲組碼 331加載后通過實體數(shù)據(jù)庫把句柄解析回圖層名遇到不存在的圖層KeyError會被靜默忽略pass不會報錯。覆蓋圖層屬性Override Layer Properties逐視口的圖層樣式覆蓋每個 VIEWPORT 可以單獨覆蓋圖層屬性。這些覆蓋存儲在Layer實體中并通過 VIEWPORT 的句柄handle引用。該流程略為復雜示例文件 viewports_override_layer_attributes.py 有完整演示核心四步獲取Layer對象從圖層獲取LayerOverrides對象覆蓋該 VIEWPORT 的屬性提交更改。layer doc.layers.get(Layer0) override layer.get_vp_overrides() override.set_linetype(vp.dxf.handle, DASHED) override.commit()LayerOverrides 源碼級解析LayerOverrides類定義于 layer.py通過Layer.get_vp_overrides()見 layer.py獲取。支持的屬性覆蓋包括ACI 顏色set_color(vp_handle, value)僅接受合法的圖層顏色索引真彩色set_rgb(vp_handle, value)RGB 三元組傳None可移除真彩色設置透明度set_transparency(vp_handle, value)0.0 完全不透明1.0 完全透明線型set_linetype(vp_handle, value)要求該線型存在于 LTYPE 表中否則拋出ValueError線寬set_lineweight(vp_handle, value)要求是合法的圖層線寬值對應的方法均有配套的get_*()讀取方法。關鍵點是 layer.py 中commit()的注釋Without a commit() all changes are lost!不調用 commit() 所有更改都會丟失——覆蓋數(shù)據(jù)在內存中累積只有commit()才會真正寫回Layer實體的擴展數(shù)據(jù)。此外還有has_overrides()查詢某視口是否存在覆蓋和discard(vp_handleNone)丟棄指定視口或全部視口的覆蓋。示例腳本 viewports_override_layer_attributes.py 分別演示了override_aci逐視口設置 ACI 色、override_rgb逐視口設置 RGB 真彩色、override_ltype逐視口設置線型如 DASHED2/DOT2和override_lw逐視口設置線寬如 13-140 等標準線寬值四種覆蓋方式并把$LWDISPLAY頭部變量置 1 以便在 DXF 查看器中顯示線寬。倉庫中還有對應的單元測試 test_141_layer_vp_override.py 可作參考。完整運行示例與配套工具把上述所有元素組合起來運行 viewports_in_paperspace.pypython examples/viewports_in_paperspace.py腳本的main()會依次為 R12、R2000、R2007 三個版本生成viewports_in_paperspace_{dxfversion}.dxf文件默認輸出到~/Desktop/Outbox目錄不存在時輸出到當前目錄。R2000/R2007 文件中包含矩形1:2、圓1:5、三角形1:1、總覽視圖1:1、1:50 微縮視口以及 3D 網格斜視角視口等多個視口。需要一提的是示例最后調用了 document.py 的set_modelspace_vport(height, center)方法如 viewports_override_layer_attributes.py 中的doc.set_modelspace_vport(60, (50, 30))它用于設置 CAD 應用打開文件時模型空間的初始視圖/縮放位置替換當前的*Active視口配置并重置坐標系為 WCS——這是讓用戶打開文件后直接看到目標內容的實用技巧。小結本文完整覆蓋了 ezdxf 圖紙空間視口布局的六大技術要點頁面設置page_setup()及輔助的Drawing.page_setup()定義紙張尺寸、邊距、單位、旋轉與比例注意margins為(上, 右, 下, 左)順時針順序圖紙空間繪圖原點在畫布左下角畫布 紙張 ? 邊距R12 請改用page_setup_r12()添加視口add_viewport(center, size, view_center_point, view_height, status)默認圖層 VIEWPORTS縮放比例視口高度 / view_height源碼get_scale()直接印證相等即 1:1方向與邊框默認俯視通過view_target_point/view_direction_vector改變視角通過關閉 VIEWPORTS 圖層隱藏邊框圖層凍結與屬性覆蓋frozen_layers逐視口凍結圖層LayerOverrides逐視口覆蓋 ACI 顏色、真彩色、透明度、線型與線寬記得調用commit()。若需在實戰(zhàn)中進一步驗證視口實體的序列化與縮放行為可閱讀測試文件 test_211_viewport.py含 R12 與 R2000 的 VIEWPORT 實體讀寫測試以及圖層概念的官方文檔 layers.rst。贊分享圖形學【免費下載鏈接】ezdxfPython interface to DXF項目地址https://gitcode.com/gh_mirrors/ez/ezdxf點擊查看免費下載相關推薦ezdxf Paperspace 布局實戰(zhàn)頁面設置、視口Viewport與打印出圖完整指南ezdxf Paperspace 布局實戰(zhàn)頁面設置、視口Viewport與打印出圖完整指南 導讀 Paperspace圖紙空間是 ezdxf 中組織模圖形學ezdxf 圖層表內部結構與視口圖層屬性覆蓋機制深度解析ezdxf 圖層表內部結構與視口圖層屬性覆蓋機制深度解析 本文基于 ezdxf 倉庫的 圖層表內部結構文檔 https://link.gitcode.com/i圖形學ezdxf VIEWPORT 實體完全指南布局空間視口的創(chuàng)建、屬性體系與源碼級原理解析ezdxf VIEWPORT 實體完全指南布局空間視口的創(chuàng)建、屬性體系與源碼級原理解析 導讀 本文以 docs/source/dxfentities/view圖形學上一篇umy-ui高性能表格組件庫深度使用指南下一篇claude-code-best-practice工作流設計提升團隊協(xié)作效率的6個關鍵策略創(chuàng)作聲明：本文部分內容由AI輔助生成（AIGC），僅供參考 ezdxf 圖紙空間（Paperspace）視口（VIEWPORT）完全指南：頁面設置、縮放比例、圖層凍結與屬性覆蓋
圖形學【免費下載鏈接】ezdxfPython interface to DXF項目地址https://gitcode.com/gh_mirrors/ez/ezdxf點擊查看免費下載本文以 ezdxf 官方教程 psp_viewports.rst 為骨架結合倉庫內示例腳本與源碼實現(xiàn)系統(tǒng)講解在圖紙空間Paperspace布局中創(chuàng)建和管理 VIEWPORT 視口的完整流程從頁面設置page_setup、視口添加與縮放比例計算到視口方向調整、圖層凍結與逐視口圖層屬性覆蓋。讀完本文你將掌握用 ezdxf 為 R2000 版本 DXF 文件制作多視口圖紙布局的完整實戰(zhàn)方案并能理解底層 DXF 數(shù)據(jù)的存儲原理。教程背景與核心示例腳本本教程基于示例腳本 viewports_in_paperspace.py 展開。該腳本會為 DXF R12 與 R2000 版本各生成一個圖紙文件其模型空間內容包含三個位于 WCS世界坐標系XY 平面內的平面幾何圖形一個紅色矩形、一個綠色圓、一個青色三角形均由 create_2d_modelspace_content 創(chuàng)建一個 20×20 網格、由正弦/余弦函數(shù)生成起伏曲面的 3D 網格由 create_3d_modelspace_content 創(chuàng)建高度為 3.0范圍 30×30。模型空間內容如下圖所示圖片路徑gfx/vp-tut-msp-content.png重要為什么建議使用 R2000 版本原教程給出了一個重要警告如果需要在圖紙空間布局中使用頁面尺寸請使用 DXF R2000 或更高版本因為 DXF R12 的頁面尺寸導出無法正常工作作者在 BricsCAD 中發(fā)現(xiàn) R12 導出的圖紙尺寸錯誤在 Autodesk DWG Trueview 中發(fā)現(xiàn)邊距錯誤且未找到原因也未修復。這是圖紙空間布局在 DXF 版本支持上的一個硬性邊界實戰(zhàn)中務必注意。頁面設置Page Setup定義紙張本身DXF 參考手冊中關于圖紙空間布局特性的文檔非常匱乏關于如何使用幾乎沒有任何實踐說明因此本教程中大部分信息是作者通過反復試錯總結出來的假設。Paperspace類的page_setup()方法定義了紙張本身的屬性。模型空間和圖紙空間的單位互不相關甚至可以使用不同的單位制英制、米制但為了簡單起見官方建議兩個空間使用相同的單位系統(tǒng)layout.page_setup(size(24, 18), margins(1, 1, 1, 1), unitsinch)page_setup 完整參數(shù)簽名從源碼 layout.py 可以看到page_setup()的完整簽名與默認值def page_setup( self, size: tuple[float, float] (297, 210), # 紙張尺寸 (寬, 高) margins: tuple[float, float, float, float] (0, 0, 0, 0), # (上, 右, 下, 左)注意是順時針順序 units: str mm, # mm 或 inch offset: tuple[float, float] (0, 0), # 繪圖原點偏移2D 點 rotation: int 0, # 旋轉取值 0-3 scale: Union[int, tuple[float, float]] 16, # 標準比例類型索引或 (分子, 分母) 元組 name: str ezdxf, # 紙張名稱前綴 device: str DWG to PDF.pc3, # 設備 .pc3 配置文件或系統(tǒng)打印機名 ) - None:各參數(shù)要點size定義旋轉模式 0 下紙張的整體尺寸。最佳實踐是先在橫向landscape模式下定義紙張范圍之后再通過rotate參數(shù)旋轉紙張。margins四元組順序為(top, right, bottom, left)順時針。內部會按unit_factor轉換為毫米存儲英寸換算系數(shù)為 25.4。units僅支持mm和inch大小寫不敏感源碼中units.startswith(inch)判定其他值會拋出DXFValueError。rotation取值表源碼與教程一致取值含義0不旋轉1逆時針旋轉 90 度2上下顛倒180 度3順時針旋轉 90 度源碼 layout.py 中會對rotation做校驗非 0-3 的值拋出DXFValueError(valid rotation values: 0-3)。scale反映圖紙空間paperspace中紙張單位與繪圖單位之間的關系?？梢詡髡麛?shù)0-32 范圍內的標準比例類型索引映射關系在const.STD_SCALES中也可以傳(分子, 分母)元組例如(1, 50)表示 1:50。教程建議保持默認 1:1并在圖紙空間中用與紙張尺寸相同的單位繪制線條和文字。注意分子或分母為 0 會拋出DXFValueError。page_setup 寫入了哪些 DXF 數(shù)據(jù)源碼顯示page_setup()會設置 PLOTSETTINGS 頭部的多項屬性并把紙張名稱規(guī)范化為{name}_({width:.2f}_x_{height:.2f}_{units})格式如ezdxf_(24.00_x_18.00_Inches)同時寫入plot_configuration_file、四邊*_margin、paper_width/paper_height統(tǒng)一換算為毫米、scale_numerator/scale_denominator、plot_paper_units0 表示 Inches1 表示 MM、plot_rotation、繪圖原點偏移等最后調用reset_paper_limits()、reset_extents()、reset_viewports()重置紙張極限、范圍和視口。更簡單的頁面設置Drawing.page_setup原教程作者在寫作過程中注意到更換打印機/繪圖儀和紙張尺寸會導致布局內容移位因為所有紙張尺寸都是在沒有邊距的情況下定義的也許最好把所有邊距設為零。為此作者在Drawing類上添加了輔助方法page_setup()并提供了示例 simple_page_setup.py 演示用法。Drawing.page_setup()位于 document.py簽名如下def page_setup( self, name: str Layout1, # 圖紙空間布局名稱 fmt: str ISO A3, # 紙張格式 landscapeTrue, # True 橫向False 縱向 ) - Paperspace:該方法要求 DXF R2000 或更新版本。fmt支持的紙張格式尺寸均為橫向度量值名稱單位寬高ISO A0mm1189841ISO A1mm841594ISO A2mm594420ISO A3mm420297ISO A4mm297210ANSI Ainch118.5ANSI Binch1711ANSI Cinch2217ANSI Dinch3422ANSI Einch4434ARCH Cinch2418ARCH Dinch3624ARCH Einch4836ARCH E1inch4230Letterinch118.5Legalinch148.5該布局使用紙張格式對應的單位作為繪圖單位無邊距、無偏移、圖紙空間比例為 1:1因此更換輸出設備非常容易至少在 BricsCAD 中如此。示例腳本中還提醒無邊距布局的繪圖空間是整個紙張但打印機/繪圖儀不會打印到紙張邊緣真實文件中應始終在紙張邊緣與內容之間保留安全空間且該安全空間的大小因設備而異、無法預知建議結合psp.dxf.paper_width和psp.dxf.paper_height自行設計。在圖紙空間中繪圖你可以像在任意布局空間一樣向圖紙空間添加 DXF 實體。坐標系原點(0, 0)位于畫布canvas的左下角畫布范圍等于紙張尺寸減去邊距。你可以繪制超出該范圍的內容但 CAD 應用程序可能不會打印這些內容。在 viewports_in_paperspace.py 中作者按此規(guī)則做了如下計算并繪制邊框layout: Paperspace doc.layout(Layout1) # Arch C 18 x 24 in width, height 24, 18 m 1 layout.page_setup(size(width, height), margins(m, m, m, m), unitsinch) # 畫布由紙張尺寸減去邊距定義 canvas_width width - 2 * m # 22 canvas_height height - 2 * m # 16 # 畫布左下角坐標為 0, 0關于 R12 的特殊處理示例腳本同時支持 R12 導出但 R12 走的是另一條路徑page_setup_r12()見 layout.py。該方法會先刪除所有已存在的視口然后通過頭部變量$PLIMMIN、$PLIMMAX、$PEXTMIN、$PEXTMAX設置打印范圍并縮放邊距與紙張尺寸源碼中有 TODO 注釋不知道如何在 R12 中設置 inch/mm 模式。同時注意DXF R12 只支持一個圖紙空間即一個布局任何布局名稱都返回同一個布局見 viewports_in_paperspace.py 的注釋。添加視口Adding ViewportsViewportDXF VIEWPORT實體是一個指向模型空間的窗口用于在圖紙空間中按任意縮放比例和旋轉角度顯示模型空間的內容。VIEWPORT 實體通過工廠方法Paperspace.add_viewport()添加。從源碼 layout.py 可以看到其完整簽名def add_viewport( self, center: UVec, # 視口在圖紙空間中的中心點 size: tuple[float, float], # 視口在圖紙空間中的 (寬, 高) view_center_point: UVec, # 要顯示的模型空間區(qū)域中心點 view_height: float, # 模型空間中要顯示的區(qū)域高度 status: int 2, # 視口狀態(tài)默認 2 dxfattribsNone, # 附加 DXF 屬性 ) - Viewport:關鍵點center定義視口在圖紙空間中的中心位置size定義 VIEWPORT 在圖紙空間中的寬度和高度要顯示的模型空間內容由view_center_point和view_height定義默認圖層為 VIEWPORTS源碼中attribs字典明確寫了layer: VIEWPORTS用于后續(xù)控制視口邊框顯隱status語義源碼注釋-1表示開啟但在屏幕外或因為$MAXACTVP計數(shù)超出而非激活0表示關閉任何大于 0 的值表示開啟且激活其中1是活動視口2是下一個以此類推dxf.id由get_next_viewport_id()自動分配從 2 開始遞增源碼 layout.py。添加視口后的圖紙空間布局如下圖所示圖片路徑gfx/vp-tut-psp-content.png縮放比例Scaling Factor由尺寸與視高的比值決定VIEWPORT 的縮放因子不是一個顯式的數(shù)值而是由size參數(shù)中的 VIEWPORT 高度與view_height參數(shù)的比值關系決定的。源碼 viewport.py 中的get_scale()方法印證了這一計算方式def get_scale(self) - float: Returns the scaling factor from modelspace to viewport. msp_height self.dxf.view_height if abs(msp_height) 1e-12: return 0.0 vp_height self.dxf.height return vp_height / msp_height # 視口高度 / 模型空間視高當兩個值相等時縮放比例為 1:1paperspace.add_viewport( center(14.5, 2.5), size(5, 5), view_center_point(12.5, 7.5), view_height5, )當view_height比 VIEWPORT 高度大 5 倍時縮放比例為 1:5paperspace.add_viewport( center(8.5, 2.5), size(5, 5), view_center_point(10, 5), view_height25, )原示例 viewports_in_paperspace.py 中還演示了更多比例組合view_height10、視口高5得到 1:2矩形視圖size(0.3, 0.15)、view_height7.5得到 1:50縮放比例 7.5 / 0.15 50并在每個視口下方用add_text()標注了比例文字形成規(guī)范的平面圖 局部放大圖圖紙布局。另外可參考 viewport.py 的get_aspect_ratio()返回width / height與 viewport.py 的get_modelspace_limits()返回模型空間中可見范圍的(min_x, min_y, max_x, max_y)這兩個輔助方法可用于進一步驗證視口覆蓋的模型空間區(qū)域。視口方向View Direction從俯視到任意視角VIEWPORT 的默認視角是俯視top down view即沿 Z 軸向下看但可以通過dxf命名空間中的view_target_point和view_direction_vector屬性更改為任意視角vp paperspace.add_viewport( center(16, 10), size(4, 4), view_center_point(0, 0), view_height30 ) vp.dxf.view_target_point (40, 40, 0) vp.dxf.view_direction_vector (-1, -1, 1)從源碼 viewport.py 的 DXF 屬性定義看view_direction_vector組碼 163D 點默認值為Z_AXIS即(0, 0, 1)對應俯視view_target_point組碼 173D 點默認值為NULLVEC(0, 0, 0)。get_view_direction()方法會返回歸一化的視角向量is_top_view屬性判斷是否仍為俯視與 Z 軸接近即為俯視見 viewport.py。示例中設置view_target_point(40, 40, 0)、view_direction_vector(-1, -1, 1)后視口將以斜向 45° 視角展示 3D 網格即Viewport to 3D Mesh視圖。注意get_transformation_matrix()模型空間到圖紙空間變換矩陣目前僅支持俯視視口見 viewport.py 注釋。視口邊框Viewport Frame用圖層控制顯隱VIEWPORT 的邊框線borderlines默認顯示在圖紙空間中但VIEWPORT 實體本身沒有控制邊框顯隱的屬性。邊框的可見性由分配給 VIEWPORT 實體的圖層控制——在 ezdxf 中默認圖層是 VIEWPORTS源碼見 layout.py 的layer: VIEWPORTS注釋use separated layer to turn off for plotting。關閉該圖層即可隱藏該圖層上所有 VIEWPORT 實體的邊框但圖層 VIEWPORTS 需要由庫的使用者自行創(chuàng)建vp_layer doc.layers.add(VIEWPORTS) vp_layer.off()示例 viewports_in_paperspace.py 中的寫法更穩(wěn)健先檢查圖層是否存在不存在才創(chuàng)建然后統(tǒng)一關閉if VIEWPORTS not in doc.layers: vp_layer doc.layers.add(VIEWPORTS) else: vp_layer doc.layers.get(VIEWPORTS) vp_layer.off()源碼注釋還指出VIEWPORT 圖層不是固定的可以通過add_viewport(..., dxfattribs{layer: MyViewportLayer})指定自定義視口圖層。凍結圖層Freeze Layers每個視口獨立控制可見性每個 VIEWPORT 可以有獨立的凍結圖層凍結的圖層在該視口內不可見。要凍結視口中的圖層只需把凍結圖層名稱以列表list-like 對象形式賦值給 VIEWPORT 實體的frozen_layers屬性vp.frozen_layers [Layer0, Layer1]從源碼 viewport.py 看frozen_layers是列表屬性并配套提供了更精細的操作方法freeze(layer_name)凍結指定圖層thaw(layer_name)解凍指定圖層is_frozen(layer_name)查詢指定圖層是否已凍結。圖層名比較通過validator.make_table_key()統(tǒng)一鍵化因此大小寫不敏感與所有表名規(guī)則一致。重要關于不存在的圖層名原教程特別提示AutoCAD 和 BricsCAD 不會因圖層名沒有對應的圖層表條目而崩潰且圖層名稱與所有表名一樣不區(qū)分大小寫。源碼 viewport.py 的post_load_hook印證了這一點讀取文件時凍結圖層以句柄形式存儲組碼 331加載后通過實體數(shù)據(jù)庫把句柄解析回圖層名遇到不存在的圖層KeyError會被靜默忽略pass不會報錯。覆蓋圖層屬性Override Layer Properties逐視口的圖層樣式覆蓋每個 VIEWPORT 可以單獨覆蓋圖層屬性。這些覆蓋存儲在Layer實體中并通過 VIEWPORT 的句柄handle引用。該流程略為復雜示例文件 viewports_override_layer_attributes.py 有完整演示核心四步獲取Layer對象從圖層獲取LayerOverrides對象覆蓋該 VIEWPORT 的屬性提交更改。layer doc.layers.get(Layer0) override layer.get_vp_overrides() override.set_linetype(vp.dxf.handle, DASHED) override.commit()LayerOverrides 源碼級解析LayerOverrides類定義于 layer.py通過Layer.get_vp_overrides()見 layer.py獲取。支持的屬性覆蓋包括ACI 顏色set_color(vp_handle, value)僅接受合法的圖層顏色索引真彩色set_rgb(vp_handle, value)RGB 三元組傳None可移除真彩色設置透明度set_transparency(vp_handle, value)0.0 完全不透明1.0 完全透明線型set_linetype(vp_handle, value)要求該線型存在于 LTYPE 表中否則拋出ValueError線寬set_lineweight(vp_handle, value)要求是合法的圖層線寬值對應的方法均有配套的get_*()讀取方法。關鍵點是 layer.py 中commit()的注釋Without a commit() all changes are lost!不調用 commit() 所有更改都會丟失——覆蓋數(shù)據(jù)在內存中累積只有commit()才會真正寫回Layer實體的擴展數(shù)據(jù)。此外還有has_overrides()查詢某視口是否存在覆蓋和discard(vp_handleNone)丟棄指定視口或全部視口的覆蓋。示例腳本 viewports_override_layer_attributes.py 分別演示了override_aci逐視口設置 ACI 色、override_rgb逐視口設置 RGB 真彩色、override_ltype逐視口設置線型如 DASHED2/DOT2和override_lw逐視口設置線寬如 13-140 等標準線寬值四種覆蓋方式并把$LWDISPLAY頭部變量置 1 以便在 DXF 查看器中顯示線寬。倉庫中還有對應的單元測試 test_141_layer_vp_override.py 可作參考。完整運行示例與配套工具把上述所有元素組合起來運行 viewports_in_paperspace.pypython examples/viewports_in_paperspace.py腳本的main()會依次為 R12、R2000、R2007 三個版本生成viewports_in_paperspace_{dxfversion}.dxf文件默認輸出到~/Desktop/Outbox目錄不存在時輸出到當前目錄。R2000/R2007 文件中包含矩形1:2、圓1:5、三角形1:1、總覽視圖1:1、1:50 微縮視口以及 3D 網格斜視角視口等多個視口。需要一提的是示例最后調用了 document.py 的set_modelspace_vport(height, center)方法如 viewports_override_layer_attributes.py 中的doc.set_modelspace_vport(60, (50, 30))它用于設置 CAD 應用打開文件時模型空間的初始視圖/縮放位置替換當前的*Active視口配置并重置坐標系為 WCS——這是讓用戶打開文件后直接看到目標內容的實用技巧。小結本文完整覆蓋了 ezdxf 圖紙空間視口布局的六大技術要點頁面設置page_setup()及輔助的Drawing.page_setup()定義紙張尺寸、邊距、單位、旋轉與比例注意margins為(上, 右, 下, 左)順時針順序圖紙空間繪圖原點在畫布左下角畫布 紙張 ? 邊距R12 請改用page_setup_r12()添加視口add_viewport(center, size, view_center_point, view_height, status)默認圖層 VIEWPORTS縮放比例視口高度 / view_height源碼get_scale()直接印證相等即 1:1方向與邊框默認俯視通過view_target_point/view_direction_vector改變視角通過關閉 VIEWPORTS 圖層隱藏邊框圖層凍結與屬性覆蓋frozen_layers逐視口凍結圖層LayerOverrides逐視口覆蓋 ACI 顏色、真彩色、透明度、線型與線寬記得調用commit()。若需在實戰(zhàn)中進一步驗證視口實體的序列化與縮放行為可閱讀測試文件 test_211_viewport.py含 R12 與 R2000 的 VIEWPORT 實體讀寫測試以及圖層概念的官方文檔 layers.rst。贊分享圖形學【免費下載鏈接】ezdxfPython interface to DXF項目地址https://gitcode.com/gh_mirrors/ez/ezdxf點擊查看免費下載相關推薦ezdxf Paperspace 布局實戰(zhàn)頁面設置、視口Viewport與打印出圖完整指南ezdxf Paperspace 布局實戰(zhàn)頁面設置、視口Viewport與打印出圖完整指南 導讀 Paperspace圖紙空間是 ezdxf 中組織模圖形學ezdxf 圖層表內部結構與視口圖層屬性覆蓋機制深度解析ezdxf 圖層表內部結構與視口圖層屬性覆蓋機制深度解析 本文基于 ezdxf 倉庫的 圖層表內部結構文檔 https://link.gitcode.com/i圖形學ezdxf VIEWPORT 實體完全指南布局空間視口的創(chuàng)建、屬性體系與源碼級原理解析ezdxf VIEWPORT 實體完全指南布局空間視口的創(chuàng)建、屬性體系與源碼級原理解析 導讀 本文以 docs/source/dxfentities/view圖形學上一篇umy-ui高性能表格組件庫深度使用指南下一篇claude-code-best-practice工作流設計提升團隊協(xié)作效率的6個關鍵策略創(chuàng)作聲明：本文部分內容由AI輔助生成（AIGC），僅供參考