Model

Content

class	CacheImpl
class	ModelImpl

Functions

	`~Model`
	`Model`
MeshKey	`Insert`
MeshKey	`Insert`
MaterialKey	`Insert`
MaterialKey	`Insert`
LinePatternKey	`Insert`
MatrixKey	`Insert`
MatrixKey	`Insert`
ImageKey	`Insert`
ImageKey	`Insert`
ImageKey	`Insert`
ImageKey	`Insert`
ImageKey	`Insert`
DataKey	`Insert`
GroupKey	`Insert`
MaterialMapKey	`Insert`
MaterialMapKey	`Insert`
PolyPolygonKey	`Insert`
ClipRegionKey	`Insert`
MaterialKey	`FindOrInsert`
MaterialKey	`FindOrInsert`
MatrixKey	`FindOrInsert`
MatrixKey	`FindOrInsert`
MaterialMapKey	`FindOrInsert`
MaterialMapKey	`FindOrInsert`
PolyPolygonKey	`FindOrInsert`
ClipRegionKey	`FindOrInsert`
void	`Set`
void	`Set`
void	`Set`
void	`Set`
void	`Set`
void	`Set`
void	`Set`
void	`Set`
void	`Set`
void	`Set`
void	`Set`
void	`Set`
void	`Set`
void	`Set`
void	`Set`
void	`Set`
void	`Set`
void	`Set`
InstanceKey	`Instance`
InclusionKey	`Include`
void	`Set`
void	`Set`
void	`Set`
void	`Set`
void	`Set`
void	`Set`
void	`Set`
void	`Set`
void	`Set`
void	`Set`
void	`Set`
void	`Set`
void	`Set`
void	`Delete`
void	`Delete`
void	`Delete`
ModelKey	`GetKey`
const char *	`GetName`
const char *	`GetPath`
void	`GetInstanceIncs`
void	`GetMeshIds`
void	`GetMaterialIds`
void	`GetMatrixIds`
void	`GetInstanceIds`
void	`GetImageIds`
void	`GetDataIds`
void	`GetGroupIds`
void	`GetMaterialMapIds`
void	`GetPolyPolygonIds`
void	`GetClipRegionIds`
void	`GetMeshKeys`
void	`GetMaterialKeys`
void	`GetMatrixKeys`
void	`GetInstanceKeys`
void	`GetImageKeys`
void	`GetDataKeys`
void	`GetGroupKeys`
void	`GetMaterialMapKeys`
void	`GetPolyPolygonKeys`
void	`GetClipRegionKeys`
void	`Get`
void	`Set`
bool	`Get`
void	`Set`
bool	`Get`
void	`Set`
bool	`Get`
ViewKey	`View`
void	`PrepareStream`
void	`ComputeBounding`
double	`GetRootMeasurementUnit`
const char *	`GenerateSCSFile`
const char *	`GenerateSCZFile`

Detailed Description

class Model

The interface into a model. This class allows the definition of meshes, colors, matrices, instances, and other model data. It also provides means of modifying existing definitions. Querying of its name, model key, default camera, keys and many other aspects.

A model is closed when its destructor or cache.Close(model) is called.

In general operations on invalid keys or otherwise invalid usage will throw exceptions. Using try catch blocks around your code is advised.

A model has a default View, but unless a self include is created nothing will be visible when it is streamed. A model without a self include can be seen as an pure container for data, but unless it is included in some other model it is not directly viewable.

Consider a model containing a single instance of a sphere. If it was self included 4 times with different matrices then 4 spheres would be visible when the model is streamed and viewed. If it was included in a second model once, a single sphere would be visible in the second model.

Public Functions

~Model()

Model(Model &&that)

MeshKey Insert(Mesh const &mesh)

Insert a new definition into the model.

Parameters: mesh – The Mesh.
Returns: A MeshKey.

MeshKey Insert(MeshKeys const &meshes)

Insert a new definition into the model. This is a mesh selector with different mesh levels.

Parameters: meshes – The MeshKeys. The index 0 is the highest representation and the Nth index is the lowest representation.
Returns: A MeshKey.

MaterialKey Insert(Color const &color)

Insert a new definition into the model.

Parameters: color – The Color.
Returns: A MaterialKey.

