Skip to content

File Controller

clear_errors()

clear errors

Returns:

Type Description
None

None

Source code in src/file_controller/__init__.pyi
162
163
164
165
166
167
def clear_errors() -> None:
    """clear errors

    Returns:
        None
    """

export_3d_file(element_id_list, file_path)

Exports a 3D file

Parameters:

Name Type Description Default
element_id_list List[int]

element_id_list

required
file_path str

file_path

required

Returns:

Type Description
bool

did operation succeed

Source code in src/file_controller/__init__.pyi
59
60
61
62
63
64
65
66
67
68
def export_3d_file(element_id_list: List[int], file_path: str) -> bool:
    """Exports a 3D file

    Parameters:
        element_id_list: element_id_list
        file_path: file_path

    Returns:
        did operation succeed
    """

export_3dc_file(element_id_list, file_path)

Exports a 3D file

Parameters:

Name Type Description Default
element_id_list List[int]

element_id_list

required
file_path str

file_path

required

Returns:

Type Description
None

None

Source code in src/file_controller/__init__.pyi
189
190
191
192
193
194
195
196
197
198
def export_3dc_file(element_id_list: List[int], file_path: str) -> None:
    """Exports a 3D file

    Parameters:
        element_id_list: element_id_list
        file_path: file_path

    Returns:
        None
    """

export_btl_file_for_nesting(file_path)

Exports a BTL file for nesting

Parameters:

Name Type Description Default
file_path str

file_path

required

Returns:

Type Description
None

None

Source code in src/file_controller/__init__.pyi
210
211
212
213
214
215
216
217
218
def export_btl_file_for_nesting(file_path: str) -> None:
    """Exports a BTL file for nesting

    Parameters:
        file_path: file_path

    Returns:
        None
    """

export_fbx_file(elements, file_path, fbx_format)

Exports a FBX file

Parameters:

Name Type Description Default
elements List[int]

elements

required
file_path str

file_path

required
fbx_format int

fbx_format

required

Returns:

Type Description
None

None

Source code in src/file_controller/__init__.pyi
150
151
152
153
154
155
156
157
158
159
160
def export_fbx_file(elements: List[int], file_path: str, fbx_format: int) -> None:
    """Exports a FBX file

    Parameters:
        elements: elements
        file_path: file_path
        fbx_format: fbx_format

    Returns:
        None
    """

export_glb_file(elements, file_path)

exports a GLB File

Parameters:

Name Type Description Default
elements List[int]

elements

required
file_path str

file_path

required

Returns:

Type Description
None

None

Source code in src/file_controller/__init__.pyi
276
277
278
279
280
281
282
283
284
285
def export_glb_file(elements: List[int], file_path: str) -> None:
    """exports a GLB File

    Parameters:
        elements: elements
        file_path: file_path

    Returns:
        None
    """

export_obj_file(elements, file_path)

Exports a OBJ file

Parameters:

Name Type Description Default
elements List[int]

elements

required
file_path str

file_path

required

Returns:

Type Description
None

None

Source code in src/file_controller/__init__.pyi
127
128
129
130
131
132
133
134
135
136
def export_obj_file(elements: List[int], file_path: str) -> None:
    """Exports a OBJ file

    Parameters:
        elements: elements
        file_path: file_path

    Returns:
        None
    """

export_rhino_file(element_id_list, file_path, version, use_default_assignment, write_standard_attributes)

Exports a 3dm rhino file

Parameters:

Name Type Description Default
element_id_list List[int]

element_id_list

required
file_path str

file_path

required
version int

version

required
use_default_assignment bool

use_default_assignment

required
write_standard_attributes bool

write_standard_attributes

required

Returns:

Type Description
None

None

Source code in src/file_controller/__init__.pyi
220
221
222
223
224
225
226
227
228
229
230
231
232
def export_rhino_file(element_id_list: List[int], file_path: str, version: int, use_default_assignment: bool, write_standard_attributes: bool) -> None:
    """Exports a 3dm rhino file

    Parameters:
        element_id_list: element_id_list
        file_path: file_path
        version: version
        use_default_assignment: use_default_assignment
        write_standard_attributes: write_standard_attributes

    Returns:
        None
    """

export_rhino_file_with_options(element_id_list, file_path, version, use_default_assignment, write_standard_attributes, rhino_options)

exports elements to a rhino 3dm file based on the export options

Parameters:

Name Type Description Default
element_id_list List[int]

element_id_list

