Surface Properties of Models
Functions Introduced:
From Creo+5.0.0.0 onwards, the following functions have been deprecated:
• ProMdlVisibleAppearancepropsGet()
• ProMdlVisibleAppearancepropsSet()
• ProMdlVisibleTexturepropsGet()
• ProMdlVisibleTexturepropsSet()
• ProMdlVisibleTextureplacementpropsGet()
• ProMdlVisibleTextureplacementpropsSet()
The functions described in this section enable you to retrieve and set the surface and texture properties of models. You can retrieve and set these properties for any level in the model hierarchy. For assemblies, set the owner of ProModelitem as the top-level assembly. These properties may or may not be visible in the user interface depending on the properties set by the higher level assembly.
Use the function
ProMdlVisibleSideAppearancepropsGet() to retrieve the surface properties for a specified part, assembly component, subassembly, specified side of a quilt or surface using the
ProSurfaceAppearanceProps data structure. Refer to the section
Surface Properties, for more information on
ProSurfaceAppearanceProps data structure. The input arguments are:
• item—Specifies a ProAsmitem object that represents the part, assembly component, subassembly, quilt, or surface.
• surface_side—Specifies the direction of the side for the surface or quilt. Pass the value as 0 to specify the side which is along the surface normal. Pass 1 to specify the side opposite to surface normal.
Use the function
ProMdlVisibleSideAppearancepropsSet() to set the surface properties for a specified element. To see the changes in the
Creo+ user interface, call the function
ProWindowRepaint() after
ProMdlVisibleSideAppearancepropsSet(). To set the default surface appearance properties, pass the value of the input argument
appearance_properties as
NULL.
Use the functions
ProMdlVisibleSideTexturepropsGet() and
ProMdlVisibleSideTexturepropsSet() to apply textures to the surface. These functions use the
ProSurfaceTextureProps data structure to retrieve and set the texture properties of the surface for a specified element. Refer to the section
Surface Properties, for more information on
ProSurfaceTextureProps data structure.
Use the functions
ProMdlVisibleSideTextureplacementpropsGet() and
ProMdlVisibleSideTextureplacementpropsSet() to retrieve and set the properties related to the placing of surface texture for the specified element. These functions use the
ProSurfaceTexturePlacementProps data structure to define the placement properties.
Refer to the section
Surface Properties, for more information on
ProSurfaceTexturePlacementProps data structure.
The functions
ProMdlLockGet() and
ProMdlLockSet() get and set the lock/unlock state of the model. The function
ProMdlLockGet() returns
PRO_B_TRUE if the model is locked and
PRO_B_FALSE if it is unlocked.
The input arguments to the function
ProMdlLockSet() follow:
• model—The model to be locked or unlocked.
• lock—Pass the value as PRO_B_TRUE to lock the model and PRO_B_FALSE to unlock it.