MaterialKey Insert(Material const &material)

Insert a new definition into the model.

Parameters: material – The Material.
Returns: A MaterialKey.

LinePatternKey Insert(LinePattern const &line_pattern)

Insert a new definition into the model.

Parameters: line_pattern – The Line Pattern.
Returns: A LinePatternKey.

MatrixKey Insert(Matrix3d const &matrix)

Insert a new definition into the model.

Parameters: matrix – The Matrix3d.
Returns: A MatrixKey.

MatrixKey Insert(DMatrix3d const &matrix)

Insert a new definition into the model.

Parameters: matrix – The DMatrix3d.
Returns: A MatrixKey.

ImageKey Insert(uint32_t byte_count, uint8_t const *byte_data, ImageFormat format)

Insert a new definition into the model.

Parameters

byte_count – The byte count.
byte_data – The image data of length byte_count.
format – The ImageFormat of the byte_data.

Returns

An ImageKey.

ImageKey Insert(uint32_t width, uint32_t height, RGBA32 const *data)

Insert a new definition into the model.

Parameters

width – The image width.
width – The image height.
data – The RGBA32 image data of length width * height.

Returns

An ImageKey.

ImageKey Insert(uint32_t width, uint32_t height, RGB24 const *data)

Insert a new definition into the model.

Parameters

width – The image width.
width – The image height.
data – The RGB24 image data of length width * height.

Returns

An ImageKey.

ImageKey Insert(uint32_t width, uint32_t height, Gray8 const *data)

Insert a new definition into the model.

Parameters

width – The image width.
width – The image height.
data – The Gray8 image data of length width * height.

Returns

An ImageKey.

ImageKey Insert(uint32_t width, uint32_t height, GrayAlpha16 const *data)

Insert a new definition into the model.

Parameters

width – The image width.
width – The image height.
data – The GrayAlpha16 image data of length width * height.

Returns

An ImageKey.

DataKey Insert(uint32_t byte_count, uint8_t const *byte_data, uint32_t priority = 0)

Insert a new definition into the model.

Parameters

byte_count – The byte count.
byte_data – The bytes of length byte_count.
priority – The priority. Controls streaming order: 0 not sent by default - ~0 sent by request only and excluded from .scs; otherwise, highest first.

Returns

A DataKey.

GroupKey Insert(InstanceIncs const &instance_incs, GroupIncs const &group_incs)

Insert a new definition into the model.

Parameters

instance_incs – The InstanceIncs to insert.
group_incs – The GroupIncs to insert.

Returns

A GroupKey.

MaterialMapKey Insert(MaterialKeys const &material_keys)

Insert a new definition into the model.

Parameters: material_keys – The MaterialKeys to insert. These define a fully enumerated material map.
Returns: A MaterialMapKey.

MaterialMapKey Insert(MaterialMapElements const &material_map_elements)

Insert a new definition into the model.

Parameters: material_map_elements – The MaterialMapElements to insert. These define a sparse material map.
Returns: A MaterialMapKey.

PolyPolygonKey Insert(uint32_t loop_count, uint32_t const *loop_counts, Point const *points)

Insert a new definition into the model.

Parameters

loop_count – The loop count.
loop_counts – The counts for loop_count loops.
points – The points.

Returns

A PolyPolygonKey.

ClipRegionKey Insert(ClipSubRegions const &clip_subregions)

Insert a new definition into the model.

Parameters: key – clip_subregions ClipSubRegions to insert.
Returns: A ClipRegionKey.

MaterialKey FindOrInsert(Color const &color)

Look up matching definition or insert if not found. Only definitions created using FindOrInsert are matchable. Helps create a more compact model if unique keying is not needed.

Parameters: color – The Color to match or insert.
Returns: A MaterialKey.

MaterialKey FindOrInsert(Material const &material)

Look up matching definition or insert if not found. Only definitions created using FindOrInsert are matchable. Helps create a more compact model if unique keying is not needed.

Parameters: material – The Material to match or insert.
Returns: A MaterialKey.

MatrixKey FindOrInsert(Matrix3d const &matrix)

Look up matching definition or insert if not found. Only definitions created using FindOrInsert are matchable. Helps create a more compact model if unique keying is not needed.

