NX二次開發-UDO用戶自定義對象(UFUN)【持續完善】

每當提起UDO總是會讓我想起大專畢業那會失業找工作，后來有個寶貴機會去了軟件公司上班，拿到了我人生中的第一個NX二次開發項目，一個關於測量汽車前后左右攝像頭的項目。當時那個項目就用到了UDO，對於只看了兩個月唐康林工程師二次開發視頻教程就跑出來找工作的我，顯然是不會UDO的，后來采用了將handle值寫到部件屬性里，然后每次打開工具對話框前先去部件屬性里讀，在給到對話框里。在然后項目沒做完我就特么滾蛋了。

時隔差不多兩年，以前技術底子太差，好多東西都不懂，直到最近我對UDO才有了一些認知了解，會用了一點點。但是依然很多東西搞不懂。技術這玩意就這樣，也許我現在看不懂，可能兩年后我就能看懂了。考驗的是一個人對熱愛的堅持程度！所以這個UDO內容我會持續完善的。做一個綜合例子，等把UFUN得UDO搞明白了，后面我回去再研究一下NXOPEN的UDO，萬變不離其宗，基本功能應該都是一樣的。

下面這個本對UDO有一些介紹，另外可以去UGOPEN文件夾里看這三個文件。

也可以去UGOPEN\SampleNXOpenApplications里看西門子官方的一個UDO例子，但那個是用NXOPEN寫得。

 

/*****************************************************************************
**
** UDOtest.cpp
**
** Description:
**     Contains Unigraphics entry points for the application.
**
*****************************************************************************/
/* Include files */
#include <stdarg.h>
#include <strstream>
#include <iostream>
using std::ostrstream;
using std::endl;
using std::ends;
using std::cerr;
#include <uf.h>
#include <uf_ui_types.h>
#include <uf_ui.h>
#include <uf_exit.h>


//頭文件
#include <uf.h>
#include <uf_ui.h>
#include <uf_modl.h>
#include <uf_udobj.h>
#include <uf_disp.h>
#include <uf_obj.h>


static void ECHO(char *format, ...)
{
    char msg[UF_UI_MAX_STRING_BUFSIZE];
    va_list args;
    va_start(args, format);
    vsnprintf_s(msg, sizeof(msg), _TRUNCATE, format, args);
    va_end(args);
    UF_UI_open_listing_window();
    UF_UI_write_listing_window(msg);
    UF_print_syslog(msg, FALSE);
}

#define UF_CALL(X) (report_error( __FILE__, __LINE__, #X, (X)))

static int report_error(char *file, int line, char *call, int irc)
{
    if (irc)
    {
        char err[133];
        UF_get_fail_message(irc, err);
        ECHO("*** ERROR code %d at line %d in %s:\n",
            irc, line, file);
        ECHO("+++ %s\n", err);
        ECHO("%s;\n", call);
    }
    return(irc);
}


//顯示事件的回調函數
void registed_display_fun(tag_t udo, void* display_context)
{
    uc1601("這是顯示事件的回調", 1);
}

//選擇事件的回調函數
void registed_select_fun(tag_t udo, void* select_context)
{
    uc1601("這是選擇事件的回調", 1);
}

//適合窗口事件的回調函數
void registed_fit_fun(tag_t udo, void* select_context)
{
    uc1601("這是適合窗口的回調", 1);
    //UF_UDOBJ_all_data_t all_data;
    ////查詢UDO對象數據
    //UF_UDOBJ_ask_udo_data(udo, &all_data);
    ////查詢UDO類的名稱
    //char* class_name, *friendly_name;
    //UF_UDOBJ_ask_class_data(all_data.class_id, &class_name, &friendly_name);//注意事項:friendly_name不能是中文,否則獲取不到.
    ////釋放
    //UF_UDOBJ_free_udo_data(&all_data);
    //uc1601(class_name, 1);
    //uc1601(friendly_name, 1);
    //UF_free(class_name);
    //UF_free(friendly_name);
}

//編輯事件的回調函數
void registed_edit_fun(tag_t udo)
{
    uc1601("這是編輯的回調", 1);
}

// 信息事件的回調函數
void registed_info_fun(tag_t udo)
{
    uc1601("這是信息事件的回調", 1);
}

// 刪除事件的回調函數
void registed_delete_fun(tag_t udo, UF_UDOBJ_link_p_t deleted_obj)
{
    uc1601("這是刪除事件的回調", 1);
}

// 更新事件的回調函數
void registed_update_fun(tag_t udo, UF_UDOBJ_link_p_t update_cause)
{
    uc1601("這是更新事件的回調", 1);
}

//當具有輸入類標識符的UDO通過注意點計算事件時，注冊注意點函數（方法）以進行調用
void registed_attn_fun(tag_t udo, void * display_context)
{
    uc1601("這是注冊注意點事件的回調", 1);
}

