AEC DevBlog

Setting AppearanceAsset properties of newly created Revit Material

By Naveen Kumar

Question: One can change the AppearanceAsset properties of a UI-generated Revit material. However, the AppearanceAssetId value is null if the material is API-generated. The AppearanceAsset properties cannot be set for the material created by the API. Is it possible to modify or set the AppearanceAsset properties of an API-generated Material?

Answer: Since the API-generated material lacks an AppearanceAssetId , it should be set explicitly. In this case, the simplest way to create a new material is to duplicate an existing one and then modify it.

In the code below, red carpet material has been duplicated, and the AppearanceAsset properties of the duplicated material have been modified.

 

public void DuplicateAndModifyMaterial(Material material)
      {
        ElementId appearanceAssetId = material.AppearanceAssetId;
        AppearanceAssetElement assetElem = material.Document
                .GetElement(appearanceAssetId) as AppearanceAssetElement;

        ElementId duplicateAssetElementId = ElementId.InvalidElementId;
        using (Transaction t = new Transaction(material.Document))
         {
            t.Start("Duplicate Red Carpet Material");
           // Duplicate the material
            Material duplicateMaterial = material.Duplicate("Blue Carpet");
           
           // Duplicate the appearance asset and the asset in it
            AppearanceAssetElement duplicateAssetElement = assetElem.Duplicate("Blue Carpet");
           
           // Assign the asset element to the material
            duplicateMaterial.AppearanceAssetId = duplicateAssetElement.Id;
            duplicateAssetElementId = duplicateAssetElement.Id;
            t.Commit();
         }
       // Make changes to the duplicate asset
         using (Transaction t2 = new Transaction(material.Document))
          {
           t2.Start("Change blue carpet material assets");
           using (AppearanceAssetEditScope editScope 
                    = new AppearanceAssetEditScope(assetElem.Document))
            {   
             // returns an editable copy of the appearance asset
              Asset editableAsset = editScope.Start(duplicateAssetElementId);   
                    
             // Description
              AssetPropertyString descriptionProperty =editableAsset
                   .FindByName("description") as AssetPropertyString;
              descriptionProperty.Value = "blue carpet";
                    
             // Diffuse image
              AssetPropertyDoubleArray4d genericDiffuseProperty = editableAsset
                  .FindByName("generic_diffuse") as AssetPropertyDoubleArray4d;
              
              genericDiffuseProperty
                 .SetValueAsColor(new Autodesk.Revit.DB.Color(0x00, 0x00, 0xFF));
              
              Asset connectedAsset = genericDiffuseProperty.GetSingleConnectedAsset();
              AssetPropertyString bitmapProperty = connectedAsset
                   .FindByName("unifiedbitmap_Bitmap") as AssetPropertyString;
                    
             //Appearance tab >>> Generic >>> Image
              bitmapProperty.Value = @"Your image Path here";
              editScope.Commit(true);
            }
           t2.Commit();
          }
      }

Please note: Here in this instance, the "generic_diffuse" property has been accessed. However, not every AppearanceAsset will have the "generic_diffuse" property. So, please use the RevitLookup tool to explore the material element, find the relevant property, and modify it accordingly.

Setting "Units and Transform" values via Navisworks API

By Naveen Kumar

Question: I'm trying to modify the Model Units, Origin, Rotation, and scale values of each appended 3D model. Is it possible to change these values via Navisworks API?

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Answer: Yes, it is possible to change these values using SetModelUnitsAndTransform Method. Please take a look at the below sample code

  
  DocumentModels models = doc.Models;
//Get the required model from DocumentModels
  Model model;

  Transform3D oldTransform3d=model.Transform;
  Transform3DComponents transform3dComponents = oldTransform3d.Factor();

//Get Values
  Vector3D originVector3D = transform3dComponents.Translation;
  Vector3D scaleVector3D = transform3dComponents.Scale;
  Rotation3D rotationVector3D = transform3dComponents.Rotation;

//Set Values
  transform3dComponents.Translation = new Vector3D(origin_X, origin_Y, origin_Z);
  //Eg: new Vector3D(10,10,10);
  
  transform3dComponents.Rotation = new Rotation3D(new UnitVector3D(0, 0, 1), 0.872665);
  //Here 50 degree=0.872665 radian
  
  transform3dComponents.Scale = new Vector3D(scale_X, scale_Y, scale_Z);
  //Eg: new Vector3D(2,2,2);
  
  Transform3D newTransform3D = transform3dComponents.Combine();

//Change model units value
  Units units = Units.Meters;

  models.SetModelUnitsAndTransform(model, units , newTransform3D, true);