Parameters: matrix – The Matrix3d to match or insert.
Returns: A MatrixKey.

MatrixKey FindOrInsert(DMatrix3d const &matrix)

Look up matching definition or insert if not found. Only definitions created using FindOrInsert are matchable. Helps create a more compact model if unique keying is not needed.

Parameters: matrix – The DMatrix3d to match or insert.
Returns: A MatrixKey.

MaterialMapKey FindOrInsert(MaterialKeys const &material_keys)

Look up matching definition or insert if not found. Only definitions created using FindOrInsert are matchable. Helps create a more compact model if unique keying is not needed.

Parameters: material_keys – The MaterialKeys to match or insert. These define a fully enumerated material map.
Returns: A MaterialMapKey.

MaterialMapKey FindOrInsert(MaterialMapElements const &material_map_elements)

Look up matching definition or insert if not found. Only definitions created using FindOrInsert are matchable. Helps create a more compact model if unique keying is not needed.

Parameters: material_map_elements – The MaterialMapElements to match or insert. These define a sparse material map.
Returns: A MaterialMapKey.

PolyPolygonKey FindOrInsert(uint32_t loop_count, uint32_t const *loop_counts, Point const *points)

Look up matching definition or insert if not found. Only definitions created using FindOrInsert are matchable. Helps create a more compact model if unique keying is not needed.

Parameters

loop_count – The loop count.
loop_counts – The counts for loop_count loops.
points – The points.

Returns

A PolyPolygonKey.

ClipRegionKey FindOrInsert(ClipSubRegions const &clip_subregions)

Look up matching definition or insert if not found. Only definitions created using FindOrInsert are matchable. Helps create a more compact model if unique keying is not needed.

Parameters: key – clip_subregions ClipSubRegions to match or insert.
Returns: A ClipRegionKey.

void Set(MeshKey key, Mesh const &mesh)

Replace the underlying definition for key.

Parameters

key – The MeshKey to modify.
meshes – The replacement Mesh.

void Set(MeshKey key, MeshKeys const &meshes)

Replace the underlying definition for key.

Parameters

key – The MeshKey to modify.
meshes – The replacement MeshKeys. The index 0 is the highest representation and the Nth index is the lowest representation.

void Set(MaterialKey key, Color const &color)

Replace the underlying definition for key.

Parameters

key – The MaterialKey to modify.
color – The replacement Color.

void Set(MaterialKey key, Material const &material)

Replace the underlying definition for key.

Parameters

key – The MaterialKey to modify.
material – The replacement Material.

void Set(MatrixKey key, Matrix3d const &matrix)

Replace the underlying definition for key.

Parameters

key – The MatrixKey to modify.
matrix – The replacement Matrix3d.

void Set(MatrixKey key, DMatrix3d const &matrix)

Replace the underlying definition for key.

Parameters

key – The MatrixKey to modify.
matrix – The replacement DMatrix3d.

void Set(ImageKey key, uint32_t byte_count, uint8_t const *byte_data, ImageFormat format)

Replace the underlying definition for key.

Parameters

key – The ImageKey to modify.
byte_count – The replacement byte count.
byte_data – The replacement image data of length byte_count.
format – The replacement ImageFormat of the byte_data.

void Set(ImageKey key, uint32_t width, uint32_t height, RGBA32 const *data)

Replace the underlying definition for key.

Parameters

key – The ImageKey to modify.
width – The replacement image width.
width – The replacement image height.
data – The replacement RGBA32 image data of length width * height.

void Set(ImageKey key, uint32_t width, uint32_t height, RGB24 const *data)

Replace the underlying definition for key.

Parameters

key – The ImageKey to modify.
width – The replacement image width.
width – The replacement image height.
data – The replacement RGB24 image data of length width * height.

void Set(ImageKey key, uint32_t width, uint32_t height, Gray8 const *data)

Replace the underlying definition for key.

Parameters

key – The ImageKey to modify.
width – The replacement image width.
width – The replacement image height.
data – The replacement Gray8 image data of length width * height.

void Set(ImageKey key, uint32_t width, uint32_t height, GrayAlpha16 const *data)

Replace the underlying definition for key.

Parameters

