Go to the source code of this file.
Typedefs | |
| typedef struct MR_AffineXf3f | MR_AffineXf3f |
| typedef struct MR_DistanceMap | MR_DistanceMap |
| typedef struct MR_DistanceMapLoadSettings | MR_DistanceMapLoadSettings |
| typedef struct MR_DistanceMapSaveSettings | MR_DistanceMapSaveSettings |
| typedef struct MR_Raster | MR_Raster |
| typedef struct MR_RasterLoadSettings | MR_RasterLoadSettings |
| typedef struct MR_RasterSaveSettings | MR_RasterSaveSettings |
| typedef struct MR_expected_MR_DistanceMap_std_string | MR_expected_MR_DistanceMap_std_string |
| typedef struct MR_expected_MR_RasterInfo_std_string | MR_expected_MR_RasterInfo_std_string |
| typedef struct MR_expected_MR_Raster_std_string | MR_expected_MR_Raster_std_string |
| typedef struct MR_std_optional_double | MR_std_optional_double |
| typedef struct MR_RasterLoad_TiffLoadSettings | MR_RasterLoad_TiffLoadSettings |
| typedef struct MR_TiffSaveSettings | MR_TiffSaveSettings |
| typedef struct MR_AffineXf3f MR_AffineXf3f |
| typedef struct MR_DistanceMap MR_DistanceMap |
this class allows to store distances from the plane in particular pixels validVerts keeps only pixels with mesh-intersecting rays from them Generated from class MR::DistanceMap. Base classes: Direct: (non-virtual) MR::RectIndexer Supported MR_PassBy modes: MR_PassBy_DefaultConstruct, MR_PassBy_Copy, MR_PassBy_Move (and MR_PassBy_DefaultArgument and MR_PassBy_NoObject if supported by the callee).
| typedef struct MR_DistanceMapLoadSettings MR_DistanceMapLoadSettings |
settings for loading distance maps from external formats Generated from class MR::DistanceMapLoadSettings. Supported MR_PassBy modes: MR_PassBy_DefaultConstruct, MR_PassBy_Copy, MR_PassBy_Move (and MR_PassBy_DefaultArgument and MR_PassBy_NoObject if supported by the callee).
| typedef struct MR_DistanceMapSaveSettings MR_DistanceMapSaveSettings |
determines how to save distance maps Generated from class MR::DistanceMapSaveSettings. Supported MR_PassBy modes: MR_PassBy_DefaultConstruct, MR_PassBy_Copy, MR_PassBy_Move (and MR_PassBy_DefaultArgument and MR_PassBy_NoObject if supported by the callee). Cartesian range vector between distance map borders in X direction Returns a pointer to a member variable of class MR::MeshToDistanceMapParams named xRange. Parameter _this can not be null. It is a single object. The returned pointer will never be null. It is non-owning, do NOT destroy it. The reference to this object might be preserved as the return value.
Stores either a MR::DistanceMap that represents success or a std::string that represents an error. Supported MR_PassBy modes: MR_PassBy_DefaultConstruct, MR_PassBy_Copy, MR_PassBy_Move (and MR_PassBy_DefaultArgument and MR_PassBy_NoObject if supported by the callee).
| typedef struct MR_expected_MR_Raster_std_string MR_expected_MR_Raster_std_string |
Stores either a MR::Raster that represents success or a std::string that represents an error. Supported MR_PassBy modes: MR_PassBy_DefaultConstruct, MR_PassBy_Copy, MR_PassBy_Move (and MR_PassBy_DefaultArgument and MR_PassBy_NoObject if supported by the callee).
Stores either a MR::RasterInfo that represents success or a std::string that represents an error. Supported MR_PassBy modes: MR_PassBy_DefaultConstruct, MR_PassBy_Copy, MR_PassBy_Move (and MR_PassBy_DefaultArgument and MR_PassBy_NoObject if supported by the callee).
regular grid of values of any type: an image if it has one layer, otherwise a volume Generated from class MR::Raster. Supported MR_PassBy modes: MR_PassBy_DefaultConstruct, MR_PassBy_Copy, MR_PassBy_Move (and MR_PassBy_DefaultArgument and MR_PassBy_NoObject if supported by the callee).
| typedef struct MR_RasterLoad_TiffLoadSettings MR_RasterLoad_TiffLoadSettings |
TIFF-specific raster load parameters Generated from class MR::RasterLoad::TiffLoadSettings. Supported MR_PassBy modes: MR_PassBy_DefaultConstruct, MR_PassBy_Copy, MR_PassBy_Move (and MR_PassBy_DefaultArgument and MR_PassBy_NoObject if supported by the callee).
| typedef struct MR_RasterLoadSettings MR_RasterLoadSettings |
settings for loading rasters from external formats Generated from class MR::RasterLoadSettings. Supported MR_PassBy modes: MR_PassBy_DefaultConstruct, MR_PassBy_Copy, MR_PassBy_Move (and MR_PassBy_DefaultArgument and MR_PassBy_NoObject if supported by the callee).
| typedef struct MR_RasterSaveSettings MR_RasterSaveSettings |
settings for saving rasters in external formats Generated from class MR::RasterSaveSettings. Derived classes: Direct: (non-virtual) MR::TiffSaveSettings Supported MR_PassBy modes: MR_PassBy_DefaultConstruct, MR_PassBy_Copy, MR_PassBy_Move (and MR_PassBy_DefaultArgument and MR_PassBy_NoObject if supported by the callee).
| typedef struct MR_std_optional_double MR_std_optional_double |
Stores either a single double or nothing. Supported MR_PassBy modes: MR_PassBy_DefaultConstruct, MR_PassBy_Copy, MR_PassBy_Move (and MR_PassBy_DefaultArgument and MR_PassBy_NoObject if supported by the callee).
| typedef struct MR_TiffSaveSettings MR_TiffSaveSettings |
settings for saving rasters in .tiff format Generated from class MR::TiffSaveSettings. Base classes: Direct: (non-virtual) MR::RasterSaveSettings Supported MR_PassBy modes: MR_PassBy_DefaultConstruct, MR_PassBy_Copy, MR_PassBy_Move (and MR_PassBy_DefaultArgument and MR_PassBy_NoObject if supported by the callee).
| MRC_API MR_expected_MR_DistanceMap_std_string * MR_DistanceMapLoad_fromTiff | ( | const char * | path, |
| const char * | path_end, | ||
| const MR_DistanceMapLoadSettings * | settings ) |
loads the first image of a .tiff file: one channel is taken as is, three or more channels give the luma of the first three, see convertRasterToFloats; the values of one channel equal to the value meaning no data (GDAL_NODATA) are invalid; settings.distanceMapToWorld gets the GeoTIFF transformation, or the identity if the file has none Generated from function MR::DistanceMapLoad::fromTiff. Parameter path is a UTF-8 encoded filesystem path. Parameter settings is a single object. Parameter settings has a default argument: {}, pass a null pointer to use it. Never returns null. Returns an instance allocated on the heap! Must call MR_expected_MR_DistanceMap_std_string_Destroy() to free it when you're done using it.
| MRC_API MR_expected_void_std_string * MR_DistanceMapSave_toTiff | ( | const MR_DistanceMap * | dmap, |
| const char * | path, | ||
| const char * | path_end, | ||
| const MR_DistanceMapSaveSettings * | settings ) |
saves in .tiff format Generated from function MR::DistanceMapSave::toTiff. Parameter dmap can not be null. It is a single object. Parameter path is a UTF-8 encoded filesystem path. Parameter settings is a single object. Parameter settings has a default argument: {}, pass a null pointer to use it. Never returns null. Returns an instance allocated on the heap! Must call MR_expected_void_std_string_Destroy() to free it when you're done using it.
| MRC_API MR_expected_MR_Image_std_string * MR_ImageLoad_fromTiff | ( | const char * | path, |
| const char * | path_end ) |
loads the first image of a .tiff file: libtiff decodes the formats it supports, the others are loaded by RasterLoad::fromTiff and converted by convertRasterToImage; the colors are not multiplied by alpha unless the file stores them so (associated alpha) Generated from function MR::ImageLoad::fromTiff. Parameter path is a UTF-8 encoded filesystem path. Never returns null. Returns an instance allocated on the heap! Must call MR_expected_MR_Image_std_string_Destroy() to free it when you're done using it.
| MRC_API MR_expected_void_std_string * MR_ImageSave_toTiff | ( | const MR_Image * | image, |
| const char * | path, | ||
| const char * | path_end ) |
saves in .tiff format with unassociated alpha, as in Image: the colors are not multiplied by it Generated from function MR::ImageSave::toTiff. Parameter image can not be null. It is a single object. Parameter path is a UTF-8 encoded filesystem path. Never returns null. Returns an instance allocated on the heap! Must call MR_expected_void_std_string_Destroy() to free it when you're done using it.
| MRC_API MR_expected_MR_Raster_std_string * MR_RasterLoad_fromTiff | ( | const char * | path, |
| const char * | path_end, | ||
| const MR_RasterLoadSettings * | settings, | ||
| const MR_RasterLoad_TiffLoadSettings * | tiffSettings ) |
loads the first image of a .tiff file as a raster with one layer:
| MRC_API MR_expected_MR_RasterInfo_std_string * MR_RasterLoad_infoFromTiff | ( | const char * | path, |
| const char * | path_end ) |
loads everything about the raster except its values from .tiff format Generated from function MR::RasterLoad::infoFromTiff. Parameter path is a UTF-8 encoded filesystem path. Never returns null. Returns an instance allocated on the heap! Must call MR_expected_MR_RasterInfo_std_string_Destroy() to free it when you're done using it.
| MRC_API MR_RasterLoad_TiffLoadSettings * MR_RasterLoad_TiffLoadSettings_AssignFromAnother | ( | MR_RasterLoad_TiffLoadSettings * | _this, |
| const MR_RasterLoad_TiffLoadSettings * | _other ) |
Generated from method MR::RasterLoad::TiffLoadSettings::operator=. Parameter _this can not be null. It is a single object. Parameter _other can not be null. It is a single object. The reference to things referred to by the parameter _other (if any) might be preserved in this object. The returned pointer will never be null. It is non-owning, do NOT destroy it. When this function is called, this object will drop any object references it held previously.
| MRC_API MR_RasterLoad_TiffLoadSettings * MR_RasterLoad_TiffLoadSettings_ConstructFrom | ( | MR_std_optional_double * | noData | ) |
Constructs MR::RasterLoad::TiffLoadSettings elementwise. The reference to the parameter noData might be preserved in the constructed object. Never returns null. Returns an instance allocated on the heap! Must call MR_RasterLoad_TiffLoadSettings_Destroy() to free it when you're done using it. When this function is called, this object will drop any object references it held previously.
| MRC_API MR_RasterLoad_TiffLoadSettings * MR_RasterLoad_TiffLoadSettings_ConstructFromAnother | ( | const MR_RasterLoad_TiffLoadSettings * | _other | ) |
Generated from constructor MR::RasterLoad::TiffLoadSettings::TiffLoadSettings. Parameter _other can not be null. It is a single object. The reference to things referred to by the parameter _other (if any) might be preserved in the constructed object. Never returns null. Returns an instance allocated on the heap! Must call MR_RasterLoad_TiffLoadSettings_Destroy() to free it when you're done using it.
| MRC_API MR_RasterLoad_TiffLoadSettings * MR_RasterLoad_TiffLoadSettings_DefaultConstruct | ( | void | ) |
Constructs an empty (default-constructed) instance. Never returns null. Returns an instance allocated on the heap! Must call MR_RasterLoad_TiffLoadSettings_Destroy() to free it when you're done using it.
| MRC_API MR_RasterLoad_TiffLoadSettings * MR_RasterLoad_TiffLoadSettings_DefaultConstructArray | ( | size_t | num_elems | ) |
Constructs an array of empty (default-constructed) instances, of the specified size. Will never return null. The array must be destroyed using MR_RasterLoad_TiffLoadSettings_DestroyArray(). Use MR_RasterLoad_TiffLoadSettings_OffsetMutablePtr() and MR_RasterLoad_TiffLoadSettings_OffsetPtr() to access the array elements.
| MRC_API void MR_RasterLoad_TiffLoadSettings_Destroy | ( | const MR_RasterLoad_TiffLoadSettings * | _this | ) |
Destroys a heap-allocated instance of MR_RasterLoad_TiffLoadSettings. Does nothing if the pointer is null.
| MRC_API void MR_RasterLoad_TiffLoadSettings_DestroyArray | ( | const MR_RasterLoad_TiffLoadSettings * | _this | ) |
Destroys a heap-allocated array of MR_RasterLoad_TiffLoadSettings. Does nothing if the pointer is null.
| MRC_API MR_std_optional_double *const * MR_RasterLoad_TiffLoadSettings_Get_noData | ( | const MR_RasterLoad_TiffLoadSettings * | _this | ) |
optional output: the value meaning no data (GDAL_NODATA) if the file has one, otherwise nullopt Returns a pointer to a member variable of class MR::RasterLoad::TiffLoadSettings named noData. Parameter _this can not be null. It is a single object. The returned pointer will never be null. It is non-owning, do NOT destroy it. The reference to this object might be preserved as the return value.
| MRC_API MR_std_optional_double ** MR_RasterLoad_TiffLoadSettings_GetMutable_noData | ( | MR_RasterLoad_TiffLoadSettings * | _this | ) |
optional output: the value meaning no data (GDAL_NODATA) if the file has one, otherwise nullopt Returns a mutable pointer to a member variable of class MR::RasterLoad::TiffLoadSettings named noData. Parameter _this can not be null. It is a single object. The returned pointer will never be null. It is non-owning, do NOT destroy it. The reference to this object might be preserved as the return value.
| MRC_API MR_RasterLoad_TiffLoadSettings * MR_RasterLoad_TiffLoadSettings_OffsetMutablePtr | ( | MR_RasterLoad_TiffLoadSettings * | ptr, |
| ptrdiff_t | i ) |
Offsets a pointer to an array element by i positions (not bytes). Use only if you're certain that the pointer points to an array element. The reference to the parameter ptr might be preserved in the return value.
| MRC_API const MR_RasterLoad_TiffLoadSettings * MR_RasterLoad_TiffLoadSettings_OffsetPtr | ( | const MR_RasterLoad_TiffLoadSettings * | ptr, |
| ptrdiff_t | i ) |
Offsets a pointer to an array element by i positions (not bytes). Use only if you're certain that the pointer points to an array element. The reference to the parameter ptr might be preserved in the return value.
| MRC_API void MR_RasterLoad_TiffLoadSettings_Set_noData | ( | MR_RasterLoad_TiffLoadSettings * | _this, |
| MR_std_optional_double * | value ) |
optional output: the value meaning no data (GDAL_NODATA) if the file has one, otherwise nullopt Modifies a member variable of class MR::RasterLoad::TiffLoadSettings named noData. Parameter _this can not be null. It is a single object. The reference to the parameter value might be preserved in this object in element noData. When this function is called, this object will drop object references it held previously in noData.
| MRC_API MR_expected_void_std_string * MR_RasterSave_toTiff_MR_RasterSaveSettings | ( | const MR_Raster * | raster, |
| const char * | path, | ||
| const char * | path_end, | ||
| const MR_RasterSaveSettings * | settings ) |
Generated from function MR::RasterSave::toTiff. Parameter raster can not be null. It is a single object. Parameter path is a UTF-8 encoded filesystem path. Parameter settings is a single object. Parameter settings has a default argument: {}, pass a null pointer to use it. Never returns null. Returns an instance allocated on the heap! Must call MR_expected_void_std_string_Destroy() to free it when you're done using it.
| MRC_API MR_expected_void_std_string * MR_RasterSave_toTiff_MR_TiffSaveSettings | ( | const MR_Raster * | raster, |
| const char * | path, | ||
| const char * | path_end, | ||
| const MR_TiffSaveSettings * | settings ) |
saves a raster with one layer in .tiff format: one channel of gray values, or three or four channels of RGB or RGBA colors (unassociated alpha: the colors are not multiplied by it), of any type from UInt8 to Float64 Generated from function MR::RasterSave::toTiff. Parameter raster can not be null. It is a single object. Parameter path is a UTF-8 encoded filesystem path. Parameter settings can not be null. It is a single object. Never returns null. Returns an instance allocated on the heap! Must call MR_expected_void_std_string_Destroy() to free it when you're done using it.
| MRC_API MR_TiffSaveSettings * MR_TiffSaveSettings_AssignFromAnother | ( | MR_TiffSaveSettings * | _this, |
| MR_PassBy | _other_pass_by, | ||
| MR_TiffSaveSettings * | _other ) |
Generated from method MR::TiffSaveSettings::operator=. Parameter _this can not be null. It is a single object. The reference to things referred to by the parameter _other (if any) might be preserved in this object. The returned pointer will never be null. It is non-owning, do NOT destroy it. When this function is called, this object will drop any object references it held previously.
| MRC_API MR_TiffSaveSettings * MR_TiffSaveSettings_ConstructFromAnother | ( | MR_PassBy | _other_pass_by, |
| MR_TiffSaveSettings * | _other ) |
Generated from constructor MR::TiffSaveSettings::TiffSaveSettings. The reference to things referred to by the parameter _other (if any) might be preserved in the constructed object. Never returns null. Returns an instance allocated on the heap! Must call MR_TiffSaveSettings_Destroy() to free it when you're done using it.
| MRC_API MR_TiffSaveSettings * MR_TiffSaveSettings_DefaultConstruct | ( | void | ) |
Constructs an empty (default-constructed) instance. Never returns null. Returns an instance allocated on the heap! Must call MR_TiffSaveSettings_Destroy() to free it when you're done using it.
| MRC_API MR_TiffSaveSettings * MR_TiffSaveSettings_DefaultConstructArray | ( | size_t | num_elems | ) |
Constructs an array of empty (default-constructed) instances, of the specified size. Will never return null. The array must be destroyed using MR_TiffSaveSettings_DestroyArray(). Use MR_TiffSaveSettings_OffsetMutablePtr() and MR_TiffSaveSettings_OffsetPtr() to access the array elements.
| MRC_API void MR_TiffSaveSettings_Destroy | ( | const MR_TiffSaveSettings * | _this | ) |
Destroys a heap-allocated instance of MR_TiffSaveSettings. Does nothing if the pointer is null.
| MRC_API void MR_TiffSaveSettings_DestroyArray | ( | const MR_TiffSaveSettings * | _this | ) |
Destroys a heap-allocated array of MR_TiffSaveSettings. Does nothing if the pointer is null.
| MRC_API const MR_std_optional_double * MR_TiffSaveSettings_Get_noData | ( | const MR_TiffSaveSettings * | _this | ) |
optional value meaning no data, written as GDAL_NODATA Returns a pointer to a member variable of class MR::TiffSaveSettings named noData. Parameter _this can not be null. It is a single object. The returned pointer will never be null. It is non-owning, do NOT destroy it. The reference to this object might be preserved as the return value.
| MRC_API const MR_std_function_bool_from_float * MR_TiffSaveSettings_Get_progress | ( | const MR_TiffSaveSettings * | _this | ) |
to report save progress and cancel saving if user desires Returns a pointer to a member variable of class MR::TiffSaveSettings named progress. Parameter _this can not be null. It is a single object. The returned pointer will never be null. It is non-owning, do NOT destroy it. The reference to this object might be preserved as the return value.
| MRC_API const MR_AffineXf3f *const * MR_TiffSaveSettings_Get_xf | ( | const MR_TiffSaveSettings * | _this | ) |
optional transformation of (column, row, value) to world coordinates, saved if the format supports it (e.g. GeoTIFF); (0, 0) is the corner of the first pixel, and (0.5, 0.5) is its center Returns a pointer to a member variable of class MR::TiffSaveSettings named xf. Parameter _this can not be null. It is a single object. The returned pointer will never be null. It is non-owning, do NOT destroy it. The reference to this object might be preserved as the return value.
| MRC_API MR_std_optional_double * MR_TiffSaveSettings_GetMutable_noData | ( | MR_TiffSaveSettings * | _this | ) |
optional value meaning no data, written as GDAL_NODATA Returns a mutable pointer to a member variable of class MR::TiffSaveSettings named noData. Parameter _this can not be null. It is a single object. The returned pointer will never be null. It is non-owning, do NOT destroy it. The reference to this object might be preserved as the return value.
| MRC_API MR_std_function_bool_from_float * MR_TiffSaveSettings_GetMutable_progress | ( | MR_TiffSaveSettings * | _this | ) |
to report save progress and cancel saving if user desires Returns a mutable pointer to a member variable of class MR::TiffSaveSettings named progress. Parameter _this can not be null. It is a single object. The returned pointer will never be null. It is non-owning, do NOT destroy it. The reference to this object might be preserved as the return value.
| MRC_API const MR_AffineXf3f ** MR_TiffSaveSettings_GetMutable_xf | ( | MR_TiffSaveSettings * | _this | ) |
optional transformation of (column, row, value) to world coordinates, saved if the format supports it (e.g. GeoTIFF); (0, 0) is the corner of the first pixel, and (0.5, 0.5) is its center Returns a mutable pointer to a member variable of class MR::TiffSaveSettings named xf. Parameter _this can not be null. It is a single object. The returned pointer will never be null. It is non-owning, do NOT destroy it. The reference to this object might be preserved as the return value.
| MRC_API MR_TiffSaveSettings * MR_TiffSaveSettings_MutableStaticDowncastFrom_MR_RasterSaveSettings | ( | MR_RasterSaveSettings * | object | ) |
Downcasts an instance of MR::RasterSaveSettings to a derived class MR::TiffSaveSettings. This is a static downcast, it trusts the programmer that the target type is correct. Results in UB and returns an invalid pointer otherwise. The reference to the parameter object might be preserved in the return value.
| MRC_API MR_RasterSaveSettings * MR_TiffSaveSettings_MutableUpcastTo_MR_RasterSaveSettings | ( | MR_TiffSaveSettings * | object | ) |
Upcasts an instance of MR::TiffSaveSettings to its base class MR::RasterSaveSettings. The reference to the parameter object might be preserved in the return value.
| MRC_API MR_TiffSaveSettings * MR_TiffSaveSettings_OffsetMutablePtr | ( | MR_TiffSaveSettings * | ptr, |
| ptrdiff_t | i ) |
Offsets a pointer to an array element by i positions (not bytes). Use only if you're certain that the pointer points to an array element. The reference to the parameter ptr might be preserved in the return value.
| MRC_API const MR_TiffSaveSettings * MR_TiffSaveSettings_OffsetPtr | ( | const MR_TiffSaveSettings * | ptr, |
| ptrdiff_t | i ) |
Offsets a pointer to an array element by i positions (not bytes). Use only if you're certain that the pointer points to an array element. The reference to the parameter ptr might be preserved in the return value.
| MRC_API void MR_TiffSaveSettings_Set_noData | ( | MR_TiffSaveSettings * | _this, |
| const double * | value ) |
optional value meaning no data, written as GDAL_NODATA Modifies a member variable of class MR::TiffSaveSettings named noData. Parameter _this can not be null. It is a single object. Parameter value is optional. To keep it empty, pass a null pointer. The reference to the parameter value might be preserved in this object in element noData. When this function is called, this object will drop object references it held previously in noData.
| MRC_API void MR_TiffSaveSettings_Set_progress | ( | MR_TiffSaveSettings * | _this, |
| MR_PassBy | value_pass_by, | ||
| MR_std_function_bool_from_float * | value ) |
to report save progress and cancel saving if user desires Modifies a member variable of class MR::TiffSaveSettings named progress. Parameter _this can not be null. It is a single object. The reference to the parameter value might be preserved in this object in element progress. When this function is called, this object will drop object references it held previously in progress.
| MRC_API void MR_TiffSaveSettings_Set_xf | ( | MR_TiffSaveSettings * | _this, |
| const MR_AffineXf3f * | value ) |
optional transformation of (column, row, value) to world coordinates, saved if the format supports it (e.g. GeoTIFF); (0, 0) is the corner of the first pixel, and (0.5, 0.5) is its center Modifies a member variable of class MR::TiffSaveSettings named xf. Parameter _this can not be null. It is a single object. The reference to the parameter value might be preserved in this object in element xf. When this function is called, this object will drop object references it held previously in xf.
| MRC_API const MR_TiffSaveSettings * MR_TiffSaveSettings_StaticDowncastFrom_MR_RasterSaveSettings | ( | const MR_RasterSaveSettings * | object | ) |
Downcasts an instance of MR::RasterSaveSettings to a derived class MR::TiffSaveSettings. This is a static downcast, it trusts the programmer that the target type is correct. Results in UB and returns an invalid pointer otherwise. This version is acting on mutable pointers. The reference to the parameter object might be preserved in the return value.
| MRC_API const MR_RasterSaveSettings * MR_TiffSaveSettings_UpcastTo_MR_RasterSaveSettings | ( | const MR_TiffSaveSettings * | object | ) |
Upcasts an instance of MR::TiffSaveSettings to its base class MR::RasterSaveSettings. This version is acting on mutable pointers. The reference to the parameter object might be preserved in the return value.