Author: admin

  • Steps to Mastery of the API (AutoCAD .net API)

    These are steps. When you get to the top, you'll be an AutoCAD master programmer.
    These are steps. When you get to the top, you’ll be an AutoCAD master programmer.

    I’ve compiled a list. There’s actually quite a bit involved. I don’t think you can get away with simply not knowing anything about unamanged ObjectARX world. Here is the list below – which I will update. If you see any notable topics which I have missed, please feel free to add a note and I will update the list.

  • Finding the Point on a Curve Which is the Closest Point to Another Curve? (AutoCAD .net API)

    Documentation of the GetClosestPointTo method of the curve object - the overloads are extremely limited. So we have to be somewhat creative in obtaining a solution.
    Documentation of the GetClosestPointTo method of the curve object – the overloads are extremely limited. So we have to be somewhat creative in obtaining a solution.

    The Genesis of this problem

    This is a tricky little problem and I could not find a solution on the forums. So I resolved, upon discovering the solution, to oblige posterity and the public, to publish my findings.

    Specific Notes about this problem

    Now the following code has been generalised to the specific case of Lines and a non-descript curve (which of course is an abstract base class), but the general principles can be applied to any type of curve.

    Notes on implementation

    Unfortunately, the curve object exposes a method: GetClosestPointTo, which is only overloaded to accept points and not other curves. In order to deal with this rigmarole we’ll have to first, convert the curve to a `Curve3d` object which is a member of the Autodesk.AutoCAD.Geometry namespace as distinct from the Autodesk.AutoCAD.DatabaseServices namespace.

  • Point Monitor Hello World (AutoCAD .net API)

    We have someone who is pointing to the monitor. Makes perfect sense right?
    We have someone who is pointing to the monitor. Makes perfect sense right?

    This is largely a replication of what is contained in the documentation without the extraneous (and extremely confusing) intertwining of WPF/WinForms functionality. Personally I believe when engaging in hello world functions that they should be as simple as possible.

    I have done as much here.

    In time, I will add further details to provide you with some more information on the classes that are used. The main thing to pay attention to here is the FullSubentityPath class as well as the PointMonitorEventArgs.AppendToolTipText(string) method. More details will follow later on. For the moment, parse this code and try to understand what you can:

  • What is a Result Buffer Data Type? (AutoCAD .net API)

    A physical representation of a Result Buffer outside the world of ObjectARX. hahha.
    A physical representation of a Result Buffer outside the world of ObjectARX. hahha.

    Unfortunately, and unsurprisingly, the documentation is a little sparse on this point. But somewhere deep within the annals of the AutoCAD documentation I found this little beauty:

    Here is the documentation. But for you folks who may find that the link does not work, I will also copy and paste verbatim, what is said there:

    The ResultBuffer type is a class that mirrors the resbuf struct defined in the ObjectARX SDK. The resbuf struct provides a flexible container for AutoCAD-specific data.

    An Autodesk.AutoCAD.DatabaseServices.ResultBuffer class object is used in much the same way as a resbuf chain. You define a ResultBuffer and populate it with a sequence of data pairs. Each pair contains a data type description and a value. In the managed API, these data pairs are instances of theAutodesk.AutoCAD.DatabaseServices.TypedValue class. This utility class serves the same purpose as the restype and resval members of the resbuf struct.

    The TypedValue.TypeCode property is a 16-bit integer value that indicates the TypedValue.Value property’s data type. Acceptable TypeCode values depend on the specific use of aResultBuffer instance. For example, TypeCode values that are suitable for an xrecord definition are not necessarily appropriate for xdata. TheAutodesk.AutoCAD.DatabaseServices.DxfCode enum defines codes that accurately describe the full range of possible ResultBuffer data types.

    The TypedValue.Value property maps to an instance of System.Object, and theoretically may contain any type of data. However, the Value data must conform to the type indicated by TypeCode to guarantee usable results.

    You can prepopulate a ResultBuffer by passing an array of TypedValue objects to its constructor, or you can construct an empty ResultBuffer and later call theResultBuffer::Add() method to append new TypedValue objects. The following example shows a typical ResultBuffer constructor usage:

    using (Xrecord rec = new Xrecord())

    {

    rec.Data = new ResultBuffer(

    new TypedValue(Convert.ToInt32(DxfCode.Text), “This is a test”),

    new TypedValue(Convert.ToInt32(DxfCode.Int8), 0),

    new TypedValue(Convert.ToInt32(DxfCode.Int16), 1),

    new TypedValue(Convert.ToInt32(DxfCode.Int32), 2),

    new TypedValue(Convert.ToInt32(DxfCode.HardPointerId), db.BlockTableId),

    new TypedValue(Convert.ToInt32(DxfCode.BinaryChunk), new byte[] {0, 1, 2, 3, 4}),

    new TypedValue(Convert.ToInt32(DxfCode.ArbitraryHandle), db.BlockTableId.Handle),

    new TypedValue(Convert.ToInt32(DxfCode.UcsOrg),

    new Point3d(0, 0, 0)));

    }

    What does all this mean?

    I can’t justify an entire post without adding some degree of value: let’s try simplify its meaning a little more. Basically, result buffers are like CLR dictionaries: they are made up of a series of TypedValue objects. These TypedValue objects are like Key-Value pairs which you can fill with different types of data (i.e. AutoCAD data), or even non-AutoCAD data. The values you can use for the Key (in a TypedValue object) are basically that which are specified as DxfCode values.

    Result Buffers are:

    • Made of TypedValue objects.
      • Typed value objects are like Key Value pairs
        • Where the key of the TypedValue is a DxfCode and
        • The value of the TypedValue is any AutoCAD type which corresponds to the DxfCode set as the key.

    I hope that’s making some degree of sense? It will be a sad day if such an explanation obfuscates what is written in the documentation (where it exists) to a greater degree than the documentation itself. Anyways, I do hope it helps.

  • Extracting Bolt Distances of Single Part Drawings (Beams) With an Output In Excel – Part 2 (Tekla Open API)

    This is a picture of a rusty beam. I added the picture here because it looks cool and for no other reason.

     

    In the last part, we left off having collected the relevant Single Part Drawings that we were after. Hopefully we have applied the correct property to filter out the ‘HEA’, ‘IPE’ and ‘CC’ drawings. We will now focus on part II – extracting the distance of the bolts from the beam’s start position.

     

    1. Get every SinglePartDrawing which name starts with “HEA/IPE/CC”
    2. Calculate the distance of every bolt distance from the start of the corresponding Single Part. ** This blog post will address Part II.
    3. Write the name of the Single Part and every bolt distance to Excel.
    4. Refactor the code.

     

    I did refactor the code a little bit, so it might not look exactly the same as the last version. The code is pretty self explanatory. But you will note that:

    • I am projecting the bolt positions along the beam’s vector (defined from the start to end point of the beam).
    • Therefore we do not need to save and set the transformation plane.
    • A corollary (and potentially unintended consequence) is that this will capture the bolt positions of all bolts, no matter if they are on the flange of the beam, or on the web etc. This may have some unintended consequences. Again, caveat emptor – programmer beware!

     

    Here is the code in all it’s glory – simply follow the well detailed comments and it should be fairly straightforward. As always, any questions, feel free to ask.

    We now have extracted the relevant information. Part III will delve into extracting this data in an Excel format. We will most likely use an OpenXML on other such library for that purpose. That post will come shortly, when I get a spare moment. Till that time, enjoy the following – or perhaps it can be left as an exercise for the user?!

  • Extracting Bolt Distances From Single Part Drawing Files With an Output In Excel – Part 1 (Tekla Open API)

    We want the bolt distances of all the single parts.
    We want the bolt distances of all the single parts.

    Every now and again we obtain a request from our readership to tackle a problem. If it is of general interest to the public and given our commitments we do sometimes oblige. Here is one such interesting problem. We will tackle this in three parts, and will focus on part 1 in this blog post.

    1. Get every SinglePartDrawing which name starts with “HEA/IPE/CC”
    2. Calculate the distance of every bolt distance from the start of the corresponding Single Part.
    3. Write the name of the Single Part and every bolt distance to Excel.
    4. Refactor the code.

    The first part is easy enough – and the code is pretty self-explanatory. We want to iterate through all the drawings and filter for the specific drawings that we are after.

    Here is the code:


    In the next part, we will look at obtaining the relevant parts that we want and calculating the bolt distances from the start and end points. And finally, we will look at refactoring the code, because it is a little slow, and also from a maintainability point of view.

     

    An Addendum

    • I was simply following the instructions of the question without inquiring too far into its purpose. If you actually want to extract NC information via the API – Tekla can very easily do this. But that was not the scope of this particular task – it was to deliver a very specific and peculiar set of requirements to a particular reader, but it is a topic which will be of general import to the public.
  • Drawing Metal Edges – BubbleDeck Detailing (+ Video Demo)

     

    Drawing these metal edges is time consuming and error prone.
    Drawing these metal edges is time consuming and error prone.

     

     

     

    What is the task at hand?

    You have a set of 30 panels. You need to draw metal edges around the edges of all these panels. That’s easy, but it’s subject to certain specific requirements.

     

    If it’s a Perth job then:

    • The metal edge can only be a maximum of 3.0m long.
    • Minimum distance: 0.4m long.

     

    If it’s an Adelaide job these are the metal edge requirements:

    • The metal edge can only be a maximum of 2.4m long.
    • Minimum distance: 0.4m long.

    That means you may need to do some maths. And you actually have to draw the things in. It’s a royal pain, and more than likely, you’ll make mistakes.

     

    Video Demonstration of the Draw Metal Edges Tool

    This tool obviates the need for manual calculations and drawing by hand. Chances of pick point errors and wrongly stipulating an unmakable and unorderable metal edge is there by significantly diminished.

     

    Here is a video demonstration:

     

    Draw Metal Edges from Tek1 on Vimeo.

  • What are curve parameters? (AutoCAD .net API)

    A perusal of the .net Reference Guide reveals these types of functions:

    This is a snapshot of the .net API Reference guide.
    This is a snapshot of the .net API Reference guide.

     

    But as per usual, there is no explanation in the documentation as to what a exactly a parameter is. This is best explained by example. Stay with me here:

    • Suppose you have a curve (i.e. a polyline) that has n points. Or in this case, 10 points.
    • If you called `polyline.GetStartParam()` you’d get a value of 0. And if you called: `polyline.GetEndParam()` you’d get a value of 9. You’ve got 10 points of course, but remember,  you’d get a value of 9 because it’s all zero index based.

    Some Notable Exceptions:

    • Now you have to remember that Ellipses and Circles are also curves too. If you asked an arc or a circle a question about its parameter, then you are really asking it about the angle around the circle or arc (starting from 0). E.g. circle.GetPointAtParameter(0) should give you (100,0,0) and circle. GetPointAtParameter (2π) should give you (100,0,0).
    • Suppose you want to calculate the halfway distance between vertex 0 and vertex 1 for a polyline? Should you use polyline.GetPointAtParam(0.5)? The answer is: no! This is because the mapping between parameters and points need not be linear. To be safe you should use: getDistAtParam() to get the distances d0 and d1 and you should then use getPointAtDist( (d0 + d1) / 2 ).

  • BREP API – A Very Basic Primer (AutoCAD .net API)

    A very nice mesh surface of a face.
    A very nice mesh surface of a face.

     

    The boffins at AutoDesk have ported that which has existed in the ObjectARX API into .net – it’s basically a wrapper. And on a side-note – it is well worth reading the ObjectARX documentation for that very reason – let’s face it – the documentation for AutoCAD APIs are not very good. So definitely read the ObjectARX API.

    Here are some very useful resources that you will need in order to fully utilise this API:

    What is the BRep API all about?

    • Think of Breps as a novel way of representing shapes in a hierarchical way. This won’t make much sense to you – but consider the example below: re: traversal of this hierarchy.

    What is it useful for?

    Brep API is useful for: (i) traversing a hierarchy of shapes, (ii) Point Containment calculations and (iii) Meshing.

    (A) Traversing a hierarchy of shapes.

    Ok. When you think of a cube for example, you have a 3d object:

    • Cube (the cube can also be thought of as a shell – a set of connected faces).That cube is made up of 6 faces, all of which are squares.
      • Those faces are made up of 4 edges each.
        • Those edges are bade up of 2 vertexes bounded by a curve.

    All 3d objects can be broken down somewhat into a hierarchy of simpler objects. The BREP API allows you to traverse that hierarchy and make queries according to your particular requirements/needs/application.

    (B) Containment calculations

    Let’s suppose you have a sphere and you want to determine whether a point lies within the sphere or outside of it. You could use the Brep API to make this determination.

    (C) Drawing meshes to represent surfaces

    You could use the API to create meshes which can approximate a 3d surface or object.