key – The ImageKey to modify.
width – The replacement image width.
width – The replacement image height.
data – The replacement GrayAlpha16 image data of length width * height.

void Set(DataKey key, uint32_t byte_count, uint8_t const *byte_data)

Replace the underlying definition for key. The original priority is retained.

Parameters

key – The DataKey to modify.
byte_count – The replacement byte count.
byte_data – The replacement bytes of length byte_count.

void Set(DataKey key, uint32_t byte_count, uint8_t const *byte_data, uint32_t priority)

Replace the underlying definition for key.

Parameters

key – The DataKey to modify.
byte_count – The replacement byte count.
byte_data – The replacement bytes of length byte_count.
priority – The replacement priority. Controls streaming order: 0 not sent by default - ~0 sent by request only and excluded from .scs; otherwise, highest first.

void Set(GroupKey key, InstanceIncs const &instance_incs, GroupIncs const &group_incs)

Replace the underlying definition for key.

Parameters

key – The GroupKey to modify.
instance_incs – The replacement InstanceIncs.
group_incs – The replacement GroupIncs.

void Set(MaterialMapKey key, MaterialKeys const &material_keys)

Replace the underlying definition for key.

Parameters

key – The MaterialMapKey to modify.
material_keys – The replacement MaterialKeys. These define a fully enumerated material map.

void Set(MaterialMapKey key, MaterialMapElements const &material_map_elements)

Replace the underlying definition for key.

Parameters

key – The MaterialMapKey to modify.
material_map_elements – The replacement MaterialMapElements. These define a sparse material map.

void Set(PolyPolygonKey key, uint32_t loop_count, uint32_t const *loop_counts, Point const *points)

Replace the underlying definition for key.

Parameters

key – The PolyPolygonKey to modify.
loop_count – The replacement loop count.
loop_counts – The replacement counts for loop_count loops.
points – The replacement points.

void Set(ClipRegionKey key, ClipSubRegions const &clip_subregions)

Replace the underlying definition for key.

Parameters

key – The ClipRegionKey to modify.
clip_subregions – The replacement ClipSubRegions.

InstanceKey Instance(MeshKey mesh, MatrixKey matrix = MatrixKey(), MaterialKey face_material = MaterialKey::Unspecified(), MaterialKey line_material = MaterialKey::Unspecified(), MaterialKey point_material = MaterialKey::Unspecified(), MaterialMapKey face_material_map = MaterialMapKey(), MaterialMapKey line_material_map = MaterialMapKey(), MaterialMapKey point_material_map = MaterialMapKey(), Visibility visibility = Visibility(), Modifiers modifiers = Modifiers(), ClipRegionKey clip_region = ClipRegionKey(), VectorCulling const &vector_culling = VectorCulling())

Creates an Instance of a mesh.

Parameters

mesh – The MeshKey to instance.
matrix – The transform matrix for the instance. The default constructed MatrixKey is an identity matrix.
face_material – The MaterialKey for faces. If MaterialKey::Unspecified() is used then the mesh’s setting will be used.
line_material – The MaterialKey for lines. If MaterialKey::Unspecified() is used then the mesh’s setting will be used.
point_material – The MaterialKey for points. If MaterialKey::Unspecified() is used then the mesh’s setting will be used.
face_material_map – The MaterialMapKey for faces. If the default constructed MaterialMapKey is used the mesh’s setting will be used.
line_material_map – The MaterialMapKey for lines. If the default constructed MaterialMapKey is used the mesh’s setting will be used.
point_material_map – The MaterialMapKey for points. If the default constructed MaterialMapKey is used the mesh’s setting will be used.
visibility – The Visibility. The default constructed Visibility is all on.
modifiers – The Modifiers. The default constructed Modifiers is none.
clip_region – The ClipRegionKey. The default constructed ClipRegionKey is none.
vector_culling – The VectorCulling setting. The default constructed VectorCulling is none.

Returns

An InstanceKey.

InclusionKey Include(Model const &model, MatrixKey matrix = MatrixKey())

Include a model in this model’s views. May be a self inclusion. Inclusions present in the included model are not included, just the included model’s data.

Parameters

model – The Model to include.
matrix – The transform matrix for the inclusion the default constructed MatrixKey is an identity matrix.

Returns

An InclusionKey.

