Managing material

Creating new material:

The command creates a new material with the given name organized into ARCHLine.XP category and subcategory.

From raster image file: 

#set #material [#project] {materialname} {categoryname} {subcategoryname} {filename} num colorindex brightness transparency renderstyle

or

From color:

#set #material [#project] {materialname} {categoryname} {subcategoryname} {#color R G B} brightness transparency renderstyle

In the case of material by color definition, the texture file, bitmap size and replacement color cannot be specified in the command.

The #project keyword is optional. If you use it, the material will be a project material, and not saved into the environment.

Return value: 

string callResult = material GUID

Properties: 

filename example: "C:\Draw\Concrete_wall_texture_R.jpg" or

R G B - RGB color value is specified with: rgb(red, green, blue).
Each parameter (red, green, and blue) defines the intensity of the color as an integer between 0 and 255.

categoryname example: "Building"

subcategoryname example: "Other"

num : physical size in X in mm

color: replacement color index from ARCHLine.XP color table where colorindex > 0 || colorindex <= 255

brightness >= 10 || brightness <= 100

transparency >= 0 || transparency <= 255

renderstyle > 0 || renderstyle <= 21 (WATER)

renderstyle: (one of the predefined ARCHLine.XP renderstyles)

GENERAL = 0,
PARQUET = 1,
MATTE = 2,
PLASTIC = 3,
LEATHER = 4,
WOOD = 5,
PORCELAIN = 6,
METAL = 7,
GLOSSY = 8,
CURTAIN = 8,
FABRIC = 10,
GLASS = 11,
MIRROR = 12
TRANSLUCENT_GLASS = 13
EMISSIVE = 14
WALL = 15
GENERAL = 16
EMISSIVE_REAL = 17
CEILING = 18
CHROME = 19
MARBLE = 20
WATER = 21

1. example material from raster image with physical size in X  500mm colorindex=6 brightness=80 transparency=0 renderstyle = 15 (WALL)
#set #material "New materialname" "Building" "Other" "C:\Draw\Concrete_wall_texture_R.jpg" 500 6 80 0 15

2. example with color: RGB (255 128 128) brightness=80 transparency=0 renderstyle = 19 (CHROME )
#set #material "New materialname" "Building" "Other" #color 255 128 128 80 0 19

Output: 

3. example with hatches and BIM parameters

#set #material #project "Isolante technic 44" "Wood" "EC - Isolante technic" #color 255 128 128 100 0 19
   #hatch3d #userpattern 6 #width 101.0 #height 51.0 #color 32 #bcolor 54 #enter
   #section #name "Terra" #width 100.0 #height 50.0 #color 13 #bcolor 16 #angle 45.0 #enter
   #parameter
      #add "ThermalMaterialProperties2" "ThermalConductivity" #extratext "Description1" "IfcThermalConductivityMeasure" "0.0335" #next
      #add "ThermalMaterialProperties2" "ThermalConductivity2" #extratext "Description2" "IfcThermalConductivityMeasure" "0.0336" #enter

Find material

This command returns true if the material is exists. The return value can be "project" or "global".

#set #material #existing ID

Transform a project material to global

This command saves a project material into the environment.

#set #material #copy "ID of material" {categoryname} {subcategoryname}

Managing material assigned BIM parameters

Every command starts with #modify #material [#global] "MaterialName", where you can give the name or ID of the material. In case of using #global keyword, the global material will be modifyed, not the project one.

Adding new BIM parameter:

#add "PropertySetName" "PropertyName" [#extratext "description"] "Type of parameter" "Value of parameter" #enter

The "Type of parameter" can be: IfcText, IfcLength, IfcNumber, IfcArea, etc.

Deleting a BIM parameter:
#delete "PropertySetName" "PropertyName"

Modifying a BIM parameter:
#modify "PropertySetName" "PropertyName" "New value"

In case of #delete and #modify command, the property set and the property names aren't case sensitives.

Example:

1. Adding a BIM parameter

#modify #material "Thermal Insulation 01" #add "Thermal parameters" "Density" "IfcText" 1000" #enter

2. You can repeat the command to assign more BIM parameters in one step, for example:

#modify #material "Thermal Insulation 01" #add "Thermal parameters" "Conductivity" "IfcText" "0.7" #next #add "Thermal parameters" "Density" "IfcText" "1000" #next #modify "Thermal parameters" "Conductivity" "0.71"#enter