Arguments

enameOrVlaObject  specifies the entity to retrieve the assigned profile;
'enameOrVlaObject' is a classical entity name or the VLA-Object for an entity name;
must be of any "curve" type (line, polyline, ...), or a 3dSolid

profileName (optional)  the profile is specified as string of format "Standard:Name:Size"
if omitted, or if NIL, or if an empty string, the "BIM Profiles" dialog is opened, so that the user can select a profile

rotation (optional)  specifies the rotation of the profile, around the axis (in radians, default is 0)

keepClippings (optional)  defines whether any clipping of the entity is maintained, or removed (default T to keep clippings)

Return

profileName if the profile is successfully applied to the target entity, or NIL if the specified profile does not exist, or the specified entity is not a "curve" or 3dSolid entity;
if the profileName was omitted, it returns the name of the profile as selected in "BIM Profiles" dialog, if successfully applied to the entity

Example

(bim:applyprofile  vlaObj  "AISC:Pipe:51XS" 1.570796) => applies the profile with 90 degree rotation; returns "AISC:Pipe:51XS" or NIL
(bim:applyprofile  vlaObj  NIL 1.570796) => applies the profile, selected in "BIM Profiles" dialog, with 90 degree rotation; returns the name of the profile or NIL

Remarks

this function will create one or more 3dSolid entities, if successful;
to retrieve these newly create 3dSolid entities created, you need to store the last entity before calling (bim:applyProfile), and iterate over the newly created entities until your code reaches that stored last-entity.