void Set(InstanceKey key, MeshKey mesh)

Replace the mesh for an Instance.

Parameters

key – The InstanceKey to modify.
mesh – The replacement MeshKey.

void Set(InstanceKey key, MatrixKey matrix)

Replace the matrix for an Instance.

Parameters

key – The InstanceKey to modify.
matrix – The replacement MatrixKey.

void Set(InstanceKey key, VectorCulling const &vector_culling)

Replace the vector culling settings for an Instance.

Parameters

key – The InstanceKey to modify.
vector_culling – The replacement VectorCulling setting.

void Set(InstanceKey key, MaterialKey face_material, MaterialKey line_material, MaterialKey point_material)

Replace the materials for an Instance.

Parameters

key – The InstanceKey to modify.
face_material – The MaterialKey for faces. If MaterialKey::Unspecified() is used then the mesh’s setting will be used.
line_material – The MaterialKey for lines. If MaterialKey::Unspecified() is used then the mesh’s setting will be used.
point_material – The MaterialKey for points. If MaterialKey::Unspecified() is used then the mesh’s setting will be used.

void Set(InstanceKey key, MaterialMapKey face_material_map, MaterialMapKey line_material_map, MaterialMapKey point_material_map)

Replace the material maps for an Instance.

Parameters

key – The InstanceKey to modify.
face_material_map – The MaterialMapKey for faces. If the default constructed MaterialMapKey is used the mesh’s setting will be used.
line_material_map – The MaterialMapKey for lines. If the default constructed MaterialMapKey is used the mesh’s setting will be used.
point_material_map – The MaterialMapKey for points. If the default constructed MaterialMapKey is used the mesh’s setting will be used.

void Set(InstanceKey key, Visibility visibility)

Replace the visibility for an Instance.

Parameters

key – The InstanceKey to modify.
visibility – The replacement Visibility.

void Set(InstanceKey key, Modifiers modifiers)

Replace the modifiers for an Instance.

Parameters

key – The InstanceKey to modify.
modifiers – The replacement Modifiers.

void Set(InstanceKey key, ClipRegionKey clip_region)

Replace the clip region for an Instance.

Parameters

key – The InstanceKey to modify.
clip_region – The replacement ClipRegionKey.

void Set(InstanceInc const &inc, MaterialKey face_material, MaterialKey line_material, MaterialKey point_material)

Override the materials for a specific InstanceInc.

Parameters

inc – The InstanceInc to override.
face_material – The MaterialKey for faces. If MaterialKey::Unspecified() is used then the mesh’s setting will be used.
line_material – The MaterialKey for lines. If MaterialKey::Unspecified() is used then the mesh’s setting will be used.
point_material – The MaterialKey for points. If MaterialKey::Unspecified() is used then the mesh’s setting will be used.

void Set(InstanceInc const &inc, MaterialMapKey face_material_map, MaterialMapKey line_material_map, MaterialMapKey point_material_map)

Override the material maps for a specific InstanceInc.

Parameters

inc – The InstanceInc to override.
face_material_map – The MaterialMapKey for faces. If the default constructed MaterialMapKey is used the mesh’s setting will be used.
line_material_map – The MaterialMapKey for lines. If the default constructed MaterialMapKey is used the mesh’s setting will be used.
point_material_map – The MaterialMapKey for points. If the default constructed MaterialMapKey is used the mesh’s setting will be used.

void Set(InstanceInc const &inc, Visibility visibility)

Override the visibility for a specific InstanceInc.

Parameters

inc – The InstanceInc to override.
visibility – The override Visibility.

void Set(InstanceInc const &inc, Modifiers modifiers_to_add)

Add modifiers for a specific InstanceInc.

Parameters

inc – The InstanceInc to add modifiers to.
modifiers_to_add – The additional Modifiers.

void Set(InstanceInc const &inc, ClipRegionKey clip_region)

Override clip region for a specific InstanceInc.

Parameters

inc – The InstanceInc to override.
clip_region – The override ClipRegionKey.

void Delete(InclusionKey inclusion_key)

Remove an existing Inclusion from a model.

Parameters: inclusion_key – The InclusionKey to remove.

void Delete(InstanceKey instance_key)

Remove an existing Instance from a model.

