Skip to content

pyplot.insert_section

fabian-flassig edited this page Mar 30, 2026 · 1 revision

Inserts one or more plotted section details on one or more sheets.

pyplot.insert_section(sheet, section [, options])
Parameter Type Description
sheet element_handle or { element_handle* } Element handle to one or more plot sheets
section element_handle A section handle created with pytha.create_section
options table (optional) Placement and appearance options

Return value

Type Description
{ element_handle* } A table containing the created detail handles

options table

Property Type Description
position {number, number} Section detail center on the sheet
size {number, number} Requested section detail size on the sheet
angle number Rotation angle of the plotted section on the sheet
scale number Explicit plot scale
layer_visible table Table mapping layer numbers to true or false
graphic_flags { string* } Display flags such as "edges", "solid", "hidden_edges", "hatching", "hatching_islands", "shaded", "material", "shadow"

Example:

local plotted = pyplot.insert_section(sheet, section, {
    position = {120, 90},
    size = {140, 80},
    graphic_flags = {"edges", "shaded"}
})

Remarks:

The function creates one plotted section detail on each target sheet.

If scale is omitted, a fitting scale is computed from the section bounding box and the requested size.

If no explicit graphic_flags are given, a default combination of edges, shaded and solid display is used.

The return value is a table containing the created plot detail handles.

Version Support:

Minimum PYTHA Version: V26

See also:

pytha.create_section, pyplot.insert_detail

Clone this wiki locally