Merge pull request #22 from NeVeSpl/v2.0

NeVeSpl · web-flow · commit 5a0e9eee362e · 2023-11-10T17:59:01.000+01:00
V2.0
diff --git a/documentation/examples/2.0.easier-work-with-element-geometry.gif b/documentation/examples/2.0.easier-work-with-element-geometry.gif
diff --git a/documentation/examples/2.0.revit-database-scripting-select-query.gif b/documentation/examples/2.0.revit-database-scripting-select-query.gif
diff --git a/documentation/examples/2.0.revit-database-scripting-update-command.gif b/documentation/examples/2.0.revit-database-scripting-update-command.gif
diff --git a/documentation/revit-database-visualization.md b/documentation/revit-database-visualization.md
@@ -1 +1,20 @@
-## Revit database visualization (RDV)
+## Revit database visualization (RDV)
+
+RDV works for selected element/object in the tree and/or on the list.
+
+Available visualizations:
+
+- model coordinate system displayed at (0,0,0)
+- for an Element, its bounding box with marked min and max points
+- for a Rebar, its Normal and marked start and end points
+- for an XYZ, small coordinate system at that point
+- BoundingBoxXYZ,
+- bounded Curve, 
+- Edge, 
+- Point, 
+- Soild, 
+- PlanarFace
+ 
+
+
+**Visualizations are static, they are not automatically updated when element changes.**
diff --git a/readme.md b/readme.md
@@ -2,14 +2,15 @@
 
 **The fastest, most advanced, asynchronous Revit database exploration tool for Revit 2021+.**
 