Parameters: instance_key – The InstanceKey to remove.

void Delete(ViewKey view_key)

Remove an existing View from a model.

Parameters: view_key – The ViewKey to remove.

ModelKey GetKey() const

Query the current ModelKey. ModelKeys are not stable values from one open model to another.

Returns: A ModelKey.

const char *GetName() const

Query the name used by a model. The name is not sufficient to uniquely identify a model; use a path instead. Returned pointer is only valid until the next call.

Returns: A pointer to a ‘C’ string with the UTF8 model name.

const char *GetPath() const

Query the file system path used by a model. Returned pointer is only valid until the next call.

Returns: A pointer to a ‘C’ string with the UTF8 file system path.

void GetInstanceIncs(InstanceIncs &instance_incs) const

Query the InstanceIncs defined in a model.

Parameters: instance_incs – A write back vector to return defined InstanceIncs.

void GetMeshIds(MeshIds &mesh_ids) const

Query the MeshIds defined in a model.

Parameters: mesh_ids – A write back vector to return defined MeshIds.

void GetMaterialIds(MaterialIds &material_ids) const

Query the MaterialIds defined in a model. Ids are not stable values from one open model to another.

Parameters: material_ids – A write back vector to return defined MaterialIds.

void GetMatrixIds(MatrixIds &matrix_ids) const

Query the MatrixIds defined in a model. Ids are not stable values from one open model to another.

Parameters: matrix_ids – A write back vector to return defined MatrixIds.

void GetInstanceIds(InstanceIds &instance_ids) const

Query the InstanceIds defined in a model. Ids are not stable values from one open model to another.

Parameters: instance_ids – A write back vector to return defined InstanceIds.

void GetImageIds(ImageIds &image_ids) const

Query the ImageIds defined in a model. Ids are not stable values from one open model to another.

Parameters: image_ids – A write back vector to return defined ImageIds.

void GetDataIds(DataIds &data_ids) const

Query the DataIds defined in a model.

Parameters: data_ids – A write back vector to return defined DataIds.

void GetGroupIds(GroupIds &group_ids) const

Query the GroupIds defined in a model. Ids are not stable values from one open model to another.

Parameters: group_ids – A write back vector to return defined GroupIds.

void GetMaterialMapIds(MaterialMapIds &material_map_ids) const

Query the MaterialMapIds defined in a model. Ids are not stable values from one open model to another.

Parameters: material_map_ids – A write back vector to return defined MaterialMapIds.

void GetPolyPolygonIds(PolyPolygonIds &polypolygon_ids) const

Query the PolyPolygonIds defined in a model. Ids are not stable values from one open model to another.

Parameters: polypolygon_ids – A write back vector to return defined PolyPolygonIds.

void GetClipRegionIds(ClipRegionIds &clip_region_ids) const

Query the ClipRegionIds defined in a model. Ids are not stable values from one open model to another.

Parameters: clip_region_ids – A write back vector to return defined ClipRegionIds.

void GetMeshKeys(MeshKeys &mesh_keys) const

Query the MeshKeys defined in a model.

Parameters: mesh_keys – A write back vector to return defined MeshKeys.

void GetMaterialKeys(MaterialKeys &material_keys) const

Query the MaterialKeys defined in a model.

Parameters: material_keys – A write back vector to return defined MaterialKeys.

void GetMatrixKeys(MatrixKeys &matrix_keys) const

Query the MatrixKeys defined in a model.

Parameters: matrix_keys – A write back vector to return defined MatrixKeys.

void GetInstanceKeys(InstanceKeys &instance_keys) const

Query the InstanceKeys defined in a model.

Parameters: instance_keys – A write back vector to return defined InstanceKeys.

void GetImageKeys(ImageKeys &image_keys) const

Query the ImageKeys defined in a model.

Parameters: image_keys – A write back vector to return defined ImageKeys.

void GetDataKeys(DataKeys &data_keys) const

Query the DataKeys defined in a model.

Parameters: data_keys – A write back vector to return defined DataKeys.

void GetGroupKeys(GroupKeys &group_keys) const

Query the GroupKeys defined in a model.

Parameters: group_keys – A write back vector to return defined GroupKeys.