required
file_path str

file_path

required
version int

version

required
use_default_assignment bool

use_default_assignment

required
write_standard_attributes bool

write_standard_attributes

required
rhino_options None

rhino_options

required

Returns:

Type Description
None

None

Source code in src/file_controller/__init__.pyi
309
310
311
312
313
314
315
316
317
318
319
320
321
322
def export_rhino_file_with_options(element_id_list: List[int], file_path: str, version: int, use_default_assignment: bool, write_standard_attributes: bool, rhino_options: None) -> None:
    """exports elements to a rhino 3dm file based on the export options

    Parameters:
        element_id_list: element_id_list
        file_path: file_path
        version: version
        use_default_assignment: use_default_assignment
        write_standard_attributes: write_standard_attributes
        rhino_options: rhino_options

    Returns:
        None
    """

export_sat_file(elements, file_path, scale_factor, binary, version)

exports a SAT File

Parameters:

Name Type Description Default
elements List[int]

elements

required
file_path str

file_path

required
scale_factor float

scale_factor

required
binary bool

binary

required
version int

version

required

Returns:

Type Description
None

None

Source code in src/file_controller/__init__.pyi
262
263
264
265
266
267
268
269
270
271
272
273
274
def export_sat_file(elements: List[int], file_path: str, scale_factor: float, binary: bool, version: int) -> None:
    """exports a SAT File

    Parameters:
        elements: elements
        file_path: file_path
        scale_factor: scale_factor
        binary: binary
        version: version

    Returns:
        None
    """

export_step_file(element_list, file_path, scale_factor, version, text_mode)

Exports a STEP file

Parameters:

Name Type Description Default
element_list List[int]

element_list

required
file_path str

file_path

required
scale_factor float

scale_factor

required
version int

version

required
text_mode bool

text_mode

required

Returns:

Type Description
None

None

Source code in src/file_controller/__init__.pyi
103
104
105
106
107
108
109
110
111
112
113
114
115
def export_step_file(element_list: List[int], file_path: str, scale_factor: float, version: int, text_mode: bool) -> None:
    """Exports a STEP file

    Parameters:
        element_list: element_list
        file_path: file_path
        scale_factor: scale_factor
        version: version
        text_mode: text_mode

    Returns:
        None
    """

export_step_file_extrude_drillings(elements, file_path, scale_factor, version, text_mode, imperial_units)

Exports a STEP file with extruded drillings

Parameters:

Name Type Description Default
elements List[int]

elements

required
file_path str

file_path

required
scale_factor float

scale_factor

required
version int

version

required
text_mode bool

text_mode

required
imperial_units bool

imperial_units

required

Returns:

Type Description
None

None

Source code in src/file_controller/__init__.pyi
352
353
354
355
356
357
358
359
360
361
362
363
364
365
def export_step_file_extrude_drillings(elements: List[int], file_path: str, scale_factor: float, version: int, text_mode: bool, imperial_units: bool) -> None:
    """Exports a STEP file with extruded drillings

    Parameters:
        elements: elements
        file_path: file_path
        scale_factor: scale_factor
        version: version
        text_mode: text_mode
        imperial_units: imperial_units

    Returns:
        None
    """

export_stl_file(element_id_list, file_path)

Exports an STL file

Parameters:

Name Type Description Default
element_id_list List[int]

element_id_list

required
file_path str

file_path

required

Returns:

Type Description
None

None

Source code in src/file_controller/__init__.pyi
14
15
16
17
18
19
20
21
22
23
def export_stl_file(element_id_list: List[int], file_path: str) -> None:
    """Exports an STL file

    Parameters:
        element_id_list: element_id_list
        file_path: file_path

    Returns:
        None
    """

export_webgl(element_id_list, file_path)

Exports a WebGL file

Parameters:

Name Type Description Default
element_id_list List[int]

element_id_list

required
file_path str

file_path

required

Returns:

Type Description
bool

did operation succeed

Source code in src/file_controller/__init__.pyi
48
49
50
51
52
53
54
55
56
57
def export_webgl(element_id_list: List[int], file_path: str) -> bool:
    """Exports a WebGL file

    Parameters:
        element_id_list: element_id_list
        file_path: file_path

    Returns:
        did operation succeed
    """

get_blum_export_path()

get blum export path

Returns:

Type Description
str

str

Source code in src/file_controller/__init__.pyi
245
246
247
248
249
250
def get_blum_export_path() -> str:
    """get blum export path

    Returns:
        str
    """