-Yet another [RevitLookup](https://github.com/jeremytammik/RevitLookup) like tool. RevitLookup was an indispensable tool to work with Revit API for many years. But now, there is a better tool for the job. Let me introduce you to Revit database explorer and its capabilities. It not only allows us to **explore** database but also to:
-- **edit**, any parameter value
-- **query**, database with intuitive syntax that is translated into a FilteredElementCollector
-- **script**, by running ad hoc scripts written in C#
-- **visualize**, geometrical features of elements
+Yet another [RevitLookup](https://github.com/jeremytammik/RevitLookup) like tool. RevitLookup was an indispensable tool to work with Revit API for many years. But now, there is a better tool for the job. Let me introduce you to Revit database explorer. It not only allows us to **explore** database but also to:
+- **edit** any parameter value
+- **query** database with intuitive syntax that is translated into a FilteredElementCollector
+- **script** by running ad hoc scripts written in C#
+- **visualize** geometrical features of elements
 
 List of features:
 
+- [easier work with Element.Geometry](#easier-work-with-elementgeometry)
 - [compare objects and parameters](#compare-object-members-and-element-parameters-values)
 - [query Revit database](#query-revit-database-with-rdq-revit-database-querying)
 - [script Revit database](#script-revit-database-with-rds-revit-database-scripting)
@@ -19,7 +20,6 @@ List of features:
 - [edit parameter value](#edit-parameter-value)
 - [extensive support for ForgeTypeId](#extensive-support-for-forgetypeid)
 - [better support for Revit Extensible Storage](#better-support-for-revit-extensible-storage)
-- [easier work with Element.Geometry](#easier-work-with-elementgeometry)
 - [dark and light UI themes](#dark-and-light-ui-themes)
 - [snoop Revit events](#snoop-revit-events-with-rem-revit-event-monitor)
 
@@ -37,33 +37,54 @@ Download and install [RevitDBExplorer.msi](https://github.com/NeVeSpl/RevitDBExp
 
 ## Features
 
+
+
+### easier work with Element.Geometry
+
+Revit database explorer provides visualization for geometrical features of various objects and also :
+
+- an instance of GeometryObject can be selected in Revit if it has a valid reference
+- mouse cursor position expressed in the Revit model coordinates can be find on the status bar
+
+[Learn more about Revit database visualization (RDV).](documentation/revit-database-visualization.md)
+
+![easier-work-with-geometry](documentation/examples/2.0.easier-work-with-element-geometry.gif)
+
+
+
 ### compare object members and element parameters values
 
 ![compare objects and parameters](documentation/examples/compare-objects-and-parameters.gif)
 
+
+
+
 ### query Revit database with RDQ (Revit database querying)
 
-RDQ is able to interpret words separated by `,` as element ids, Revit classes, categories, parameters and many more. RDQ builds from them FilteredElementCollector and uses it to query Revit database. 
+RDQ is capable of interpreting words separated by `,` as element ids, Revit classes, categories, parameters and many more. RDQ builds from them FilteredElementCollector and uses it to query Revit database. 
 
 [Learn more about Revit database querying (RDQ).](documentation/revit-database-querying.md)
 
 ![possibility-to-query-Revit-database-from-UI](documentation/examples/rdq-revit-database-query-with-rql-revit-query-language.v2.gif)
 
+
+
 ### script Revit database with RDS (Revit database scripting)
 
-RDS is intended to compile and run C# code that is too small or ephemeral to make macro/dynamo/addon for it. RDS offers the quickest way to run C# code generated with generative AI chats (such as ChatGPT). 
+RDS is able to compile and run C# code that is too small or ephemeral to make macro/dynamo/addon for it. RDS offers the quickest way to run C# code generated with generative AI chats (such as ChatGPT). 
 
 [Learn more about Revit database scripting (RDS).](documentation/revit-database-scripting.md) 
 
 #### ad hoc SELECT query
 
-![revit-database-scripting-select-query](documentation/examples/revit-database-scripting-select-query.gif)
+![revit-database-scripting-select-query](documentation/examples/2.0.revit-database-scripting-select-query.gif)
 
 #### ad hoc UPDATE command
 
 An example shows how to add a prefix to `Mark` parameter for many selected elements as inputs for the script. 
 
-![possibility-to-query-Revit-database-from-UI](documentation/examples/revit-database-scripting-update-command.gif)
+![revit-database-scripting-update-query](documentation/examples/2.0.revit-database-scripting-update-command.gif)
+
 
 
 ### easy access to Revit API documentation
@@ -72,10 +93,14 @@ An example shows how to add a prefix to `Mark` parameter for many selected eleme
 
 ![tooltips-with-Revit-documentations](documentation/examples/easy-access-to-revit-api-documentation.gif)
 
+
+
 ### edit parameter value
 
 ![edit-parameter-value](documentation/examples/set.parameter.value.gif)
 
+
+
 ### extensive support for ForgeTypeId
 
 We all love (or hate) the ForgeTypeId, Revit database explorer exposes all data related to a given ForgeTypeId scattered through many utils. You can also snoop all ForgeTypeIds returned from: 
@@ -95,29 +120,24 @@ ForgeTypeId label corresponds to static properties defined on:
 ![extensive-support-for-ForgeTypeId](documentation/examples/extensive-support-for-ForgeTypeId.gif)
 
 
+
 ### better support for Revit Extensible Storage
 
 Revit database explorer allows you to snoop all schemas that are loaded into Revit memory, and you can easily get all elements that have an entity of a given schema. You get access to Extensible Storage data exactly like through RevitAPI, by invoking: Element.GetEntity(). 
 
 ![better-support-for-revit-extensible-storage](documentation/examples/better-support-for-revit-extensible-storage.gif)
 
 
-### easier work with Element.Geometry
-
-- you can select an instance of GeometryObject in Revit if it has a valid reference
-- on the status bar you will find mouse cursor position expressed in the Revit model coordinates
-
-![easier-work-with-geometry](documentation/examples/easier-work-with-element-geometry.gif)
-
 
 ### dark and light UI themes
 
 ![dark-and-light-ui-themes](documentation/examples/dark-and-light-ui-themes.gif)
 
+
+
 ### snoop Revit events with REM (Revit Event Monitor)
 
 A new take on [EventsMonitor from  RevitSdkSamples
 ](https://github.com/jeremytammik/RevitSdkSamples/tree/master/SDK/Samples/Events/EventsMonitor/CS). Revit database explorer stores the latest 30 events that occurred during Revit session and allows to snoop them. UIControlledApplication.Idling event and ControlledApplication.ProgressChanged events are not stored because they are too noisy - they happen too often. In order to use this feature, you need to enable event monitor, which by default is disabled.
 
-![snooping-events](documentation/examples/snooping-events.gif)
-
+![snooping-events](documentation/examples/snooping-events.gif)
diff --git a/sources/RevitDBExplorer/MainWindow.xaml b/sources/RevitDBExplorer/MainWindow.xaml
@@ -294,8 +294,8 @@
                     </Button>
                 </StackPanel>
                 
-                <Grid Grid.ColumnSpan="2" Background="{DynamicResource StatusBar.Background}" HorizontalAlignment="Center">
-                    <TextBlock  HorizontalAlignment="Center" VerticalAlignment="Center" Visibility="{Binding IsNewVerAvailable, Converter={StaticResource BoolToVisibilityConverterCollapsed}}">    
+                <Grid Grid.ColumnSpan="2" Background="{DynamicResource StatusBar.Background}" HorizontalAlignment="Center" >
+                    <TextBlock  HorizontalAlignment="Center" VerticalAlignment="Center" Visibility="{Binding IsNewVerAvailable, Converter={StaticResource BoolToVisibilityConverterCollapsed}}" Margin="13 0 13 0">    
                         <Run Foreground="{DynamicResource {x:Static SystemColors.ControlTextBrushKey}}">a new version is available :</Run>
                         <Hyperlink NavigateUri="{Binding NewVersionLink}" ap:HyperlinkAP.OpenOnClick="True" Foreground="{DynamicResource {x:Static SystemColors.HighlightBrushKey}}" TextDecorations="None"  >
                             <Run Text="{Binding NewVersionLink}" />
diff --git a/sources/RevitDBExplorer/RevitDBExplorer.csproj b/sources/RevitDBExplorer/RevitDBExplorer.csproj
@@ -24,7 +24,7 @@
 	</PropertyGroup>
 	<PropertyGroup>
 		<StartupObject />
-		<Version>1.10.5.0</Version>
+		<Version>2.0.0.0</Version>
 	</PropertyGroup>
 	<PropertyGroup Condition="'$(Configuration)|$(Platform)' == 'R2023|AnyCPU'">
 		<DefineConstants>TRACE;R2021b, R2022b, R2023b, R2023e, R2024e</DefineConstants>
diff --git a/sources/RevitDBExplorer/UIComponents/Workspaces/WorkspaceViewModel.cs b/sources/RevitDBExplorer/UIComponents/Workspaces/WorkspaceViewModel.cs
@@ -180,7 +180,7 @@ public void PopulateExplorerTree(SourceOfObjects sourceOfObjects, bool workspace
             Title = "<???>";
             if (sourceOfObjects.Info is not null)
             {
-                Title = sourceOfObjects.Info.ShortTitle.Truncate(33);
+                Title = sourceOfObjects.Info.ShortTitle.Truncate(27);
                 InfoAboutSource = sourceOfObjects.Info;
             }
         }
diff --git a/sources/RevitDBExplorer/UIComponents/Workspaces/WorkspacesView.xaml b/sources/RevitDBExplorer/UIComponents/Workspaces/WorkspacesView.xaml
@@ -39,7 +39,7 @@
                                 </Grid.ColumnDefinitions>
 
                                 <TextBlock Text=">"
-                                           Margin="2,0,1,-2" 
+                                           Margin="0,0,0,-2" 
                                            Foreground="{DynamicResource {x:Static SystemColors.ControlTextBrushKey}}"
                                            VerticalAlignment="Center"
                                            />
@@ -57,7 +57,7 @@
                                          VerticalAlignment="Center"
                                          HorizontalAlignment="Center"
                                          ContentSource="Header"
-                                         Margin="9,0,9,0"
+                                         Margin="6,0,6,0"
                                          RecognizesAccessKey="True"
                                          TextBlock.Foreground="{DynamicResource {x:Static SystemColors.ControlTextBrushKey}}" />
                                  </Border>

Original file line number	Diff line number	Diff line change
`@@ -180,7 +180,7 @@ public void PopulateExplorerTree(SourceOfObjects sourceOfObjects, bool workspace`
`180`	`180`	`Title = "<???>";`
`181`	`181`	`if (sourceOfObjects.Info is not null)`
`182`	`182`	`{`
`183`		`- Title = sourceOfObjects.Info.ShortTitle.Truncate(33);`
	`183`	`+ Title = sourceOfObjects.Info.ShortTitle.Truncate(27);`
`184`	`184`	`InfoAboutSource = sourceOfObjects.Info;`
`185`	`185`	`}`
`186`	`186`	`}`