void GetMaterialMapKeys(MaterialMapKeys &material_map_keys) const

Query the MaterialMapKeys defined in a model.

Parameters: material_map_keys – A write back vector to return defined MaterialMapKeys.

void GetPolyPolygonKeys(PolyPolygonKeys &polypolygon_keys) const

Query the PolyPolygonKeys defined in a model.

Parameters: polypolygon_keys – A write back vector to return defined PolyPolygonKeys.

void GetClipRegionKeys(ClipRegionKeys &clip_region_keys) const

Query the ClipRegionKeys defined in a model.

Parameters: clip_region_keys – A write back vector to return defined ClipRegionKeys.

void Get(DataKey key, std::vector<uint8_t> &byte_data) const

Query the data associated with a DataKey.

Parameters

key – The data to read
byte_data – The write back vector to return the associated data.

void Set(Camera const &camera, ViewKey view = ViewKey())

Set a views camera.

Parameters

camera – The camera for the view.
view – The view to set the properties on. If unspecified the default view is used.

bool Get(Camera &camera, ViewKey view = ViewKey())

Query a views camera.

Parameters

camera – A write back value to return the Camera. Only valid if true is returned.
view – The view to query the properties on. If unspecified the default view is used.

Returns

True if Camera has been set.

void Set(MaterialProperties const &material_properties, ViewKey view = ViewKey())

Set a views default material properties - these apply to all materials that do not have their own properties.

Parameters

material_properties – The default properties for the view.
view – The view to set the properties on. If unspecified the default view is used.

bool Get(MaterialProperties &material_properties, ViewKey view = ViewKey())

Query a views default material properties.

Parameters

material_properties – A write back value to return the MaterialProperties. Only valid if true is returned.
view – The view to query the properties on. If unspecified the default view is used.

Returns

True if MaterialProperties have been set.

void Set(ViewKey view)

Set a new initial View. Only needed if more than one View exists.

Parameters: view – The initial ViewKey.

bool Get(ViewKey &view)

Query an optional initial View. *

Parameters: view – A write back value containing the initial ViewKey. Only valid if true is returned. *
Returns: True if an optional View has been set.

ViewKey View()

Create a new View.

Returns: A new ViewKey.

void PrepareStream(CompressionStrategy compression_strategy = CompressionStrategy::Default)

Prepares this model for streaming. This should be done last when all data has been authored. *

Parameters: compression_strategy – The strategy use to compress large meshes and images. Affects speed and output size

void ComputeBounding(Point &min, Point &max): Compute the bounding for this model. This requires PrepareStream() has been called. If the stream has not been prepared an exception may be thrown.

double GetRootMeasurementUnit()

Returns the measurement unit of the root node in the model if any. Returns 0 if no measurement unit is set.

Returns: The measurement unit of the root node.

const char *GenerateSCSFile(const char *utf8_scs_file_path = nullptr)

Generates an .scs file. Returned pointer is only valid until the next call.

Parameters: utf8_scs_file_path – Specifies the full path and file name of the .scs file to generate include the .scs extension. If the utf8_scs_file_path is nullptr or empty a .scs file will be generated in the model directory with a default name.
Returns: A pointer to a ‘C’ string UTF8 file system path of the generated .scs file.

const char *GenerateSCZFile(const char *utf8_scz_file_path = nullptr, bool include_derived = true, bool include_editable = true, bool create_bundled = false)

Generates an .scz file. Returned pointer is only valid until the next call. Using “include_derived = false” is not compatible with “include_editable = false” the resulting file is unusable and the call will throw. A bundled .scz can be streamed without decompression but will create a larger file and may only be opened read-only. A file created with “include_editable = false” can only be opened read-only.

Parameters

utf8_scz_file_path – Specifies the full path and file name of the .scz file to generate include the .scz extension. If the utf8_scz_file_path is nullptr or empty a .scz file will be generated in the model directory with a default name.
include_derived – If true the .scz file will include the files needed from streaming.
include_editable – If true the .scz file will include the files needed for future editing.
create_bundled – If true the .scz file will be bundled rather than compressed.

Returns

A pointer to a ‘C’ string UTF8 file system path of the generated .scz file.

Friends

friend class TC::Store::CacheImpl

friend class TC::Store::ModelImpl