//確定此UDO是否可出現的事件回調函數
void registed_occurrenceable_fun(tag_t udo, logical * is_occurrenceable)
{
    uc1601("這是確定此UDO是否可出現的事件回調函數", 1);
}

/*****************************************************************************
**  Activation Methods
*****************************************************************************/
/*  Explicit Activation
**      This entry point is used to activate the application explicitly, as in
**      "File->Execute UG/Open->User Function..." */
extern DllExport void ufusr(char *parm, int *returnCode, int rlen)
{
    /* Initialize the API environment */
    if (UF_CALL(UF_initialize()))
    {
        /* Failed to initialize */
        return;
    }

    /* TODO: Add your application code here */

    UF_initialize();

    uc1601("創建UDO", 1);

    //創建UDOTestClass類
    UF_UDOBJ_class_t class_id;
    UF_UDOBJ_create_class("UDOTestClass", "MyUDOTest", &class_id);

    //將UDOTestClass類的顯示名稱加入到類選擇對話框的類列表中
    UF_UI_add_to_class_sel(class_id);

    //創建UDOTestClass類的對象
    tag_t udo_tag = NULL_TAG;
    UF_UDOBJ_create_udo(class_id, &udo_tag);

    //點構造器
    char sCue[] = "點構造器";
    UF_UI_POINT_base_method_t base_method = UF_UI_POINT_INFERRED;
    tag_t tPoint = NULL_TAG;
    double sBasePoint[] = { 0, 0, 0 };
    int iResponse;
    UF_UI_point_construct(sCue, &base_method, &tPoint, sBasePoint, &iResponse);
    //UFUN創建直線
    UF_CURVE_line_t Line_coords;
    Line_coords.start_point[0] = sBasePoint[0];
    Line_coords.start_point[1] = sBasePoint[1];
    Line_coords.start_point[2] = sBasePoint[2];
    Line_coords.end_point[0] = 100.0;
    Line_coords.end_point[1] = 100.0;
    Line_coords.end_point[2] = 100.0;
    tag_t Line = NULL_TAG;
    UF_CURVE_create_line(&Line_coords, &Line);

    //創建UDO特征
    tag_t udo_feature_tag = NULL_TAG;
    UF_UDOBJ_create_udo_feature_from_udo(udo_tag, &udo_feature_tag);

    //創建鏈接
    //UF_UDOBJ_link_t link_defs[2];
    //link_defs[0].link_type = 1;
    //link_defs[0].assoc_ug_tag = Line;
    //link_defs[0].object_status = 0;
    //將UDOTestClass類對象和直線特征鏈接
    //UF_UDOBJ_add_links(udo_tag, 1, link_defs);

    //創建自有鏈接
    //將UDOTestClass類和對象以自有鏈接方式鏈接
    UF_UDOBJ_add_owning_links(udo_tag, 1, &Line);

    //注冊顯示事件
    UF_UDOBJ_register_display_cb(class_id, registed_display_fun);

    //注冊選擇事件
    UF_UDOBJ_register_select_cb(class_id, registed_select_fun);

    //注冊fit事件
    UF_UDOBJ_register_fit_cb(class_id, registed_fit_fun);

    //注冊編輯事件
    UF_UDOBJ_register_edit_cb(class_id, registed_edit_fun);

    //注冊信息事件
    UF_UDOBJ_register_info_obj_cb(class_id, registed_info_fun);

    //注冊刪除事件
    UF_UDOBJ_register_delete_cb(class_id, registed_delete_fun);

    //注冊更新事件
    UF_UDOBJ_register_update_cb(class_id, registed_update_fun);

    //當具有輸入類標識符的UDO通過注意點計算事件時，注冊注意點函數（方法）以進行調用
    //UF_UDOBJ_register_attn_pt_cb(class_id, registed_attn_fun);

    //注冊確定此UDO是否可出現的事件回調函數
    //UF_UDOBJ_register_is_occurrenceable_cb(class_id, registed_occurrenceable_fun);

/*
    //查詢功能是否為UDO功能
    logical is_udo_feature;
    UF_UDOBJ_is_udo_feature(udo_feature_tag, &is_udo_feature);

    //查詢NX對象是否具有UDO擁有的鏈接
    logical owned;
    UF_UDOBJ_is_owned(Line, &owned);

    //查詢NX對象是否具有UDO擁有的鏈接
    logical owned1;
    UF_UDOBJ_is_owned(Line, &owned1);

    //查詢UDO是否引用指定的NX對象
    logical linked;
    UF_UDOBJ_is_obj_linked_to_udo(Line, &linked);

    //顯式記錄UDO功能以進行更新
    UF_UDOBJ_log_udo_feature_for_update(udo_feature_tag);

    //將指定的UDO版本化為新類
    UF_UDOBJ_version_udo(udo_tag, class_id);

    //如果在部件中找到給定類的UDO,則設置警告用戶的行為,但未加載實現UDO方法的代碼
    UF_UDOBJ_set_user_warn_flag(class_id, true); //TRUE - 將警告用戶,FALSE - 不會警告用戶。請注意，如果未調用此例程，則默認值為FALSE。

    //設置在給定類名的情況下查詢類id的行為
    //默認 模式為UF_UDOBJ_DONT_ALLOW_QUERY_CLASS_ID。這意味着如果使用UDO的類名調用 UF_UDOBJ_ask_class_id_of_name，將返回錯誤代碼， 返回的類ID將為0.此機制用於幫助保護專有UDO的完整性。
    //將查詢設置為UF_UDOBJ_ALLOW_QUERY_CLASS_ID意味着給定一個類名， 您可以找到類ID。此機制用於跨多個共享庫傳遞類ID 
    UF_UDOBJ_set_query_class_id(class_id, UF_UDOBJ_ALLOW_QUERY_CLASS_ID);

    //設置UDO類的擁有對象選擇的行為
    //在 默認的選擇模式是UF_UDOBJ_DONT_ALLOW_SELECTION。這意味着無法單獨選擇擁有的對象。
    //將擁有對象的選擇設置為UF_UDOBJ_ALLOW_SELECTION意味着 如果擁有的對象和UDO都是可選擇的，則選擇擁有的對象將導致選擇 擁有的NX對象並在交互式選擇中激活Up One Level按鈕 。如果UDO不可選擇，則仍然可以選擇 擁有的對象。
    UF_UDOBJ_set_owned_object_selection(class_id, UF_UDOBJ_ALLOW_SELECTION);


    //通過使用UDO對象的輸入標記替換UDO對象的現有標記來編輯UDO功能
    UF_UDOBJ_edit_udo_of_udo_feature(udo_feature_tag, udo_tag);

    //編輯UDO的卷可轉換數據區域
    double volumes[] = { 1};
    UF_UDOBJ_edit_volumes(udo_tag, volumes);

    //編輯UDO的自由格式字符串區域
    char * strings[] = { "123" };
    UF_UDOBJ_edit_strings(udo_tag, strings);

    //編輯UDO的鏈接記錄
    //UF_UDOBJ_edit_links

    //使用以下編輯功能編輯UDO的鏈接
    UF_UDOBJ_edit_link(udo_tag, link_defs, Line);

    //編輯UDO的長度可轉換數據區域
    double length[] = { 1 };
    UF_UDOBJ_edit_lengths(udo_tag, length);

    //編輯UDO的自由格式整數區域
    int integers[] = { 1 };
    UF_UDOBJ_edit_integers(udo_tag, integers);

    //編輯UDO的自由格式double型區域
    double double1[] = { 1 };
    UF_UDOBJ_edit_doubles(udo_tag, double1);

    //編輯UDO的可轉換數據面積
    double area[] = { 1 };
    UF_UDOBJ_edit_areas(udo_tag, area);

    //從指定位置開始刪除UDO的可轉換卷區域， 並以要刪除的指定卷數結束 。
    //UF_UDOBJ_delete_volumes

    //從指定位置開始刪除UDO的自由格式字符串區域， 並以要刪除的指定數量的字符串結束 。
    //UF_UDOBJ_delete_strings

    //刪除UDO及其關聯的NX 對象之間的擁有鏈接
    UF_UDOBJ_delete_owning_link(udo_tag, Line);

    //刪除UDO的鏈接
    UF_UDOBJ_delete_link(udo_tag, link_defs);

    //從指定位置開始刪除UDO的可轉換長度區域， 並以指定的要刪除長度數結束
    //UF_UDOBJ_delete_lengths

    //從指定位置開始刪除UDO的自由格式整數區域， 並以指定的要刪除的整數數結束
    //UF_UDOBJ_delete_integers 

    //刪除從指定位置開始的UDO的自由格式double型區域， 並以指定的double型要刪除的數量結束 。
    //UF_UDOBJ_delete_doubles

    //從指定位置刪除UDO的可轉換區域區域， 並以指定的要刪除區域數結束
    //UF_UDOBJ_delete_areas 

*/




    UF_terminate();
    /* Terminate the API environment */
    UF_CALL(UF_terminate());
}
/*****************************************************************************
**  Utilities
*****************************************************************************/
/* Unload Handler
**     This function specifies when to unload your application from Unigraphics.
**     If your application registers a callback (from a MenuScript item or a
**     User Defined Object for example), this function MUST return
**     "UF_UNLOAD_UG_TERMINATE". */
extern int ufusr_ask_unload(void)
{
    return(UF_UNLOAD_IMMEDIATELY);
}

Caesar盧尚宇
2019年11月22日