get_import_3dc_options()

get import 3dc options

Returns:

Type Description
import_3dc_options

import_3dc_options

Source code in src/file_controller/__init__.pyi
335
336
337
338
339
340
def get_import_3dc_options() -> import_3dc_options:
    """get import 3dc options

    Returns:
        import_3dc_options
    """

get_last_error(error_code)

Gets the last error

Parameters:

Name Type Description Default
error_code int

error_code

required

Returns:

Type Description
str

error string

Source code in src/file_controller/__init__.pyi
 4
 5
 6
 7
 8
 9
10
11
12
def get_last_error(error_code: int) -> str:
    """Gets the last error

    Parameters:
        error_code: error_code

    Returns:
        error string
    """

import_3dc_file(file_path)

Imports a 3DC file

Parameters:

Name Type Description Default
file_path str

file_path

required

Returns:

Type Description
List[int]

imported element ID list

Source code in src/file_controller/__init__.pyi
82
83
84
85
86
87
88
89
90
def import_3dc_file(file_path: str) -> List[int]:
    """Imports a 3DC file

    Parameters:
        file_path: file_path

    Returns:
        imported element ID list
    """

import_3dc_file_with_glide(file_path)

Imports a 3DC file with glide

Parameters:

Name Type Description Default
file_path str

file_path

required

Returns:

Type Description
List[int]

imported element ID list

Source code in src/file_controller/__init__.pyi
169
170
171
172
173
174
175
176
177
def import_3dc_file_with_glide(file_path: str) -> List[int]:
    """Imports a 3DC file with glide

    Parameters:
        file_path: file_path

    Returns:
        imported element ID list
    """

import_3dc_file_with_options(file_path, import3dc_options)

imports a 3d or a 3dc file depending on the import options

Parameters:

Name Type Description Default
file_path str

file_path

required
import3dc_options None

import3dc_options

required

Returns:

Type Description
List[int]

imported element ID list

Source code in src/file_controller/__init__.pyi
324
325
326
327
328
329
330
331
332
333
def import_3dc_file_with_options(file_path: str, import3dc_options: None) -> List[int]:
    """imports a 3d or a 3dc file depending on the import options

    Parameters:
        file_path: file_path
        import3dc_options: import3dc_options

    Returns:
        imported element ID list
    """

import_3dz_file(file_path)

Imports a 3DZ file

Parameters:

Name Type Description Default
file_path str

file_path

required

Returns:

Type Description
None

None

Source code in src/file_controller/__init__.pyi
117
118
119
120
121
122
123
124
125
def import_3dz_file(file_path: str) -> None:
    """Imports a 3DZ file

    Parameters:
        file_path: file_path

    Returns:
        None
    """

import_btl_file(file_path)

Imports a BTL file

Parameters:

Name Type Description Default
file_path str

file_path

required

Returns:

Type Description
None

None

Source code in src/file_controller/__init__.pyi
179
180
181
182
183
184
185
186
187
def import_btl_file(file_path: str) -> None:
    """Imports a BTL file

    Parameters:
        file_path: file_path

    Returns:
        None
    """

import_btl_file_for_nesting(file_path)

Imports a BTL file for nesting

Parameters:

Name Type Description Default
file_path str

file_path

required

Returns:

Type Description
None

None

Source code in src/file_controller/__init__.pyi
200
201
202
203
204
205
206
207
208
def import_btl_file_for_nesting(file_path: str) -> None:
    """Imports a BTL file for nesting

    Parameters:
        file_path: file_path

    Returns:
        None
    """

import_bxf_file(file_path, insert_position)

import bxf file

Parameters:

Name Type Description Default
file_path str

file_path

required
insert_position point_3d

insert_position

required

Returns:

Type Description
List[int]

List[int]

Source code in src/file_controller/__init__.pyi
234
235
236
237
238
239
240
241
242
243
def import_bxf_file(file_path: str, insert_position: point_3d) -> List[int]:
    """import bxf file

    Parameters:
        file_path: file_path
        insert_position: insert_position

    Returns:
        List[int]
    """

import_element_light(a0, a1)

import element light

Parameters:

Name Type Description Default
a0 str

a0

required
a1 point_3d

a1

required

Returns:

Type Description
int

int

Source code in src/file_controller/__init__.pyi
298
299
300
301
302
303
304
305
306
307
def import_element_light(a0: str, a1: point_3d) -> int:
    """import element light

    Parameters:
        a0: a0
        a1: a1

    Returns:
        int
    """

