RevitSdkSamples/SDK/Samples/BoundaryConditions/CS/ReadMe_BoundaryConditions.rtf

{\rtf1\fbidis\ansi\ansicpg1252\deff0\deflang1033\deflangfe2052{\fonttbl{\f0\fswiss\fprq2\fcharset0 Arial;}{\f1\froman\fprq2\fcharset0 Times New Roman;}{\f2\fmodern\fprq1\fcharset0 Courier New;}}
{\colortbl ;\red0\green0\blue255;}
\viewkind4\uc1\pard\ltrpar\nowidctlpar\b\f0\fs20 Application:\b0  BoundaryConditions\line\b Revit Platform:\b0  Structure\line\b Revit Version:\b0  2011.0\line\b First Released For:\b0  9.1\line\b Programming Language:\b0  C#\line\b Skill Level:\b0  High\line\b Category:\b0  Structure\line\b Type:\b0  ExternalCommand\line\line\b Subject:\b0  Create or retrieve boundary conditions.\line\b Summary:\b0  \line This sample shows to get BoundaryConditions\rquote  parameters or create BoundaryConditons.\par
\par
\b Classes:\b0  \par
\pard\ltrpar\nowidctlpar\fi360 Autodesk.Revit.UI.IExternalCommand\par
Autodesk.Revit.DB.BoundaryConditions\par
\pard\ltrpar\nowidctlpar\par
\b Project Files:\b0  \cf1\par
\cf0 Command.cs\par
\pard\ltrpar\nowidctlpar\li360\tx720 This is the main DLL source file. It contains the class Command which implements interface IExternalCommand.\par
\pard\ltrpar\nowidctlpar\par
BoundaryConditionsData.cs\par
\pard\ltrpar\nowidctlpar\li360\tx720 This file contains class BoundaryConditionsData which prepares the needed data (the selected element type and its BC information) and creates BoundaryConditions.\par
\pard\ltrpar\nowidctlpar\par
BCProperties.cs\par
\pard\ltrpar\nowidctlpar\li360\tx720 This file contains three enumerations (BCType, BCState and BCTranslationRotation) and two classes (BCTypeAttribute, BCProperties). They prepare data for the PropertyGrid which is contained in BoundaryConditionsForm.\f1\par
\pard\ltrpar\nowidctlpar\f0\par
UnitConversion.cs\par
\pard\ltrpar\nowidctlpar\li360\tx720 This file contains a structure ConversionValue and a class ConversionValue. The structure defines the conversion rule between display value and internal value. The class is a value conversion dictionary, which stores some units and their corresponding ConversionValue.\par
\pard\ltrpar\nowidctlpar\fi400\par
\pard\ltrpar\nowidctlpar\b Description:\b0  \par
\pard\ltrpar\nowidctlpar\fi-357\li357\tx357 -\tab Only select one structure element.\par
\pard\ltrpar\nowidctlpar\fi-357\li357 -\tab If the selected element has boundary conditions the parameters of the boundary conditions (BC) are presented. And users are also allowed to set these parameters with other valid values.\par
\pard\ltrpar\nowidctlpar\fi-363\li720\tx720 -\tab List all the Ids of BC whose host is the selected element in a list box\f2 .\f0\par
\pard\ltrpar\nowidctlpar\fi-363\li720 -\tab According to the selected BC Id, the relevant BC Type, State and X, Y, Z translation/rotation will be displayed.\par
-\tab User is not allowed to change the BC Type.\par
-\tab User can set the State of BC to Fixed, Pinned, Roller or User (When different values are selected the X, Y or Z translation/rotation should do corresponding changes according to the Revit main program UI). \par
-\tab If the User is selected as the current State, then X, Y or Z translation/rotation can be set to Fixed, Released or Spring.\par
-\tab If Spring is selected for X, Y or Z translation/rotation, positive values can be inputted as the Spring Modulus (Show the unit of the value for users).\par
\pard\ltrpar\nowidctlpar\fi-357\li357\tx360 -\tab If the selected element does not have a BC then create one.\par
\pard\ltrpar\nowidctlpar\fi-363\li720\tx720 -\tab Set the BC Type to Point, Line or Area according to the selected element. (Beams/Walls/ Wall Foundations have line BC; Columns/ braces have point BC; Slabs/Foundation Slabs have area BC)\par
\pard\ltrpar\nowidctlpar\fi-363\li720 -\tab Other initial parameters are set to be fixed.\par
-\tab The user can change all the parameters values except the BC Type (refer to the details of last point)\par
\pard\ltrpar\nowidctlpar\fi-357\li357\tx357 -\tab When the user clicks the OK button the existing BC is updated or the new BC is created.\f1\par
\f0 -\tab We should use NewPointBoundaryConditions, NewLineBoundaryConditions and NewAreaBoundaryConditions methods of Autodesk.Revit.Creation.Document to create BC\f1\par
\pard\ltrpar\nowidctlpar\f0\par
\b Instructions:\cf1\b0  \cf0\par
\pard\ltrpar\nowidctlpar\fi-360\li360\tx360 1.\tab Open Revit Structure and draw a beam.\par
2.\tab Select the beam and run the sample.\par
\pard\ltrpar\nowidctlpar\fi-360\li360 3.\tab Select the property value in the PropertyGrid control in Form.\par
\pard\ltrpar\nowidctlpar\fi-360\li360\tx360 4.\tab In sample\rquote s main UI click the OK button.\par
5.\tab Return to Revit main program you can see a line BoundaryConditions is created on the selected beam.\par
\pard\ltrpar\nowidctlpar\par
\b Others:\par
\pard\ltrpar\nowidctlpar\fi-357\li357\tx357\b0 -\tab We provide four additional files (Boundary Conditions Pinned.rfa, Boundary Conditions Fixed.rfa, Boundary Conditions Roller.rfa, and Boundary Conditions User.rfa). They are family files of Boundary Conditions. If you cannot draw any Boundary Conditions, pleas load these families first. And then setting the Family symbol for Boundary Conditions in Setting menu->Structural Settings->Boundary Conditions Settings.\f1\par
\f0 -\tab Only The following structural elements can have BC:\f1\par
\pard\ltrpar\nowidctlpar\li360\tx720\f0 Columns/braces/Isolated Foundations/ Beams/Walls/ Wall Foundations/ Slabs/Foundation Slabs\f1\par
}