PTC introduced Creo Object TOOLKIT C++ as a part of its modernization plan and to improve productivity.

To enable users to smoothly migrate their existing Creo TOOLKIT applications, the Creo TOOLKIT APIWizard provides links to equivalent Creo Object TOOLKIT C++ methods.

Additionally, from Creo 3.0 onward, PTC provides a tool to facilitate migration of Creo TOOLKIT applications to Creo Object TOOLKIT C++.

Certain functional areas are not yet available in Creo Object TOOLKIT C++. In such cases, you can continue using the Creo TOOLKIT functions in Creo Object TOOLKIT C++ applications, as both the toolkits are compatible. Refer to the Creo Object TOOLKIT C++ User’s Guide for more information.

PTC provides the mark_otkmethod.pl tool to help you migrate applications from Creo TOOLKIT to Creo Object TOOLKIT C++. This perl script is located at <creo_loadpoint>\<version>\Common Files\protoolkit\scripts. The script parses directories and looks for files with extensions such as, .c, .cxx, and .cpp, which are the default extensions included in the script.

The script searches for Creo TOOLKIT functions in these files. When it finds Creo TOOLKIT functions, the script inserts comments with recommendations of possible replacing Creo Object TOOLKIT C++ methods. By default, the script uses the mapping table protk2otkmap.txt provided at <creo_loadpoint>\<version>\Common Files\protoolkit\scripts.

The script options are listed when you run mark_otkmethod.pl with no arguments, or with options –h, -? or –help.

When you run the script, it saves a copy of the original files. However, PTC recommends that you back up all the files, before running the script.

The script generates two types of outputs depending on the -m option. The mark_otkmethod.pl generates output similar to the mark_deprecated.pl script.

For example, consider a file Xsection.c. It contains the following code:

    ProMessageDisplay(msgfil, "USER Pick the start plane");
    status = ProSelect("face", 1, NULL, NULL, NULL, NULL, &sel, &n_sel);
    if(status != PRO_TK_NO_ERROR || n_sel < 1)
        return(0);

    ProSelectionModelitemGet(sel[0], &surface_modelitem);
    ProSurfaceInit(part, surface_modelitem.id, &surface);
    ProSurfaceTypeGet(surface, &stype);
    if(stype != PRO_SRF_PLANE)
	return(0);

If you specify the -m option, the original file is retained, and the output file with the name <filename>_markup.c is created. The recommended Creo Object TOOLKIT C++ methods are inserted as comments on separate lines in the output file. In this example, for the file Xsection.c, the following output is generated in the file Xsection_markup.c:

   ProMessageDisplay(msgfil, "USER Pick the start plane");
  /* Replace ProMessageDisplay with pfcSession::UIDisplayMessage / 
         pfcSession::UIDisplayLocalizedMessage */

    status = ProSelect("face", 1, NULL, NULL, NULL, NULL, &sel, &n_sel);

/* Replace ProSelect with pfcBaseSession::Select */    
     if(status != PRO_TK_NO_ERROR || n_sel < 1)
        return(0);

    ProSelectionModelitemGet(sel[0], &surface_modelitem);

/* Replace ProSelectionModelitemGet with pfcSelection::GetSelModel / 
         pfcSelection::GetSelItem */
    ProSurfaceInit(part, surface_modelitem.id, &surface);
    ProSurfaceTypeGet(surface, &stype);
    if(stype != PRO_SRF_PLANE)
	return(0);

If you do not specify the -m option, a copy of the original file is saved as <filename>.c.orig. The comments with recommendations are inserted in the original file. In this example, the original file Xsection.c is saved as Xsection.c.orig. The following output is generated in the file Xsection.c:

   /* Replace ProMessageDisplay -> pfcSession::UIDisplayMessage / 
        pfcSession::UIDisplayLocalizedMessage */ 
           ProMessageDisplay(msgfil, "USER Pick the start plane");
   
 status =/* Replace ProSelect -> pfcBaseSession::Select */ 
   ProSelect("face", 1, NULL, NULL, NULL, NULL,  &sel, &n_sel);

    if(status != PRO_TK_NO_ERROR || n_sel < 1)
        return(0);

    /* Replace ProSelectionModelitemGet -> pfcSelection::GetSelModel / 
        pfcSelection::GetSelItem */ 
          ProSelectionModelitemGet(sel[0], &surface_modelitem);

    ProSurfaceInit(part, surface_modelitem.id, &surface);
    ProSurfaceTypeGet(surface, &stype);
    if(stype != PRO_SRF_PLANE)
	return(0);