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