Skip to main content

openbim_ifc_v0_1_model_convert_length_unit

Function openbim_ifc_v0_1_model_convert_length_unit 

Source
#[unsafe(no_mangle)]
pub unsafe extern "C" fn openbim_ifc_v0_1_model_convert_length_unit( model: OpenbimIfcModel, target: *const u8, target_len: usize, flags: u32, nodes: *mut OpenbimIfcValueNode, node_capacity: usize, out_nodes_required: *mut usize, strings: *mut u8, string_capacity: usize, out_strings_required: *mut usize, ) -> OpenbimIfcStatus
Expand description

Convert the model’s length unit to the unit named target (target_len UTF-8 bytes): an SI METRE with any prefix, or inch, foot, yard, mile, US survey foot. Every length, area and volume value is rescaled as one checked transaction. flags: OPENBIM_IFC_LENGTH_UNIT_KEEP_AREA_AND_VOLUME, OPENBIM_IFC_LENGTH_UNIT_KEEP_REPLACED_UNITS, OPENBIM_IFC_LENGTH_UNIT_DRY_RUN. The answer is the LengthUnitReport tape of the module docs; a size query or a short buffer plans the conversion and answers BufferTooSmall without applying it.

InvalidValue for a target that is not a length unit; Unsupported naming the values the conversion cannot carry (a parameter on a curve whose parameter space IFC leaves undefined, a p-curve off a plane, polynomial coefficients …) and for an offset unit (#110); InvalidModel when the project length unit does not resolve; UnsupportedSchema; InvalidArgument for an unknown flag or text that is not UTF-8; FeatureDisabled.

§Safety

target valid for target_len; the buffers as for openbim_ifc_v0_1_entity_attribute.