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