import_rhino_file(file_path, without_dialog)

Imports a Rhino file

Parameters:

Name Type Description Default
file_path str

file_path

required
without_dialog bool

without_dialog

required

Returns:

Type Description
List[int]

imported element ID list

Source code in src/file_controller/__init__.pyi
 92
 93
 94
 95
 96
 97
 98
 99
100
101
def import_rhino_file(file_path: str, without_dialog: bool) -> List[int]:
    """Imports a Rhino file

    Parameters:
        file_path: file_path
        without_dialog: without_dialog

    Returns:
        imported element ID list
    """

import_sat_file(file_path, scale_factor, binary)

Imports an SAT file

Parameters:

Name Type Description Default
file_path str

file_path

required
scale_factor float

scale_factor

required
binary bool

binary

required

Returns:

Type Description
List[int]

imported element ID list

Source code in src/file_controller/__init__.pyi
70
71
72
73
74
75
76
77
78
79
80
def import_sat_file(file_path: str, scale_factor: float, binary: bool) -> List[int]:
    """Imports an SAT file

    Parameters:
        file_path: file_path
        scale_factor: scale_factor
        binary: binary

    Returns:
        imported element ID list
    """

import_sat_file_silently(file_path, scale_factor, binary)

Imports a SAT File without messages

Parameters:

Name Type Description Default
file_path str

file_path

required
scale_factor float

scale_factor

required
binary bool

binary

required

Returns:

Type Description
List[int]

List[int]

Source code in src/file_controller/__init__.pyi
138
139
140
141
142
143
144
145
146
147
148
def import_sat_file_silently(file_path: str, scale_factor: float, binary: bool) -> List[int]:
    """Imports a SAT File without messages

    Parameters:
        file_path: file_path
        scale_factor: scale_factor
        binary: binary

    Returns:
        List[int]
    """

import_step_file(file_path, scale_factor)

Imports a STEP file

Parameters:

Name Type Description Default
file_path str

file_path

required
scale_factor float

scale_factor

required

Returns:

Type Description
List[int]

imported element ID list

Source code in src/file_controller/__init__.pyi
25
26
27
28
29
30
31
32
33
34
def import_step_file(file_path: str, scale_factor: float) -> List[int]:
    """Imports a STEP file

    Parameters:
        file_path: file_path
        scale_factor: scale_factor

    Returns:
        imported element ID list
    """

import_step_file_with_message_option(file_path, scale_factor, hide_message)

Imports a STEP file

Parameters:

Name Type Description Default
file_path str

file_path

required
scale_factor float

scale_factor

required
hide_message bool

hide_message

required

Returns:

Type Description
List[int]

imported element ID list

Source code in src/file_controller/__init__.pyi
36
37
38
39
40
41
42
43
44
45
46
def import_step_file_with_message_option(file_path: str, scale_factor: float, hide_message: bool) -> List[int]:
    """Imports a STEP file

    Parameters:
        file_path: file_path
        scale_factor: scale_factor
        hide_message: hide_message

    Returns:
        imported element ID list
    """

import_variant_file(file_path, insert_position)

imports a variant by .val-File

Parameters:

Name Type Description Default
file_path str

file_path

required
insert_position point_3d

insert_position

required

Returns:

Type Description
List[int]

imported element ID list

Source code in src/file_controller/__init__.pyi
287
288
289
290
291
292
293
294
295
296
def import_variant_file(file_path: str, insert_position: point_3d) -> List[int]:
    """imports a variant by .val-File

    Parameters:
        file_path: file_path
        insert_position: insert_position

    Returns:
        imported element ID list
    """

load_webgl_preset_file(file_path)

loads a preset file for the WebGl export

Parameters:

Name Type Description Default
file_path str

file_path

required

Returns:

Type Description
None

None

Source code in src/file_controller/__init__.pyi
342
343
344
345
346
347
348
349
350
def load_webgl_preset_file(file_path: str) -> None:
    """loads a preset file for the WebGl export

    Parameters:
        file_path: file_path

    Returns:
        None
    """

set_blum_export_path(path)

set blum export path

Parameters:

Name Type Description Default
path str

path

required

Returns:

Type Description
None

None

Source code in src/file_controller/__init__.pyi
252
253
254
255
256
257
258
259
260
def set_blum_export_path(path: str) -> None:
    """set blum export path

    Parameters:
        path: path

    Returns:
        None
    """